Nastavitve SDK: settings.json

Sintaksa

{
  "format": 1,
  "newProjects": {
    "root": "D:\\Projekti",
    "sourceFolder": "source",
    "buildFolder": "build",
    "deliveryFolder": "delivery",
    "neutralLanguage": "sl",
    "targetAccess": "x64",
    "configurations": "Debug;Release;Stranka"
  },
  "paths": {
    "packages": "D:\\Paketi",
    "templates": "D:\\Predloge;%USERPROFILE%\\Predloge",
    "controlBlocks": "%LOCALAPPDATA%\\WKL\\Access Components\\2.0.0\\control-blocks",
    "bootstrapperManager": "D:\\Orodja\\Wkl.Bootstrapper.Manager.accdb"
  },
  "behavior": {
    "exportOnSave": true,
    "checkCodeBeforeBuild": true,
    "askBeforeReopen": false,
    "language": "sl",
    "terminalShell": "pwsh"
  },
  "publisher": {
    "template": "D:\\Zaloznik\\publisher.json"
  }
}

Povzetek

Nastavitve SDK pripadajo vašemu uporabniku sistema Windows, ne projektu: privzete vrednosti za nove projekte, mape, v katerih SDK najde pakete izdaj, predloge, gradnike kontrolnikov in Bootstrapper Manager, delovanje dodatka in predlogo založnika. Dodatek (Nastavitve v skupini Orodja) in ukazna vrstica (`wkl-office settings`) bereta in pišeta isto datoteko.

Datoteka je %APPDATA%\WKL\Office SDK\settings.json, torej v mapi AppData\Roaming vašega profila: v omrežju z vodenimi profili vas spremlja na druge računalnike in ostane, ko namestite drugo različico SDK. Brez datoteke veljajo privzete vrednosti SDK. Spremenljivka okolja WKL_SDK_SETTINGS navede drugo datoteko, na primer na strežniku za gradnjo.

Vrstni red veljavnosti

Vrednost velja po tem vrstnem redu; velja prvi vir, ki vrednost navaja:

projektna datoteka (.acproj) za nastavitve, za katere ima lastnost;
spremenljivka okolja nastavitve;
settings.json;
privzeta vrednost SDK.

Pogovorno okno Nastavitve SDK in wkl-office settings list pokažeta, od kod je posamezna vrednost. Vrednost, ki jo zapišete v datoteko, ne velja, dokler je njena spremenljivka okolja nastavljena; oba na to opozorita.

Vnosi

