Schema-Export und -Import

Überblick

Ein Schema repräsentiert die Metadaten jeder Entität und jedes Auswahlsatzes und enthält Informationen wie etwa Datentypen für Entitätsfelder oder Beziehungen zwischen Entitätsfeldern.

Durch den Export und das Importieren von Schemata können Sie den Anwendungs-Lebenszyklus bestmöglich managen (Entwicklung, Testen, Bereitstellung) und dabei Funktionen wie das Kopieren von Schemata zwischen Mandanten oder die Nachverfolgung von Schemaänderungen über ein Source Control-Tool Ihrer Wahl nutzen.

Beim Exportieren des Schemas wird eine JSON-Datei mit den Entitätsmetadaten auf Ihre lokale Maschine heruntergeladen. Sie können die Datei freigeben damit verschiedene Entwickler sie in ihre Mandanten importieren können. Sie könne auch selbst Schemata importieren, die von der Community entwickelt wurden.

Berechtigungen

Die folgenden Administratorberechtigungen müssen für Benutzer festgelegt werden, damit sie Schemata importieren und exportieren können:

Betrieb	Berechtigung
Schema exportieren	Schema anzeigen
Schema importieren	Schema anpassen Schema anzeigen

Informationen zum Festlegen der erforderlichen Berechtigungen finden Sie auf der Seite Verwalten des Zugriffs .

Exportieren des Schemas

Hinweis:

• Nur Benutzer mit entsprechenden Berechtigungen können das Schema exportieren.
• Alle im Mandanten vorhandenen Entitäten werden exportiert.
• Vom System erstellte Entitäten und die entsprechenden Systemfelder sind vom Export ausgeschlossen.

So exportieren Sie das aktuelle Schema:

1. Gehen Sie im Data Service zum gewünschten Mandanten.
2. Klicken Sie auf Importieren/Exportieren.
3. Wählen Sie Schema exportieren aus. In einer Popup-Meldung werden Sie aufgefordert, den Export zu bestätigen.
4. Klicken Sie auf Bestätigen, um den Export auszulösen. Eine .JSON-Datei mit dem Schema wird auf Ihre Maschine heruntergeladen.

Importieren des Schemas

Hinweis:

• Nur Benutzer mit entsprechenden Berechtigungen können das Schema importieren.
• Die importierte Schemadatei muss:
  • gültig sein
  • im JSON-Format vorliegen
  • kleiner als 30 MB groß sein
• Die Felder Erstellt von und Geändert von des importierten Schemas werden mit dem Benutzer aufgefüllt, der den Import durchgeführt hat.
• Die Felder für den Erstellungszeitpunkt und den Zeitpunkt der letzten Änderung werden mit dem Zeitstempel des Imports aufgefüllt.
• Nach dem Start kann der Importprozess nicht mehr angehalten werden.

So importieren Sie ein Schema in Ihren Mandanten:

1. Gehen Sie im Data Service zum gewünschten Mandanten.
2. Klicken Sie auf Importieren/Exportieren.

3. Wählen Sie Schema importieren aus. Ein Fenster erscheint, in dem Sie nach der Schemadatei suchen und diese auswählen können.

   Hinweis: Die Schemadatei muss im JSON-Format und gültig sein.
4. Wenn kein Duplikat erkannt wird, werden die Entitäten in den Zielmandanten importiert. Bei Duplikaten wird das Fenster Entitätenimport angezeigt, in dem Sie wählen können, ob doppelte Felder an vorhandene Entitäten angefügt werden sollen oder ob die Duplikate nicht importiert werden sollen.

Bearbeiten von Duplikaten

Beim Importieren eines Schemas werden die vorhandenen Entitäten, Felder bzw. Auswahlsätze im Mandanten mit denen im importierten Schema verglichen.

Zu jedem erkannten Duplikat im importierten Schema werden die folgenden Optionen angezeigt:

Anhängen an vorhandene (Standardoption)

• Entitätsfelder und Auswahlsätze, die im Zielmandanten nicht vorhanden sind, werden importiert.
• Entitäten, die Felder und Auswahlsätze mit unterschiedlichen Eigenschaften (z. B. Name oder Datentyp) enthalten, werden beim Importieren übersprungen.

Nicht importieren

• Die Entität wird nicht in den Zielmandanten importiert.