Mit Migrationsdefinitionen arbeiten

Migrationsdefinitionen erstellen

Die zu migrierenden Artefakte müssen in einer Migrationsdefinition definiert werden. Beachten Sie Folgendes zu Migrationsdefinitionen:

  • In Oracle Hyperion Shared Services Console wird eine Migrationsdefinition erstellt, wenn Sie einen Export- oder Importvorgang durchführen.

  • Wenn Sie Artefakte exportieren, erstellt Oracle Hyperion Enterprise Performance Management System Lifecycle Management zwei XML-Dateien: eine für den Export und eine für den Import. Diese XML-Dateien können für die Migrationsdefinitionsdatei im Lifecycle Management-Utility verwendet werden.

  • Wenn Sie einen Exportvorgang durchführen, wird die MDF-Datei für diesen Export sowie für den entsprechenden Import automatisch im Dateisystemordner unter dem Root-Ordner erstellt.

XML-Schema für Migrationsdefinitionsdatei

Bei der folgenden Abbildung handelt es sich um eine XML-Schema-Modellstruktur der Migrationsdefinitionsdatei.

Abbildung 7-2 XML-Schema-Modellstruktur der Migrationsdefinitionsdatei


Bei dieser Abbildung handelt es sich um eine XML-Schema-Modellstruktur der Migrationsdefinitionsdatei.

Elemente einer Migrationsdefinitionsdatei

In diesem Abschnitt werden die Elemente und Attribute beschrieben, die im XML-Schema für Migrationsdefinitionsdateien verwendet werden.

Gebietsschema

Definiert das Gebietsschema des Servers zum Zeitpunkt, wenn die Migrationsdefinitionsdatei erstellt wird. Dieses Gebietsschema umfasst alle Fehlermeldungen und Konsolenmeldungen.

Benutzer und Kennwort

Definiert den Benutzernamen und das verschlüsselte Kennwort des Benutzers, der die Migrationsdefinitionsdatei ausführen wird.

Aufgabe

Definiert die Aufgaben, die während der Migration ausgeführt werden müssen. Eine in der Migrationsdefinitionsdatei definierten Aufgabe hängt von der Quelle, dem Ziel und den zu migrierenden Artefakten ab. Jede Aufgabe enthält mindestens Quell-, Ziel- und Artefakt-Tags.

Bei mehreren Quellen und Zielen müssen Sie mindestens eine Aufgabe für jede Kombination aus Quelle und Ziel definieren. Das Extrahieren von Artefakten aus dem Dateisystem können Sie z.B. als Aufgabe 1 definieren, und das Laden der Artefakte aus dem Dateisystem in eine Anwendung als Aufgabe 2.

Hinweis:

Das Utility fährt nach einer nicht erfolgreichen Aufgabe standardmäßig mit der nächsten Aufgabe fort. Die Validierung der Quell- und Zielverbindungen einer Task wird nicht durchgeführt, bevor die Aufgabenausführung gestartet wird, sondern erst, wenn die Task ausgeführt wird.

Die Aufgabe enthält diese Elemente:

Quelle

Definiert die Quelle für die Migration. Sie müssen eine Quelle und ein Ziel pro Aufgabe definieren.

Tabelle 7-1 Quellenattribute

Attribut Beschreibung
application Name, mit dem die Anwendung registriert wird. Der Anwendungsname wird in Shared Services Console angezeigt.

Beispiel: HPAPP1
filePath Verzeichnis, in dem Artefakte im Dateisystem gespeichert werden.

Beispiel: filePath="/Essbase.Sample.Basic"

Hinweis: Wenn eine MDF-Datei in der Benutzerschnittstelle generiert wird, ist der Pfad ein relativer Pfad zum Arbeitsordner. Wenn die MDF-Datei nicht im Arbeitsordner vorhanden ist, verwenden Sie das Befehlszeilenargument -b, um den Basispfad entsprechend dem angegebenen Dateisystempfad zu verwenden.
product Produktcode für die Anwendung, die in Shared Services registriert ist.

Beispiele:

  • HUB (Oracle Hyperion Shared Services)

  • CALC (Oracle Hyperion Calculation Manager)

  • ESBAPP (Oracle Essbase)

  • BPM (Oracle Essbase Studio)

  • AIF (Oracle Hyperion Financial Data Quality Management, Enterprise Edition)

  • HFM (Oracle Hyperion Financial Management)

  • FCC (Oracle Hyperion Financial Close Management)

  • HP (Oracle Hyperion Planning)

  • HPM (Oracle Hyperion Profitability and Cost Management)
project Name der Shared Services-Anwendungsgruppe, zu der die Anwendung gehört. Der Projektname wird in Shared Services Console angezeigt.

