Störungen und ihre Behebung

Diese Seite nennt Meldungen und Fehlbilder des Bootstrapper Managers mit Ursache und Abhilfe. Sie gilt für Wkl.Bootstrapper.Manager.accdb in Access aus Microsoft 365. Die Meldungen stehen hier im Wortlaut des Bootstrapper Managers; Meldungen des Starters (englisch) erscheinen auf der Seite Probleme oder in der Meldung des Befehls.

Die Seiten bleiben leer, oder Access meldet, dass Inhalte deaktiviert sind

Ursache: Der Ordner von Wkl.Bootstrapper.Manager.accdb ist kein vertrauenswürdiger Speicherort; Access führt den Code der Seiten nicht aus.

Abhilfe: Tragen Sie den Ordner als vertrauenswürdigen Speicherort ein, siehe So richten Sie den Bootstrapper Manager ein und starten ihn, Schritt 2. Öffnen Sie den Bootstrapper Manager danach neu.

"Der Starter wurde nicht gefunden (Einstellung StarterPath oder Wkl.Bootstrapper.exe bzw. Wkl.Access.Bootstrapper.exe neben der Projektdatei)."

Ursache: Am Ort, an dem der Bootstrapper Manager sucht, liegt kein Starter: Es gibt kein starter= beim Start, keine Einstellung StarterPath und keine Wkl.Bootstrapper.exe im Ordner der Projektdatei – oder starter= bzw. StarterPath nennt eine Datei, die es nicht gibt; dann sucht der Bootstrapper Manager nicht weiter. Die Meldung erscheint bei Prüfen (als Zeile auf Probleme), Neu, Übernehmen, Importieren, Vorschau, Probelauf und MSI erstellen.

Abhilfe: Legen Sie den Starter neben die Projektdatei; dort liegt er auch in der Auslieferung. Oder setzen Sie StarterPath auf einen gültigen Pfad, siehe So richten Sie den Bootstrapper Manager ein und starten ihn, Schritt 3. Bearbeiten und Speichern gehen auch ohne Starter.

"… ist keine Projektdatei im Format 2 (Format 1). Der Bootstrapper Manager liest nur Format 2."

Ursache: Sie haben mit Öffnen eine Projektdatei im Format 1 gewählt.

Abhilfe: Schreiben Sie die Datei auf Format 2 um, siehe Die Projektdatei (Format 2), Abschnitt Format 1 (Dokumentation von WKL Bootstrapper). Eine Konfiguration des früheren Starters (StarterPro.config.xml) übernehmen Sie dagegen direkt mit Übernehmen.

Öffnen meldet den Pfad der Datei und eine Ursache des JSON-Lesers

Ursache: Die Datei ist kein gültiges JSON, meist nach einer Bearbeitung von Hand (fehlendes Komma, Anführungszeichen, ein einzelner Backslash in einem Pfad statt \).

Abhilfe: Korrigieren Sie die genannte Stelle in einem Editor, und öffnen Sie die Datei erneut.

"… ist bereits vorhanden. Wählen Sie einen anderen Namen." (Übernehmen)

Ursache: Am gewählten Ort liegt schon eine Datei dieses Namens. Übernehmen ersetzt keine vorhandene Projektdatei.

Abhilfe: Wählen Sie Übernehmen erneut, und geben Sie einen anderen Namen oder Ordner an.

"Die Projektdatei wurde nicht angelegt." (Neu) oder "Die Konfiguration wurde nicht übernommen." (Übernehmen)

Ursache: Der Starter hat abgelehnt; der Rest der Meldung ist seine Begründung, etwa eine unbekannte Vorlage oder ein Ordner ohne Schreibrecht. Beim Ersetzen einer vorhandenen Datei steht die vorige wieder an ihrem Platz.

Abhilfe: Beheben Sie die in der Meldung genannte Ursache, etwa indem Sie einen anderen Ordner wählen.

"Das Paket wurde nicht erstellt." (MSI erstellen)

Ursache: Das Skript New-StarterMsi.ps1 ist gescheitert; unter der Meldung steht seine Ausgabe. Häufig ist wix nicht installiert oder älter als Version 6, oder die Version ist ungültig.

Abhilfe: Installieren Sie WiX (dotnet tool install --global wix), und geben Sie eine Version aus zwei oder drei Zahlen an. Fehlt das Skript selbst, meldet der Bootstrapper Manager „tools\New-StarterMsi.ps1 wurde nicht gefunden (Einstellung MsiTool oder neben dem Starter).“ – das Skript liegt im Ordner tools des Release-Pakets des Starters.

