So legen Sie fest, welche Dateien wohin kommen

Die Seite Dateien ist die Packliste der Auslieferung. Jede Zeile sagt dem Starter, welche Datei oder welchen Ordner er aus dem Lieferordner nimmt und wohin er sie auf dem Rechner des Benutzers legt. Was hier nicht steht, kommt beim Benutzer nicht an, auch wenn es im Lieferordner liegt.

Das Beispiel dieser Seite ist die Kasse aus dem Tutorial: Im Lieferordner C:\Lieferung\Kasse\deploy liegen Kasse.accde, der Ordner bin mit zwei DLLs und der Ordner Berichte mit einer Berichtsvorlage.

Voraussetzungen

Im Feld Quelle auf der Seite Allgemein steht der Lieferordner. Die Befehle dieser Seite öffnen ihn und nehmen nur auf, was darin liegt.

Dateien und Ordner aufnehmen

Vorgehen:

Wählen Sie in der Navigation Installation > Dateien.
Wählen Sie Dateien hinzufügen und im Dialogfeld eine oder mehrere Dateien, im Beispiel Kasse.accde. Für einen ganzen Ordner wählen Sie Ordner hinzufügen, im Beispiel nacheinander bin und Berichte. Beide Dialogfelder öffnen den Lieferordner.
Alternativ ziehen Sie Dateien und Ordner aus dem Explorer auf die Liste.

Ergebnis: Jede gewählte Datei und jeder Ordner steht einmal in der Liste. Der Bootstrapper Manager trägt die Quelle relativ zum Lieferordner ein und als Ziel denselben Unterordner unter [VersionDir], dem Ordner der installierten Version; so behält die Version beim Benutzer die Ordnerstruktur der Lieferung:

Quelle	Ziel	Aktion
`Kasse.accde`	`[VersionDir]`	`copy`
`bin`	`[VersionDir]\bin`	`copy`
`Berichte`	`[VersionDir]\Berichte`	`copy`

Kontrolle: Der Zielbaum links zeigt unter [VersionDir] die Unterordner bin und Berichte. Hat der Bootstrapper Manager etwas nicht aufgenommen, nennt eine Meldung den Grund: Der Pfad liegt außerhalb des Lieferordners (der Starter nimmt nur, was in der Lieferung liegt), oder für die Quelle gibt es schon einen Eintrag.

Ziel eines Eintrags ändern

Nicht alles gehört in den Ordner der Version. Diesen Ordner legt der Starter für jede Version neu an und entfernt alte Versionen nach und nach. Dateien, die der Benutzer selbst öffnet oder behalten soll, gehören in einen festen Ordner, im Beispiel die Berichtsvorlagen in die Dokumente des Benutzers.

Vorgehen:

Klicken Sie in der Zeile Berichte in die Spalte Ziel.
Tragen Sie [Documents]\Kassensystem\Berichte ein.

Alternativ ziehen Sie Dateien aus dem Explorer direkt auf einen Ordner des Zielbaums: Sie erhalten dann genau diesen Ordner als Ziel, ein gezogener Ordner wird dort als gleichnamiger Unterordner eingetragen.

Ergebnis:

$Zielbaum und Liste der Seite Dateien: links der Zielbaum mit den Zielordnern des Starters, darin bin unter dem Versionsordner [VersionDir] und Kassensystem\Berichte unter Dokumente [Documents]; rechts die Liste mit Kasse.accde nach [VersionDir], dem Ordner bin nach [VersionDir]\bin und dem Ordner Berichte nach [Documents]\Kassensystem\Berichte, jeweils mit der Aktion copy$

Kontrolle: Der Zielbaum zeigt Kassensystem\Berichte unter Dokumente [Documents]. Wohin jede Datei auf Ihrem Rechner käme, zeigt der Probelauf mit vollständigen Pfaden; siehe So testen Sie ein Projekt vorab und erstellen das MSI-Paket.

Technische Einzelheiten

Spalten und Mitglieder der Projektdatei. Die Bedeutung jeder Spalte, Muster wie bin\*.dll, die Aktionen registerCom und registerNetCom sowie [Dir:<Kennung>] und [ItemVersion] legt der Starter fest; sie beschreibt Die Projektdatei (Format 2), Abschnitt Dateien (Dokumentation von WKL Bootstrapper).

Spalte	In der Projektdatei	Vorschlag beim Hinzufügen
Kennung	`id`	leer
Quelle	`source`	Pfad relativ zum Lieferordner
Ziel	`target`	derselbe Unterordner unter `[VersionDir]`
Aktion	`action`	`copy`
Bitbreite	`bitness`	leer (für beide Bitbreiten)
Version aus	`versionFrom`	leer

Bitbreite eines Eintrags. Ein Eintrag mit x86 oder x64 wird nur eingerichtet, wenn diese Bitbreite gilt; welche gilt, legt das Feld Bitbreite der Seite Allgemein fest (Vorgabe: die des installierten Access, siehe So stellen Sie Produkt, Version, Darstellung und Startziel ein). So liegen etwa components\x86 und components\x64 in derselben Lieferung, und jeder Benutzer erhält die passenden Komponenten.

Zielordner. Der Baum zeigt die Zielordner des Starters und darunter jeden Unterordner, den die Einträge nennen. Auf dem Rechner des Benutzers ersetzt der Starter die Platzhalter durch diese Ordner:

Platzhalter	Ordner beim Benutzer (Vorgaben des Starters)
`[VersionDir]`	`%LOCALAPPDATA%\WKL\<Produkt>\Frontends\<Fassung>`
`[AppDir]`	`%LOCALAPPDATA%\WKL\<Produkt>`
`[LocalAppData]`, `[AppData]`	lokale und servergespeicherte Anwendungsdaten des Benutzers
`[Documents]`, `[Desktop]`	Dokumente und Desktop des Benutzers
`[Programs]`, `[Startup]`	Startmenü und Autostart des Benutzers

Ein Klick auf einen Ordner zeigt nur seine Einträge und die darunter. Der Baum ist eine Ansicht der Einträge: Er wird für jedes Projekt neu aufgebaut und nie in die Projektdatei geschrieben.

Teile ohne Spalte. Teile eines Eintrags ohne eigene Spalte (etwa keep) bleiben beim Speichern erhalten, wie sie gelesen wurden.

COM-Server (registerCom) brauchen eine registration.json neben sich; das Release-Paket der WKL Access Components bringt sie ab Version 1.57 mit. Einzelheiten: Die Projektdatei (Format 2), Abschnitt COM-Server (Dokumentation von WKL Bootstrapper).

So legen Sie fest, welche Dateien wohin kommen

Voraussetzungen

Dateien und Ordner aufnehmen

Ziel eines Eintrags ändern

Technische Einzelheiten

Verwandte Themen