Utilisation des définitions de migration

Création de définitions de migration

Les artefacts à migrer doivent être définis dans une définition de migration. Prenez en compte les éléments suivants concernant les définitions de migration :

Une définition de migration est créée dans Oracle Hyperion Shared Services Console lorsque vous effectuez une opération d'export ou d'import.
Lorsque vous exportez des artefacts, la gestion du cycle de vie Oracle Hyperion Enterprise Performance Management System crée deux fichiers XML, un pour l'export et un pour l'import. Ces fichiers XML peuvent être utilisés pour le fichier de définition de migration dans l'utilitaire de gestion du cycle de vie.
Lorsque vous effectuez une opération d'export, le fichier MDF pour cet export et pour l'import correspondant est automatiquement créé dans le dossier Système de fichiers sous le dossier racine.

Schéma XML du fichier de définition de migration

L'illustration suivante présente une outline de schéma XML de la définition de migration.

Figure 7-2 Outline de schéma XML du fichier de définition de la migration

Cette image illustre une outline de schéma XML du fichier de définition de la migration.

Eléments du fichier de définition de la migration

Cette section présente les éléments et les attributs utilisés dans le schéma XML du fichier de définition de la migration :

Paramètres régionaux

Définit les paramètres régionaux du serveur au moment de la création du fichier de définition de migration. Tous les messages d'erreur et les messages de la console sont inclus dans ces paramètres régionaux.

Utilisateur et mot de passe

Définit le nom d'utilisateur et le mot de passe crypté de l'utilisateur qui exécutera le fichier de définition de migration.

Tâche

Définit les tâches à réaliser pendant la migration. Chaque tâche définie dans le fichier de définition de migration dépend de la source, de la destination et des artefacts à migrer. Une tâche contient, au minimum, la source, la destination et les balises d'artefact.

Dans le cadre de plusieurs sources et destinations, vous devez définir au moins une tâche pour chaque combinaison source-destination. Par exemple, la tâche 1 peut correspondre à l'extraction des artefacts vers le système de fichiers. Quant à la tâche 2, elle peut correspondre au chargement des artefacts vers une application depuis le système de fichiers.

Remarque :

Par défaut, lorsqu'une tâche échoue, l'utilitaire passe à la tâche suivante. La validation des connexions source et cible d'une tâche est effectuée uniquement lorsque la tâche est exécutée, et pas avant.

La tâche contient les éléments suivants :

Source

Définit la source de la migration. Vous devez définir une source et une destination par tâche.

Tableau 7-1 Attributs source

Attribut	Description
`application`	Nom sous lequel l'application est enregistrée. Le nom de l'application s'affiche dans Shared Services Console. Exemple : `HPAPP1`
`filePath`	Répertoire dans lequel les artefacts sont stockés sur le système de fichiers. Exemple : `filePath="/Essbase.Sample.Basic"` Remarque : lorsqu'un fichier MDF est généré à partir de l'interface utilisateur, le chemin est un chemin relatif vers le dossier de travail. Si le fichier MDF ne se trouve pas dans le dossier de travail, utilisez l'argument de ligne de commande `-b` afin d'employer le chemin de base relatif à l'emplacement où le chemin d'accès au système de fichiers est défini.
`product`	Code de produit de l'application enregistrée auprès de Shared Services. Exemples : `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`	Nom du groupe d'applications Shared Services auquel l'application appartient. Le nom du projet s'affiche dans Shared Services Console. Exemple : `DevPlan_Proj`
`type`	Types de connexion : `FileSystem` pour la connexion du système de fichiers `Application` pour la connexion de l'application enregistrée auprès de Shared Services

Cible

Définit la destination de la migration. Vous devez définir une destination par tâche.

Tableau 7-2 Attributs cible

