Uporabniški priročnik za WKL Bootstrapper Manager

WKL Bootstrapper Manager je orodje, s katerim aplikacijo Access pripravite za namestitev na računalnike uporabnikov. V njem uredite projektno datoteko bootstrapper.json, po kateri deluje zaganjalnik WKL, in iz nje izdelate namestitveni paket. Bootstrapper Manager pri tem pokrije naslednje korake:

• Opis namestitve: na preglednih straneh določite, katere datoteke se namestijo in kam, katere bližnjice, vrednosti registra, vrste datotek in pogoji sodijo zraven ter kaj se na koncu zažene. Datoteke JSON vam ni treba pisati ročno.
• Preverjanje: projektno datoteko preveri zaganjalnik sam, po istih pravilih, po katerih bo pozneje deloval pri uporabniku. Za vsako najdeno težavo vas Bootstrapper Manager napoti na polje, v katerem jo odpravite.
• Preizkus pred namestitvijo: Predogled prikaže okno, ki ga uporabnik vidi med namestitvijo. Poskusni zagon na vašem računalniku simulira zagon in za vsako datoteko pokaže, kam bi bila nameščena, ne da bi kar koli spremenil.
• Izdelava paketa: Ustvari MSI izdela paket Windows Installer, s katerim oddelek IT namesti zaganjalnik na računalnike.

Bootstrapper Manager ni orodje za oblikovanje namestitvenih paketov, kot sta Visual Studio Installer Projects ali WiX. Namestitvenih pogovornih oken ne oblikuje, paket MSI pa ima vedno enako zgradbo in namesti le zaganjalnik in projektno datoteko. Aplikacijo samo namesti in posodablja zaganjalnik, za vsakega uporabnika posebej in brez skrbniških pravic.

Prvič uporabljate Bootstrapper Manager? Vadnica: aplikacija Access od izvorne mape do preverjene namestitve vas na enem primeru vodi skozi vse korake.

graph LR
    subgraph H["Računalnik založnika"]
        K["WKL Bootstrapper Manager"]
        P["Projektna datoteka bootstrapper.json"]
        M["Paket MSI"]
        K -->|"ureja in preverja"| P
        K -->|"Ustvari MSI"| M
    end
    L[("Izvorna mapa v skupni rabi – Blagajna.accde, bin, Poročila")]
    subgraph R["Uporabnikov računalnik"]
        S["Zaganjalnik in projektna datoteka – Program Files (x86)"]
        A["Aplikacija v profilu – %LOCALAPPDATA%"]
        S -->|"ob vsakem zagonu prekopira manjkajoče in nove datoteke"| A
    end
    M -->|"oddelek IT enkrat namesti"| S
    L -->|"bere"| S

Slika: razdelitev nalog. Bootstrapper Manager opiše namestitev in izdela paket MSI, sam pa ničesar ne namesti. Paket na računalnik prenese samo zaganjalnik in projektno datoteko. Zaganjalnik ob vsakem zagonu prekopira aplikacijo iz izvorne mape v uporabnikov profil in jo zažene. O veljavnosti projektne datoteke odloča izključno zaganjalnik; Bootstrapper Manager nima lastnih pravil, temveč uporabi njegovo preverjanje.

Priročnik je namenjen založnikom, ki aplikacijo Access razdeljujejo z zaganjalnikom. V programu Bootstrapper Manager določite, katere datoteke se namestijo in kam, kako so videti okna zaganjalnika in kaj zaganjalnik na koncu zažene. Zadošča osnovno znanje Accessa in dela z mapami v sistemu Windows; poznavanje oblike JSON ni potrebno.

Potrebujete:

• Microsoft Access iz paketa Microsoft 365, 32- ali 64-bitno različico, in WKL Office SDK, katerega namestitveni program namesti tudi Bootstrapper Manager.
• WKL Forms Object Library 2.0 ali novejšo in WKL Office JSON 2.0 ali novejšo, registrirani za 32- ali 64-bitno različico, ki ustreza nameščenemu Accessu. Slike v priročniku prikazujejo različico 1.59.2 z nemškim uporabniškim vmesnikom.
• Zaganjalnik Wkl.Bootstrapper.exe iz paketa različice WKL Bootstrapper. Potrebujejo ga ukazi Preveri, Predogled, Poskusni zagon, Nov in uvozi. Brez njega lahko projektne datoteke odpirate, urejate in shranjujete, ne morete pa jih preveriti.
• Za ukaz Ustvari MSI še orodje ukazne vrstice WiX (wix, različica 6 ali novejša) in skript zaganjalnika tools\New-StarterMsi.ps1.