"Der Starter hat keine Vorschau gezeichnet." oder "Der Starter hat kein Ergebnis geliefert."

Ursache: Der Starter wurde beendet, ohne ein Ergebnis zu schreiben – etwa weil eine ältere Version /preview bzw. /whatif nicht kennt oder eine Sicherheitssoftware ihn blockiert hat.

Abhilfe: Verwenden Sie den Starter aus dem aktuellen Release von WKL Bootstrapper, und wiederholen Sie den Befehl. Um die Ursache zu sehen, rufen Sie den Starter in einer Eingabeaufforderung mit demselben Befehl auf (Wkl.Bootstrapper.exe /whatif <Projektdatei>).

Ein Problem auf der Seite Probleme führt zu keiner Stelle oder zu keiner Markierung

Ursache: Der Bootstrapper Manager erkennt den Wortlaut dieses Problems nicht, etwa weil es kein Feld betrifft („Der Starter wurde nicht gefunden …“) oder weil eine neuere Version des Starters es anders formuliert. Nennt das Problem keinen bekannten Teil der Projektdatei, ist Zur Seite nicht verfügbar; sonst öffnet der Befehl die Seite, ohne eine Stelle zu markieren.

Abhilfe: Beheben Sie das Problem nach seinem Text; er nennt am Anfang den Teil der Projektdatei.

Nach dem Öffnen fehlen Änderungen, die im Bootstrapper Manager vorgenommen wurden

Ursache: Eine Projektdatei, die schon in der Liste stand, wurde neu gelesen; bei der Rückfrage „Die Datei neu lesen und die Änderungen verwerfen?“ wurde Ja gewählt. Ohne diese Rückfrage liest der Bootstrapper Manager ein Projekt nur neu, wenn es keine ungespeicherten Änderungen hat.

Abhilfe: Verworfene Änderungen lassen sich nicht wiederherstellen; die Datei enthält den zuletzt gespeicherten Stand.

Nach der Installation mit dem MSI-Paket startet die Anwendung nicht (Code 12)

Ursache: Im Feld Quelle steht ein relativer Pfad wie deploy. Der Starter rechnet ihn ab seinem eigenen Ordner, nach der Installation also ab C:\Program Files (x86)\WKL\<Produkt>, wo es keinen Lieferordner gibt. Sein Fenster zeigt den Code 12, die Diagnosedetails den Text The source C:\Program Files (x86)\WKL\Kasse\deploy is not reachable. Probelauf und Prüfen im Bootstrapper Manager zeigen das nicht, weil der Starter dort neben der Projektdatei liegt und der relative Pfad passt.

Abhilfe: Tragen Sie im Feld Quelle einen vollständigen Pfad oder eine Freigabe ein, speichern Sie, und erstellen Sie ein neues MSI-Paket mit höherer Paketversion. Weitere Ursachen des Codes 12 beschreibt Der Ordner mit der Anwendung ist nicht erreichbar (Code 12) (Dokumentation von WKL Bootstrapper).

Bei Benutzern mit 64-Bit-Office startet die Anwendung nicht

Ursache: Die Datei der Anwendung ist in 32-Bit-Access gebaut. Eine ACCDE und eine kompilierte ACCDB laufen nur in der Bitbreite, in der sie gebaut sind. Der Starter bricht dann mit Code 21 ab, oder Access meldet beim Öffnen „Funktion nicht gefunden“.

Abhilfe: Bauen Sie die Lieferung mit dem WKL Office SDK und "bitness": "any" als ACCDB für beide Bitbreiten; siehe delivery-settings.json (Dokumentation des WKL Office SDK). Soll es eine ACCDE bleiben, liefern Sie für diese Benutzer eine in 64-Bit-Access gebaute Version aus einem eigenen Lieferordner mit eigenem Starter aus; siehe Für 32-Bit- und 64-Bit-Office installieren, Abschnitt Umsetzung, und Die Version der Anwendung passt nicht zum installierten Access (32 oder 64 Bit) (Code 21) (Dokumentation von WKL Bootstrapper). Prüfen Sie die Lieferung auf einem Rechner mit 64-Bit-Office, wie unter So testen Sie ein Projekt vorab und erstellen das MSI-Paket beschrieben.

Die Liste der Projekte ist nach dem Austausch des Bootstrapper Managers leer

Ursache: Die Liste steht in Wkl.Bootstrapper.Manager.accdb; eine neue Version der Datei beginnt leer.

Abhilfe: Nehmen Sie die Projektdateien mit Öffnen wieder auf. Ungespeicherte Änderungen der alten Version stehen nur in der alten Datei; speichern Sie dort, bevor Sie wechseln.