navpane.json

Model podokna za krmarjenje podatkovne zbirke: ena kategorija po meri v podoknu za krmarjenje programa Access z njenimi skupinami in bližnjicami, skupina, ki jo podokno prikaže ob zagonu, ali je skupina nedodeljenih predmetov skrita in ali je podokno zaklenjeno. Pogoji določajo, kdaj se prikaže skupina ali bližnjica. WklNavPane hrani model v tabeli USysWklNavPane podatkovne zbirke. Orodje za gradnjo ga prebere iz datoteke, ki jo navaja navPaneModel v access-app.json, projekt WKL Office SDK pa iz datoteke navigation/navpane.json med svojimi viri.

Podpis

{
  "version": 1,
  "category": "Kunden",
  "defaultGroup": "Daten",
  "hideUnassigned": false,
  "lock": true,
  "groups": [
    {
      "name": "Daten",
      "entries": [
        { "kind": "form", "object": "frmCustomer", "label": "Kunden" },
        { "kind": "report", "object": "rptCustomerList", "label": "Kundenliste" }
      ]
    },
    {
      "name": "Verwaltung",
      "condition": { "profiles": ["DEV", "TEST"], "fileKinds": ["accdb"] },
      "entries": [
        { "kind": "table", "object": "tblCustomer" },
        { "kind": "module", "object": "basAdmin", "condition": { "function": "IsAdmin" } }
      ]
    },
    { "name": "Archiv", "hidden": true }
  ]
}

Povzetek

En objekt JSON v kodiranju UTF-8. Vsi ključi razen version so neobvezni; izpuščeni ključ obdrži privzeto vrednost. Neznani ključ, napačna vrsta ali neznana vrednost se zavrne z wkeInvalidValue in navedbo mesta, nikoli se ne prezre. Komentarji niso dovoljeni.

Ključi

Ključ	Vrsta	Privzeto	Pomen
`version`	število	-	Različica oblike; `1`. Obvezno. Drugo število se zavrne.
`category`	besedilo	prazno	Ime kategorije po meri, kot ga prikažeta naslov podokna in seznam kategorij. Obvezno, preden je mogoče model shraniti (največ 255 znakov).
`defaultGroup`	besedilo	prazno	Skupina, na katero se podokno filtrira, ko se model uporabi; prazno prikaže celotno kategorijo. Navajati mora skupino modela, ki ni skrita (velike in male črke niso pomembne).
`hideUnassigned`	true/false	true	Skrije skupino “Nedodeljeni predmeti” programa Access v tej kategoriji; `false` tam prikaže vsak predmet podatkovne zbirke, ki ni v nobeni skupini.
`lock`	true/false	false	Zaklene podokno pred brisanjem, preimenovanjem in spreminjanjem skupin (`DoCmd.LockNavigationPane`).
`groups`	polje	brez	Skupine kategorije v tem vrstnem redu.

Skupina

Ključ	Vrsta	Privzeto	Pomen
`name`	besedilo	-	Napis skupine. Obvezno, največ 255 znakov, enolično v kategoriji (velike in male črke niso pomembne).
`hidden`	true/false	false	Skupina obstaja, a je skrita: Access jo prikaže zatemnjeno le, kadar so prikazani skriti predmeti. Skrita skupina ne more biti `defaultGroup`.
`condition`	objekt	brez	Kdaj se skupina prikaže; glejte Pogoj. Skupina, katere pogoj ne velja, se sploh ne zapiše.
`entries`	polje	brez	Bližnjice skupine. Podokno jih samodejno razvrsti po prikazanem imenu.

Vnos

Ključ	Vrsta	Privzeto	Pomen
`kind`	besedilo	-	Vrsta predmeta: `table` (lokalna ali povezana), `query`, `form`, `report`, `macro` ali `module` (standardni ali razredni modul). Obvezno.
`object`	besedilo	-	Ime predmeta v podatkovni zbirki (na primer `frmCustomer`). Obvezno. Isti predmet se v skupini lahko pojavi le enkrat.
`label`	besedilo	prazno	Ime, ki ga podokno prikaže za bližnjico (največ 255 znakov); prazno prikaže ime predmeta.
`condition`	objekt	brez	Kdaj se bližnjica prikaže; glejte Pogoj.

Pogoj

Enaka oblika kot pri pogojih ukazov traku. Veljati mora vsak navedeni del; izpuščeni pogoj velja vedno.

Ključ	Vrsta	Pomen
`profiles`	polje besedil	Profili povezave (na primer `DEV`, `TEST`, `PROD` orodja WKL Linked Tables Manager), pri katerih se skupina ali bližnjica prikaže; velike in male črke niso pomembne. Profil je tisti, ki je nastavljen z `WklNavPane.Profile` ali `WklRibbon.Profile`, sicer profil, ki ga uporablja največ povezanih tabel.
`fileKinds`	polje besedil	`accdb` (ACCDB v polnem programu Access), `accde` (ACCDE v polnem programu Access), `runtime` (katera koli podatkovna zbirka v okolju Access Runtime); skupina ali bližnjica se prikaže, kadar je podatkovna zbirka ene od navedenih vrst. Podatkovna zbirka v okolju Runtime šteje samo kot `runtime`.
`function`	besedilo	Ime javne funkcije VBA brez argumentov; skupina ali bližnjica se prikaže, kadar vrne True ali število, različno od 0. Funkcija, ki ne uspe, šteje kot False.

Opombe

Kdaj pogoji učinkujejo. Pogoji se ovrednotijo, ko se model uporabi (WklNavPane.Apply in Save, razen kadar je njegov drugi argument False). Kar ne velja, se v podokno ne zapiše, zato tega uporabnik ne more prikazati niti prek pogovornega okna Možnosti krmarjenja. Podokno ohrani, kar je bilo zapisano nazadnje: aplikacija, katere podokno se razlikuje glede na okolje, ob zagonu pokliče Apply, na primer v dogodku Ob nalaganju zagonskega obrazca. Pogoji so olajšava, ne zaščita; kdor odpre podatkovno zbirko, lahko predmet še vedno odpre drugače.

Manjkajoči predmeti. Vnos lahko navaja predmet, ki ga podatkovna zbirka še nima (doda ga poznejša gradnja). Check tega ne šteje za težavo; Apply vnos izpusti in za vsak manjkajoči predmet vrne eno vrstico.

Isti bajti. WklNavPane model shrani s ključi v vrstnem redu te strani in brez privzetih vrednosti (hideUnassigned samo pri false, lock in hidden samo pri true), z zamikom dveh presledkov, koncem vrstic LF in zaključnim koncem vrstice. Prebran in znova zapisan model da isto besedilo, zato je datoteko mogoče hraniti v sistemu za nadzor izvorne kode.

Vgrajene kategorije. Zapiše se samo kategorija po meri. Vgrajene kategorije programa Access (vrsta predmeta, tabele in povezani pogledi) ostanejo nespremenjene.

Primer kode

Dim pane As New WklNavPane
Debug.Print pane.Check("{ ""version"": 1, ""category"": ""Kunden"" }")   ' empty: no problems
pane.Save "{ ""version"": 1, ""category"": ""Kunden"", ""groups"": [ { ""name"": ""Daten"" } ] }"

Sorodne teme

Referenčni priročnik API (v angleščini): WklNavPane – objekt, ki model preveri, shrani in uporabi.
WklNavPane: pregled in vadnica.
Različno podokno za krmarjenje glede na okolje.
access-app.json – navPaneModel orodja za gradnjo.