Odpravljanje težav

Na tej strani so zbrana sporočila in napake programa Bootstrapper Manager z vzroki in rešitvami. Velja za Wkl.Bootstrapper.Manager.accdb v Accessu iz paketa Microsoft 365. Sporočila programa Bootstrapper Manager so navedena tako, kot se prikažejo v slovenskem uporabniškem vmesniku; „…“ nadomešča ime ali pot datoteke. Sporočila zaganjalnika (v angleščini) se prikažejo na strani Težave ali v sporočilu izvedenega ukaza.

Vzrok: mapa, v kateri je Wkl.Bootstrapper.Manager.accdb, ni zaupanja vredno mesto, zato Access kode strani ne izvede.

Rešitev: mapo dodajte med zaupanja vredna mesta, kot opisuje 2. korak v razdelku Nastavitev in zagon programa Bootstrapper Manager. Nato Bootstrapper Manager znova odprite.

Vzrok: zaganjalnika ni na nobenem mestu, kjer ga Bootstrapper Manager išče: ob zagonu ni bil podan starter=, nastavitev StarterPath ne obstaja, v mapi projektne datoteke pa ni datoteke Wkl.Bootstrapper.exe. Mogoče je tudi, da starter= ali StarterPath kaže na datoteko, ki ne obstaja; v tem primeru Bootstrapper Manager ne išče naprej. Sporočilo se lahko prikaže pri ukazih Preveri (kot vrstica na strani Težave), Nov, Prevzemi, Uvozi, Predogled, Poskusni zagon in Ustvari MSI.

Rešitev: zaganjalnik shranite v mapo projektne datoteke, kjer je tudi po namestitvi. Druga možnost je, da StarterPath nastavite na veljavno pot, kot opisuje 3. korak v razdelku Nastavitev in zagon programa Bootstrapper Manager. Urejanje in shranjevanje delujeta tudi brez zaganjalnika.

Vzrok: zaganjalnik je v mapi projektne datoteke, ta mapa pa na tem računalniku ni potrjena. Ko je Bootstrapper Manager vprašal, ali mapi zaupate, ste kliknili Ne. Zagnalo se ni nič.

Rešitev: ukaz zaženite znova in kliknite Da, če mapi zaupate. Druga možnost je, da zaganjalnik navedete, in Bootstrapper Manager potem ne vpraša: nastavite StarterPath ali ob zagonu podajte starter=, kot opisuje 3. korak v razdelku Nastavitev in zagon programa Bootstrapper Manager.

Vzrok: z ukazom Odpri ste izbrali projektno datoteko v obliki 1.

Rešitev: datoteko ročno pretvorite v obliko 2; glejte Projektna datoteka (format 2), razdelek Format 1 (dokumentacija WKL Bootstrapper). Konfiguracijo prejšnjega zaganjalnika (StarterPro.config.xml) pa lahko prevzamete neposredno z ukazom Prevzemi.

Vzrok: datoteka ni veljaven JSON, običajno zato, ker je bila urejena ročno (manjka vejica ali narekovaj ali pa je v poti enojna poševnica nazaj namesto \\).

Rešitev: napako, na katero opozarja sporočilo, popravite v urejevalniku besedila in datoteko znova odprite.

Vzrok: na izbranem mestu že obstaja datoteka s tem imenom. Ukaz Prevzemi obstoječe projektne datoteke ne prepiše.

Rešitev: znova izberite Prevzemi in vnesite drugo ime ali izberite drugo mapo.

Vzrok: zaganjalnik je zahtevo zavrnil; nadaljevanje sporočila navede razlog, na primer neznano predlogo ali mapo, v katero nimate pravice pisanja. Če je ukaz zamenjal obstoječo datoteko, je prejšnja spet na svojem mestu.

Rešitev: odpravite vzrok, ki ga navaja sporočilo, na primer tako, da izberete drugo mapo.

Vzrok: različica in oznaka izdelka postaneta del imena paketa in ukazne vrstice skripta. Bootstrapper Manager kot različico sprejme samo dve ali tri števila, ločena s pikami, kot oznako izdelka pa od 1 do 64 znakov: črke angleške abecede, števke, pike, vezaje in podčrtaje, vendar ne samih pik. Sicer ničesar ne shrani in skripta ne zažene.

Rešitev: vnesite različico, kot je 1.0.0, ali spremenite oznako izdelka na strani Splošno.

Vzrok: skript New-StarterMsi.ps1 se je končal z napako; njegov izpis je pod sporočilom. Najpogostejši vzrok je, da orodje wix ni nameščeno ali je starejše od različice 6.

