app-model.json

Model aplikacije podatkovne zbirke: naslov, ikona, začetni obrazec, trak, jezik komponent, uporabniški vmesnik vsakega načina, načini, v katerih sme teči posamezni profil povezave, in kaj sme skrbnik prilagoditi med delovanjem. WklApplication ga hrani v tabeli USysWklApp podatkovne zbirke; orodje za gradnjo ga prebere iz datoteke, ki jo navaja appModel v access-app.json.

Podpis

{
  "version": 1,
  "title": "Kunden",
  "icon": "kunden.ico",
  "iconForFormsAndReports": true,
  "startForm": "frmAppShell",
  "ribbon": "AppRibbon",
  "language": "de",
  "modes": {
    "administration": { "navigationPane": false },
    "production": { "statusBar": false }
  },
  "profiles": [
    { "profile": "PROD", "modes": ["production"] },
    { "profile": "TEST", "modes": ["administration", "production"] }
  ],
  "adjustments": {
    "relink": true,
    "condition": { "function": "IsAdmin" },
    "options": [
      { "key": "Mail.Server", "label": "Mailserver", "default": "smtp.example.com" },
      { "key": "Branch", "label": "Filiale", "kind": "choice", "default": "Wien", "choices": ["Wien", "Graz"] }
    ]
  }
}

Povzetek

En objekt JSON v UTF-8. Vsi ključi razen version so izbirni; ključ, ki je izpuščen, obdrži privzeto vrednost. Neznan ključ, napačna vrsta ali neznana vrednost se zavrne z wkeInvalidValue, ki navede mesto, nikoli se ne prezre.

Ključi

Ključ	Vrsta	Privzeto	Pomen
`version`	število	-	Različica oblike; `1`. Obvezno. Novejša oblika, kot jo berejo komponente, se zavrne.
`title`	besedilo	prazno	Naslov okna programa Access (AppTitle); prazno ohrani lastni naslov programa Access.
`icon`	besedilo	prazno	Ime datoteke .ico ali .bmp, shranjene z modelom (`WklApplication.SaveIcon` ali orodje za gradnjo iz mape datoteke z modelom); postane AppIcon.
`iconForFormsAndReports`	true/false	false	Ikono prikaže tudi v naslovnih vrsticah obrazcev in poročil (UseAppIconForFrmRpt).
`startForm`	besedilo	prazno	Obrazec, ki se odpre ob zagonu (StartUpForm); prazno pomeni nobenega.
`ribbon`	besedilo	prazno	Trak aplikacije (CustomRibbonID), ime v USysRibbons; prazno pomeni trak programa Access.
`language`	besedilo	prazno	Jezik aplikacije: koda jezika z malimi črkami (`de`, `fr` …); komponente WKL jo prevzamejo, če je `en`, `de`, `sl`, `hr` ali `it`. Prazno pomeni samodejno (Office, nato Windows, nato angleščina).
`modes`	objekt	privzete vrednosti spodaj	Uporabniški vmesnik po načinih, ključi `development`, `administration`, `production`.
`profiles`	polje	brez	Pravila: načini, v katerih sme teči profil povezave.
`adjustments`	objekt	brez	Kaj je mogoče prilagoditi med delovanjem brez razvojnega dostopa.

modes

Vsak način je objekt z naslednjimi nastavitvami, vse vrste true/false. Zapišejo se samo vrednosti, ki se razlikujejo od privzete vrednosti tega načina; način, ki je izpuščen, obdrži vse svoje privzete vrednosti.

Ključ	Zagonska lastnost	`development`	`administration`	`production`
`navigationPane`	StartUpShowDBWindow	true	true	false
`statusBar`	StartUpShowStatusBar	true	true	true
`fullMenus`	AllowFullMenus	true	false	false
`shortcutMenus`	AllowShortcutMenus	true	true	false
`builtInToolbars`	AllowBuiltInToolbars	true	false	false
`specialKeys`	AllowSpecialKeys	true	false	false
`bypassKey`	AllowBypassKey	true	false	false

Način se nikoli ne nastavlja; WklApplication ga ugotovi: ACCDB je development, ACCDE v polnem programu Access administration, ACCDE v okolju Access Runtime pa production.

profiles

Polje objektov s profile (profil povezave upravitelja povezav, na primer PROD) in modes (polje imen načinov). Profil, uporabljen v načinu, ki ga njegovo pravilo ne navaja, EnsureApplication sporoči, nikoli pa ga ne zavrne.

adjustments

Ključ	Vrsta	Pomen
`relink`	true/false	V `ShowSettings` dovoli preusmeritev povezav na drug strežnik ali drugo podatkovno zbirko.
`condition`	objekt	Kdo sme odpreti `ShowSettings`: `profiles` (polje imen profilov), `fileKinds` (polje z `accdb`, `accde`, `runtime`), `function` (ime funkcije VBA, ki vrne True); veljati morajo vsi podani deli. Izpuščeno: vsi.
`options`	polje	Možnosti aplikacije v vrstnem redu pogovornega okna: `key` (črke, števke, podčrtaj, pika; enolično), `label` (besedilo v pogovornem oknu; prazno prikaže ključ), `kind` (privzeto `text`, `number`, `yesNo`, `choice`), `default` (v zapisu vrste: število v nevtralnem zapisu, `true`/`false`), `choices` (polje, za `choice`). Aplikacija vrednost prebere z `WklApplication.OptionValue`.

Opombe

Brez modela se nič ne nastavi. Podatkovna zbirka brez shranjenega modela obdrži svoje zagonske lastnosti, kakršne so: EnsureApplication vrne prazno besedilo in v nobenem načinu ničesar ne spremeni. Zaklenjene privzete vrednosti načina production začnejo veljati šele, ko je model shranjen; najmanjši model je { "version": 1 }, ki uporabi natanko privzete vrednosti iz zgornje tabele.

Kdaj vrednosti učinkujejo. WklApplication.Apply, Save in EnsureApplication zapišejo zagonske lastnosti trenutnega načina. Naslov in ikona učinkujeta takoj; vse druge zagonske lastnosti učinkujejo ob naslednjem odpiranju podatkovne zbirke. EnsureApplication pokličite ob zagonu aplikacije (na primer v začetnem obrazcu), tako da se ACCDE, zgrajena za en način in odprta v drugem, od naslednjega odpiranja dalje popravi sama. Orodje za gradnjo zagonske lastnosti vsakega cilja deploy zapiše v izdano kopijo, ne da bi jo odprlo.

Isti bajti. WklApplication.Canonical vrne model s ključi v vrstnem redu te strani in brez privzetih vrednosti, tako da isti model vedno da isto besedilo in je datoteko mogoče hraniti v sistemu za nadzor izvorne kode. Oblikovalnik in Save shranjujeta to obliko.

Primer kode

Dim app As New WklApplication
Debug.Print app.Check("{ ""version"": 1, ""title"": ""Kunden"" }")   ' empty: no problems
app.Save "{ ""version"": 1, ""title"": ""Kunden"", ""startForm"": ""frmAppShell"" }"

Sorodne teme

Referenčni priročnik API (v angleščini): WklApplication – objekt, ki model preveri, shrani in uporabi.
Nastavitve aplikacije: pregled in vadnica.
access-app.json – appModel in deploy orodja za gradnjo.