Beispiel: DevPlan_Proj
type Verbindungstypen:

  • FileSystem für die Verbindung des Dateisystems

  • Application für die Verbindung der Anwendung, die unter Shared Services registriert ist

Ziel

Definiert das Ziel für die Migration. Sie müssen ein Ziel pro Aufgabe definieren.

Tabelle 7-2 Zielattribute

Attribut Beschreibung
application Name, mit dem die Anwendung registriert wird. Der Anwendungsname wird in Shared Services Console angezeigt.

Beispiel: HPAPP1
filePath Verzeichnis, in dem Artefakte im Dateisystem gespeichert werden.

Beispiel: filePath="/Essbase.Sample.Basic"

Hinweis: Wenn eine MDF-Datei in der Benutzerschnittstelle generiert wird, ist der Pfad ein relativer Pfad zum Arbeitsordner. Wenn die MDF-Datei nicht im Arbeitsordner vorhanden ist, verwenden Sie das Befehlszeilenargument -b, um den Basispfad entsprechend dem angegebenen Dateisystempfad zu verwenden.
product Produktcode für die Anwendung, die in Shared Services registriert ist.

Beispiele:

  • HUB (Shared Services)

  • ESBAPP (Essbase)

  • HFM (Financial Management)

  • HP (Planning)

  • CALC (Calculation Manager)

  • HPM (Profitability and Cost Management)
project Name der Shared Services-Anwendungsgruppe, zu der die Anwendung gehört. Der Projektname wird in Shared Services Console angezeigt.

Beispiel: DevHP_Proj

Artefakt

Für die aktuelle Migration verwendeter Filter.

Tabelle 7-3 Artefaktattribute

Attribut Beschreibung
parentPath Verzeichnis der obersten Ebene, in dem Artefakte oder Daten für die Migration gespeichert werden. Weitere Informationen zu Produktverzeichnisstrukturen finden Sie in den Anhängen am Ende dieser Dokumentation.

Beispiel: /Data Analysis & Report Creation

Achtung: Wenn das übergeordnete Pfadverzeichnis ein Et-Zeichen (&) enthält, müssen Sie dieses in der Migrationsdefinitionsdatei durch "&" ersetzen (siehe Beispiel unten).

Hinweise:

Falls recursive="true" gilt, werden alle in den Unterverzeichnissen enthaltenen Artefakte importiert.

Das Attribut pattern ist für alle Produkte erforderlich.
pattern Artefaktauswahlkriterien

Geben Sie den Namen eines zu importierenden Artefakts an, oder verwenden Sie * (Sternchen), um alle Artefakte zu importieren, die mit den Filterbedingungen übereinstimmen.

Beispiel: *

Hinweis: Das Attribut pattern ist für alle Produkte erforderlich.
recursive Gibt an, ob die Migration für Artefakte, die in Unterverzeichnissen gespeichert sind, durchgeführt werden muss.

Beispiel: true

Hinweis: Das Attribut recursive ist optional.

Optionen

Optionen sind produktspezifisch. Informationen dazu, welche Import- und Exportoptionen Sie festlegen können, finden Sie in den Anhängen am Ende dieser Dokumentation. Die Quelle bzw. das Ziel interpretiert die Optionen, um zu ermitteln, welche Artefakte migriert werden.

Wenn keine Optionen festgelegt werden, werden die in der Oracle Hyperion Shared Services Registry festgelegten Standardoptionen verwendet.

Tabelle 7-4 Optionsattribute

Attribut Beschreibung
option Name, mit dem der in der Shared Services-Registry definierte Optionsname überschrieben wird.

Beispiel: ExportJobOutput
value Wert, mit dem der in der Shared Services-Registry definierte Optionswert überschrieben wird.

Beispiel: true

Beispiel für Migrationsdefinitionsdatei

Im Folgenden finden Sie ein Beispiel für eine Migrationsdefinitionsdatei. Jede Änderung an der Struktur oder Syntax führt zu Fehlern während der Migration.

<?xml version="1.0" encoding="UTF-8"?>
<Package>
<LOCALE>en_US</LOCALE>
<User name="admin" password=""/>
   <Task>
      <Source type="Application" product="HUB" project="Foundation" application="Shared Services"/>
      <Target type="FileSystem" filePath="/folder/HUB.Shared Services" />
      <Options option="GroupFilter" Value= "*" />
      <Artifact recursive="true" parentPath="/Native Directory" pattern="*"/>
      <Artifact recursive="true" parentPath="/Taskflows" pattern="*"/>
   </Task>
   <Task>
      <Source type="FileSystem" filePath="/folder/HUB.Shared Services" />
      <Target type="Application" product="HUB" project="Foundation" application="Shared Services" />
      <Artifact recursive="true" parentPath="/Native Directory" pattern="*"/>
      <Artifact recursive="true" parentPath="/Taskflows" pattern="*"/>
           </Task>
</Package>