Office SDK · za razvijalce aplikacij Access
Aplikacije Access v Gitu in gradnja iz izvornih datotek
Vsak obrazec, poizvedba in modul kot besedilna datoteka. ACCDE nastane iz commita – ne iz kopije, ki jo je nekdo nazadnje shranil.
Oblikujete še naprej v programu Access. SDK prenaša aplikacijo med programom Access in besedilnimi izvornimi datotekami ter iz njih zgradi podatkovno zbirko – v ukazni vrstici, na traku programa Access ali v cevovodu za gradnjo.
- Oblikovanje v programu Access
- Izvorne datoteke v Gitu
- ACCDE iz commita
Oblikujete v programu Access, SDK pa spremembe zapiše v izvorne datoteke. Gradnja vedno izhaja iz točno določene različice teh datotek.
Izhodišče
Aplikacija Access je ena datoteka. To zadošča, dokler se ne pojavijo štiri vprašanja.
Obrazci, poročila, poizvedbe, koda, tabele in nastavitve so v eni sami binarni datoteki. Dokler na eni kopiji dela en razvijalec, je to dovolj. Ko se pridruži drugi razvijalec ali se v produkciji pokaže prva napaka, ni več.
- Kaj se je spremenilo? Dveh kopij datoteke ACCDB ni mogoče primerjati po vrsticah. Kdor išče vzrok napake, odpira stare kopije drugo ob drugi.
- Kdo dela na aplikaciji? Dva razvijalca svojega dela ne moreta združiti v eno datoteko. Eden obrazce drugega prenaša ročno – sprememba, shranjena v napačni kopiji, pa se izgubi brez sledu.
- Kaj dobijo uporabniki? Izdaja nastane iz razvijalčeve delovne datoteke ACCDB, prevedene v ACCDE skupaj z vsem, kar je bilo tisti dan v njej: s preizkusnimi obrazci, staro povezavo ali nedokončanim modulom.
- Ali jo je mogoče preveriti samodejno? Skript ne more ugotoviti, ali je aplikacija popolna in ali se prevede – to pokaže šele odpiranje v programu Access.
Kaj pa SaveAsText ali dodatek?
Access zna kot besedilo zapisati posamezne objekte – celotne aplikacije ne
Veliko ekip objekte že danes izvaža s SaveAsText in jih z LoadFromText uvaža nazaj. Za obrazce, poročila in module to deluje. Microsoft teh metod uradno ne dokumentira, poleg tega pa ne zajamejo tabel, podatkov, sklicev in lastnosti podatkovne zbirke: celotne aplikacije samo iz njih ni mogoče znova zgraditi.
Veliko ekip gre z odprtokodnim dodatkom msaccess-vcs-addin še korak dlje: obrazce, poizvedbe, module in drugo izvozi s traku v Accessu in iz izvornih datotek znova zgradi podatkovno zbirko. Za posameznega razvijalca je to pogosto dovolj. SDK doda, kar potrebujeta ekipa in cevovod za gradnjo: ukazno vrstico in povezavo z MSBuild z natančno določenimi izhodnimi kodami, preverjanje, še preden se Access zažene, in usklajevanje, ki se ustavi, namesto da bi prepisalo objekt, spremenjen na obeh straneh.
SDK hrani celotno aplikacijo kot izvorne datoteke, tudi sheme tabel, začetne podatke, sklice in lastnosti. Če aplikacijo že hranite kot besedilo z drugim orodjem – z DATEC Access SDK, z orodjem za gradnjo Forms Object Library ali z dodatkom Extensions –, jo wkl-office migrate enkrat pretvori, starega projekta pa pri tem ne spreminja. Prehod z drugega orodja
Z SDK
Aplikacija kot besedilo: spremembe so berljive, delo je mogoče združevati, gradnja je ponovljiva
Odgovori se nadgrajujejo. Ko je aplikacija besedilo, so spremembe berljive; potem lahko na njej dela več ljudi; ko so izvorne datoteke popolne, se iz njih zgradi podatkovna zbirka; in ko je gradnja en ukaz, teče brez posredovanja človeka.
Merodajen je repozitorij. Datoteki ACCDB in ACCDE sta rezultat gradnje in nikoli ne gresta v repozitorij.
Stranke/ Stranke.acproj source/ forms/frmStranke.form.txt queries/ modules/ classes/ reports/ tables/tblDrzave.table.json data/tblDrzave.jsonl references.json application/properties.json build/ zgrajeno, ni v repozitoriju Debug/Stranke.accdb Release/Stranke.accde
- Kaj se je spremenilo?
git logpokaže, kdaj,wkl-office diffpokaže vrstice,wkl-office changespa navede vse razlike med odprto podatkovno zbirko, izvornimi datotekami in zadnjim commitom. - Kdo dela na aplikaciji? Vsak potrdi besedilne izvorne datoteke, git jih združi in spore pokaže za vsako datoteko posebej. Spajanje brez sporov ni vsebinsko preverjeno – rezultat zgradite in združene obrazce preizkusite v programu Access. V zahtevah za spajanje so obrazci, poizvedbe in moduli prikazani kot besedilo.
- Kaj dobijo uporabniki?
wkl-office build -c Releasezgradi ACCDE iz potrjenih izvornih datotek. Iste izvorne datoteke z istim programom Access, istimi sklici in isto kodno stranjo dajo iste objekte, tabele, podatke in nastavitve; datoteka sama pa bajt za bajtom ni enaka. - Samodejno preverljivo.
wkl-office checknajde neveljavne izvorne datoteke, manjkajoče sklice ali gonilnike ODBC, neustrezno 32- ali 64-bitno različico in gesla v izvornih datotekah, še preden se Access zažene.
En razvojni cikel
Access ostane oblikovalnik: SDK upravlja nameščeni program Access in ne nadomešča oblikovanja obrazcev ali poročil.
-
Zgradite delovno podatkovno zbirko
Samo iz izvornih datotek, v
build/Debug/Stranke.accdb.wkl-office build Stranke.acproj -
Spremenite jo v programu Access
Oblikujte obrazec, uredite modul, shranite – kot ste vajeni.
-
Preverite, kaj se je spremenilo
Seznam spremenjenih objektov s predlaganim naslednjim korakom za vsakega, nato spremenjene vrstice enega obrazca.
wkl-office changes Stranke.acprojwkl-office diff Stranke.acproj form:frmStranke
-
Potrdite spremembe
Ukaz še enkrat preveri projekt, spremenjene objekte izvozi v izvorne datoteke in jih potrdi. Na strežnik jih pošlje šele
wkl-office push.wkl-office commit Stranke.acproj -m "Obrazec strank: novo polje za ID za DDV" -
Izdajte
Na vsakem računalniku z enakim programom Access in enakimi sklici nastane ACCDE iz natanko tega commita.
wkl-office build Stranke.acproj -c Release
Spremembe z druge strani – commit sodelavca ali urejanje v Visual Studio Code – prenese v odprto podatkovno zbirko wkl-office sync. Objekt, ki je spremenjen na obeh straneh, se nikoli ne prepiše: izvajanje se ustavi, dokler ne odločite, katera stran velja.
wkl-office test: dva preizkusna postopka, oba uspešna. Preizkušanje aplikacijeDeluje z orodji, ki jih že uporabljate
- V programu Access – isti koraki na zavihku dodatka za Access na traku.
- V Visual Studio Code – izvorne datoteke, ki jih uredite tam, vrne v odprto podatkovno zbirko
wkl-office sync. - V cevovodu za gradnjo –
dotnet buildizvede isto gradnjo prek MSBuild; vsak ukaz vrne določeno izhodno kodo, z--jsonpa objekt JSON. - Z Gitom ali Subversionom – Subversion deluje prek
svn.exe, vendar še ni potrjen v prevzemnem preizkusu.
Stanje in omejitve
Ali SDK ustreza vašemu projektu?
V razvoju
Ustreza, če razvijate v sistemu Windows 11 z 32- ali 64-bitnim programom Microsoft Access iz Microsoft 365 in želite izvorne datoteke voditi v Gitu ali Subversionu. Pred tem preverite naslednje:
- Access 2016 do 2021, Windows 10 ali samo Access Runtime: trenutna izdaja teh okolij ne podpira.
- Gradnja teče v prijavljeni seji Windows s programom Access, ne kot storitev. Za prijavo računa za gradnjo in odprto sejo poskrbi sistem za gradnjo.
- Preverite, česa izvoz ne zajame: delov, ki jih SDK ne obdeluje, ne izvozi. Nov projekt zato enkrat preverite z
wkl-office roundtrip. - Gradi, ne namešča: na računalnike uporabnikov aplikacijo prenese Bootstrapper. Podatkov v produkcijskih podatkovnih zbirkah SDK ne vodi v različicah.
Kje začeti
- Namestitev SDKMapa, ne namestitveni program: Windows 11 s polno različico programa Microsoft Access, izvajalno okolje .NET 10 in git na poti PATH.
- VadnicaOd obstoječe datoteke ACCDB do prvega commita, z resnično podatkovno zbirko.
- NavodilaPotrjevanje iz programa Access, dodatek, delo v Visual Studio Code, gradnja z dotnet build, preizkušanje, prevajanje.
- Referenčni priročnik ukazne vrsticeVsi ukazi, parametri, izhodne kode in polja JSON.
- Odpravljanje težavPogovorno okno v programu Access, neshranjeno delo, roundtrip z razlikami in drugo.
- Struktura in oblike izvornih datotekKje je v izvornih datotekah vsak del aplikacije Access in v kateri obliki.
Vas zanima, kaj SDK obsega in kaj potrebuje vaš razvojni računalnik? Funkcije, zahteve in omejitve so na strani izdelka.
Na stran izdelka