Eine Lösung exportieren

Ziel

Eine Lösung aus der Umgebung, in der Sie sie gebaut haben, als portables, versioniertes Paket exportieren, das in eine andere Umgebung importiert werden kann.

Voraussetzungen

• Sie sind als Plattformadministrator oder Ersteller beim Admin Control Center angemeldet.
• Eine Lösung existiert und enthält die Komponenten, die Sie übertragen möchten (Entitäten, Formulare, Ansichten und Server-Plug-in-Schritte). Siehe Eine Lösung erstellen und Einer Lösung eine Komponente hinzufügen.
• Sie wissen, welche Quellumgebung die gebauten Komponenten enthält – der Export liest die tatsächlichen Komponentendefinitionen aus dieser Umgebung.

Schritte

1. Wählen Sie oben im Admin Control Center die Quellumgebung aus – die Umgebung, in der die Komponenten der Lösung gebaut wurden (zum Beispiel Entwicklung). Der Export liest die tatsächlichen Komponentendefinitionen aus dieser Umgebung.
2. Öffnen Sie die Seite Lösungen über die obere Navigation.
3. Wählen Sie die Lösung aus, die Sie exportieren möchten.
4. Wählen Sie Exportieren aus.
5. Die Plattform erzeugt eine Paketdatei, die die Lösung beschreibt: ihren Herausgeber, ihre Version, die Liste der Komponenten und die vollständige Definition jeder Komponente.
6. Speichern Sie das Paket. Genau diese Datei importieren Sie in eine andere Umgebung (siehe Eine Lösung in eine Umgebung importieren).

Eine Änderung ausliefern: zuerst die Version erhöhen

Wenn Sie eine Lösung ändern, die schon in Test oder Produktion ist, erhöhen Sie ihre Version, bevor Sie sie erneut exportieren:

1. Öffnen Sie die Lösung.
2. Wählen Sie Version festlegen, geben Sie die neue Version ein, etwa 1.1.0, und wählen Sie Speichern.
3. Wählen Sie Exportieren. Die Datei trägt die neue Version im Namen.

Eine Version besteht aus zwei bis vier durch Punkte getrennten Zahlen. Wird die Datei dort importiert, wo eine frühere Version installiert ist, ist das ein Upgrade (siehe „Eine Lösung in eine Umgebung importieren“). Nur eine Lösung, in der Sie bauen, hat Version festlegen: Die Version einer verwalteten Lösung ist die, mit der sie importiert wurde.

Was im Hintergrund passiert

Der Export liest jede modellgesteuerte Komponente der Lösung aus der Quellumgebung und bettet ihre vollständige Definition in das Paket ein, nicht nur einen Verweis. Weil die Definitionen im Paket mitreisen, werden beim Import in eine andere Umgebung dort die echten Entitäten, Formulare, Ansichten und Regeln neu angelegt – die Zielumgebung braucht keinen Zugriff auf die Daten der Quellumgebung.

Fehlerbehebung

• „Lösung nicht gefunden.“ – Die Lösung existiert in Ihrem Mandanten nicht; aktualisieren Sie die Liste der Lösungen.
• Der Export schlägt mit Verweis auf die Quellumgebung fehl – Die gewählte Quellumgebung konnte die Komponentendefinitionen nicht liefern. Vergewissern Sie sich vor dem Export, dass die Komponenten tatsächlich in dieser Umgebung gebaut wurden.

Verwandte Szenarien

• Eine Lösung erstellen.
• Einer Lösung eine Komponente hinzufügen.
• Eine Lösung in eine Umgebung importieren.
• Startdaten mit einer Lösung ausliefern – damit auch die Zeilen einer Tabelle im Paket mitreisen.