access-app.json

Projektna datoteka aplikacije Access, ki jo zgradi tools/build/Build-AccessApp.ps1: iz česa je aplikacija sestavljena in kje so njene besedilne izvorne datoteke. Vir je repozitorij; datoteki ACCDB in ACCDE sta izdelka gradnje.

Novi projekti: WKL Office SDK gradi, izvaža in preverja aplikacije Access iz izvornih datotek z več koraki kot to orodje za gradnjo (stanje in usklajevanje z odprtim programom Access, krožna preverba, MSBuild, dodatek za Access), access-app.json pa prevzame z wkl-office migrate access-app.json -o <folder> (dokumentacija WKL Office SDK, navodilo za selitev projekta orodja za gradnjo). To orodje za gradnjo za obstoječe projekte deluje še naprej.

{
  "name": "Kunden",
  "output": "out",
  "references": [
    { "library": "WklForms", "major": 2, "minor": 0 },
    { "library": "WklJSON", "major": 1, "minor": 0 },
    { "guid": "{00025E01-0000-0000-C000-000000000046}", "major": 5, "minor": 0 }
  ],
  "tables": "src/tables",
  "modules": "src/modules",
  "macros": "src/macros",
  "theme": { "folder": "src/theme", "name": "Riviera" },
  "ribbons": "src/ribbons",
  "queries": "src/queries",
  "forms": "src/forms",
  "reports": "src/reports",
  "controlBlocks": "src/controls",
  "properties": { "AppTitle": "Kunden", "StartUpForm": "frmShell", "CustomRibbonID": "AppRibbon", "StartUpShowDBWindow": false },
  "appModel": "src/app/app-model.json",
  "accde": true,
  "deploy": { "folder": "deploy", "version": "1.4.0", "targets": ["Administration", "Production"] }
}

Poimenuje aplikacijo in njene mape z izvornimi datotekami. Vsi vnosi razen name so izbirni; mapa, ki ni navedena, se ne gradi. Poti so relativne glede na mapo projektne datoteke; absolutna pot (na primer themes/riviera iz paketa izdaje) se uporabi takšna, kot je, tako pri gradnji kot pri izvozu.

Vnos, ki ga skript ne pozna, se zavrne s seznamom znanih vnosov, tako da zatipkano ime ne izpusti dela aplikacije brez opozorila.

