Namestitev in uvajanje WKL Office JSON

JDoc in druge razrede JSON omogočite za VBA v razvijalskem računalniku in v računalnikih uporabnikov aplikacije – brez izvorne kode in brez .NET.

• Ena datoteka za 32-bitni in ena za 64-bitni Office. Wkl.Office.JSON.dll je strežnik COM v strojni kodi, ki vsebuje lastno izvajalno okolje: .NET ni treba namestiti v noben računalnik.
• 32- ali 64-bitni Office. 32-bitni Office potrebuje datoteko x86, 64-bitni Office datoteko x64; odloča Office, ne Windows (Datoteka › Račun › Vizitka programa Access).
• Registracija za vsakega uporabnika sistema Windows posebej z regsvr32 v isti (32- ali 64-bitni) različici in /n /i:user, brez skrbniških pravic.
• Sklic WKL Office JSON 1.1 v projektu VBA ali pozna vezava s CreateObject("WklJSON.JDoc").

1. Datoteko Wkl.Office.JSON.dll iz mape izdaje x86 (32-bitni Office) ali x64 (64-bitni Office) kopirajte v lokalno mapo, ki ostane na svojem mestu, na primer %LOCALAPPDATA%\WKL\Office JSON\2.0\x86. Datoteke .pdb in .xml ob njej vsebujejo simbole za razhroščevanje in dokumentacijo; niso potrebne.

2. Zaprite Access in knjižnico registrirajte za trenutnega uporabnika sistema Windows. Za 32-bitni Office:

   %windir%\SysWOW64\regsvr32.exe /n /i:user "%LOCALAPPDATA%\WKL\Office JSON\2.0\x86\Wkl.Office.JSON.dll"

   Za 64-bitni Office uporabite %windir%\System32\regsvr32.exe in datoteko x64. V skriptih dodajte /s, da se okno s sporočilom ne prikaže; registracijo odstranite tako, da dodate /u.

3. V urejevalniku VBA izberite Orodja › Sklici in označite WKL Office JSON 1.1. Preverite v oknu Immediate:

   ? CreateObject("WklJSON.JDoc").LoadJson("{""a"": 1}")

   Izpiše se True.

V računalnikih uporabnikov ponovite koraka 1 in 2 za vsakega uporabnika sistema Windows, ki zažene aplikacijo, na primer iz prijavnega skripta; podatkovna zbirka svoj sklic obdrži. ACCDE zgradite v računalniku, v katerem je registrirana ista datoteka.

Od izdaje 1.0.2 paket ob Wkl.Office.JSON.dll v x86 in x64 vsebuje tudi registration.json: registracijo za posameznega uporabnika v obliki podatkov. Zaganjalnik WKL Bootstrapper na podlagi te datoteke registrira WKL Office JSON za vsakega uporabnika sistema Windows, brez skrbniških pravic in brez regsvr32, knjižnico hrani v uporabnikovem profilu pod izdajo (2.0.0) in jo odstrani, ko je ne potrebuje nobena nameščena aplikacija več. Paket od izdaje 2.0.0 naprej potrebuje zaganjalnik 2.3.1 ali novejši, skupaj z WKL Forms Object Library 2.0 pa zaganjalnik 3.1 ali novejši. Program zaganjalnika se od različice WKL Bootstrapper 3.0 imenuje Wkl.Bootstrapper.exe, prej Wkl.Access.Bootstrapper.exe.

1. Projekt zaganjalnika ustvarite s predlogo json (za aplikacijo Access s kontrolniki WKL skupaj z access in components): /new-project ... /template access,components,json.
2. Mapi x86 in x64 iz paketa izdaje, vsako z njeno datoteko registration.json, kopirajte v mapo json izvorne mape aplikacije, kot določa predloga.
3. Aplikacijo izdajte, kot je opisano za zaganjalnik (kodni wiki WKL-Access-Bootstrapper, strani „How to: Create a project from templates“ in „The installer of the bootstrapper 2.0“).

Paketa 1.0 in 1.0.1 nimata datoteke registration.json; njuna Wkl.Access.JSON.dll sporoča različico 0.1.0. Za namestitev prek zaganjalnika uporabite izdajo 1.0.2 ali novejšo.

Do izdaje 1.0.3 se je knjižnica imenovala WKL Access JSON, njena datoteka Wkl.Access.JSON.dll, knjižnica tipov pa WKL Access JSON 1.0. Sklic nanjo se brez ponovnega prevajanja razreši v WKL Office JSON 1.1: identifikator knjižnice, ProgID-ji in vsi člani so ostali enaki. Aplikacija, izdana z različico 1.0.x, obdrži svojo datoteko; če sta nameščeni obe izdaji, zaganjalnik registrira novejšo.

• Brez lastnega namestitvenega programa. Paket ne vsebuje paketa MSI ali namestitvenega programa: namestite ga ročno, kot je opisano zgoraj, ali ga uvedite skupaj z aplikacijo z zaganjalnikom WKL Bootstrapper, ki ga registrira za vsakega uporabnika posebej.
• Mapa mora ostati na svojem mestu. Registracija kaže na datoteko na njenem mestu; po premiku jo registrirajte znova.
• Vsak uporabnik sistema Windows registrira enkrat. /n /i:user piše samo v HKEY_CURRENT_USER; enako velja za zaganjalnik.
• Ena datoteka, brez Wkl.Office.Json.Core.dll. NativeAOT jedro poveže v Wkl.Office.JSON.dll; paket vsebuje samo datoteki .pdb in .xml jedra.
• Napačna različica (32- ali 64-bitna) se pokaže kot napaka med izvajanjem 429 ali kot sklic, označen kot manjkajoč (v angleškem Officeu MISSING); registrirajte datoteko, ki ustreza 32- ali 64-bitni različici Officea.

• Pregled
• Vadnica
• Referenca API (v angleščini): JDoc