Mit Vorlagen arbeiten

Mit Vorlagen können Sie Anwendungs- und Dimensionskonfigurationsinformationen oder ausgewählte Metadateninformationen in einer Offlinedatei zur Verwendung in anderen Oracle Fusion Cloud Enterprise Data Management-Umgebungen speichern.

Verwenden Sie Vorlagen, um Anwendungen, Dimensionen oder spezifische Metadatenobjekte umgebungsübergreifend zu übertragen (beispielsweise aus einer Testumgebung in eine Produktionsumgebung) oder um einen schnellen Einstieg in neue Implementierungen zu ermöglichen.

Cloud EDM unterstützt zwei Typen von Vorlagenexporten:

  • Anwendungsexport: Exportieren Sie ganze Anwendungen oder Dimensionen zusammen mit allen zugehörigen Metadatenobjekten.
  • Granularer Export: Exportieren Sie einzeln ausgewählte Metadatenobjekte in allen unterstützten Artefakttypen, um gezieltere, inkrementelle Migrationen durchzuführen.

Um eine Vorlage zu verwenden, exportieren Sie Inhalt aus der Quellumgebung in eine .json-Datei, und importieren Sie die Vorlage dann in die Zielumgebung.

  • Bei Anwendungsexporten exportieren Sie eine vollständige Anwendung oder Dimension und alle zugehörigen Metadaten.
  • Bei granularen Exporten wählen Sie bestimmte Metadatenobjekte (aus mindestens einem Artefakttyp) aus, die in die Vorlage aufgenommen werden sollen.

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 granulare Rolle Migrationen - Verwalten verfügen (siehe Erläuterungen zu granularen Rollen und Berechtigungen), um Anwendungen und Dimensionen in Vorlagen zu importieren und zu exportieren.
  • Anwendungsexporte umfassen vollständige Anwendungen oder Dimensionen und alle abhängigen Artefakte (wie globale Verbindungen). Granulare Exporte umfassen nur die ausgewählten Metadatenobjekte und schließen nicht automatisch alle Abhängigkeiten ein. Stellen Sie bei Verwendung granularer Exporte sicher, dass erforderliche abhängige Objekte in der Zielumgebung oder in der Vorlage enthalten sind, um Importfehler zu vermeiden.
  • 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 oder vorhandene Anwendungen, Dimensionen oder unterstützte Metadatenobjekte übertragen. Der Vorlagenimportprozess aktualisiert vorhandene Anwendungen, Dimensionen oder Metadatenobjekte in der Zielumgebung, indem noch nicht vorhandene Objekte erstellt und vorhandene Objekte geändert werden. Informationen hierzu finden Sie unter Vorhandenes Artefakt mit einer Vorlage 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 sowohl Anwendungen als auch Dimensionen in einer Vorlagendatei übertragen. Beispiel: Sie können eine HB-Anwendung und zwei Dimensionen aus einer Planning-Anwendung auswählen. Beachten Sie jedoch, dass die Auswahl einer Anwendung automatisch alle Dimensionen in dieser Anwendung enthält. Sie können keine Anwendung auswählen und dann nur eine Teilmenge der Dimensionen innerhalb dieser Anwendung auswählen. Wenn die HB-Anwendung also drei Dimensionen enthält, können Sie zwei Dimensionen einzeln auswählen. Wenn Sie jedoch die gesamte Anwendung auswählen, werden automatisch alle drei Dimensionen ausgewählt.

    Tip:

    Wenn Sie Knotentypconverter oder Abonnements in mehreren Anwendungen verwenden, kann es hilfreich sein, diese Anwendungen und Dimensionen in einer einzigen Vorlagendatei zu übertragen. Beispiel: Wenn Sie ein Abonnement zwischen einem Ansichtspunkt "Account" in einer HB-Anwendung und einem Ansichtspunkt "Account" in einer Planning-Anwendung verwenden, können Sie die HB-Anwendung sowie die Account-Dimension in der Planning-Anwendung mit dem abonnierenden Ansichtspunkt 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.