Uporabniki s 64-bitnim Officeom. Bootstrapper Manager sam deluje v 32- in 64-bitnem Accessu. Ali je izdaja aplikacije namenjena 32-bitnemu ali 64-bitnemu Officeu, določite v WKL Office SDK; glejte Priprava izdaje aplikacije z WKL Office SDK, razdelek Opombe (dokumentacija WKL Office SDK). Projektno datoteko in paket MSI ustvarite enako kot pri vsakem drugem projektu, izdajo za 64-bitni Office pa preverite na računalniku s 64-bitnim Officeom (glejte Preizkus projekta in izdelava paketa MSI).

Kako Bootstrapper Manager pripravite za delo, opisuje Nastavitev in zagon programa Bootstrapper Manager.

Začetek

• Vadnica: aplikacija Access od izvorne mape do preverjene namestitve
• Nastavitev in zagon programa Bootstrapper Manager

Opravila

• Ustvarjanje, odpiranje ali prevzem projekta
• Nastavitev izdelka, različice, videza in cilja zagona
• Katere datoteke se namestijo in kam
• Nastavitev bližnjic, vrednosti registra in drugih vnosov
• Shranjevanje projekta
• Preverjanje projekta in odpravljanje težav
• Preizkus projekta in izdelava paketa MSI

Za sprotno uporabo

• Navigacija, ukazi in tipkovnica
• Odpravljanje težav
• "Command line of WKL Bootstrapper Manager" – zagon programa Bootstrapper Manager iz drugega programa (tehnična specifikacija v angleščini)

• Podprte so samo projektne datoteke v obliki 2. Datoteko v obliki 1 Bootstrapper Manager ob odpiranju zavrne; pretvoriti je ne moreta ne Bootstrapper Manager ne zaganjalnik. Konfiguracijo prejšnjega zaganjalnika (StarterPro.config.xml) pa zaganjalnik pretvori z ukazom Prevzemi.
• Ustvari MSI vedno izdela paket enake zgradbe: za vse uporabnike računalnika, z zaganjalnikom, projektno datoteko in morebitnim logotipom, brez lastnih namestitvenih pogovornih oken. Paket drugačne zgradbe izdelate sami, na primer z orodjem WiX.
• Dele projektne datoteke, ki nimajo svojega polja ali stolpca (na primer keep pri vnosu datoteke ali start.environment), Bootstrapper Manager ob shranjevanju ohrani nespremenjene, urejati pa jih ne morete. Takšne dele uredite neposredno v datoteki; glejte Projektna datoteka (format 2) (dokumentacija WKL Bootstrapper).
• Pri nekaterih poljih (32- ali 64-bitna različica, jezik, barvna shema, /runtime) izbirate med vrednostmi projektne datoteke v izvirni obliki (access, automatic …). Njihov pomen opisuje Projektna datoteka (format 2), razdelek Vrednost lastnosti (dokumentacija WKL Bootstrapper).
• Uporabniški vmesnik je v jeziku Officea: v slovenščini, nemščini ali angleščini, pri vseh drugih jezikih pa v angleščini.

Izhodiščna je nemška različica. Slovenska in angleška različica podajata isto vsebino, vsaka v naravnem slogu svojega jezika; če se kje razlikujeta, velja nemška.

• WKL Bootstrapper: namestitev in zagon aplikacij Access brez skrbniških pravic (dokumentacija WKL Bootstrapper) – kaj počne zaganjalnik
• Projektna datoteka (format 2) (dokumentacija WKL Bootstrapper) – vsa polja projektne datoteke
• Uvajanje zaganjalnika s paketom MSI (dokumentacija WKL Bootstrapper)