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
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 : |
filePath |
Répertoire dans lequel les artefacts sont stockés sur le système de fichiers.
Exemple : 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 |
product |
Code de produit de l'application enregistrée auprès de Shared Services.
Exemples :
|
project |
Nom du groupe d'applications Shared Services auquel l'application appartient. Le nom du projet s'affiche dans Shared Services Console.
Exemple : |
type |
Types de connexion :
|
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 : |
filePath |
Répertoire dans lequel les artefacts sont stockés sur le système de fichiers.
Exemple : 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 |
product |
Code de produit de l'application enregistrée auprès de Shared Services.
Exemples :
|
project |
Nom du groupe d'applications Shared Services auquel l'application appartient. Le nom du projet s'affiche dans Shared Services Console.
Exemple : |
Artefact
Filtre utilisé pour la migration en cours.
Tableau 7-3 Attributs d'artefact
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 : Attention : si le répertoire du chemin parent contient une esperluette (&), remplacez-la par Remarques : Si L'attribut |
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 |
recursive |
Indique si la migration doit s'appliquer aux artefacts stockés dans des sous-répertoires.
Exemple : Remarque : l'attribut |
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 : |
value |
Valeur utilisée pour remplacer la valeur d'option définie dans le registre Shared Services.
Exemple : |
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>