Die v2-Apps waren eine erste experimentelle Funktion, um die KI-basierte Anwendungsentwicklung in Simplifier zu ermöglichen. Mit unserer Integration von Anna in Simplifier wird die KI-basierte Entwicklung viel einfacher. Externe KI-Entwicklung ist weiterhin möglich, wurde aber angepasst, um Anna auch die Arbeit mit den Ergebnissen der externen Entwicklung zu ermöglichen.
Du migrierst eine Anwendung in sechs Schritten:
- Vor dem Upgrade: Aktualisiere deinen lokalen Klon der v2-App und lösche sie in Simplifier
- Nach dem Upgrade: Erstelle eine KI-App
- bearbeite eine Datei in deinem lokalen Klon der v2-App
- Push,
- überprüfe,
- deploye.
Vorbereitungen vor dem Upgrade auf MAKERS CHOICE 26-09
Bevor du mit dem Upgrade deiner Instanz beginnst
- Aktualisiere deinen lokalen Klon deiner v2-Apps und stelle sicher, dass es die neueste Version ist.
- Notiere dir den technischen Namen, die Rollenzuweisungen, das Projekt und die Transportpakete jeder v2-App – nichts davon wird übernommen.
Danach lösche deine v2-Apps in Simplifier, damit die Anwendungsnamen für die migrierten Anwendungen verfügbar sind.
Jetzt bist du bereit, deine Instanz auf MAKERS CHOICE 26-09 zu aktualisieren.
Vorbereitungen nach dem Upgrade auf MAKERS CHOICE 26-09
1. Erstelle die KI-App
In der Admin-Oberfläche: Anwendungen → Erstellen → App Editor Version: KI-App.
Oder über REST. Verwende die Basisauthentifizierung mit deinem Simplifier-Benutzer als Header-Parameter. Der Aufruf antwortet, sobald das Repository existiert:
POST https://<Host>/UserInterface/api/application
{"category": "Application", "name": "", "displayName": "", "description": "",
"appEditorVersion": "aiApp", "defaultLanguageCode": "en_US",
"systemLib": {"name": "", "version": ""}, "assignedProjects": {}}
2. Korrigiere die API-Basis-URL in webapp/modules/AppSettings.ts
In deinem v2-Klon leitet diese Datei die API-Basis-URL vom Seitenpfad ab und kennt ‘/ai/app/‘ nicht. Ohne diese Bearbeitung geht jeder Backend-Aufruf aus der Live-Vorschau an ‘/UserInterface/‘ und schlägt mit 404 fehl. Ersetze die Zuweisung von ‘apiBaseUrl‘ durch:
export const apiBaseUrl: string = _injected?.apiBaseUrl
?? (_inBtpLaunchpad
? _launchpadApiBaseUrl()
: (window.location.pathname.startsWith("/appDirect/")
|| window.location.pathname.startsWith("/ai/app/"))
? "/"
: "/UserInterface/");
Committe die Änderung.
3. Pushe deinen v2-Klon in die KI-App
Im Verzeichnis des Klons:
git remote set-url origin https://<Host>/ai/app/git/<AiAppName> git Push --force origin master git pull
- ‘–force‘ ist erforderlich, da die KI-App mit ihrem eigenen initialen Commit beginnt.
- ‘git pull‘ holt den Commit, den der AppServer während des Pushs macht (seine Einträge in ‘.gitignore‘, seinen Block in ‘webapp/index.html‘).
Dein v2-Klon ist jetzt deine Arbeitskopie der KI-App; benenne den lokalen Ordner um, wenn du möchtest. Die Quellen können den v2-Namespace (‘sap.app.id‘, ‘<title>‘) beibehalten. Nur wenn du keinen Klon mehr hast: ‘git clone https://<host>/ai/app/git/<AiAppName>‘.
Alle anderen v2-Dateien bleiben erhalten, einschließlich ‘.env‘ und der Tooling-Konfigurationen. Die App behält auch ihre v2-Struktur: Backend-Aufrufe erfolgen über ‘webapp/modules/*‘ und ‘BaseController‘, während eine native KI-App ‘webapp/util/*‘ verwendet. Beide funktionieren nebeneinander, aber Annas Anweisungen beschreiben die nativen Helfer, sodass sie möglicherweise ‘webapp/util/‘-Dateien neben den vorhandenen modules/-Dateien hinzufügt.
Wenn der Push abgelehnt wird
| Nachricht | Was zu tun ist |
|---|---|
| Updates wurden abgelehnt, weil der Tip deines aktuellen Branches zurückliegt | ‘git pull‘, dann erneut pushen. |
| Arbeitsverzeichnis hat ungestagte Änderungen | Die App wird bearbeitet (eine Anna-Runde läuft). Warte, dann pushe erneut. |
| Arbeitsbaum konnte nicht auf neuen HEAD aktualisiert werden | Eine nicht verfolgte Datei auf dem Server ist im Weg (in älteren KI-Apps typischerweise ‘pnpm-lock.yaml‘). Erstelle eine neue KI-App und pushe dorthin. |
4. Überprüfe die Anwendung
Erstelle die noch fehlenden Daten neu:
- Projektzuweisungen: Weise die KI-App ihrem Projekt zu
- Berechtigungen und Rollenzuweisungen: Erstelle/weise die für die Anwendung erforderlichen Rollen und Berechtigungen neu zu
- Transportpakete: Füge die KI-App den erforderlichen Paketen hinzu. Passe dein neues App-Transportpaket an, falls du zuvor zusätzliche Artefakte zugewiesen hast
- Browser-Tab-Titel: Der ‘<title>‘ in ‘webapp/index.html‘ lautet immer noch ‘UI5 Application: <namespace>‘. Ändere ihn in den tatsächlichen Titel der App.
- ‘README.md‘: Beschreibt immer noch den v2-Workflow. Schreibe ihn neu oder ersetze ihn durch die ‘README.md‘ einer neuen KI-App
- ‘dependencies.json‘: Wird nicht mehr verwendet – eine KI-App leitet ihre Abhängigkeiten aus den Quellen ab. Lösche sie
Überprüfe nun, ob die Live-Vorschau gerendert wird und ob der Login der App funktioniert.
5. Deploye die Anwendung
Deploye die Anwendung im Anwendungseditor.
Oder deploye über REST. Im Gegensatz zum Aufruf in Schritt 1 akzeptiert dieser keine Basisauthentifizierung – hole zuerst ein Token und sende es als SimplifierToken-Header:
POST https:///genToken/
{"user": "", "pass": ""}
antwortet ‘{“result”: “”, “success”: true}‘. Dann:
POST https:///ai/app//deploy
SimplifierToken:
{"deployToBtp": false}
Der Aufruf erstellt die App, bevor er antwortet, was etwa eine Minute dauert.
- ‘deployToBtp: true‘ kopiert den Build auch in das BTP-Deployment-Verzeichnis der App, falls eines konfiguriert ist.
- Ein fehlgeschlagener Build antwortet immer noch ‘200‘, wobei ‘message‘ ‘deploy failed: <reason>‘ anstelle von ‘deploy completed‘ lautet – überprüfe die Nachricht, nicht den Statuscode.
