- Erste Schritte
- Lizenzierung
- Einstellung und Konfiguration (Setup and Configuration)
- Verwenden des Dienstes
- Entitätstypen
- Erstellen einer Entität
- Entitäten in VS-Code
- Anpassen einer Entität
- Verwalten der Daten für eine Entität
- Erstellen von Beziehungen
- Auswahlsätze
- Systembenutzerentität
- Schema-Export und -Import
- Erweiterte Suche in Entitätsdaten
- Abfragelimits für externe Daten
- Best Practices für Entitätsmodellierung und Abfragen
- Entitäten in Lösungen
- Bekannte Einschränkungen
- Referenz (Reference)
- Beispiele und Tutorials
- Protokollierung
Schema-Export und -Import
Exportieren und Importieren von Entitäts- und Auswahlsatzschemata in Data Fabric/Data Service zur Unterstützung des Anwendungslebenszyklusmanagements über Entwicklung, Tests und Produktion hinweg.
Ü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 das Exportieren und Importieren von Schemas können Sie die Best Practices eines Anwendungslebenszyklusmanagements – Entwicklung, Tests, Bereitstellung – implementieren und dabei Funktionen wie das Kopieren von Schemas zwischen Mandanten und Ordnern oder das Nachverfolgen von Schemaänderungen über ein Source Control-Tool Ihrer Wahl berücksichtigen.
Beim Exportieren des Schemas wird eine JSON-Datei heruntergeladen, die die Entitätsmetadaten auf Ihre lokale Maschine enthält. Sie können die Datei freigeben, die von verschiedenen Entwicklern in deren Mandanten oder Ordner importiert werden soll, und Sie können selbst von der Community entwickelte Schemas importieren.
Klonen von Entitäten über Scopes hinweg
Sie können exportieren und importieren verwenden, um ein natives Entitätsschema von einem Scope in einen anderen zu klonen. Exportieren Sie beispielsweise eine Entität auf Mandantenebene und importieren Sie sie in einen Ordner, um eine Ordner-Scope-Kopie mit demselben Schema zu erstellen. Nur das Schema wird geklont – es werden keine Daten kopiert. Die importierte Entität ist unabhängig vom Original und kann separat geändert werden.
Dies ist nützlich, wenn Sie ein vorhandenes Entitätsdesign in einem Ordner für die Verwendung mit Lösungen wiederverwenden möchten, ohne das Schema manuell neu zu erstellen.
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
- Nur Benutzer mit entsprechenden Berechtigungen können das Schema exportieren.
- Alle nativen Entitäten, die im Mandanten vorhanden sind, werden exportiert.
- Vom System erstellte Entitäten und die entsprechenden Systemfelder sind vom Export ausgeschlossen.
So exportieren Sie das Schema:
- Navigieren Sie zum gewünschten Mandanten in Data Fabric/Data Service.
- Wählen Sie Importieren/Exportieren aus.
- Wählen Sie Schema exportieren aus. In einer Popup-Meldung werden Sie aufgefordert, den Export zu bestätigen.
- Wählen Sie Bestätigen aus , um den Export auszulösen. Eine
.JSON-Datei mit dem Schema wird auf Ihre Maschine heruntergeladen.
Importieren des Schemas
- 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:
- Navigieren Sie zum gewünschten Mandanten oder Ordner in Data Fabric/Data Service.
- Wählen Sie Importieren/Exportieren aus.
- Wählen Sie Schema importieren aus.
- Wählen Sie den Zielspeicherort (Mandant oder Ordner) für den Import aus.
- Suchen Sie nach der Schemadatei und wählen Sie sie aus.
Hinweis:
Die Schemadatei muss im JSON-Format vorliegen und gültig sein. Wenn Sie Schemadateien über Codierungsagenten generieren, stellen Sie sicher, dass die Feldtypen mit den erwarteten Data Fabric-Typen übereinstimmen, da falsche Typen zu unerwartetem Verhalten führen können.
- Wählen Sie die Entitäten und Auswahlsätze aus, die Sie importieren möchten.
- Wenn kein Duplikat erkannt wird, werden die ausgewählten Entitäten in das ausgewählte Ziel importiert. Bei Duplikaten wird das Fenster Entitätenimport angezeigt, in dem Sie entweder doppelte Felder an vorhandene Entitäten anhängen oder die Duplikate nicht importieren können.
Bearbeiten von Duplikaten
Beim Importieren eines Schemas werden die vorhandenen Entitäten, Felder oder Auswahlsätze am ausgewählten Ziel 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 am ausgewählten Ziel 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 das ausgewählte Ziel importiert.