• Vrstni red gradnje: sklici, tabele, moduli in makri, prevajanje, tema (vdelana, podatkovna zbirka znova odprta, preverjena), trakovi, model trakov, poizvedbe, obrazci, poročila, model podokna za krmarjenje, lastnosti, model aplikacije, funkcija finish, prevajanje, ACCDE, izdaja. Obrazci pridejo za temo, ker Access vdelano temo uporabi samo za obrazce, ustvarjene po ponovnem odprtju podatkovne zbirke.
• Katero različico zabeleži sklic: major in minor sta najnižja različica, ki jo zahteva gradnja, ne pa tista, ki jo hrani podatkovna zbirka. Access zabeleži najvišjo različico te knjižnice tipov, registrirano v računalniku za gradnjo, z isto glavno različico: če je registrirana izdaja 2.3, { "library": "WklForms", "major": 2, "minor": 0 } da sklic na 2.3 v datoteki ACCDB in v datoteki ACCDE. Nižji minor torej ne omogoči, da bi ACCDE delovala v računalnikih s starejšo izdajo; kaj ACCDE, zgrajena z novejšo izdajo, naredi v takem računalniku, je opisano v razdelku o vrstnem redu posodobitve v navodilu deploy-to-user-pcs. Če želite, da podatkovna zbirka ostane uporabna s starejšo izdajo, jo zgradite v računalniku, v katerem je ta izdaja registrirana. Gradnja zapiše zabeleženo različico v requires datoteke app-manifest.json in opozori, kadar je višja od major.minor.
• Ograde za kontrolnike WKL: pravokotnik v obrazcu, katerega lastnost Tag je wkl:<Kind> – wkl:Grid, wkl:TreeList, wkl:ToggleSwitch … kot imena datotek v docs/control-blocks –, se zamenja s tem kontrolnikom z imenom, položajem in velikostjo pravokotnika, in z njegovimi sidri (HorizontalAnchor, VerticalAnchor), kadar jih pravokotnik ima. Potrebno samo za obrazce, ki jih ustvari skript; obrazec, urejen v programu Access in shranjen s SaveAsText, svoje kontrolnike WKL že vsebuje.
• Zaključna funkcija mora sama obravnavati svoje napake. Napaka, ki je ne obravnava, odpre pogovorno okno VBA za napako med izvajanjem, ki ga skriti Access nikoli ne prikaže: gradnja se nato konča ob časovni omejitvi (-TimeoutSeconds). Napake prestrezite in jih vrnite kot besedilo.
• Projekt VBA se mora prevesti. Če se ne, se gradnja ustavi (IsCompiled) in navede korak; napaka pri prevajanju, ki čaka na pogovorno okno, se konča ob časovni omejitvi.
• Model trakov in izvoz: Export-AccessApp zapiše model nazaj v datoteko ribbonModel bajt za bajtom (podatkovna zbirka hrani njegovo kanonično besedilo) in izpusti, kar pripada modelu: modul basWklRibbon in trakovi modela v USysRibbons se ne zapišejo kot datoteke. Ročno urejen model se po prvi gradnji in izvozu vrne v kanonični obliki. Dodelitve priročnih menijev ostanejo v modelu; izvožena besedila obrazcev in poročil nosijo ShortcutMenuBar, ki ga je zapisala gradnja, zato druga gradnja ne zapiše nič novega.
• Model podokna za krmarjenje in izvoz: Export-AccessApp zapiše model nazaj v datoteko navPaneModel bajt za bajtom; lastne tabele podokna programa Access se ne izvozijo. Skupine in vnosi s pogoji se zapišejo za računalnik za gradnjo (ACCDB); aplikacija, katere podokno se razlikuje glede na okolje, ob zagonu pokliče WklNavPane.Apply.
• Izdaja brez odpiranja aplikacije: zagonske lastnosti cilja se v njegovo kopijo zapišejo z DAO; kopija se nikoli ne odpre, zato se njen začetni obrazec med gradnjo ne zažene. Lastnosti začnejo učinkovati, ko se kopija prvič odpre (večino jih Access prebere šele ob odpiranju). AppIcon se iz kopije odstrani – navajal bi datoteko v računalniku za gradnjo – in ga ob prvem zagonu zapiše WklApplication.EnsureApplication; ikona učinkuje takoj.
• Česa deploy ne naredi: ničesar ne namesti, ničesar ne registrira in ne nastavi zaupanja vrednega mesta. Mapa je tisto, kar zaganjalnik ali skrbnik postavi v uporabnikov računalnik.
• Model aplikacije in izvoz: Export-AccessApp zapiše model nazaj v datoteko appModel bajt za bajtom, shranjeno ikono pa kot datoteko ob njem.
• Predloga in izvoz: Export-AccessApp ne zapiše nobenega objekta predloge v aplikacijo, razen če aplikacija že hrani datoteko s tem imenom (ki nadomesti objekt predloge). Če želite objekt predloge spremeniti za eno aplikacijo, najprej v mapo aplikacije postavite datoteko z enakim imenom.
• Kodiranje besedila: moduli in trakovi UTF-8; obrazci, poročila, poizvedbe in makri, kot jih zapiše SaveAsText (UTF-16), obrazci tudi UTF-8 z oznako vrstnega reda bajtov.

Projekt z lupino in eno stranjo, s knjižnico WKL Forms Object Library 1.38 in s trakom po meri:

{
  "name": "Kunden",
  "references": [ { "library": "WklForms", "major": 2, "minor": 0 } ],
  "tables": "src/tables",
  "modules": "src/modules",
  "ribbons": "src/ribbons",
  "forms": "src/forms",
  "properties": { "AppTitle": "Kunden", "StartUpForm": "frmShell", "CustomRibbonID": "AppRibbon" }
}

Ni.