Rešitev: namestite WiX (dotnet tool install --global wix). Če manjka skript sam, Bootstrapper Manager sporoči „Skripte tools\New-StarterMsi.ps1 ni mogoče najti (nastavitev MsiTool ali v mapi zaganjalnika).“ Skript je v mapi tools paketa različice zaganjalnika.

Vzrok: zaganjalnik se je končal, ne da bi zapisal rezultat, na primer ker starejša različica ne pozna stikala /preview oziroma /whatif ali ker ga je ustavila varnostna programska oprema.

Rešitev: uporabite zaganjalnik iz trenutne različice WKL Bootstrapper in ukaz ponovite. Vzrok ugotovite tako, da zaganjalnik z istim ukazom zaženete v ukaznem pozivu (Wkl.Bootstrapper.exe /whatif <projektna datoteka>).

Vzrok: Bootstrapper Manager besedila te težave ne prepozna, na primer ker se ne nanaša na nobeno polje („Zaganjalnika ni mogoče najti …“) ali ker jo novejša različica zaganjalnika opiše drugače. Če težava ne navaja nobenega znanega dela projektne datoteke, ukaz Na stran ni na voljo; sicer odpre stran, vendar ne označi nobenega mesta.

Rešitev: težavo odpravite po njenem opisu; na začetku je naveden del projektne datoteke, ki ga zadeva.

Vzrok: projektna datoteka, ki je bila že na seznamu, je bila prebrana znova, pri vprašanju „Želite datoteko prebrati znova in spremembe zavreči?“ pa je bil izbran odgovor Da. Brez tega vprašanja Bootstrapper Manager projekt znova prebere samo, če nima neshranjenih sprememb.

Rešitev: zavrženih sprememb ni mogoče obnoviti; v datoteki je nazadnje shranjeno stanje.

Vzrok: v polju Izvorna mapa je relativna pot, na primer deploy. Zaganjalnik jo računa od svoje mape, po namestitvi torej od C:\Program Files (x86)\WKL\<oznaka izdelka>, kjer izvorne mape ni. Okno zaganjalnika prikaže kodo 12, diagnostične podrobnosti pa besedilo The source C:\Program Files (x86)\WKL\Blagajna\deploy is not reachable. Poskusni zagon in preverjanje v programu Bootstrapper Manager tega ne pokažeta, ker je tam zaganjalnik v isti mapi kot projektna datoteka in relativna pot velja.

Rešitev: v polje Izvorna mapa vnesite polno pot ali mapo v skupni rabi, projekt shranite in izdelajte nov paket MSI z višjo različico paketa. Druge vzroke za kodo 12 opisuje Mape z aplikacijo ni mogoče doseči (koda 12) (dokumentacija WKL Bootstrapper).

Vzrok: datoteka aplikacije je bila izdelana v 32-bitnem Accessu. Datoteka ACCDE in prevedena datoteka ACCDB delujeta samo v različici Accessa (32- ali 64-bitni), v kateri sta bili izdelani. Zaganjalnik se v tem primeru ustavi s kodo 21 ali pa Access ob odpiranju sporoči, da funkcije ni mogoče najti.

Rešitev: izdajo pripravite z WKL Office SDK in vrednostjo "bitness": "any" kot datoteko ACCDB, ki deluje v obeh različicah; glejte Nastavitve izdaje (dokumentacija WKL Office SDK). Če mora ostati datoteka ACCDE, tem uporabnikom zagotovite različico, izdelano v 64-bitnem Accessu, z lastno izvorno mapo in lastnim zaganjalnikom; glejte Namestitev za 32- in 64-bitni Office, razdelek Izvedba, in Aplikacija ni za nameščeni 32- ali 64-bitni Access (koda 21) (dokumentacija WKL Bootstrapper). Izdajo preverite na računalniku s 64-bitnim Officeom, kot je opisano v Preizkus projekta in izdelava paketa MSI.

Vzrok: seznam je shranjen v datoteki Wkl.Bootstrapper.Manager.accdb, nova različica te datoteke pa se začne s praznim seznamom.

Rešitev: projektne datoteke znova dodajte z ukazom Odpri. Neshranjene spremembe iz stare različice so samo v stari datoteki, zato jih shranite tam, preden datoteko zamenjate.

• Uporabniški priročnik za WKL Bootstrapper Manager
• Kode napak zaganjalnika (dokumentacija WKL Bootstrapper) – sporočila zaganjalnika na uporabnikovem računalniku