Anhand von Vorlagen können Sie Anwendungs- oder Dimensionskonfigurationen in einer Offlinedatei speichern, um sie in anderen Oracle Enterprise Data Management Cloud-Umgebungen zu verwenden. Verwenden Sie Vorlagen, um Anwendungen oder Dimensionen und ihre Metadatenobjekte umgebungsübergreifend zu übertragen (beispielsweise aus einer Testumgebung in eine Produktionsumgebung) oder um einen schnellen Einstieg in neue Implementierungen zu ermöglichen.
Um eine Vorlage verwenden zu können, exportieren Sie zunächst eine Anwendung oder eine Dimension und alle zugehörigen Metadatenobjekte in der Quellumgebung in eine .json-Datei. Importieren Sie diese Vorlage anschließend in die Zielumgebung.
Vorlagen enthalten ausschließlich Metadaten und keine Daten, Anforderungen oder Transaktionshistorien.
Best Practice
Wenn Sie eine Anwendung in einer Testumgebung erstellen und vorhaben, diese in eine vorhandene Produktionsumgebung zu übertragen, ist es ein bewährtes Verfahren, die Testumgebung zunächst mit einem aktuellen Snapshot Ihrer Produktionsumgebung zu aktualisieren und dann die zu übertragende Anwendung zu erstellen. So wird sichergestellt, dass globale Objekte wie Eigenschaften und Ansichten in beiden Umgebungen dieselben IDs aufweisen.
Caution:
Vorlagen sind für die Migration von Änderungen von einer Umgebung zu einer anderen bestimmt. Daher ist es wichtig, ein Quellsystem zu bestimmen, in dem alle Änderungen vorgenommen werden, sowie ein Zielsystem, zu dem die Änderungen migriert werden. Nehmen Sie die Änderungen nicht in beiden Umgebungen vor. Mit Migrations-Snapshots können Sie die Umgebungen bei Bedarf erneut synchronisieren. Informationen hierzu finden Sie unter
Best Practices im Abschnitt
Beispiele für Migrationsszenarios.
Wichtige Aspekte
- Sie müssen Serviceadministrator sein oder über die Anwendungsrolle Migrationen - Verwalten verfügen (siehe Erläuterungen zu Anwendungsrollen und Berechtigungen), um Anwendungen und Dimensionen in Vorlagen zu importieren und zu exportieren.
- Wenn eine Anwendung in die Zielumgebung übertragen wird, gilt Folgendes:
- Wenn der Anwendungseigentümer aus der Quellumgebung auch in der Zielumgebung vorhanden ist, wird er in der Zielumgebung als Anwendungseigentümer beibehalten.
- Wenn der Anwendungseigentümer aus der Quellumgebung in der Zielumgebung nicht vorhanden ist, muss ein Serviceadministrator der Anwendung in der Zielumgebung einen Eigentümer zuweisen.
- Sie können neue Anwendungen oder Dimensionen aus der Quell- in die Zielumgebung übertragen, oder Sie können Anwendungen oder Dimensionen übertragen, die bereits in der Zielumgebung vorhanden sind. Der Vorlagenimportprozess aktualisiert vorhandene Anwendungen oder Dimensionen in der Zielumgebung, indem Objekte erstellt werden, die nicht bereits vorhanden sind, und vorhandene Objekte für die Zielanwendung oder -dimension geändert werden. Informationen hierzu finden Sie unter Vorhandene Anwendungen oder Dimensionen mit Vorlagen aktualisieren.
- Sie können nur aktive Anwendungen übertragen.
- Sie können archivierte Datenkettenobjekte aus Vorlagenimporten ausschließen, wenn die archivierten Objekte in der Quellumgebung in der Zielumgebung nicht bereits vorhanden sind.
Note:
Von einem archivierten Objekt abhängige Objekte werden auch aus dem Vorlagenimport ausgeschlossen, wenn sie in der Zielumgebung nicht vorhanden sind. Wenn ein abhängiges Objekt teilweise ausgeschlossen würde, wird es in der Vorlagenvorschau oder im Vorlagenimport mit einer Warnmeldung angezeigt, in der angegeben wird, dass es nicht importiert werden konnte.
Beispiel: Wenn Sie beim Import eine archivierte Dimension ausschließen und diese in der Zielumgebung nicht bereits vorhanden ist, werden Objekte wie Dimensions-Bindings, Knotentypen, Policys und Extraktionen ebenfalls vom Vorlagenimport ausgeschlossen, wenn sie in der Zielumgebung nicht bereits vorhanden sind.
- Sie können in einer einzigen Vorlagendatei mehrere Anwendungen übertragen. Wenn Sie die Übertragung auf Dimensionsebene durchführen, können Sie nicht mehrere Dimensionen in einer einzigen Vorlagendatei übertragen.
- Beim Übertragen von Dimensionen muss die Anwendung, die die Dimension enthält, in der Zielumgebung vorhanden sein.
- Um eine Anwendung oder Dimension zwischen Umgebungen zu übertragen, müssen beide Umgebungen dieselbe Releaseversion aufweisen.
- Wenn Sie eine Vorlage importieren, und ein Benutzer oder eine Gruppe sowohl in der Quell- als auch in der Zielumgebung vorhanden ist, werden die folgenden Benutzer- und Gruppenreferenzen für die zugeordneten Objekte importiert:
- Berechtigungen
- Policy-Benutzer und -Gruppen
- Bearbeiter für Abonnements
- Filter für Benutzer und Gruppen anzeigen
Wenn ein Benutzer oder eine Gruppe der Quellumgebung in der Zielumgebung nicht vorhanden ist, werden die zugehörigen Benutzer- oder Gruppenreferenzen nicht übertragen. Es wird eine Meldung angezeigt, in der die in der Zielumgebung fehlenden Benutzer und Gruppen und die nicht importierten zugeordneten Objekte angegeben sind.
- Die Quell- und Zielanwendungen oder -dimensionen müssen in der Zielumgebung vorhanden sein, damit Knotentypconverter und Abonnements importiert werden können. Übertragen Sie sowohl die Quell- als auch die Zielanwendung in derselben Vorlagendatei, oder stellen Sie sicher, dass Sie die Quellanwendung oder -dimension für Converter und Abonnements als Erstes importieren, damit beim Importieren der Zielanwendung oder -dimension die Converter und Abonnements erstellt werden.
- Wenn Sie eine Dimension mit Eigenschaften übertragen, die einen Knotendatentyp zum Referenzieren anderer Dimensionen verwenden, müssen diese Quelldimensionen bereits im Zielsystem vorhanden sein. Ist dies nicht der Fall, müssen sie diese Quelldimensionen zunächst übertragen oder eine Anwendungsvorlage zum Übertragen aller Dimensionen in derselben Vorlagendatei verwenden.
- Wenn beim Importieren der folgenden globalen Objekte das Objekt bereits in der Zielumgebung mit demselben Namen, aber einer anderen ID vorhanden ist, wird das Quellobjekt in der Zielumgebung umbenannt, sodass es eindeutig ist:
- Eigenschaften
- Ansichten
- Suchsets
- Globale Verbindungen
- Nachdem Sie eine Anwendung oder Dimension in eine Vorlage exportiert haben, können Sie die Inhalte der Vorlagendatei in einem
.json-Viewer prüfen.
Caution:
Die manuelle Bearbeitung der Vorlagendatei wird nicht unterstützt.
So exportieren Sie Anwendungen oder eine Dimension in eine Vorlage:
- Wählen Sie in der Kachel Extras die Option Vorlagen aus.
Note:
Die Kachel
Extras ist nur für Serviceadministratoren und Benutzer mit der Anwendungsrolle
Migrationen - Verwalten sichtbar.
- Führen Sie in der Registerkarte Export eine Aktion durch:
- Um Anwendungen zu exportieren, wählen Sie im linken Bereich eine Anwendung aus. Mit STRG + Klicken bzw. CMD + Klicken können Sie mehrere Anwendungen auswählen. Die Anwendungen, die Sie auswählen, werden im Abschnitt "Ausgewählte Artefakte" aufgelistet.
- Um eine Dimension zu exportieren, blenden Sie die Anwendung im linken Bereich ein, und wählen Sie die zu exportierende Dimension aus. Sie können nicht mehrere Dimensionen in einer einzigen Vorlagendatei auswählen.
Note:
Um eine Attribute-Dimension zu exportieren, wählen Sie die Basisdimension für die Attribute-Dimension aus.
- Geben Sie in der Vorlagendatei einen Dateinamen mit der Erweiterung
.json ein, und klicken Sie auf Exportieren.
Die Vorlage wird erstellt und in Ihr lokales Dateisystem heruntergeladen. Der Status Ihres Exports wird angezeigt.
So importieren Sie Anwendungen oder Dimensionen aus Vorlagen:
- Wählen Sie in der Kachel Extras die Option Vorlagen aus.
Note:
Die Kacheln
Extras und
Vorlagen sind nur für Serviceadministratoren und Benutzer mit der Anwendungsrolle
Migrationen - Verwalten sichtbar.
- Klicken Sie in der Registerkarte für Importe auf Datei auswählen.
- Wählen Sie in Ihrem lokalen Dateisystem eine Datei mit der Erweiterung
.json aus, und klicken Sie auf Öffnen.
- Optional: Wählen Sie eine oder mehrere Importoptionen aus:
- Berechtigungen ersetzen: Ersetzen Sie vorhandene Berechtigungen in der Zielumgebung durch die Berechtigungen aus der Quellvorlage.
- Policy-Gruppen ersetzen: Ersetzen Sie vorhandene Policy-Gruppen in der Zielumgebung durch die Policy-Gruppen aus der Quellvorlage.
- Archivierte Objekte ausschließen: Archivierte Objekte in einer Vorlage aus einer Quellumgebung werden vom Import in die Zielumgebung ausgeschlossen, wenn die Quellobjekte in der Zielumgebung nicht bereits vorhanden sind.
Note:
Archivierte Objekte in einer Quellvorlage, die in der Zielumgebung bereits vorhanden sind, können nicht aus der Vorlagenvorschau oder dem Vorlagenimport ausgeschlossen werden.
Informationen hierzu finden Sie unter Objekte und Einstellungen in Vorlagen.
- Klicken Sie auf Vorschau, um die Objekte in der Vorlagendatei zu identifizieren und den jeweiligen Status anzuzeigen. Informationen hierzu finden Sie unter Vorlagenimporte in der Vorschau anzeigen und Importergebnisse prüfen.
- Klicken Sie auf Importieren, und klicken Sie in der Bestätigungsnachricht auf Ja.
Die Vorlage wird importiert, und der Status der einzelnen Objekte in der Vorlage wird angezeigt. Informationen hierzu finden Sie unter Vorlagenimporte in der Vorschau anzeigen und Importergebnisse prüfen.