Vom bisherigen Starter umsteigen

Eine Auslieferung wird noch vom bisherigen Starter (StarterPro) mit seiner StarterPro.config.xml gestartet und soll zu diesem Starter wechseln, ohne dass die Konfiguration neu eingegeben werden muss.

Der Befehl /import-starterpro liest die bisherige Konfiguration und schreibt eine Projektdatei im Format 2 (bootstrapper.json). Er listet je Zeile auf, was er nicht übernommen hat und was Nacharbeit braucht. Die Projektdatei wird danach mit /check geprüft und bei Bedarf im Bootstrapper Manager (siehe dessen „Benutzerhandbuch WKL Bootstrapper Manager“) oder in einem Texteditor fertiggestellt.

1. Kopieren Sie Wkl.Bootstrapper.exe in den Ordner der bisherigen Konfiguration, oder nennen Sie die Konfiguration mit ihrem Pfad.

2. Wandeln Sie sie um:

   Wkl.Bootstrapper.exe /import-starterpro "\\server\amed\deploy\StarterPro.config.xml"

   Das Projekt landet in bootstrapper.json neben der Konfiguration; /out <file> nennt eine andere Datei. Eine vorhandene Datei wird nie überschrieben: Der Befehl endet dann mit Code 11.

3. Arbeiten Sie die aufgelisteten Zeilen ab (siehe Hinweise), und prüfen Sie dann das Ergebnis:

   Wkl.Bootstrapper.exe /check "\\server\amed\deploy\bootstrapper.json"

4. Liefern Sie den Starter mit der neuen Projektdatei aus, wie unter Anwendung mit dem Bootstrapper ausliefern beschrieben.

• Nicht übernommen: die SQL-Verbindung (SRV, CURUSR, CATALOG) und das Kennwort, das der bisherige Starter Base64-codiert und damit für jeden lesbar ablegte. Die Zeilen nennen sie, nie ihre Werte. Eine Anwendung verwaltet ihre Verbindung selbst, zum Beispiel mit WKL Linked Tables Manager.
• INI-Werte, deren Schlüssel wie ein Geheimnis aussieht (pass, pwd, kennwort, secret, token, Endung key), werden aus demselben Grund ausgelassen; der Starter lehnt sie in einem Projekt ab.
• CLIENTPATH wird nicht verwendet: Jede Version kommt in einen eigenen Ordner im Benutzerprofil, sodass eine neue Version nie die laufende überschreibt.
• Eine Datei außerhalb von SERVERPATH wird ausgelassen: Jede Datei muss aus der Auslieferung stammen.
• Eine registrierte Datei (registerCom, registerNetCom) braucht ihre registration.json daneben in der Auslieferung; sie wird mit tools\Export-ComRegistration.ps1 auf dem Computer des Herausgebers geschrieben.
• Das Logo wird über seinen Dateinamen genannt: Kopieren Sie es neben den Starter.
• Der Produktschlüssel wird aus dem Firmennamen gebildet (nach den Regeln für product: aus č wird c, aus ä wird a; andere unzulässige Zeichen, Punkte und Bindestriche am Anfang sowie Punkte am Ende entfallen; Application, wenn kein gültiger Schlüssel entsteht). Er benennt den Eintrag unter „Apps“ und den Ordner des Benutzers; legen Sie ihn vor der ersten Auslieferung fest und behalten Sie ihn bei.
• Eine Firmenversion, die keine Version aus zwei bis vier Zahlen ist, wird zu 1.0.0 und aufgelistet.

• Die Projektdatei (Format 2) – jedes Element der Projektdatei.
• Der Installer des Bootstrappers 2.0 – /import-starterpro, /check und die übrigen Befehle.
• Signierte Auslieferung veröffentlichen – die Auslieferungen der umgestellten Anwendung signieren.