Définir un plan de migration

Pour afficher ou définir un plan de migration, sélectionnez Administration > Outils d'implémentation > Plan de migration.

Utilisez le portail Requête de plan de migration pour rechercher un plan de migration existant. Une fois qu'un plan de migration est sélectionné, vous accédez au portail de maintenance dans lequel vous pouvez consulter et gérer l'enregistrement sélectionné.

Les points suivants fournissent des informations relatives à la définition d'instructions pour un plan de migration.

La séquence d'instruction identifie l'instruction de façon unique. Il est recommandé d'utiliser des incréments de 10 pour prévoir l'insertion d'autres instructions à l'avenir.

Sélectionnez Principal pour le premier type d'instruction. Tous les plans de migration doivent contenir une et seulement une instruction principale. Toutes les instructions suivantes ont besoin d'un type d'instruction Subordonné. Dans ce cas, la séquence d'instruction parent doit être entrée. Ce numéro, qui permet de gérer les relations définies dans les données exportées, doit correspondre à un numéro de séquence d'instruction à un niveau plus haut de la hiérarchie.

La description de l'instruction fournit une description fonctionnelle de l'instruction.

Sélectionnez un objet métier pour définir le type d'objet à partir duquel les données seront dérivées.

Critères de traversée est utilisé pour définir la relation entre chacun des objets d'un plan de migration. Le système offre trois options permettant de définir la manière dont l'objet enfant est connecté à l'objet parent, de manière à ce que le système sache comment traverser d'un objet à l'autre. Les options de Type de critères de traversée sont Contraintes, SQL et XPath. Chacune de ces options est expliquée ci-dessous :

• Contrainte vous permet de sélectionner une contrainte de table qui représente la relation d'un enregistrement donné avec un autre enregistrement du système par l'intermédiaire d'une contrainte de clé étrangère définie dans les métadonnées. Si Contraintes est sélectionné, les champs complémentaires suivants sont activés :

  • ID contrainte est l'identifiant unique de la contrainte. La recherche affiche les contraintes de table valides pour l'objet de maintenance de l'objet métier de l'instruction et l'objet de maintenance de l'objet métier de l'instruction parent.

  • Propriétaire de la contrainte permet de définir le propriétaire de la contrainte. Ce champ est renseigné automatiquement lorsque vous sélectionnez une contrainte issue de la recherche.

• SQL permet de spécifier des critères de jointure SQL entre l'objet de l'instruction parent et l'objet enfant dans les critères de traversée SQL. La syntaxe des critères de traversée est celle d'une clause WHERE (sans inclure le mot WHERE). Lorsque vous faites référence à un champ de l'objet de l'instruction parent, utilisez la syntaxe #PARENT.TABLE_​NAME.FIELD_​NAME. Lorsque vous faites référence à un champ de l'objet de l'instruction actuelle, utilisez la syntaxe #THIS.TABLE_​NAME.FIELD_​NAME. Par exemple, l'instruction suivante est utilisée dans un plan de migration pour un objet métier, où l'instruction parent est l'objet métier et où l'instruction subordonnée est utilisée pour référencer la matrice IU désignée comme option d'objet métier avec le type d'option "F1DU": #PARENT.F1_​BUS_​OBJ_​OPT.BUS_​OBJ_​OPT_​FLG = 'F1DU' AND @trim(#THIS.F1_​MAP.MAP_​CD) = @trim(#PARENT.F1_​BUS_​OBJ_​OPT.BUS_​OBJ_​OPT_​VAL).

• L'option XPath vous permet d'appliquer la syntaxe dans une expression XPath qui référence des éléments dans les objets métier référencés de l'instruction. Celle-ci est entrée dans les critères de traversée XPath. Par exemple l'instruction liée à la matrice d'affichage dans l'exemple SQL ci-dessus sera écrite comme suit en XPath : #this/mapCd = #parent/businessObjectOption/businessObjectOptionValue AND #parent/businessObjectOption/businessObjectOptionType = 'F1DU'. Cette technique permet de référencer des références de clé étrangère mappées dans une colonne XML.

  Remarque :

  Les expressions #parent peuvent accéder à des éléments stockés dans une colonne XML et décrits avec mapXML et mdField. Toutefois, les expressions #this doivent faire référence à des champs disponibles dans l'objet métier à l'aide de la référence mapField.

Plan de migration suivant permet d'indiquer qu'en plus de copier l'objet défini dans l'instruction, les instructions supplémentaires éventuellement incluses dans ce plan de migration référencée seront également incluses dans une exportation.

La grille Algorithmes contient les algorithmes associés à chaque instruction. Vous devez définir les informations suivantes pour chaque algorithme :

• Spécifiez l'événement système auquel l'algorithme est associé (voir la table suivante pour obtenir une description de tous les événements possibles).
• Indiquez la Séquence et l'Algorithme pour chaque événement système. Vous pouvez attribuer la valeur 10 à la séquence, sauf si l'événement système que vous utilisez est associé à plusieurs algorithmes. Dans ce cas, vous devez indiquer au système la séquence d'exécution des algorithmes.