Vnos	Vrednosti	Privzeto	Spremenljivka okolja	Pomen
`newProjects.root`	mapa	brez	–	`wkl-office new` ustvari projekt, naveden samo z imenom (`new Stranke`), v tej mapi.
`newProjects.sourceFolder`	ime mape	`source`	–	`SourceRoot` novega projekta.
`newProjects.buildFolder`	ime mape	`build`	–	`BaseOutputPath` novega projekta in mapa v njegovi datoteki `.gitignore`.
`newProjects.deliveryFolder`	ime mape	`delivery`	–	`DeliveryRoot` novega projekta.
`newProjects.neutralLanguage`	koda jezika	brez	–	`NeutralLanguage` novega projekta, na primer `sl`.
`newProjects.targetAccess`	`x86`, `x64`, `any`	`any`	–	`TargetAccess` novega projekta.
`newProjects.configurations`	imena, ločena z `;`	Debug in Release	–	Konfiguracije, ki jih nov projekt navaja poleg konfiguracij Debug in Release (`Configurations`).
`paths.packages`	mapa	brez	`WKL_PACKAGES`	Mapa paketov izdaj (`<izdelek>\<različica>`); nova izdaja iz nje predlaga najnovejšo različico vsake knjižnice WKL.
`paths.templates`	mape, ločene z `;`	brez	`WKL_ACCESS_TEMPLATES`	Kje SDK išče `Template` projekta, če je ne najde glede na projekt.
`paths.controlBlocks`	mapa	brez	`WKL_ACCESS_CONTROL_BLOCKS`	Gradniki kontrolnikov knjižnice WKL Forms Object Library, kadar mape ne navaja niti projekt niti njegova predloga.
`paths.bootstrapperManager`	datoteka	nameščena različica	`WKL_BOOTSTRAPPER_MANAGER`	Podatkovna zbirka orodja Bootstrapper Manager namesto najnovejše nameščene različice.
`behavior.exportOnSave`	`true`, `false`	`true`	–	Ali shranjevanje v urejevalniku VBA izvozi spremembe, za projekt, za katerega tega niste sami vklopili ali izklopili.
`behavior.checkCodeBeforeBuild`	`true`, `false`	`false`	–	Zgradi in znova odpri ter Znova zgradi in odpri najprej preverita kodo; napaka ustavi gradnjo, preden se podatkovna zbirka zapre, opozorila je ne ustavijo.
`behavior.askBeforeReopen`	`true`, `false`	`true`	–	Ali Zgradi in znova odpri ter Znova zgradi in odpri vprašata, preden zapreta podatkovno zbirko.
`behavior.language`	`en`, `de`, `sl`, `hr`, `it`	jezik Officea	`WKL_SDK_LANGUAGE`	Jezik dodatka in ukazne vrstice.
`behavior.terminalShell`	`pwsh`, `powershell`, `cmd`	PowerShell 7, sicer Windows PowerShell	–	Lupina terminala v dodatku.
`publisher.template`	datoteka	brez	–	Datoteka `publisher.json`, ki se kopira v `DeliveryRoot` projekta, ko se nastavi njegova izdaja in projekt datoteke `publisher.json` še nima.

Mape in datoteke lahko vsebujejo spremenljivke okolja (%USERPROFILE%). Ime mape nima poti.

Česa v nastavitvah ni

SDK ne ponavlja nastavitev, ki jih že ponujata Access in urejevalnik VBA. Spremenite jih tam:

Nastavitev	Kje
Zaupanja vredna mesta, nastavitve makrov, dodatki	Access: Datoteka › Možnosti › Središče zaupanja
Zagonski obrazec, podokno za krmarjenje, trak podatkovne zbirke	Access: Datoteka › Možnosti › Trenutna zbirka podatkov (v projektu: `source/application/properties.json`)
Privzeta oblika zapisa datoteke, privzeta mapa zbirke podatkov	Access: Datoteka › Možnosti › Splošno
Zahtevaj deklaracijo spremenljivk, samodejno preverjanje sintakse, pisava, širina tabulatorja	Urejevalnik VBA: Orodja › Možnosti
Prevajanje na zahtevo, prekinitev ob napakah	Urejevalnik VBA: Orodja › Možnosti › Splošno

Opombe

Oblika. format je 1. Datoteko novejše oblike SDK zavrne s sporočilom, namesto da bi jo prebral le deloma: pogovorno okno Nastavitve SDK takrat ne ponudi ničesar za spreminjanje, wkl-office settings pa se konča z izhodno kodo 3, zato je SDK nikoli ne prepiše. Uporabite različico SDK, ki je datoteko zapisala, ali datoteko odstranite.
Neznane vnose SDK zavrne in navede seznam vnosov, zato napačno natipkano ime nikoli ne ostane neopaženo.
Datoteka, ki je ni mogoče prebrati, za vse druge ukaze velja, kot da je ni; ti delajo s privzetimi vrednostmi.
Obstoječi projekti ohranijo svoje nastavitve: vnosi pod newProjects veljajo samo za wkl-office new.

Primer kode

wkl-office settings set paths.packages D:\Paketi
wkl-office settings set behavior.askBeforeReopen false
wkl-office settings get paths.packages
paths.packages = D:\Paketi (settings)
wkl-office settings set paths.packages

Zadnja vrstica vnos odstrani; nato spet velja privzeta vrednost.

Sorodne teme

Ukazna vrstica: settings
Projektna datoteka – BaseOutputPath, DeliveryRoot, Configurations
Uporaba dodatka za Access