Attribut	Description
`application`	Nom sous lequel l'application est enregistrée. Le nom de l'application s'affiche dans Shared Services Console. Exemple : `HPAPP1`
`filePath`	Répertoire dans lequel les artefacts sont stockés sur le système de fichiers. Exemple : `filePath="/Essbase.Sample.Basic"` Remarque : lorsqu'un fichier MDF est généré à partir de l'interface utilisateur, le chemin est un chemin relatif vers le dossier de travail. Si le fichier MDF ne se trouve pas dans le dossier de travail, utilisez l'argument de ligne de commande `-b` afin d'employer le chemin de base relatif à l'emplacement où le chemin d'accès au système de fichiers est défini.
`product`	Code de produit de l'application enregistrée auprès de Shared Services. Exemples : `HUB` (Shared Services) `ESBAPP` (Essbase) `HFM` (Financial Management) `HP` (Planning) `CALC` (Calculation Manager) `HPM` (Profitability and Cost Management)
`project`	Nom du groupe d'applications Shared Services auquel l'application appartient. Le nom du projet s'affiche dans Shared Services Console. Exemple : `DevHP_Proj`

Artefact

Filtre utilisé pour la migration en cours.

Tableau 7-3 Attributs d'artefact

Attribut Description

Attribut	Description
`parentPath`	Répertoire de niveau supérieur pour le stockage des artefacts ou des données de la migration. Pour plus d'informations sur les structures de répertoires produit, reportez-vous aux annexes figurant à la fin de ce guide. Exemple : `/Data Analysis & Report Creation` Attention : si le répertoire du chemin parent contient une esperluette (&), remplacez-la par `"&"` dans le fichier de définition de migration (voir l'exemple ci-dessous). Remarques : Si `recursive="true"`, tous les artefacts contenus dans les sous-répertoires de ce répertoire sont importés. L'attribut `pattern` est requis pour tous les produits.
`pattern`	Critères de sélection des artefacts. Indiquez le nom de l'artefact à importer ou utilisez un astérisque () pour importer tous les artefacts correspondant aux conditions de filtre. Exemple : Remarque : l'attribut `pattern` est requis pour tous les produits.
`recursive`	Indique si la migration doit s'appliquer aux artefacts stockés dans des sous-répertoires. Exemple : `true` Remarque : l'attribut `recursive` est facultatif.

parentPath

Répertoire de niveau supérieur pour le stockage des artefacts ou des données de la migration. Pour plus d'informations sur les structures de répertoires produit, reportez-vous aux annexes figurant à la fin de ce guide.

Exemple : /Data Analysis & Report Creation

Attention : si le répertoire du chemin parent contient une esperluette (&), remplacez-la par "&" dans le fichier de définition de migration (voir l'exemple ci-dessous).

Remarques :

Si recursive="true", tous les artefacts contenus dans les sous-répertoires de ce répertoire sont importés.

L'attribut pattern est requis pour tous les produits.

pattern

Critères de sélection des artefacts.

Indiquez le nom de l'artefact à importer ou utilisez un astérisque (*) pour importer tous les artefacts correspondant aux conditions de filtre.

Exemple : *

Remarque : l'attribut pattern est requis pour tous les produits.

recursive

Indique si la migration doit s'appliquer aux artefacts stockés dans des sous-répertoires.

Exemple : true

Remarque : l'attribut recursive est facultatif.

Options

Les options sont propres à chaque produit. Pour plus d'informations sur les options d'import et d'export que vous pouvez définir, reportez-vous aux annexes figurant à la fin de ce guide. La source ou la destination interprète les options de façon à identifier les artefacts en cours de migration.

Si aucune option n'est définie, les options par défaut définies dans le registre Oracle Hyperion Shared Services sont utilisées.

Tableau 7-4 Attributs d'options

Attribut	Description
`option`	Nom utilisé pour remplacer le nom d'option défini dans le registre Shared Services. Exemple : `ExportJobOutput`
`value`	Valeur utilisée pour remplacer la valeur d'option définie dans le registre Shared Services. Exemple : `true`

Exemple de fichier de définition de migration

L'exemple suivant représente une partie de fichier de définition de migration. Toute modification apportée à la structure ou à la syntaxe provoque des erreurs lors de 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>