Vadnica: aplikacija Access pod nadzorom različic

V tej vadnici obstoječo podatkovno zbirko Access pretvorite v izvorne datoteke v repozitoriju git, iz njih zgradite podatkovno zbirko in spoznate vsakodnevni potek dela: spremembo naredite v programu Access, nato jo z enim ukazom potrdite (commit).

• Windows 11 s polno različico programa Microsoft Access, nameščeno za vašega uporabnika (zahteve).
• Izvajalno okolje .NET 10.
• wkl-office na poti PATH (namestitev).
• git na poti PATH. Vadnica uporablja git; za Subversion glejte Potrjevanje sprememb iz programa Access.
• Podatkovna zbirka za začetek; v vadnici je to C:\Data\Stranke.accdb. SDK jo samo bere in je ne spreminja.

wkl-office new C:\Work\Stranke
cd C:\Work\Stranke
git init

new ustvari Stranke.acproj, prazno mapo source/, datoteko .gitignore za mapi build/ in obj/ ter opravila za Visual Studio Code. Ime mape postane ime aplikacije, zato mora biti veljaven identifikator VBA.

wkl-office export Stranke.acproj -d C:\Data\Stranke.accdb

Izvoz dela na kopiji v skritem programu Access. V mapo source/ zapiše vse poizvedbe, module, razrede, obrazce, poročila, makre in sheme tabel ter sklice, lastnosti podatkovne zbirke, temo in slike, nato pa navede vsako zapisano datoteko. Povezanih tabel ne izvozi in na to tudi ne opozori. Če vaša podatkovna zbirka uporablja povezane tabele, povezave vodite v upravitelju povezav (Linked Tables Manager) WKL Forms Object Library (glejte Razporeditev izvornih datotek).

Tabele se zgradijo prazne, razen če pravilo za tabelo določa drugače. V Stranke.acproj navedite tabele, katerih podatki so del aplikacije, na primer šifrante in nastavitve:

<ItemGroup>
  <TablePolicy Include="tblDrzave" Policy="SeedData" />
</ItemGroup>

Izvozite znova: datoteka source/data/tblDrzave.jsonl zdaj vsebuje zapise te tabele.

V programu Access ukaz Nov projekt iz te podatkovne zbirke… v meniju projektov dodatka opravi korake od 1 do 3 v enem pogovornem oknu (Uporaba dodatka za Access).

wkl-office check Stranke.acproj
wkl-office build Stranke.acproj

check še pred zagonom programa Access najde neveljavne izvorne datoteke, manjkajoče sklice, manjkajoč gonilnik ODBC ali geslo, zapisano v poizvedbo. build nato samo iz izvornih datotek ustvari build/Debug/Stranke.accdb.

wkl-office roundtrip Stranke.acproj

Krožna preverba (roundtrip) zgradi kopijo, jo izvozi in rezultat primerja z izvornimi datotekami. Izhodna koda 0 pomeni, da gradnja teh izvornih datotek in ponovni izvoz rezultata na tem računalniku zapišeta natanko iste izvorne datoteke. Besedilne datoteke se pri tem primerjajo s poenotenimi konci vrstic, druge bajt za bajtom. Rezultat pokaže, da so izvorne datoteke stabilne in da gradnja upošteva vse, kar opisujejo.

Ne pokaže pa, da izvorne datoteke vsebujejo vse, kar je imela prvotna podatkovna zbirka: česar izvoz ne zapiše, se pri primerjavi ne more razlikovati (glejte Česa izvoz ne ohrani). Prav tako ne pokaže, da se aplikacija obnaša enako; za to preizkusite zgrajeno podatkovno zbirko. Preberite tudi opozorila izvoza: lastnost, ki je ni bilo mogoče ohraniti, sporoči izvoz, ne krožna preverba. Prvo izvajanje po izvozu iz stare podatkovne zbirke lahko navede obrazce in module, ki jih Access enkrat zapiše po svoje. V tem primeru na zgrajeni podatkovni zbirki izvedite wkl-office export Stranke.acproj; naslednja krožna preverba je potem čista.

wkl-office commit Stranke.acproj -m "Stranke: izvorne datoteke iz podatkovne zbirke"

commit zgrajeno podatkovno zbirko še enkrat izvozi, nato projektno datoteko, .gitignore in mapo source/ doda v git in jih potrdi. V oddaljeni repozitorij ne pošlje ničesar.

1. V programu Access odprite build\Debug\Stranke.accdb in spremenite obrazec, poizvedbo ali kodo. Shranite.
2. Z wkl-office status Stranke.acproj preverite, kaj se je spremenilo.
3. Z wkl-office commit Stranke.acproj -m "<kaj se je spremenilo>" spremembe potrdite. Izvoz vzame podatkovno zbirko iz odprtega programa Access. Dokler je v njem kaj neshranjenega, izvoz zavrne in navede, kaj ni shranjeno.

Ko z git pull prejmete spremembe sodelavca, jih z wkl-office import Stranke.acproj --changed naložite v podatkovno zbirko, odprto v programu Access, ali pa jo zaprete in izvedete wkl-office build Stranke.acproj.

Repozitorij s Stranke.acproj in mapo source/, iz katerega wkl-office build na vsakem računalniku s programom Access zgradi delujočo datoteko Stranke.accdb. Vsaka sprememba, ki jo naredite v programu Access, pride v repozitorij kot berljivo besedilo.

• Referenčni priročnik ukazne vrstice – gradnja Release z ACCDE, sledenje spremembam, izhod JSON za CI
• Referenčni priročnik projektne datoteke – konfiguracije, predloge, zaključna funkcija
• Odpravljanje težav