IBM InfoSphere Master Data Management Collaboration Server Version Guide de migration SC

Transcription

1 IBM InfoSphere Master Data Management Collaboration Serer Version 11.4 Guide de migration SC

2

3 IBM InfoSphere Master Data Management Collaboration Serer Version 11.4 Guide de migration SC

4 Important Aant d'utiliser le présent document et le produit associé, prenez connaissance des informations générales figurant à la section «Remarques», à la page 55. Troisième édition - Octobre 2014 Cette édition s'applique à la ersion 11.4 d'ibm InfoSphere Master Data Management et à toutes les réisions et modifications suiantes jusqu'à indication du contraire dans une nouelle édition. Réf. US : SC LE PRESENT DOCUMENT EST LIVRE EN L'ETAT SANS AUCUNE GARANTIE EXPLICITE OU IMPLICITE. IBM DECLINE NOTAMMENT TOUTE RESPONSABILITE RELATIVE A CES INFORMATIONS EN CAS DE CONTREFACON AINSI QU'EN CAS DE DEFAUT D'APTITUDE A L'EXECUTION D'UN TRAVAIL DONNE. Ce document est mis à jour périodiquement. Chaque nouelle édition inclut les mises à jour. Les informations qui y sont fournies sont susceptibles d'être modifiées aant que les produits décrits ne deiennent eux-mêmes disponibles. En outre, il peut contenir des informations ou des références concernant certains produits, logiciels ou serices non annoncés dans ce pays. Cela ne signifie cependant pas qu'ils y seront annoncés. Pour plus de détails, pour toute demande d'ordre technique, ou pour obtenir des exemplaires de documents IBM, référez-ous aux documents d'annonce disponibles dans otre pays, ou adressez-ous à otre partenaire commercial. Vous pouez également consulter les sereurs Internet suiants : (sereur IBM en France) (sereur IBM au Canada) (sereur IBM aux Etats-Unis) Compagnie IBM France Direction Qualité 17, aenue de l'europe Bois-Colombes Cedex Copyright IBM France Tous droits réserés. Copyright IBM Corporation 2000, 2014.

5 Table des matières Tableaux Figures ii Ais aux lecteurs canadiens ix Préface xi Noueautés dans la ersion xi Contacter le serice de support logiciel IBM... xii Chapitre 1. Migration Chapitre 2. Mise en route Chapitre 3. Migration depuis des ersions antérieures Migration des données maître du format interne ers le format XML Migration depuis V9.1 ers V Migration depuis V10.0 ers V Migration depuis V10.1 ers V Migration depuis V11.0 ers V Migration depuis V11.3 ers V Chapitre 4. Migration de scripts InfoSphere MDM Collaboration Serer. 27 Différences entre les scripts dans les dierses ersions Méthodes aec des signatures différentes dans V6.0 et V Méthodes uniques à la ersion 9.0 reportées à la ersion Changements de comportement des opérations de script à compter des ersions V5.3.2 et V Changement de comportement des opérations de script à compter des ersions V6.0 et V Différences des API Jaa entre les dierses ersions 42 Méthodes et énumérations API Jaa Nouelles API Jaa Modifications des points d'extension Jaa Optimisation de la base de données Chapitre 5. Identification et résolution des incidents Identification et résolution des incidents liés aux scripts de migration Exécution de scripts de migration compilés Erreurs de compilation de script courantes Erreurs et incidents d'exécution courants Résolution des erreurs et incidents d'exécution. 51 Identification et résolution des problèmes de migration Remarques Index Comment prendre contact aec IBM.. 63 Copyright IBM Corp. 2000, 2014 iii

6 i InfoSphere MDM Collaboration Serer : Guide de migration

7 Tableaux 1. Causes possibles des erreurs et actions recommandées Fichiers SQL à modifier lorsque ous utilisez des noms d'espace table personnalisés Fichiers SQL à modifier lorsque ous utilisez des noms d'espace table personnalisés Fichiers SQL à modifier lorsque ous utilisez des noms d'espace table personnalisés Fichiers SQL à modifier lorsque ous utilisez des noms d'espace table personnalisés Fichiers SQL à modifier lorsque ous utilisez des noms d'espace table personnalisés Comparaison des méthodes aec des signatures différentes dans V6.0 et V Ressources IBM Transmission de commentaires à IBM Copyright IBM Corp. 2000, 2014

8 i InfoSphere MDM Collaboration Serer : Guide de migration

9 Figures Copyright IBM Corp. 2000, 2014 ii

10 iii InfoSphere MDM Collaboration Serer : Guide de migration

11 Ais aux lecteurs canadiens Le présent document a été traduit en France. Voici les principales différences et particularités dont ous deez tenir compte. Illustrations Les illustrations sont fournies à titre d'exemple. Certaines peuent contenir des données propres à la France. Terminologie La terminologie des titres IBM peut différer d'un pays à l'autre. Reportez-ous au tableau ci-dessous, au besoin. IBM France ingénieur commercial agence commerciale ingénieur technico-commercial inspecteur IBM Canada représentant succursale informaticien technicien du matériel Claiers Les lettres sont disposées différemment : le claier français est de type AZERTY, et le claier français-canadien de type QWERTY. OS/2 et Windows - Paramètres canadiens Au Canada, on utilise : les pages de codes 850 (multilingue) et 863 (français-canadien), le code pays 002, le code claier CF. Nomenclature Les touches présentées dans le tableau d'équialence suiant sont libellées différemment selon qu'il s'agit du claier de la France, du claier du Canada ou du claier des États-Unis. Reportez-ous à ce tableau pour faire correspondre les touches françaises figurant dans le présent document aux touches de otre claier. Copyright IBM Corp. 2000, 2014 ix

12 Breets Il est possible qu'ibm détienne des breets ou qu'elle ait déposé des demandes de breets portant sur certains sujets abordés dans ce document. Le fait qu'ibm ous fournisse le présent document ne signifie pas qu'elle ous accorde un permis d'utilisation de ces breets. Vous pouez enoyer, par écrit, os demandes de renseignements relaties aux permis d'utilisation au directeur général des relations commerciales d'ibm, 3600 Steeles Aenue East, Markham, Ontario, L3R 9Z7. Assistance téléphonique Si ous aez besoin d'assistance ou si ous oulez commander du matériel, des logiciels et des publications IBM, contactez IBM direct au x InfoSphere MDM Collaboration Serer : Guide de migration

13 Préface Ces informations ont pour but de ous aider à effectuer la migration depuis IBM InfoSphere Master Data Management Serer for Product Information Management Version et IBM InfoSphere Master Data Management Collaboration Serer Versions 10.0, 10.1, 11.0 et 11.3 ers IBM InfoSphere Master Data Management Collaboration Serer Version 11.4 à l'aide d'une série d'étapes et de migrations intermédiaires. A propos de cette publication Les informations du présent guide courent les rubriques suiantes : instructions pas à pas, pratiques recommandées, réglage des performances et résolution des incidents courants. Public cible Ce guide de migration est destiné aux installateurs, aux administrateurs système et au personnel des serices de maintenance IBM afin de les aider à déployer correctement le produit dans otre enironnement. Informations sur les prérequis et informations associées Aant d'utiliser ce guide de migration, familiarisez-ous aec les sources d'information suiantes : InfoSphere MDM Collaboration Serer Knowledge Center La documentation de otre sereur d'applications La documentation de otre logiciel de base de données Enoi de commentaires Vos commentaires sont essentiels pour nous aider à fournir des informations de première qualité et les plus précises possibles. Si ous aez des commentaires relatifs à ce guide ou à toute autre documentation InfoSphere MDM Collaboration Serer, utilisez le formulaire suiant pour nous les faire parenir : Noueautés dans la ersion 11.4 IBM InfoSphere Master Data Management Collaboration Serer Version 11.4 contient un grand nombre de fonctions et de caractéristiques nouelles. InfoSphere MDM Collaboration Serer est inclus dans InfoSphere MDM Enterprise Edition et InfoSphere MDM Collaboratie Edition. InfoSphere MDM Collaboration Serer permet de créer un seul référentiel d'informations produit à jour, à utiliser à l'échelle d'une entreprise dans le cadre d'initiaties commerciales stratégiques. Voici les principales modifications apportées au produit : Copyright IBM Corp. 2000, 2014 xi

14 Prise en charge de la migration pour les utilisateurs InfoSphere MDM Collaboration Serer Les rubriques suiantes documentent les noueaux chemins de migration des ersions InfoSphere MDM Collaboration Serer antérieures à la ersion 11.4 : Migration depuis V9.1 ers V11.4 Migration depuis V10.0 ers V11.4 Migration depuis V10.1 ers V11.4 Migration depuis V11.0 ers V11.4 Migration depuis V11.3 ers V11.4 Prise en charge de la migration pour Adanced Catalog Management (ACM) Adanced Catalog Management (ACM) ersion 11.0 FP5 apporte une série de fonctions nouelles. Pour pouoir utiliser ces fonctions, ous deez mettre à jour le modèle de données. Pour de plus amples informations, oir Migration d'adanced Catalog Management. Banking Solution Sample Banking Solution Sample est un modèle de données d'échantillon implémenté dans le MDM collaboratif pour la gestion des données de l'offre de produits bancaires. Pour plus d'informations, oir Banking Solution Sample. Banking Solution Toolkit Le kit d'outils Banking Solution Toolkit est utilisé pour publier les métadonnées de solutions (par exemple, Spécifications) et les données de produit (par exemple, Catégorie et Produit) depuis le MDM collaboratif et le MDM physique. Pour plus d'informations, oir MDM physique IBM InfoSphere. Amélioration des API Jaa API JAVA InfoSphere MDM Collaboration Serer améliorées pour la prise en charge XML des spécifications unifiées. Pour plus d'informations, oir Documentation IBM Jaadoc et Schéma d'objet. Mise à nieau de piles et d'applications Les nouelles mises à nieau de piles suiantes sont prises en charge par InfoSphere MDM Collaboration Serer : Mise à nieau de Rational Architect Deeloper à la ersion 9.1 Mise à nieau de WebSphere Portal Serer à la ersion 8.5 Mises à jour de la documentation Les éléments suiants sont noueaux ou constituent des mises à jour de la documentation : Nouelles rubriques et contenu mis à jour dans la section IBM WebSphere Commerce. Nouelles rubriques et contenu mis à jour dans la section Identification des incidents et support. Nouelles rubriques et contenu mis à jour dans la section Optimisation des performances. Contacter le serice de support logiciel IBM Le serice de support logiciel IBM ous fournit une assistance en cas de défaillance d'un produit, ous aide à répondre aux FAQ et à réaliser une nouelle reconnaissance. xii InfoSphere MDM Collaboration Serer : Guide de migration

15 Aant de commencer Si ous ne trouez pas une réponse ou une solution en utilisant d'autres options d'auto-assistance tels que les notes techniques, ous pouez contacter le support IBM. Aant de contacter le support IBM, érifiez que otre entreprise possède un contrat de maintenance IBM et que ous êtes autorisé à soumettre des incidents à IBM. Pour obtenir des informations sur les types d'aides disponibles, oir Portefeuille de support du Software Support Handbook. Lorsque ous contactez le serice de support logiciel IBM, eillez à distinguer les différents nieaux de support offerts ia IBM : Questions spécifiques au produit : si ous aez suii une formation au produit, ous pouez soumettre os questions et préoccupations spécifiques. Support d'incident : analyse et traail nécessaires requis pour la résolution d'un défaut de produit ou soumission d'une solution palliatie. Opérations de script : pour les questions relaties à une opération de script ou le signalement d'un probable défaut aec une opération de script, ous deez limiter otre question ou incident à eniron 5 lignes de code ou moins. IBM ne prend pas en charge le débogage et l'analyse des scripts personnalisés. Demandes d'améliorations : demandes relaties à une nouelle fonctionnalité ajoutée au produit. Les demandes qui ne concernent pas le serice de support logiciel IBM et qui requièrent que ous contactiez otre représentant de serice ou commercial : Traail diers : traail ou aide qui requiert une implication supplémentaire d'ibm au cours de l'installation ou du processus de mise en oeure qui englobe les installations complexes ou les installations à traers plusieurs plateformes. Support pour les clients non formés : demandes d'aide IBM étape par étape mais les clients n'ont pas suii de formation au produit IBM. IBM Education propose des formations aux clients si du personnel supplémentaire doit être formé. Pour des informations spécifiques sur les formations disponibles, consultez le site Web d'ibm. Scripts personnalisés ou rédaction de scripts : aucune prise en charge n'est fournie pour les scripts que ous aez rédigés ou qui requièrent un débogage. Tous les scripts personnalisés rédigés par les serices professionnels sont détenus et gérés par ous, le client, une fois le traail des serices acheé. Le support technique n'est pas disponible pour la rédaction ou le débogage des scripts personnalisés. Extraction des données : il est iement recommandé de faire une sauegarde de routine de os données. Aide pour les performances et le réglage ou recommandations requérant des données client. Procédure 1. Déterminez si une note technique relatie à otre incident existe déjà. 2. Déterminez si un collègue ou otre équipe de support interne peut ous fournir de l'aide. 3. Définissez le problème, collectez des informations générales, puis déterminez la graité du problème. Pour obtenir de l'aide, oir «Before contacting IBM Software Support» du document Software Support Handbook. Informations d'arrière-plan requises Préface xiii

16 Tous les paramètres et informations relatifs à la configuration. Le comportement attendu par rapport au comportement obtenu. Tous les changements et modifications récemment mis en oeure. Déterminer si l'incident peut être recréé. Définir les étapes qui mènent à l'apparition de l'incident. 4. Rassemblez les données de diagnostic : Utilisez également la fonction de collecte de données de base de l'ibm Support Assistant pour rassembler les fichiers journaux et de configuration critiques (pour plus d'informations, oir isa/). Créez otre propre outil de collecte IBM Support Assistant Lite dans l'atelier. a. Téléchargez le module complémentaire du produit dans le plan de traail d'ibm Support Assistant. b. Cliquez sur Collect and Send Data. Trois options apparaissent à gauche. c. Choisissez...Using IBM Support Assistant Lite. d. Créez le collecteur généré en effectuant chacune des opérations suiantes : Choisissez un collecteur (si l'add-on du produit installé ne s'affiche pas, c'est qu'il ne possède pas de document Must Gather et qu'il ne peut pas créer de collecteur IBM Support Assistant Lite) Spécifiez le répertoire cible Indiquez le nom du fichier Cliquez sur le bouton Export e. Transférez le collecteur IBM Support Assistant Lite exporté sur un système distant ia ftp ou par le biais d'un autre protocole de transfert de fichiers disponible. f. Décompressez le collecteur IBM Support Assistant Lite exporté dans l'emplacement cible. g. Configurez la ariable JAVA_HOME ou érifiez que Jaa se troue dans l'instruction PATH. h. Exécutez la commande runisalite.bat sous Windows ou le script runisalite.sh sous UNIX et LINUX à partir du répertoire d'outils d'ibm Support Assistant Lite sur le système distant. i. Apportez les réponses appropriées aux messages de collecte éentuels. j. Vérifiez les fichiers collectés ou enoyez-les au serice de support IBM. 5. Soumettez otre problème au serice de support logiciel IBM de l'une des façons suiantes : En ligne : (recommandé) a. Cliquez sur Open serice request sous la section Choose your task dans la barre de naigation de gauche du IBM InfoSphere Master Data Management Collaboration Serer site de support. b. Cliquez sur ESR/SR et suiez les instructions disponibles sur le site Web d'esr. Utilisez les instructions et conseils suiants pour utiliser l'esr et soumettre des RGP : Joignez les documents directement au RGP afin de les rendre disponibles pour les serices de support IBM. ESR gère la liste de tous les RGP que ous aez affichés afin que ous puissiez y accéder directement afin de érifier leur statut. xi InfoSphere MDM Collaboration Serer : Guide de migration

17 Utilisez l'esr pour configurer des notifications RGP automatiques. Enoyez des mises à jour pour les RGP que ous aez ouerts directement aux serices de support IBM depuis l'esr. Lorsque ous soumettez un RGP, ous deez indiquer un degré de graité afin de nous aider à définir la priorité pour nos ressources par rapport aux autres RGP en cours : Graité 1 Impact métier majeur : ce degré indique que ous êtes dans l'impossibilité d'utiliser le programme ce qui affecte sérieusement os opérations. Cette situation nécessite une solution immédiate. Remarque : L'impact métier majeur signifie généralement que otre système de production est à l'arrêt, et, pour que le serice de support logiciel IBM puisse traailler en dehors des heures de bureau, ous deez ous assurer qu'un contact soit disponible par téléphone 24 heures sur 24 afin de faciliter les recherches de l'ingénieur chargé du problème, d'exécuter les tests dans otre instance de production, etc. Graité 2 Impact métier important : indique que le programme est utilisable mais de façon très restreinte. Graité 3 Impact métier quelconque : indique que le programme est utilisable et que certaines fonctions majeures (non essentielles pour les opérations) sont indisponibles. Graité 4 Impact métier minime : indique un problème aec un faible impact sur les opérations ou qu'un contournement au problème a été mis en oeure. Pour ourir une demande d'amélioration (une demande pour une nouelle fonctionnalité produit générale non associée à une personnalisation spécifique) : - Ourez un RGP aec le degré de graité 2, 3 ou 4 (en fonction du gain potentiel de la demande) et la demande est enoyée à la gestion produit IBM pour réision. Vous recerez un numéro de demande d'amélioration pour le suii qui remplace le numéro de RGP. Généralement, otre approbation est requise pour clôturer le RGP. Par téléphone : pour connaître le numéro de téléphone à appeler dans otre pays, accédez à la page des contacts du Software Support Handbook. Que faire ensuite Si le problème que ous soumettez concerne un défaut de produit ou une documentation manquante ou inexacte, le serice de support logiciel IBM crée un rapport officiel d'analyse de programme (APAR). L'APAR décrit l'incident en détails. Lorsque cela est possible, le serice de support logiciel IBM propose une solution palliatie jusqu'à la résolution de l'apar et à la découerte d'un correctif. IBM publie tous les jours les APAR résolus sur le site Web IBM Support afin que les autres utilisateurs qui rencontrent le même problème puissent bénéficier de la même résolution. Préface x

18 xi InfoSphere MDM Collaboration Serer : Guide de migration

19 Chapitre 1. Migration Si ous utilisez une ersion antérieure d'ibm InfoSphere Master Data Management Collaboration Serer, ous pouez migrer otre ersion ers la ersion la plus récente. Ces informations d'installation sont également disponibles dans le document InfoSphere MDM Collaboration Serer - Guide de migration, accessible dans le format lire dans un fichier PDF. Cliquez aec le bouton droit de la souris sur le lien, puis sélectionnez Enregistrer la cible sous pour télécharger le fichier PDF sur otre ordinateur. Copyright IBM Corp. 2000,

20 2 InfoSphere MDM Collaboration Serer : Guide de migration

21 Chapitre 2. Mise en route Vous deez modifier le schéma de base de données de otre installation en cours à l'aide des scripts de migration pour effectuer la migration d'une ersion antérieure ers IBM InfoSphere Master Data Management Collaboration Serer Version Vous deez posséder les droits appropriés pour créer et modifier des tables et des index dans la base de données, de même que pour créer et supprimer des fichiers dans les sous-répertoires du répertoire $TOP. Le processus de migration comprend les principales étapes suiantes : Vérifier que la table de base de données contient un espace suffisant. Arrêter l'instance qui utilise le schéma de base de données. Sauegarder le schéma de base de données existant. Installer InfoSphere MDM Collaboration Serer V11.4 et le faire pointer ers le schéma de base de données utilisé par l'instance antérieure. Exécuter le script de migration approprié pour modifier le schéma de base de données et l'éleer à InfoSphere MDM Collaboration Serer V11.4. Copyright IBM Corp. 2000,

22 4 InfoSphere MDM Collaboration Serer : Guide de migration

23 Chapitre 3. Migration depuis des ersions antérieures Vous pouez effectuer une migration ers IBM InfoSphere Master Data Management Collaboration Serer Version 11.4 depuis des ersions antérieures. Les chemins de migration suiants sont pris en charge pour la ersion 11.4 : Migration depuis V9.1, groupe de correctifs 2 ou ultérieur ers V11.4 Migration depuis V10.0, groupe de correctifs 1 ou ultérieur ers V11.4 Migration depuis V10.1, GA et tous les nieaux de groupes de correctifs ers V11.4 Migration depuis V11.0, GA et tous les nieaux de groupes de correctifs ers V11.4 Migration depuis V11.3, GA ers V11.4 Si ous migrez ers une ersion ultérieure, et non pas ers un groupe de correctifs de la même ersion, ous deez utiliser un noueau répertoire d'installation pour éiter les discordances de ersion de fichier JAR. Si ous migrez depuis une ersion de groupe de correctifs antérieure, assurez-ous que ous n'utilisez pas des API supprimées dans os scripts Excel. Les API suiantes ne sont pas disponibles dans le dernier fichier JAR POI : public String getexcelcellencoding(); public oid setencoding(string encoding); public String getexcelcellencoding(object cellobj) throws AustinException; Remarque : 1. L'analyseur syntaxique InfoSphere MDM Collaboration Serer Excel est pris en charge ia un fichier.jar tiers nommé poi jar. Cette bibliothèque prend en charge le format Microsoft Excel 2007, lequel autorise plus de 255 colonnes par feuille de données. Vous deez exécuter le script de rapport de résultat de la recherche aancée. Lorsque ous exécutez ce script, utilisez l'option Script de rapport de résultats de la recherche aancée par défaut (format Excel xlsx) pour exporter les éléments comportant plus de 255 attributs. 2. Vous pouez exporter les résultats de la recherche aancée dans le format Excel 2003 à l'aide de l'option Script de rapport de résultats de la recherche aancée par défaut. Toutefois, aec ce format, le rapport échouera si des éléments comportent plus de 255 attributs. 3. Excel 2010.xlsx n'est pas pris en charge par ce fichier JAR. Important : Aant d'exécuter les scripts de migration, ous deez érifier que ous utilisez la ersion correcte de la base de données. Pour plus d'informations, oir la rubrique relatie à la configuration système requise : support/dociew.wss?uid=swg Vous deez également érifier que l'utilisateur de la base de données InfoSphere MDM Collaboration Serer bénéficie des droits appropriés, comme indiqué dans le guide d'installation. Consultez l'équipe DBA pour les modifications des priilèges utilisateur de base de données pour les règles de sécurité. Copyright IBM Corp. 2000,

24 Vous deez utiliser la ersion de base de données DB2 ou Oracle, comme indiqué dans la configuration système. Pour plus d'informations, oir la rubrique relatie à la configuration système requise : dociew.wss?uid=swg Vous pouez ous reporter à la documentation DB2 ou Oracle pour saoir comment mettre à nieau otre base de données DB2 et Oracle ers la ersion prise en charge. Etapes de migration de MDM collaboratif lorsque des espaces table personnalisés sont utilisés dans DB2 et Oracle Si ous utilisez des noms d'espace table personnalisés au lieu de la aleur par défaut USERS ou INDX, ous deez modifier les noms d'espace table manuellement dans les fichiers SQL suiants aant de commencer la migration ers InfoSphere MDM Collaboration Serer. Vous deez érifier que la base de données contient au moins 30 % d'espace disponible aant d'effectuer la migration. Les journaux d'audit ne sont pas migrés ers V11.4. En raison du noueau format de description introduit dans la ersion 9.1.0, les descriptions de journaux d'audit présentes dans les ersions antérieures à la ersion ne sont pas isibles dans la ersion Par conséquent, elles sont supprimées de la base de données pendant la migration. Les anciens journaux d'audit peuent être affichés en utilisant l'édition depuis laquelle ous effectuez la migration. Vous deez effectuer manuellement les étapes suiantes pour réussir la migration : 1. Procédez à la migration manuelle des fichiers de propriétés suiants. Dans la mesure où les fichiers de propriétés font partie des systèmes de fichiers locaux, la méthode de migration ne prend pas en charge l'exportation de ces fichiers. Modifiez chaque propriété personnalisée des éditions précédentes pour utiliser le fichier correspondant dans la nouelle ersion. Ne remplacez pas les fichiers de propriétés d'une ersion antérieure dans une ersion plus récente car de noueaux paramètres ont été introduits dans la ersion Pour plus d'informations sur chacun des fichiers de propriétés, consultez la documentation InfoSphere MDM Collaboration Serer. $TOP/etc/default/common.properties $TOP/etc/default/logs.xml $TOP/etc/default/docstore_mount.xml $TOP/etc/default/user_jars.list 2. Copiez manuellement le contenu du répertoire $TOP/public_html/suppliers/ <cmp code>/ctg_files ers la nouelle instance pour chaque société. Dans la mesure où ces fichiers font partie du système de fichiers local, la méthode de migration ne prend pas en charge l'exportation du répertoire ctg_files. 3. Ajoutez manuellement les fichiers JAR utilisateur nécessaires à la nouelle instance. Comme ces fichiers font partie du système de fichiers local, la méthode de migration ne permet pas d'exporter les fichiers. Pour plus d'informations sur l'ajout des fichiers JAR au déploiement, oir Déploiement d'un fichier.jar utilisateur personnalisé. 4. Réexécutez manuellement toute modification ayant été effectuée dans le script de rapport de résultats de la recherche aancée par défaut pour le personnaliser. La migration ers InfoSphere MDM Collaboration Serer V11.4 écrase le script existant disponible dans le répertoire du magasin de documents InfoSphere MDM Collaboration Serer, /scripts/report. Ce script permet d'exporter les résultats de recherche d'objet InfoSphere MDM Collaboration 6 InfoSphere MDM Collaboration Serer : Guide de migration

25 Serer ers une feuille de calcul Excel. Pour plus d'informations sur ce script, consultez la rubrique sur l'exportation des résultats de la recherche ers Excel. 5. Assurez-ous qu'aucune option de compilation prolixe n'est définie pour les scripts de compilation. Vérifiez que dans le fichier common.properties ous n'utilisez pas erbose comme aleur pour le paramètre script_compiler_options. Pour plus d'informations sur ce paramètre, oir script_compiler_options parameters. 6. Exécutez le script setup.sh pour érifier si la ersion de PERL installée sur otre ordinateur est compatible aec la ersion de InfoSphere MDM Collaboration Serer installée. Ce script se troue dans le répertoire $TOP. Sila ersion actuelle de PERL n'est pas compatible, ous deez installer une nouelle ersion. 7. Si ous installez la nouelle ersion de InfoSphere MDM Collaboration Serer dans un noueau répertoire, ous deez mettre à jour la aleur des ariables TOP et PERL5LIB dans le fichier.bash_profile. Vous deez définir la ariable PERL5LIB sur le répertoire $TOP/bin/perllib. Migration des données maître du format interne ers le format XML Vous deez conertir les données maîtres à XML lors de la migration depuis IBM InfoSphere Master Data Management Serer for Product Information Management Versions ou ers IBM InfoSphere Master Data Management Collaboration Serer Version Aant de commencer 1. Créez des espaces table XML et des pools de mémoire tampon, comme indiqué dans le guide d'installation. 2. Vous deez également érifier que l'utilisateur de la base de données d'infosphere MDM Collaboration Serer dispose des droits appropriés, comme indiqué dans le guide d'installation. 3. Arrêtez l'application InfoSphere MDM Collaboration Serer sur le sereur local. 4. Exécutez le script delete_old_ersions.sh pour supprimer les anciennes ersions. Utilisez le code de la société et la date en cours comme aleurs pour les paramètres code et end_date. 5. Facultatif : étendez la mémoire disponible pour le processus Jaa. L'exécution du script de conersion des données utilise beaucoup de mémoire. Il est recommandé dé fournir 2 Go de mémoire au processus Jaa en mettant à jour le paramètre custom_jaa_options dans le fichier $TOP/bin/conf/ en_settings.ini. Exécutez configureen.sh après aoir modifié le paramètre custom_jaa_options pour appliquer les noueaux paramètres de mémoire. custom_jaa_options=-xmx2048m -Xms256m Pourquoi et quand exécuter cette tâche Le script de migration des données nécessite en terme de connexions le double du nombre d'unités d'exécution. Par exemple, si ous utilisez 10 unités d'exécution dans l'option d'inite de commande, 20 connexions BD sont nécessaires. Vous deez configurer le nombre de connexions BD en utilisant les deux paramètres de configuration suiants : db_maxconnection db_maxconnection_default Chapitre 3. Migration depuis des ersions antérieures 7

26 Ces deux paramètres sont disponibles dans le fichier common.properties. Si les aleurs des paramètres sont déjà égales ou supérieures au nombre de connexions BD nécessaires, ous n'aez pas à les modifier. Si elles sont inférieures au nombre de connexion BD, augmentez les aleurs pour améliorer la itesse. Si les catalogues contiennent plus de entrées de données, augmentez le nombre d'unité d'exécution. Par exemple, ous pouez utiliser 50 ou 100 unités d'exécution pour accélérer la migration des données. Le nombre d'unités d'exécution maximal que ous pouez utiliser dépend des ariables suiantes dans InfoSphere MDM Collaboration Serer. Vous pouez connaître ce nombre en exécutant le script de migration dans un enironnement de test. Nombre de coeurs de processeurs disponibles Nombre de spécifications définies Mémoire disponible Toutes les spécifications définies dans l'enironnement InfoSphere MDM Collaboration Serer sont extraites et utilisées dans le processus de conersion de données. Si ous aez plus de 100 spécifications, réglez les paramètres de mise en cache des spécifications sur les aleurs appropriées pour réduire les déplacements de bases de données et améliorer la performance générale des scripts. Procédure 1. Pour obtenir le nombre de spécifications dans InfoSphere MDM Collaboration Serer, exécutez la commande suiante : $PERL5LIB/runSQL.pl --sql_command="select count(*) from spc;" 2. Modifiez les paramètres aec les aleurs extraites de la requête de l'étape 1. Ces paramètres se trouent dans le fichier mdm-cache-config.properties dans le répertoire $TOP/etc/default. speccache_key_start_version_to_value.maxelementsinmemory=<spec count> speccache_key_to_current_start_version.maxelementsinmemory=<spec count> speccache_key_version_to_start_version.maxelementsinmemory=<spec count> Remarque : L'exécution du script configureen.sh après la mise à jour du fichier mdm-cache-config.properties remplace les paramètres par les aleurs par défaut. 3. Exécutez le script de shell de migration des données migratedatatoxml.sh. Ce fichier se troue dans le répertoire $TOP/bin/migration. migratedatatoxml.sh --company=<company name> --threads=<number of threads> Où : --company Définit le code de société utilisé pour se connecter à InfoSphere MDM Collaboration Serer. --threads Définit le nombre d'unités d'exécution. Utilisez un grand nombre d'unités d'exécution pour améliorer la itesse, mais érifiez qu'un nombre suffisant de connexions DB existent. La aleur par défaut est 1. Au moins 10 unités d'exécution sont recommandées. Par exemple, migratedatatoxml.sh --company=ibm --threads=50 8 InfoSphere MDM Collaboration Serer : Guide de migration

27 Que faire ensuite Vous pouez érifier que le script fonctionne correctement en obserant les erreurs qui s'affichent sur la console et qui sont consignées dans le fichier default.log dans le répertoire $TOP/logs/default. La liste des entrées n'ayant pas pu être migrées s'affiche en fin d'exécution. Le script de migration de données met à jour la base de données par lot. En cas d'erreur, l'ensemble du lot est annulé. Par conséquent, le nombre d'entrées dont la migration échoue est supérieur au nombre réel d'échecs. Affectez la aleur 1 au paramètre index_regeneration_batch_size dans le fichier common.properties, puis réexécutez le script de migration de données pour réduire le nombre d'entrées par rapport aux échecs réels. Le tableau des causes possibles des erreurs de migration et les actions recommandées sont fournis : Tableau 1. Causes possibles des erreurs et actions recommandées Causes des erreurs de migration Action recommandée La migration des données affiche l'erreur suiante : jaa.sql.sqlexception: ORA-00600: internal error code, arguments: [KGHALP1], [0x ], [], [], [], [], [], [], [], [], [], [] La migration des données affiche l'erreur suiante : jaa.sql.sqlexception: ORA-31061: XDB error: XML eent error ORA-19202: Error occurred in XML processing In line 46 of orastream: LPX-00241: entity reference is not well formed Vérifiez que ous utilisez le nieau de correctif de base de données correct. Si nécessaire, mettez à jour la base de données, puis réexécutez le script de migration des données. L'une des aleurs d'attribut dans l'entrée contient le caractère "&" ou la aleur n'est pas alide. Modifiez l'entrée pour supprimer la aleur non alide depuis l'interface d'édition d'élément d'infosphere MDM Collaboration Serer et réexécutez le script de migration des données. Migration depuis V9.1 ers V11.4 Pour effectuer une migration ers IBM InfoSphere Master Data Management Collaboration Serer Version 11.4 depuis IBM InfoSphere Master Data Management Serer for Product Information Management Version 9.1.0, ous deez exécuter le script de migration approprié. Aant de commencer Aant d'effectuer la migration depuis InfoSphere MDM Serer for PIM V9.1.0 ers InfoSphere MDM Collaboration Serer V11.4, ous deez ous assurer que ous utilisez bien le groupe de correctifs 2 ou les groupes de correctifs successifs de V Si ous utilisez la ersion aec un autre nieau de groupe de correctifs, ous deez migrer ers la ersion groupe de correctifs 2 ou ultérieur. Suiez les instructions figurant dans les notes sur l'édition appropriées. Chapitre 3. Migration depuis des ersions antérieures 9

28 Vous deez également érifier que tous les espaces table XML sont créés comme indiqué dans le guide d'installation. Assurez-ous également que l'utilisateur de la base de données InfoSphere MDM Collaboration Serer est autorisé à utiliser les noueaux espaces table. Vous pouez configurer l'emplacement du fichier journal des erreurs en modifiant la ariable _ERROR_LOGS dans le script de migration migratefrom910.sh. Cette ariable est définie sur $TOP/logs/errfile.log par défaut. Si ous utilisez des noms d'espace table personnalisés au lieu des aleurs USERS ou INDX par défaut, ous deez modifier les noms d'espace table manuellement dans create_pimdb.sh et create_pimdb_for_zlinux.sh dans le dossier $TOP/bin/db_creation. De plus, ous deez modifier les noms d'espace table manuellement dans les fichiers SQL suiants. Cette modification doit être effectuée aant de commencer la migration ers InfoSphere MDM Collaboration Serer V11.4. Tableau 2. Fichiers SQL à modifier lorsque ous utilisez des noms d'espace table personnalisés Fichiers SQL à modifier quand DB2 est la base de données dorsale Fichiers SQL à modifier quand Oracle est la base de données dorsale Remplacez les noms d'espace table USERS, INDX et BLOB_TBL_DATA par les noms d'espace table personnalisés appropriés dans les fichiers SQL suiants dans le répertoire $TOP/src/db/schema/dbscripts/ db2 : Remplacez les noms d'espace table USERS, INDX et BLOB_TBL_DATA par les noms d'espace table personnalisés appropriés dans les fichiers SQL suiants dans le répertoire $TOP/src/db/schema/dbscripts/ oracle : addcaestepentrydate.sql addcehentryid.sql addobhcompanyid.sql addsstshared.sql addsstshared.sql add_icm_index.sql add_lot_index.sql add_sca_index.sql add_sit_index1.sql redefine_ctg_indexes.sql modifyicm1index.sql Pourquoi et quand exécuter cette tâche Les étapes suiantes constituent l'unique façon d'effectuer une migration depuis InfoSphere MDM Serer for PIM V9.1.0 ers InfoSphere MDM Collaboration Serer V11.4. Vous ne pouez pas utiliser l'outil d'exportation et d'importation d'enironnement. Procédure 1. Effectuez une copie de sauegarde du schéma de base de données existant. 2. Installez InfoSphere MDM Collaboration Serer V11.4 dans un répertoire différent. 3. Configurez la base de données. a. Pour les bases de données DB2, créez des pools de mémoire tampon et des espaces table, comme indiqué dans Configuration de la base de données DB2 dans le guide d'installation. Remarque : La taille de l'espace table XML_DATA doit être égale à l'espace occupé par l'espace table TCTG_ITD_ITEM_DETAIL. Pour connaître la taille approximatie de la table, utilisez la requête suiante : 10 InfoSphere MDM Collaboration Serer : Guide de migration

29 select (fpages * 16) / 1024 megabytes from syscat.tables where tabschema = current schema and tabname like TCTG_ITD_ITEM_DETAIL ; b. Pour les bases de données Oracle, créez des espaces table et installez le composant Oracle XML DB, comme indiqué dans Configuration de la base de données Oracle dans la guide d'installation. 4. Faites pointer l'instance InfoSphere MDM Collaboration Serer V11.4 ers le schéma de base de données de la ersion 9.1.0, groupe de correctifs 2 ou ultérieur. Pour faire pointer l'instance ers la base de données, ajoutez les paramètres de base de données dans le fichier en_settings.ini. Pour plus d'informations, oir Configuration des paramètres communs de la base de données. 5. Exécutez le script de migration migratefrom910fp.sh. Ce script est disponible dans le répertoire $TOP/bin/migration. Consultez la section Results dans le récapitulatif de la migration. Si la migration n'a pas abouti, ous pouez exécuter de noueau le script de migration. 6. Migrez les données, comme indiqué dans Migration des données maître du format interne ers le format XML. 7. Exécutez le script test_db.sh afin de érifier le schéma de base de données, la connectiité entre InfoSphere MDM Collaboration Serer et les bases de données, et pour érifier les connexions client naties et JDBC. Pour plus d'informations, oir test_db.sh script. 8. Démarrez l'instance InfoSphere MDM Collaboration Serer V11.4. Résultats Tous les messages, comme l'état des composants de migration indiiduels et le récapitulatif de migration global, sont affichés dans la console. Après aoir exécuté le script de migration, des messages indiquant que la migration a réussi ou échoué s'affichent. Le message suiant s'affiche si la migration a réussi : Summary of the migration Migration to IBM InfoSphere Master Data Management Collaboration Serer Version is complete. Check the messages for any errors. Generating database erification report... Changed tables =========================================================== There are no changed tables Missing Tables =========================================================== There are no missing tables Chapitre 3. Migration depuis des ersions antérieures 11

30 Changed Indexes =========================================================== There are no changed indexes Missing Indexes =========================================================== There are no missing indexes LOG FILE: $TOP/logs/default/default.log Le message suiant s'affiche si la migration a échoué :!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Migration Failed : xxxx!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Please see the file for further details : /home/pimuser/mdmcs11/logs/errfile.log Le message suiant s'affiche si la migration de modules spécifiques a échoué : Summary of the migration Migration of the following modules failed : <module names> Ce message s'affiche s'il existe une différence dans les tables et les index de base de données. Generating database erification report... Changed tables =========================================================== <table names> Missing Tables =========================================================== <table names> Changed Indexes =========================================================== <index names> 12 InfoSphere MDM Collaboration Serer : Guide de migration

31 Missing Indexes =========================================================== <index names> LOG FILE: $TOP/logs/default/default.log Recherchez d'éentuels messages supplémentaires dans le fichier errfile.log. Pour les erreurs SQL, trouez le message d'erreur détaillé à partir du code d'erreur SQL, corrigez l'erreur, puis exécutez de noueau le script de migration. Pour l'action recommandée en cas d'échec de la migration, oir Identification et résolution des problèmes de migration. Contactez IBM Software Support si le problème persiste après aoir corrigé les erreurs. Migration depuis V10.0 ers V11.4 Pour effectuer une migration ers IBM InfoSphere Master Data Management Collaboration Serer Version 11.4 depuis IBM InfoSphere Master Data Management Serer for Product Information Management Version , ous deez exécuter le script de migration approprié. Aant de commencer Aant d'effectuer une migration depuis InfoSphere MDM Collaboration Serer V ers V11.4, ous deez ous assurer que ous utilisez bien le groupe de correctifs 1 de la ersion , ou un groupe de correctifs ultérieur. Si ous utilisez la ersion GA, ous deez effectuer une migration ers la ersion , groupe de correctifs 1 ou ultérieur, en suiant les instructions des notes d'édition appropriées. Vous pouez configurer le fichier journal des erreurs en modifiant la ariable _ERROR_LOGS dans le script de migration migratefrom1000.sh. Cette ariable est définie sur $TOP/logs/errfile.log par défaut. Si ous utilisez des noms d'espace table personnalisés au lieu des aleurs USERS ou INDX par défaut, ous deez modifier les noms d'espace table manuellement dans create_pimdb.sh et create_pimdb_for_zlinux.sh dans le dossier $TOP/bin/db_creation. De plus, ous deez modifier les noms d'espace table manuellement dans les fichiers SQL suiants. Cette modification doit être effectuée aant de commencer la migration ers InfoSphere MDM Collaboration Serer V11.4. Chapitre 3. Migration depuis des ersions antérieures 13

32 Tableau 3. Fichiers SQL à modifier lorsque ous utilisez des noms d'espace table personnalisés Fichiers SQL à modifier quand DB2 est la base de données dorsale Fichiers SQL à modifier quand Oracle est la base de données dorsale Remplacez les noms d'espace table USERS, INDX et BLOB_TBL_DATA par les noms d'espace table personnalisés appropriés dans les fichiers SQL suiants dans le répertoire $TOP/src/db/schema/dbscripts/ db2 : Remplacez les noms d'espace table USERS, INDX et BLOB_TBL_DATA par les noms d'espace table personnalisés appropriés dans les fichiers SQL suiants dans le répertoire $TOP/src/db/schema/dbscripts/ oracle : addcaestepentrydate.sql addcehentryid.sql addobhcompanyid.sql addsstshared.sql addsstshared.sql add_icm_index.sql add_lot_index.sql add_sca_index.sql add_sit_index1.sql redefine_ctg_indexes.sql modifyicm1index.sql Pourquoi et quand exécuter cette tâche Les étapes suiantes constituent l'unique façon d'effectuer une migration depuis InfoSphere MDM Collaboration Serer V ers V11.4. Vous ne pouez pas utiliser l'outil d'exportation et d'importation d'enironnement. Procédure 1. Effectuez une copie de sauegarde du schéma de base de données existant. 2. Installez InfoSphere MDM Collaboration Serer V11.4 dans un répertoire différent. 3. Faites pointer l'instance InfoSphere MDM Collaboration Serer V11.4 ers le schéma de base de données de ersion , groupe de correctifs 1 ou ultérieur. Pour pointer l'instance ers la base de données, ajoutez les paramètres de base de données dans le fichier en_settings.ini. Pour plus d'informations, oir Configuration des paramètres communs de la base de données. 4. Exécutez le script de migration migratefrom1000fp.sh. Ce script est disponible dans le répertoire $TOP/bin/migration. Consultez la section Results dans le récapitulatif de la migration. Si la migration n'a pas abouti, ous pouez exécuter de noueau le script de migration. 5. Exécutez le script test_db.sh afin de érifier le schéma de base de données, la connectiité entre InfoSphere MDM Collaboration Serer et les bases de données, et pour érifier les connexions client naties et JDBC. Pour plus d'informations, oir test_db.sh script. 6. Démarrez l'instance InfoSphere MDM Collaboration Serer V11.4. Résultats Tous les messages, comme l'état des composants de migration indiiduels et le récapitulatif de migration global, sont affichés dans la console. Après aoir exécuté le script de migration, des messages indiquant que la migration a réussi ou échoué s'affichent. Le message suiant s'affiche si la migration a réussi : 14 InfoSphere MDM Collaboration Serer : Guide de migration

33 Summary of the migration Migration to IBM InfoSphere Master Data Management Collaboration Serer Version is complete. Check the messages for any errors. Generating database erification report... Changed tables =========================================================== There are no changed tables Missing Tables =========================================================== There are no missing tables Changed Indexes =========================================================== There are no changed indexes Missing Indexes =========================================================== There are no missing indexes LOG FILE: $TOP/logs/default/default.log Le message suiant s'affiche si la migration a échoué :!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Migration Failed : xxxx!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Please see the file for further details : /home/pimuser/mdmcs11/logs/errfile.log Le message suiant s'affiche si la migration de modules spécifiques a échoué : Summary of the migration Migration of the following modules failed : <module names> Ce message s'affiche s'il existe une différence dans les tables et les index de base de données. Generating database erification report... Chapitre 3. Migration depuis des ersions antérieures 15

34 Changed tables =========================================================== <table names> Missing Tables =========================================================== <table names> Changed Indexes =========================================================== <index names> Missing Indexes =========================================================== <index names> LOG FILE: $TOP/logs/default/default.log Recherchez d'éentuels messages supplémentaires dans le fichier errfile.log. Pour les erreurs SQL, trouez le message d'erreur détaillé à partir du code d'erreur SQL, corrigez l'erreur, puis exécutez de noueau le script de migration. Pour l'action recommandée en cas d'échec de la migration, oir Identification et résolution des problèmes de migration. Contactez IBM Software Support si le problème persiste après aoir corrigé les erreurs. Migration depuis V10.1 ers V11.4 Pour effectuer une migration ers IBM InfoSphere Master Data Management Collaboration Serer Version 11.4 depuis IBM InfoSphere Master Data Management Collaboration Serer Version , ous deez exécuter le script de migration approprié. Aant de commencer Si ous utilisez des noms d'espace table personnalisés au lieu des aleurs USERS ou INDX par défaut, ous deez modifier les noms d'espace table manuellement dans create_pimdb.sh et create_pimdb_for_zlinux.sh dans le dossier $TOP/bin/db_creation. De plus, ous deez modifier les noms d'espace table manuellement dans les fichiers SQL suiants. Cette modification doit être effectuée aant de commencer la migration ers InfoSphere MDM Collaboration Serer V InfoSphere MDM Collaboration Serer : Guide de migration

35 Tableau 4. Fichiers SQL à modifier lorsque ous utilisez des noms d'espace table personnalisés Fichiers SQL à modifier quand DB2 est la base de données dorsale Fichiers SQL à modifier quand Oracle est la base de données dorsale Remplacez les noms d'espace table USERS, INDX et BLOB_TBL_DATA par les noms d'espace table personnalisés appropriés dans les fichiers SQL suiants dans le répertoire $TOP/src/db/schema/dbscripts/ db2 : Remplacez les noms d'espace table USERS, INDX et BLOB_TBL_DATA par les noms d'espace table personnalisés appropriés dans les fichiers SQL suiants dans le répertoire $TOP/src/db/schema/dbscripts/ oracle : addcaestepentrydate.sql addcehentryid.sql addobhcompanyid.sql addsstshared.sql addsstshared.sql add_icm_index.sql add_lot_index.sql add_sca_index.sql add_sit_index1.sql redefine_ctg_indexes.sql modifyicm1index.sql Pourquoi et quand exécuter cette tâche Vous pouez effectuer une migration ers InfoSphere MDM Collaboration Serer Version 11.4 depuis InfoSphere MDM Collaboration Serer Version GA ou tout groupe de correctifs (1, 6, 7, 8, 9, 10 ou 11). Les étapes suiantes constituent l'unique façon d'effectuer une migration depuis InfoSphere MDM Collaboration Serer V ers V11.4. Vous ne pouez pas utiliser l'outil d'exportation et d'importation d'enironnement. Vous pouez configurer le fichier journal des erreurs en modifiant la ariable _ERROR_LOGS dans le script de migration migratefrom1010.sh. Cette ariable est définie sur $TOP/logs/errfile.log par défaut. Procédure 1. Effectuez une copie de sauegarde du schéma de base de données existant. 2. Installez InfoSphere MDM Collaboration Serer V11.4 dans un répertoire différent. 3. Faites pointer l'instance InfoSphere MDM Collaboration Serer V11.4 ers le schéma de base de données de ersion Pour faire pointer l'instance ers la base de données, ajoutez les paramètres de base de données dans le fichier en_settings.ini. Pour plus d'informations, oir Configuration des paramètres communs de la base de données. 4. Exécutez le script de migration migratefrom1010fp.sh. Ce script est disponible dans le répertoire $TOP/bin/migration. Consultez la section Results dans le récapitulatif de la migration. Si la migration n'a pas abouti, ous pouez exécuter de noueau le script de migration. 5. Exécutez le script test_db.sh afin de érifier le schéma de base de données, la connectiité entre InfoSphere MDM Collaboration Serer et les bases de données, et pour érifier les connexions client naties et JDBC. Pour plus d'informations, oir test_db.sh script. 6. Démarrez l'instance InfoSphere MDM Collaboration Serer V11.4. Chapitre 3. Migration depuis des ersions antérieures 17

36 Résultats Tous les messages, comme l'état des composants de migration indiiduels et le récapitulatif de migration global, sont affichés dans la console. Après aoir exécuté le script de migration, des messages indiquant que la migration a réussi ou échoué s'affichent. Le message suiant s'affiche si la migration a réussi : Summary of the migration Migration to IBM InfoSphere Master Data Management Collaboration Serer Version is complete. Check the messages for any errors. Generating database erification report... Changed tables =========================================================== There are no changed tables Missing Tables =========================================================== There are no missing tables Changed Indexes =========================================================== There are no changed indexes Missing Indexes =========================================================== There are no missing indexes LOG FILE: $TOP/logs/default/default.log Le message suiant s'affiche si la migration a échoué :!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Migration Failed : xxxx!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Please see the file for further details : /home/pimuser/mdmcs11/logs/errfile.log Le message suiant s'affiche si la migration de modules spécifiques a échoué : 18 InfoSphere MDM Collaboration Serer : Guide de migration

37 Summary of the migration Migration of the following modules failed : <module names> Ce message s'affiche s'il existe une différence dans les tables et les index de base de données. Generating database erification report... Changed tables =========================================================== <table names> Missing Tables =========================================================== <table names> Changed Indexes =========================================================== <index names> Missing Indexes =========================================================== <index names> LOG FILE: $TOP/logs/default/default.log Recherchez d'éentuels messages supplémentaires dans le fichier errfile.log. Pour les erreurs SQL, trouez le message d'erreur détaillé à partir du code d'erreur SQL, corrigez l'erreur, puis exécutez de noueau le script de migration. Pour l'action recommandée en cas d'échec de la migration, oir Identification et résolution des problèmes de migration. Contactez IBM Software Support si le problème persiste après aoir corrigé les erreurs. Migration depuis V11.0 ers V11.4 Pour effectuer une migration ers IBM InfoSphere Master Data Management Collaboration Serer Version 11.4 depuis IBM InfoSphere Master Data Management Collaboration Serer Version , ous deez exécuter le script de migration approprié. Chapitre 3. Migration depuis des ersions antérieures 19

38 Aant de commencer Si ous utilisez des noms d'espace table personnalisés au lieu des aleurs USERS ou INDX par défaut, ous deez modifier les noms d'espace table manuellement dans create_pimdb.sh et create_pimdb_for_zlinux.sh dans le dossier $TOP/bin/db_creation. De plus, ous deez modifier les noms d'espace table manuellement dans les fichiers SQL suiants. Cette modification doit être effectuée aant de commencer la migration ers InfoSphere MDM Collaboration Serer V11.4. Tableau 5. Fichiers SQL à modifier lorsque ous utilisez des noms d'espace table personnalisés Fichiers SQL à modifier quand DB2 est la base de données dorsale Fichiers SQL à modifier quand Oracle est la base de données dorsale Remplacez les noms d'espace table USERS, INDX et BLOB_TBL_DATA par les noms d'espace table personnalisés appropriés dans les fichiers SQL suiants dans le répertoire $TOP/src/db/schema/dbscripts/ db2 : Remplacez les noms d'espace table USERS, INDX et BLOB_TBL_DATA par les noms d'espace table personnalisés appropriés dans les fichiers SQL suiants dans le répertoire $TOP/src/db/schema/dbscripts/ oracle : addcaestepentrydate.sql addcehentryid.sql addobhcompanyid.sql addsstshared.sql addsstshared.sql add_icm_index.sql add_lot_index.sql add_sca_index.sql add_sit_index1.sql redefine_ctg_indexes.sql modifyicm1index.sql Pourquoi et quand exécuter cette tâche Vous pouez effectuer une migration ers InfoSphere MDM Collaboration Serer Version 11.4 depuis InfoSphere MDM Collaboration Serer Version GA ou tout groupe de correctifs (1 à 5). Les étapes suiantes constituent l'unique façon d'effectuer une migration depuis InfoSphere MDM Collaboration Serer V ers V11.4. Vous ne pouez pas utiliser l'outil d'exportation et d'importation d'enironnement. Vous pouez configurer l'emplacement du fichier journal des erreurs en modifiant la ariable _ERROR_LOGS dans le script de migration migratefrom1100.sh. Cette ariable est définie sur $TOP/logs/errfile.log par défaut. Procédure 1. Arrêtez l'instance d'infosphere MDM Collaboration Serer ersion en cours d'exécution. 2. Effectuez une copie de sauegarde du schéma de base de données existant. 3. Installez InfoSphere MDM Collaboration Serer V11.4 dans un répertoire différent. 4. Faites pointer l'instance InfoSphere MDM Collaboration Serer V11.4 ers le schéma de base de données de ersion Pour faire pointer l'instance ers la base de données, ajoutez les paramètres de base de données dans le fichier en_settings.ini. Pour plus d'informations, oir Configuration des paramètres communs de la base de données. 20 InfoSphere MDM Collaboration Serer : Guide de migration

39 5. Exécutez le script de migration migratefrom1100fp.sh. Ce script est disponible dans le répertoire $TOP/bin/migration. Consultez la section Results dans le récapitulatif de la migration. Si la migration n'a pas abouti, ous pouez exécuter de noueau le script de migration. 6. Exécutez le script test_db.sh afin de érifier le schéma de base de données, la connectiité entre InfoSphere MDM Collaboration Serer et les bases de données, et pour érifier les connexions client naties et JDBC. Pour plus d'informations, oir test_db.sh script. 7. Démarrez l'instance InfoSphere MDM Collaboration Serer V11.4. Résultats Tous les messages, comme l'état des composants de migration indiiduels et le récapitulatif de migration global, sont affichés dans la console. Après aoir exécuté le script de migration, des messages indiquant que la migration a réussi ou échoué s'affichent. Le message suiant s'affiche si la migration a réussi : Summary of the migration Migration to IBM InfoSphere Master Data Management Collaboration Serer Version is complete. Check the messages for any errors. Generating database erification report... Changed tables =========================================================== There are no changed tables Missing Tables =========================================================== There are no missing tables Changed Indexes =========================================================== There are no changed indexes Missing Indexes =========================================================== Chapitre 3. Migration depuis des ersions antérieures 21

40 There are no missing indexes LOG FILE: $TOP/logs/default/default.log Le message suiant s'affiche si la migration a échoué :!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Migration Failed : xxxx!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Please see the file for further details : /home/pimuser/mdmcs11/logs/errfile.log Le message suiant s'affiche si la migration de modules spécifiques a échoué : Summary of the migration Migration of the following modules failed : <module names> Ce message s'affiche s'il existe une différence dans les tables et les index de base de données. Generating database erification report... Changed tables =========================================================== <table names> Missing Tables =========================================================== <table names> Changed Indexes =========================================================== <index names> Missing Indexes =========================================================== <index names> LOG FILE: $TOP/logs/default/default.log Recherchez d'éentuels messages supplémentaires dans le fichier errfile.log. Pour les erreurs SQL, trouez le message d'erreur détaillé à partir du code d'erreur SQL, corrigez l'erreur, puis exécutez de noueau le script de migration. Pour l'action recommandée en cas d'échec de la migration, oir Identification et 22 InfoSphere MDM Collaboration Serer : Guide de migration

41 résolution des problèmes de migration. Contactez IBM Software Support si le problème persiste après aoir corrigé les erreurs. Migration depuis V11.3 ers V11.4 Pour effectuer une migration ers IBM InfoSphere Master Data Management Collaboration Serer Version 11.4 depuis IBM InfoSphere Master Data Management Collaboration Serer Version 11.3, ous deez exécuter le script de migration approprié. Aant de commencer Si ous utilisez des noms d'espace table personnalisés au lieu des aleurs USERS ou INDX par défaut, ous deez modifier les noms d'espace table manuellement dans create_pimdb.sh et create_pimdb_for_zlinux.sh dans le dossier $TOP/bin/db_creation. De plus, ous deez modifier les noms d'espace table manuellement dans les fichiers SQL suiants. Cette modification doit être effectuée aant de commencer la migration ers InfoSphere MDM Collaboration Serer V11.4. Tableau 6. Fichiers SQL à modifier lorsque ous utilisez des noms d'espace table personnalisés Fichiers SQL à modifier quand DB2 est la base de données dorsale Fichiers SQL à modifier quand Oracle est la base de données dorsale Remplacez les noms d'espace table USERS, INDX et BLOB_TBL_DATA par les noms d'espace table personnalisés appropriés dans les fichiers SQL suiants dans le répertoire $TOP/src/db/schema/dbscripts/ db2 : Remplacez les noms d'espace table USERS, INDX et BLOB_TBL_DATA par les noms d'espace table personnalisés appropriés dans les fichiers SQL suiants dans le répertoire $TOP/src/db/schema/dbscripts/ oracle : addcaestepentrydate.sql addcehentryid.sql addobhcompanyid.sql addsstshared.sql addsstshared.sql add_icm_index.sql add_lot_index.sql add_sca_index.sql add_sit_index1.sql redefine_ctg_indexes.sql modifyicm1index.sql Pourquoi et quand exécuter cette tâche Vous pouez effectuer une migration ers InfoSphere MDM Collaboration Serer Version 11.4 depuis InfoSphere MDM Collaboration Serer Version 11.3 GA. Les étapes suiantes constituent l'unique façon d'effectuer une migration depuis InfoSphere MDM Collaboration Serer V11.3 ers V11.4. Vous ne pouez pas utiliser l'outil d'exportation et d'importation d'enironnement. Vous pouez configurer l'emplacement du fichier journal des erreurs en modifiant la ariable _ERROR_LOGS dans le script de migration migratefrom1130.sh. Cette ariable est définie sur $TOP/logs/errfile.log par défaut. Procédure 1. Arrêtez l'instance InfoSphere MDM Collaboration Serer V11.3 en cours. 2. Effectuez une copie de sauegarde du schéma de base de données existant. Chapitre 3. Migration depuis des ersions antérieures 23

42 3. Installez InfoSphere MDM Collaboration Serer V11.4 dans un répertoire différent. 4. Faites pointer l'instance InfoSphere MDM Collaboration Serer V11.4 ers le schéma de base de données de ersion V11.3. Pour pointer l'instance ers la base de données, ajoutez les paramètres de base de données dans le fichier en_settings.ini. Pour plus d'informations, oir Configuration des paramètres communs de la base de données. 5. Exécutez le script de migration migratefrom1130fp.sh. Ce script est disponible dans le répertoire $TOP/bin/migration. Consultez la section Results dans le récapitulatif de la migration. Si la migration n'a pas abouti, ous pouez exécuter de noueau le script de migration. 6. Exécutez le script test_db.sh afin de érifier le schéma de base de données, la connectiité entre InfoSphere MDM Collaboration Serer et les bases de données, et pour érifier les connexions client naties et JDBC. Pour plus d'informations, oir test_db.sh script. 7. Démarrez l'instance InfoSphere MDM Collaboration Serer V11.4. Résultats Tous les messages, comme l'état des composants de migration indiiduels et le récapitulatif de migration global, sont affichés dans la console. Après aoir exécuté le script de migration, des messages indiquant que la migration a réussi ou échoué s'affichent. Le message suiant s'affiche si la migration a réussi : Summary of the migration Migration to IBM InfoSphere Master Data Management Collaboration Serer Version is complete. Check the messages for any errors. Generating database erification report... Changed tables =========================================================== There are no changed tables Missing Tables =========================================================== There are no missing tables Changed Indexes =========================================================== There are no changed indexes 24 InfoSphere MDM Collaboration Serer : Guide de migration

43 Missing Indexes =========================================================== There are no missing indexes LOG FILE: $TOP/logs/default/default.log Le message suiant s'affiche si la migration a échoué :!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Migration Failed : xxxx!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Please see the file for further details : /home/pimuser/mdmcs11/logs/errfile.log Le message suiant s'affiche si la migration de modules spécifiques a échoué : Summary of the migration Migration of the following modules failed : <module names> Ce message s'affiche s'il existe une différence dans les tables et les index de base de données. Generating database erification report... Changed tables =========================================================== <table names> Missing Tables =========================================================== <table names> Changed Indexes =========================================================== <index names> Missing Indexes =========================================================== <index names> LOG FILE: $TOP/logs/default/default.log Chapitre 3. Migration depuis des ersions antérieures 25

44 Recherchez d'éentuels messages supplémentaires dans le fichier errfile.log. Pour les erreurs SQL, trouez le message d'erreur détaillé à partir du code d'erreur SQL, corrigez l'erreur, puis exécutez de noueau le script de migration. Pour l'action recommandée en cas d'échec de la migration, oir Identification et résolution des problèmes de migration. Contactez IBM Software Support si le problème persiste après aoir corrigé les erreurs. 26 InfoSphere MDM Collaboration Serer : Guide de migration

45 Chapitre 4. Migration de scripts InfoSphere MDM Collaboration Serer Vous pouez utiliser des scripts pour exécuter différentes fonctions dans IBM InfoSphere Master Data Management Collaboration Serer. Les scripts offrent une grande souplesse sans compromettre l'efficience de fonctionnement et la simplicité de déeloppement. Différences entre les scripts dans les dierses ersions La ersion de base utilisée pour IBM InfoSphere Master Data Management Collaboration Serer Version 11.4 est WebSphere Product Center Version 5.0.1, par conséquent il existe des différences de fonctions et de comportements entre la ersion et la ersion Les attributs du type de données Flag renoient des aleurs différentes dans la ersion Dans la ersion 5.2.1, le type de données Flag renoyait une chaîne TRUE/FALSE. Dans la ersion 11.4, le type de données Flag renoie l'équialent d'une aleur booléenne Jaa pouant aoir les aleurs true/false/null. Aussi, lorsque ous comparez un attribut flag, ous deez procéder comme suit : if (flagvalue==null) Si la aleur d'un Flag est imprimée, par exemple,out.write(flagvalue);, les aleurs imprimées seront peut-être null, false ou true. Comme le code est compilé en Jaa lorsque ous utilisez le mode compiled_only_mode, une exception est générée si les scripts IBM InfoSphere Master Data Management Collaboration Serer utilisent des mots clés Jaa comme ariables. De même, les scripts ne se compileront pas s'ils contiennent des ariables qui sont déjà utilisées par InfoSphere MDM Collaboration Serer dans le code généré. Par exemple, logger et hmcontext. Une autre différence majeure existe entre les méthodes qui renoient un ItemSet ou un CategorySet : dans la ersion 5.2.1, si la méthode n'extrayait aucun résultat, elle renoyait null. Dans la ersion 5.3.2, et par conséquent dans la ersion 11.4, ces méthodes renoient un ensemble ide Exemple de méthodes renoyant un ItemSet : getctgitembyattributevalue(string snodepath, String svalue) getitemsetforcategory(catalog ctg [, Boolean ordered]) getitemsetforcatalog() getitemsetforunassigned(categorytree ctr, boolean readonly) getitemsetforprimarykeys(array pkeys, Boolean boptimize) getitemsetforselection() getsubset(iitemset items, Integer start_point [, Integer end_point]) Exemple de méthodes renoyant un CategorySet : getcategoryset([boolean breadonly]) getdescendentcategorysetforcategory([boolean breadonly]) getcategorysetbyattributevalue(string attribpath, Object attribvalue, [Boolean breadonly]) Copyright IBM Corp. 2000,

46 getcategorysetbyprimarykey(string primarykey, [Boolean breadonly]) getcategorysetbyleel(integer leel, [Boolean breadonly]) getcategorysetbyfullnamepath(string[] fullnamepaths, String delimiter ) getcategorysetbyitemsecondaryspec(string specname) getcategorysetbystandalonespec(string specname) getlocationsaddedaailability(categorytree locationhierarchy) getlocationschangedtohaedata(categorytree locationhierarchy) getlocationschangedtohaenodata(categorytree locationhierarchy) getlocationshaingchangeddata(categorytree locationhierarchy) getaailablelocations(object locationorcategorytree) Méthodes aec des signatures différentes dans V6.0 et V11.4 Le tableau suiant compare les opérations de script ajoutées à la bibliothèque de scripts de IBM InfoSphere Master Data Management Collaboration Serer V11.4 : Méthodes aec des signatures différentes dans IBM InfoSphere MDM Serer for PIM V6.0 et InfoSphere MDM Collaboration Serer V11.4. Tableau 7. Comparaison des méthodes aec des signatures différentes dans V6.0 et V11.4 Opérations dans la ersion 6.0 Opérations dans la ersion 11.4 String exporten(enobjectlist enobjlist, String sdocfilepath) String exporten(enobjectlist enobjlist, String sdocfilepath, [String smapfilepath]) Méthodes uniques à la ersion 9.0 reportées à la ersion 11.4 Les méthodes suiantes sont uniquement disponibles dans IBM InfoSphere Master Data Management Collaboration Serer V9.0 et ont été reportées à V11.4. commitdb() new LinkHandler(String wflname) updatelinks(ientryset entryset) New PathSelectionHandler(ICollaborationArea colarea) selectandsetpath(ientryset entryset,string propertyname) MultiMoeHandler(String wflname) moeentries(ientryset entryset,string steppath) loadwf(string filepath) checkoutitem(string wfname, String itemid) checkoutcategory(string wfname, String categoryid,string categorytreename) new ChildCheckinHandler(String wflname) checkinchilds(ientryset entryset, String steppath) TIAttrVerifier(String wflname) erifyattrgroupsandsetexitvalues(ientryset entryset,string [] attrcollectionnames) new GDSXMLDocument(Doc doc/string str) getxmlnodevalue(boolean brequired) setxmlnodevalue (String spath, String alue) getgdsxmlnodename() 28 InfoSphere MDM Collaboration Serer : Guide de migration

47 getxmlnodepath() getgdsxmlnode() addxmlnode(gdsxmlnode xmlnode [,String path]) remoexmlnode(object obj) getxmlnode(string path) clonexmlnode() setvalue(string path, String alue) getgdsxmlnodes(string path) remoeaustinnodes(string path) getxmlstring() getgdsxmlnodefromxmlnode(xmlnode xmlnode) getnewpublicationmessageids() getnewpublicationmessageidsbytype(string[] messagetypes) getpublicationmessageidsbydate(string fromdate, String todate [,String recipientgln]) MessageItemHandler(String messageid) gettradeitems() sendconfirmation(string confirmationtype,string[] messageids) getlinks() changestate() gethierarchytree() getassociatedlinks(string gtin, Boolean fetchchildlinks) getinternalcode() setnodetype(string nodetype) sendcicconfirmationreasoncodes(string confirmationtype,string MsgId,HashMap hmcicreasoncodedata) new CICStatus(String confirmationstatuscode, String confirmationstatuscodedescription, String languageisocode [,String additionalconfirmationstatusdescription] [,String correctieaction] [,String expectedcorrectieinformation]) getparent(int index) getchild(int index) getnumberofchildren() getnumberofparents() getroottradeitem() isleaf() getlinkquantity() createnotification(ibusinessobject iobj, String notftype, String username) new TradeItemSS(String sgtin, String sgtinname, String sproducttype, String sinternalcatcode, [String sdatapoolcatcode]) gettradeitemss(string sgtin,string stm,string sip) settradeitemattributesss(hashmap hmattributepathstovalues) settradeitemattributess(string attributepath,string attributevalue) gettradeitemattributevaluess(string sattrpath) toboolean(string str) Chapitre 4. Migration de scripts InfoSphere MDM Collaboration Serer 29

48 alidategtin(string sgtin) alidategln(string sgln) getgtincategory(string sgtin) getgtintree(string sgtin, String sproducttype, Integer ilinkquantity, String slinkstatus) addchild(gtintree tree) remoechild(string sgtin) saetradeitemss() searchtradeitems(hashmap hmsearchparamstovalues) gettradeitemparentlinks() gettradeitemchildlinks() getmodifiedtradeitems(string transactiontype, Date startdate, Date enddate) getitems() setudexcategorycode(string code) setinternalcategorycode(string code) alidatetradeitem() alidatetradeitemattribute(string sattrpath) alidatetradeitemattributegroup(string sattributegroup) new TradeItemDS(String seanucccode, String seanucccodetype, String sextensionname, String sproducttype,string sgpccode[,string sinternalcatcode,string sgtin,string sgtinname]) getexchangespecificattribute() gettradeitemds(string seanucccode,string stm,string sip,[string sgtin],[string recipientgln]) settradeitemattributesds(hashmap hmattributepathstovalues) settradeitemattributeds(string attributepath,string attributevalue) gettradeitemattributevalueds(string sattrpath) saetradeitemds() getalltradeitemattributes() searchtradeitemsds(hashmap hmsearchparamstovalues) deletetmipvariant() deletegtin() istradeitemcheckedout() getwwreexchangespecificattribute() iswwreinteroperablee() additemss(hashmap sentrymap, String strdate) synchronizeitemchangesss(hashmap sentrymap, String strdate, String operationtype) publishnewitemss(hashmap sentrymap, HashMap tradingpartners,string strdate, String operationtype) sendinitialloadss(hashmap sentrymap, HashMap tradingpartners, String strdate, String operationtype) additemlinksformasstransactionsss(hashmap sentrymap, String strdate) getctgitemattribvalues() readgdspropertiesss(string spropkey) 30 InfoSphere MDM Collaboration Serer : Guide de migration

49 searchtradeitems(hashmap hmsearchparamstovalues,string start, String end) processmasstransaction(string massjobid,hashmap hmsearchparamstovalues) HashMap setmassimportss(boolean bimport) publishpublicationlist(hashmap hmsearchparamstovalues) new TradeItemLink(String parentgtin, String childgtin [,Integer linkquantity]) setlinkattributes(hashmap hmattributenamestovalues [,String informationproider]) setlinkattribute(string attributename,string attributevalue [,String informationproider]) gettradeitemlink(string parentgtin, String childgtin) saetradeitemlink() deletetradeitemlink() getlinkattributevalue(string sattrname) getparentgtin() getchildgtin() new TradingPartner(String sgln, String spartnername, String scountry, String sglnid, String itemtype) new TradingPartner(String sgln, String spartnername, String scountry, String itemtype) gettradingpartner(string sgln) setpartnerattributes(hashmap hmattributepathstovalues) setpartnerattribute(string attributepath,string attributevalue) saetradingpartner() searchtradingpartners(hashmap hmsearchparamstovalues) getpartnerattributevalue(string sattrpath) createtransaction(ibusinessobject iobj, String txntype, String username) isstring() iterator() hasnext() next() islangspecificattr(string sattrpath) getgdslanguages() flushgdscache() new WWREMessageHandler(String wflname) sendmessage(ientryset entryset,string messagetype[, List transactionvolist]) new MessageValidationResult(String smsgid, String smessage) new TradeItemValidationResult(String skey) new AttributeValidationResult(String skey) new ValidationResultObject(String srulename) addvalidationresult(validationresultobject refvalidationresultobject, String smessage, String sstatus, String stype, Object objholder) addvalidationresultobject(abstractvalidationresult refabstractvalidationresult, ValidationResultObject refvalidationresultobject) Chapitre 4. Migration de scripts InfoSphere MDM Collaboration Serer 31

50 addtradeitemvalidationresult(messagevalidationresult refmessagevalidationresult, TradeItemValidationResult reftradeitemvalidationresult) addattributevalidationresult(tradeitemvalidationresult reftradeitemvalidationresult,attributevalidationresult refattributevalidationresult) getvalidationresultobjectlist(abstractvalidationresult refabstractvalidationresult) gettradeitemvalidationresultlist(messagevalidationresult msgvalidationresult) getattributevalidationresultlist(tradeitemvalidationresult tradeitemvalidationresult) setvalidationresultstatus(boolean bstatus) getvalidationresultstatus() setvalidationresultmessage(string message) setlocalizedvalidationresultmessage(string messageid [,String[] arguments]) addlocalizedvalidationresultmessage(string messageid [,String[] arguments]) getvalidationresultmessage() setvalidationresultholder(object holder) getvalidationresultholder() setvalidationresulttype(string stype) getvalidationresulttype() gettradeitemsinmsgitemds(item msgitem) getvalidationresult(abstractvalidationresult refabstractvalidationresult) getmessagetypename(item msgitem) getdatapoolnameformsgitem(item msgitem) new TransactionHandlerDS() inserttransactionds(icollaborationarea colarea,ientryset entryset,string steppathstring,string trasactiontype,string status,string steptrasition) updatetransactionds(icollaborationarea colarea,ientryset entryset,string steppathstring,string trasactiontype,string status,string steptrasition) new StatusUpdaterDS() updatetradeitemglobalstatusds(ientryset entryset,string status) updatetradeitemlocalstatusds(ientryset entryset,string status) updatestatusds(ientryset entryset,string status) new NotificationHandlerDS(String wflname) notifyusersforactionds(ientryset entryset,string action) notifyusersforactionwithstatusds(ientryset entryset,string action) new InternalSyncHandler() synchronize(ientryset entryset) new EnrichmentHandler() canstartenrichment(ientryset entryset) startenrichment(ientryset entryset) new InitialLoadSaer() saeinitloadentries(ientryset entryset) 32 InfoSphere MDM Collaboration Serer : Guide de migration

51 new MessageValidator() checkinitloadandsetexitval(ientryset entryset) new CategoryMappingValidator() erifyandsetexitvalues(ientryset entryset) gettransactiondetails(icollaborationarea colarea,ientryset entryset,string steppathstring,string trasactiontype,string status,string steptrasition) runwftest(string ar1,string arg2, String arg3) createtestdata(string ar1,string arg2) GDSCreateMassPublicationItems(IEntrySet entryset) GDSDeleteMassPublicationItems(IEntrySet entryset) GDSCheckFilters(IEntrySet entryset) LogInboundTransaction(IItem msgitem,string transactiontype, String sendergln, String msgfilepath) TransactionHandlerSS() inserttransactionss(icollaborationarea colarea,ientryset entryset,string steppathstring,string trasactiontype,string status,string steptrasition) updatetransactionss(icollaborationarea colarea,ientryset entryset,string steppathstring,string trasactiontype,string status,string steptrasition) new StatusUpdaterSS() updatestatusss(ientryset entryset,string status) updatetradeitemglobalstatusss(ientryset entryset,string status) updatetradeitemlocalstatusss(ientryset entryset,string status) new NotificationHandlerSS(String wflname) notifyusersforactionss(ientryset entryset,string action) notifyusersforactionwithstatusss(ientryset entryset,string action,string status) inokeworkflowss(hashmap entrymap, String swfname) publishentriestosrccontainer (EntrySet entryset) setldapoperation (LdapOperation operation) setviewableattributegroups (String subviewtype, String[]/AttrGroup[] attrgroups, [String locationhierarchyname]) isitemaailableinlocation (Category location) isbinary () reset () getcurrentlocation () getentryinstep (String steppath) deletelookuptable (LookupTable lkp) assertfalse (Boolean condition, [String message]) getentryattribvalues (String sattribpath) getsearchtemplatename () getldapobjectclasses () getcategoryparentsusingcache (CategoryCache cat_cache) getctgitemlocationattribsforkeys (Category location, Object[] aattribpath [, String sdelimiter]) getaddedattributepathsnewentry ([Category location]) Chapitre 4. Migration de scripts InfoSphere MDM Collaboration Serer 33

52 getitemrootentrynodeshainglocationdata () getentrychangeddatasincelastsae () getdate (int columnindex) addldapattribute (LdapAttribute attribute) getlocationpathforinheritedvalue (String delimiter) getmodifylocationhierarchyaailability (String locationhierarchyname) makeitemaailableinlocations (Category[] locations, [Boolean brecursie]) encodeusingcharset (String charset) getlocationsaddedaailability (CategoryTree locationhierarchy) getentryrelationshipattrib (String sattribpath) new$ldapobjectclass (String objclass) getwflstepview (String subviewtype, [String locationhierarchyname]) getlocationschangedtohaedata (CategoryTree locationhierarchy) setldapdistinguishedname (LdapAttribute dn) getlocation () xmldoctostring () getaailablelocations (Object locationorcategorytree) writefileusingreader (Reader r) seteditableattributegroups (String subviewtype, String[]/AttrGroup[] attrgroups, [String locationhierarchyname]) getdynamicselectionquerystring () setactionmodetoexport (String sactionmode) addldapentry (LdapEntry entry) getldapoperation () getcategory (int columnindex) gethierarchy (int columnindex) remoelocationspecificdata (CategoryTree ctr) parsedate (String alue, String format[,locale locale]) new$searchquery (String querystring) getstepsforentry (Entry entry) getwsdddocpath () setrequiredattributegroups (String subviewtype, String[]/AttrGroup[] attrgroups, [String locationhierarchyname]) getwflstepviews () startexportbyname (String sname) geterrorsforlocation () getint (int columnindex) parsexmlnodewithnamespace (String sxmlsubpath) initializekeyvaluemapping (Object[] akeyset) asserttrue (Boolean condition, [String message]) getctgitemattribsforkeys (Object[] aattribs [, String sdelimiter]) getnodedisplayname ([Locale locale]) getlocationerrors () getldapentries () 34 InfoSphere MDM Collaboration Serer : Guide de migration

53 getrequiredattributegroups ([String subviewtype], [String locationhierarchyname]) getentrychangeddata (Entry oldentry, Entry newentry) getlocalenode (Locale locale) locationhasdata (Category location) execute () makeitemunaailableinlocations (Category[] locations, [Boolean brecursie]) getldapattributes () assertnotnull (Object obj, [String message]) getlocationshaingchangeddata (CategoryTree locationhierarchy) getlocationshaingdata (Object locationorcategorytree) getspec (int columnindex) getitemlocationattrib (Category location, String sattribpath) runquery (String qrystring) getldapattributevalue () definelocationspecificdata (CategoryTree ctr, Spec spc, AttrGroup[] inhattrgrps) new$searchtemplate (String name, Array attrgroupnames, Container container, String desc, [String colareaname, String steppath]) getboolean (int columnindex) setitemlocationdata (Item item, CategoryTree locationtree, String[] locfullpaths, String delimiter, Boolean rootincluded[, Boolean append]) setimplclass (String implclass) isinheriting (Category location, String sattribpath) new$ldapentry () getldapattributetype () setxmlnodevalue (String spath, String alue) parseldiffile (String filename) dropentry (Entry entry) new$dynamicselection (String selectionname, String querystring) makeitemaailableinlocation (Category location, [Boolean brecursie]) getcategorychildrenusingcache (CategoryCache cat_cache) isdefined (int columnindex) getentrynodetype () setauthrequired (Boolean authrequired) flushscriptcache () getlocationsremoedaailability (CategoryTree locationhierarchy) getscriptexecutionmode () getmodifiedattributepathsoldentry ([Category location]) copysearchitemdata (Item searchitem[, Boolean append]) copysearchitemlocationtreedata (Item searchitem, CategoryTree locationtree[, Boolean append]) createldiffile (String docstore_filename, LdapEntrySet entryset) getlong (int columnindex) decodeusingcharset (String charset) Chapitre 4. Migration de scripts InfoSphere MDM Collaboration Serer 35

54 moeentrytonextstep (Entry entry, String steppath, String exitvalue) isauthrequired () getsearchtemplatebyname (String name) getitemrootentrynodeforlocation (Category location) getviewableattributegroups ([String subviewtype], [String locationhierarchyname]) moeentrytocolarea (Entry entry, String destcolareaname) getctgviewtype () getpossibleentrynodevalues () getitemusingentryrelationshipattrib (String sattribpath) jaaarrayfromscriptarray (Array scriptarray, String type) getxmlnode (String nodepath) assertequals (Object expectedvalue, Object actualvalue, [String message]) addldapobjectclass (LdapOperation objectclass) new$ldapentryset () setnodeindexed (Boolean) isnodeindexed () getproductcenterurl - Renoie la propriété trigo_web_url définie dans le fichier common.properties, qui détient l'url absolue, notamment le numéro de port, du site Web où les utilisateurs font pointer leurs naigateurs pour accéder à cette instance d'infosphere MDM Collaboration Serer. assertnull (Object obj, [String message]) setxmlnodevalues (String spath, String[] alues) setmodifylocationhierarchyaailability (String locationhierarchyname, Boolean canmodifyaailability) getflatentrynodesof (EntryNode en) checkoutentry (Entry entry, [String steppath], [boolean waitforstatus) getlocationhierarchynames ([Boolean canmodifyaailability]) getglobalerrors () getitem (int columnindex) getmodifiedattributepathsnewentry ([Category location]) deletectgview (CtgView ctgview) getlocationschangedtohaenodata (CategoryTree locationhierarchy) new$searchselection (Catalog catalog, String name) getdouble (int columnindex) moecursor (int position) getxmlnodes (String spath) getldapobjectclass () new$ldapattribute (String attributetype, Object attributevalue [, Boolean isbinary, Boolean isexternal) getimplclass () getallusers () geteditableattributegroups ([String subviewtype], [String locationhierarchyname]) getxmlnodevalues (String nodepath [, Boolean brequired]) getfloat (int columnindex) 36 InfoSphere MDM Collaboration Serer : Guide de migration

55 makeitemunaailableinlocation (Category location, [Boolean brecursie]) deletesearchtemplate () getdeletedattributepathsoldentry ([Category location]) isexternal () setinheriting (Category location, String sattribpath, [Boolean flag]) setwsdddocpath (String wsdddocpath) getstring (int columnindex) setitemlocationattrib (Category location, String sattribpath, Object svalue) scriptarrayfromjaaarray (OneDimensionalJaaArray) setentryattribvalues (String sattribpath, Object[] svalues) getldapdistinguishedname () executeinbackground (String selectionname) getlocationforerrors () disableentryvalidation(entry collabareaentry, String workflowstepatpath, Boolean disablevalidation) isentrynew() item.getctgitemrelatediteminfo() Remarque : Cette opération de script est obsolète dans WebSphere Product Center Cette opération de script est remplacée par entry::getentryrelationshipattrib(string attribpath) dans InfoSphere MDM Collaboration Serer ersion moeusertoorganization(category srcorg,category dstorg) copyusertoorganizations(category[] organizations) remoeuserfromorganization(category organization) inocationcacheget(string key) inocationcacheput(string key, Object alue) inocationcacheremoe(string key) inocationcacheclear() setdynamicselectionquerystring(string querystring) getexactattributepath() String ExcelCell::getExcelCellEncoding() Changements de comportement des opérations de script à compter des ersions V5.3.2 et V11.4 La liste suiante indique les changements de comportement des opérations de script existantes dans les bibliothèques de script de WebSphere Product Center V5.3.2 et de IBM InfoSphere Master Data Management Collaboration Serer V11.4. setcontainerproperties() Comportement dans la ersion Les propriétés spécifiées dans la mappe de hachage sont définies pour le conteneur en question. Comportement dans V11.4. Chapitre 4. Migration de scripts InfoSphere MDM Collaboration Serer 37

56 Les propriétés spécifiées dans la mappe de hachage sont définies pour le conteneur en question. La clé de mappe de hachage "SCRIPT_NAME" est désormais obsolète et a été remplacée par "POST_SCRIPT_NAME". getcategoryattrib() Comportement dans la ersion Renoie la aleur de l'attribut sattribpath (nom_spécification/ nom_attribut) de cette catégorie. Comportement dans V11.4. Renoie la aleur de l'attribut sattribpath (nom_spécification/ nom_attribut) de cette catégorie, uniquement lorsque l'attribut est inclus dans la collection de ues ou d'attributs. Sinon, la aleur null est renoyée. getentryattrib() Comportement dans la ersion Renoie la aleur de l'attribut sattribpath (nom_spécification/ nom_attribut) de cette entrée. Comportement dans V11.4. Renoie la aleur de l'attribut sattribpath (nom_spécification/ nom_attribut) de cette entrée, uniquement lorsque l'attribut est inclus dans la collection de ues ou d'attributs. Sinon, la aleur null est renoyée. getctgitemattrib() Comportement dans la ersion Renoie la aleur de l'attribut sattribpath (nom_spécification/ nom_attribut) de cet article. Comportement dans V11.4. Renoie la aleur de l'attribut sattribpath (nom_spécification/ nom_attribut) de cet article, uniquement lorsque l'attribut est inclus dans la collection de ues ou d'attributs. Sinon, la aleur null est renoyée. remoenode() Comportement dans la ersion Renoie une aleur booléenne. Comportement dans V11.4. Renoie une aleur ide. settypetoexport() Comportement dans la ersion Définit le type d'objet à exporter. Comportement dans V11.4. Définit le type d'objet à exporter. COLLABORATION_AREA_CONTENT et INHERITANCE_RULES sont retirés de la liste des aleurs acceptables pour sobjecttype. addobjectbynametoexport() Comportement dans la ersion COLLABORATION_AREA_CONTENT est une aleur acceptable pour sobjecttype. Comportement dans V InfoSphere MDM Collaboration Serer : Guide de migration

57 COLLABORATION_AREA_CONTENT est retiré de la liste des aleurs acceptables pour sobjecttype. addallobjectstoexport() Comportement dans la ersion COLLABORATION_AREA_CONTENT est une aleur acceptable pour sobjecttype. Comportement dans V11.4. COLLABORATION_AREA_CONTENT est retiré de la liste des aleurs acceptables pour sobjecttype. disablecontainerprocessingoptions(string[] options) Comportement dans la ersion Désactie les options de traitement indiquées. Comportement dans V11.4. Désactie les options de traitement indiquées. Autres aleurs possibles pour le paramètre Options : ENTRY_BUILD_SCRIPT et UNIQUE_VALIDATION. setentrynodevalue() Comportement dans la ersion Crée un noeud s'il n'en existe pas. 2. Renoie la aleur qui a été définie. Comportement dans V Génère une erreur si le noeud n'est pas déjà présent. Vous deez créer un noueau noeud à l'aide de la méthode entry.setentryattrib(). 2. Renoie 1/0/-1 en fonction de l'action entreprise (succès, aucune modification, erreur). getentrynode() Comportement dans la ersion Lorsqu'une nouelle catégorie ou un nouel article est créé, une occurrence du noeud MultiAttibute est présente par défaut. itemnode.getentrynode("/specformigtest/multi#0/sub-multi#0") Renoie le noeud. 2. Si le chemin d'accès spécifié n'est pas troué, la ersion le crée et renoie le noeud. Renoie Null si le chemin d'accès n'est pas alide. Comportement dans V V11.4 produit une erreur si le chemin d'accès n'est pas déjà présent. 2. V11.4 ne crée pas de noeud. setentrynode() Comportement dans la ersion La ersion le crée et renoie le noeud, ou renoie Null si le chemin d'accès n'est pas alide. Comportement dans V V11.4 produit une erreur si le chemin d'accès n'est pas déjà présent. getentrynodechildren() Comportement dans la ersion La ersion renoie les enfants actuels du noeud de groupe. itemnode = item.getrootentrynode(); node = itemnode.setentrynode("/specformigtest/multi"); Chapitre 4. Migration de scripts InfoSphere MDM Collaboration Serer 39

58 Sortie : SpecForMigTest/Multi/Sub-Multi Comportement dans V V11.4 renoie des occurrences multiples, mais pas les enfants en cours par exemple itemnode = item.getrootentrynode(); node = itemnode.setentrynode("/specformigtest/multi"); Sortie : /SpecForMigTest/Multi#0 /SpecForMigTest/Multi#1 getentrynodes() Comportement dans la ersion Dans la ersion 5.3.2, les enfants sont également renoyés car les chemins d'accès des enfants contiennent le chemin d'accès qui est spécifié dans l'opération de script. itemnode = item.getrootentrynode(); nodes = itemnode.getentrynodes("/specformigtest/multi"); out.writeln(nodes); Comportement dans V V11.4 ne renoie pas d'enfants. getentrynodeparent() Comportement dans la ersion La ersion renoie les parents actuels. itemnode = item.getrootentrynode(); node = itemnode.getentrynodes("/specformigtest/multi#0/sub-multi#0"); out.writeln("node:: " + node[0].getentrynodepath()); out.writeln("node Parents:: " + node[0].getentrynodeparent().getentrynodepath()); Sortie : Node:: SpecForMigTest/Multi/Sub-Multi Node Parents:: SpecForMigTest/Multi Comportement dans V V11.4 renoie le noeud de groupe au lieu des parents en cours. itemnode = item.getrootentrynode(); node = itemnode.getentrynodes("/specformigtest/multi#0/sub-multi#0"); out.writeln("node:: " + node[0].getentrynodepath()); out.writeln("node Parents:: " + node[0].getentrynodeparent().getentrynodepath()); Sortie : Node:: SpecForMigTest/Multi/Sub-Multi Node Parents:: SpecForMigTest/Multi/Sub-Multi getflatentrynodes() Comportement dans la ersion Cette méthode renoie un tableau des EntryNodes non hiérarchiques de cette entrée. Comportement dans V11.4. Cette méthode générait des exceptions dans les ersions précédentes qui étaient prooquées par le script qui effectuait un appel ers getentrynodevalue sur le entrynode renoyé par getflatentrynodes. L'exception est prooquée, car aec le formulaire sérialisé, ous disposez d'un nouel entrynode renoyé par getflatentrynodes : le noeud directory. Pour les attributs indiiduels qui apparaissent plusieurs fois, un élément entrynode supplémentaire est renoyé et son node::type est STRING ou le type de l'attribut. Le script tente d'obtenir la aleur et de la signaler. Un correctif est fourni dans la ersion A présent, une fois que 40 InfoSphere MDM Collaboration Serer : Guide de migration

59 getflatentrynodes a renoyé les noeuds, une nouelle méthode getentrynodetype() érifie son type. Si le type s'aère être V, seul le noeud de l'entrée est traité. Le prototype de la méthode est le suiant : <prototype> <![CDATA[String EntryNode::getEntryNodeType()]]> </prototype> <description> <![CDATA[return "V" = aleur, "G" = groupement ou nieau supérieur du répertoire de spécifications, "M" = répertoire multiple (contient plusieurs occurrences des aleurs ou groupements))]]> </description> L exemple suiant illustre l implémentation. ctg1 = getctgbyname( "<catalog name>" ); itm1 = ctg1.getctgitembyprimarykey( "<clé primaire de l article>" ); ents1 = itm1.getflatentrynodes(); for( i=0; i<ents1.size(); i++ ) { ar al1 = "----"; ar ent1 = ents1[i]; ar epath1 = ent1.getentrynodeexactpath(); out.write( epath1 + " " ); ar type1 = ent1.getentrynodetype(); out.write( type1 + " " ); if( type1 == "V" ) { al1 = "" + ent1.getentrynodevalue(); } else { al1 = "" + ent1.getentrynodechildren().size(); } out.writeln( al1 ); } settypetoexport(string sobjecttype) Comportement dans la ersion COLLABORATION_AREA_CONTENT est une aleur acceptable pour sobjecttype Comportement dans V11.4. COLLABORATION_AREA_CONTENT a été retiré de la liste des aleurs acceptables pour sobjecttype addobjectbynametoexport (String sentityname[, String sobjecttype, [String sactionmode]]) Comportement dans la ersion COLLABORATION_AREA_CONTENT est une aleur acceptable pour sobjecttype Comportement dans V11.4. COLLABORATION_AREA_CONTENT a été retiré de la liste des aleurs acceptables pour sobjecttype addallobjectstoexport ([String sobjecttype, [String sactionmode]]) Comportement dans la ersion COLLABORATION_AREA_CONTENT est une aleur acceptable pour sobjecttype Comportement dans V11.4. COLLABORATION_AREA_CONTENT a été retiré de la liste des aleurs acceptables pour sobjecttype Chapitre 4. Migration de scripts InfoSphere MDM Collaboration Serer 41

60 Changement de comportement des opérations de script à compter des ersions V6.0 et V11.4 La liste suiante indique les changements de comportement des opérations de script existantes dans les bibliothèques de script de IBM InfoSphere Master Data Management Collaboration Serer V6.0 et V11.4. exporten () Comportement dans V6.0. Exporte les objets InfoSphere MDM Collaboration Serer spécifiés dans enobjlist dans le chemin du magasin de documents spécifié. La ariable sdocfilepath contient le chemin du fichier compressé qui est exporté dans le magasin de documents. Cette méthode renoie le journal sous la forme d'une chaîne. Comportement dans V11.4. Exporte les objets InfoSphere MDM Collaboration Serer spécifiés dans enobjlist dans le chemin du magasin de documents spécifié. La ariable sdocfilepath contient le chemin du fichier compressé qui est exporté dans le magasin de documents. Si sdocfilepath est indiqué sous la forme file:/// suii du chemin sur le système de fichiers, le fichier compressé est exporté directement dans le système de fichiers, et non dans le magasin de documents. Le paramètre facultatif smapfilepath est le chemin du nom du fichier de mappage sur le système de fichiers qui fournit l'objet aux mappages de nom de fichier pour les objets en cours d'exportation. Cette méthode renoie le journal sous la forme d'une chaîne. Différences des API Jaa entre les dierses ersions La ersion de base utilisée pour l'api Jaa dans IBM InfoSphere Master Data Management Collaboration Serer Version 11.4 est WebSphere Product Center Version Méthodes et énumérations API Jaa Cette section décrit les nouelles méthodes et énumérations ajoutées aux interfaces qui existent dans IBM InfoSphere MDM Serer for PIM V6.0.0, groupe de correctifs 5, V9.1.0 et IBM InfoSphere Master Data Management Collaboration Serer V11.4. AttributeDefinition.jaa enum: AttributeDefinition.Type: RICH_TEXT et EXTERNAL_CONTENT_REFERENCE ajoutés method: public int getid() AttributeDefinitionProperty.jaa enum AttributeDefinitionProperty.Name: GROUP et LOCALE_NODE obsolètes enum AttributeDefinitionProperty.Name: RICH_TEXT ajouté AttributeInstance.jaa method: public oid setvalueusingjson(object alue) AttributeOwner.jaa method: public AttributeInstance getattributeinstance(int[] nodeidarray, int[] indexarray, boolean bfollowinheritance, boolean createoccurrencesifneeded) 42 InfoSphere MDM Collaboration Serer : Guide de migration

61 Item.jaa method: public OrderedJSONObject tojson(boolean includeattributetype) method: public oid addstatusandaailability(orderedjsonobject itemjsonobj) Catalog.jaa method: public PIMCollection<Item> getitems(int[] itemids) method: public PIMCollection<Item> getitems(object[] itemids) method: public oid setignorecache(boolean ignorecache) method: public boolean getignorecache() method: public boolean iscached() method: public oid setcached(boolean setcached) method: public OrderedJSONObject tojson() CatalogManager.jaa method: public Catalog getcatalog(string catalogname, boolean returnitem) method: public Catalog getcatalog(int catalogid) method: public Catalog getcatalog(int catalogid, boolean returnitem) CategoryCollaborationArea.jaa method: public CollaborationCategory createcollaborationcategory() CollaborationCategory.jaa enum: CollaborationCategory.SaeResult method: public SaeResult getsaeresult() method: public Collection<SecondarySpec> getitemsecondaryspecs() method: public OrderedJSONObject tojson(boolean includeattributetype) method: public oid addstatusandaailability(orderedjsonobject collaborationcategoryjsonobj) method: public oid additemsecondaryspec(secondaryspec spec, Collection<Catalog> catalogs, boolean addtochildcategories, boolean addacrossmapping) method: public oid addsecondaryspec(secondaryspec spec) method: public oid remoeitemsecondaryspec(secondaryspec spec) CollaborationItem.jaa method: public OrderedJSONObject tojson(boolean includeattributetype) method:public oid addstatusandaailability(orderedjsonobject collaborationitemjsonobj) CollaborationStep.jaa method: public CollaborationObject getcollaborationobject(int id) enum ValidationError.Type Les méthodes suiantes sont ajoutées : TOTAL_DIGITS, MIN_EXCLUSIVE, MIN_INCLUSIVE, MAX_EXCLUSIVE, MAX_INCLUSIVE Chapitre 4. Migration de scripts InfoSphere MDM Collaboration Serer 43

62 Context.jaa method: SearchQuery createsearchquery(string querystring, Collection<Item> items, Catalog catalog) method: public String setsaepoint() method: oid rollbacktosaepoint(string name) method: public SearchHelper getsearchhelper() method: public HistoryManager gethistorymanager() method: public MessageBundle getmessagebundle() method: public MessageBundle getmessagebundle(locale locale) method: oid disableallaccesschecking() method: oid enableallaccesschecking() Category.jaa enum: Category.SaeResult method: public Collection<String[]> getfulldisplaypaths() method: public Collection<Integer> getsecondaryspecidsforchildren() method: public OrderedJSONObject tojson(boolean includeattributetype) method: public oid addstatusandaailability(orderedjsonobject categoryjsonobj) method: public View getdefaultview() Hierarchy.jaa method: public Category createcategory() method: public PIMCollection<Category> getcategories(int[] categoryids) method: public PIMCollection<Category> getcategories(object[] categoryids) method: public OrderedJSONObject tojson() HierarchyManager.jaa method: public Hierarchy gethierarchy(int hierarchyid) OrganizationManager.jaa method: public OrganizationHierarchy getorganizationhierarchy(int id) SearchQuery.jaa enum SearchQuery.ColumnType : LOGENTRY added enum: SearchQuery.SearchQueryOp SearchResultSet.jaa method: public UserDefinedLogEntry getuserdefinedlogentry(int columnindex) throws PIMSearchException SelectionManager.jaa method: public Selection getselection(int selectionid) Spec.jaa method: public AttributeDefinition getattributedefinition(int attributedefinitionid) 44 InfoSphere MDM Collaboration Serer : Guide de migration

63 SpecManager.jaa method: public Spec getspec(int specid) EnironmentExporter.jaa method: public String export(exportlist exportlist, String documentpath, String mappingpath) method: public String export(exportlist exportlist, String documentpath, boolean checkforrequisites) checkforrequisites, String mappingpath) method: public String exportall(string documentpath, String mappingpath) SaedSearch.jaa method: public boolean isshared() method: public oid setshared(boolean isshared) method: public int getcreatorid() SearchHelper.jaa method: public SaedSearch createsearchtemplate(catalog catalog, int creatorid, String name, boolean isshared) method: public SaedSearch createsearchtemplate(hierarchy hierarchy, int creatorid, String name, boolean isshared) method: public SaedSearch createsearchtemplate(organizationhierarchy orghierarchy, int creatorid, String name, boolean isshared) method: public SaedSearch createsearchtemplate(collaborationarea collaborationarea, CollaborationStep step, int creatorid, String name, boolean isshared) method: public SaedSearch getsaedsearch(string name, int creatorid) method: public SaedSearch getaccessiblesearchtemplate(string name) method: public Collection<SaedSearch>getSearchTemplates(Filter filter) method: public SaedSearch getpriatedefaultsearchtemplate(pimobject pimobj) method: public SaedSearch getpriatedefaultsearchtemplate(pimobject pimobj, int userid) method: public SaedSearch getshareddefaultsearchtemplate(pimobject pimobj) UIHelper.jaa method: oid openentriesincollaborationareastep(collaborationstep collaborationstep, String additionalpredicates, HttpSerletRequest request, HttpSerletResponse response) LeftPaneDataObject.jaa method: public int getprimaryhierarchyid() Chapitre 4. Migration de scripts InfoSphere MDM Collaboration Serer 45

64 Nouelles API Jaa Cette section décrit les nouelles interfaces introduites dans IBM InfoSphere MDM Serer for PIM V9.1.0 et IBM InfoSphere Master Data Management Collaboration Serer V11.4. Filtrage PIMObject HistoryManager CMSContentURN CMSInstance CMSManager AuthorizationHelper SaedSearch SearchHelper LeftPaneDataObject LeftPaneDataObjectFactory RichTextEditor MessageBundle PackagingTool Modifications des points d'extension Jaa Cette section décrit les modifications apportées aux points d'extension Jaa dans IBM InfoSphere Master Data Management Collaboration Serer V11.4. CollaborationItemPreiewFunctionArguments.jaa new method: PIMCollection<CollaborationItem> getallcollaborationitems() ItemPreiewFunctionArguments.jaa new method: PIMCollection<Item> getallitems() Optimisation de la base de données Vous deez optimiser la base de données en augmentant la taille de pile si le sereur de base de données utilisé est IBM DB2. Aant de commencer Pour optimiser les paramètres de la base de données DB2, ous deez d'abord ous connecter en tant qu'administrateur DB2. Procédure 1. Exécutez les commandes suiantes pour augmenter la taille de pile. db2 update database configuration for database <nom_bdd> using applheapsz 8192 db2 update database configuration for database <nom_bdd> using app_ctl_heap_sz 8192 db2 update database configuration for database <nom_bdd> using LOGFILSIZ 4000 où nom_bdd est le nom réel de l'instance de base de données DB2. Vous pouez connaître les aleurs en cours de ces paramètres à l'aide des commandes suiantes : 46 InfoSphere MDM Collaboration Serer : Guide de migration

65 db2 get dbm cfg db2 get db cfg for <nom_bdd> 2. Exécutez les commandes suiantes pour gérer les conditions de journalisation. update db config for <nom_bdd> using logprimary 10; update db config for <nom_bdd> using logsecond 20; Remarque : Les aleurs des commandes DB2 précédentes sont fournies à titre indicatif. Vous deez demander les aleurs appropriées pour otre enironnement à l'administrateur de la base de données. Chapitre 4. Migration de scripts InfoSphere MDM Collaboration Serer 47

66 48 InfoSphere MDM Collaboration Serer : Guide de migration

67 Chapitre 5. Identification et résolution des incidents Vous pouez utiliser les solutions recommandées pour résoudre les problèmes de migration courants. Identification et résolution des incidents liés aux scripts de migration Vous deez compiler les scripts de migration aant de pouoir les afficher dans la console de script d'ibm InfoSphere Master Data Management Collaboration Serer et les exécuter. Vous pouez également utiliser les fonctions d'infosphere MDM Collaboration Serer pour identifier et résoudre les incidents liés à os scripts. Exécution de scripts de migration compilés Vous deez modifier le fichier common.properties aant d'utiliser des scripts compilés. Aant de pouoir utiliser des scripts compilés, assurez-ous que le fichier common.properties du répertoire $TOP/etc/default contient le paramètre suiant : script_execution_mode = compiled_only Vous pouez désactier la compilation de script pour les scripts indiiduels en insérant la directie suiante au début du script : script_execution_mode=not_compiled Cependant, la désactiation de la compilation de script au nieau du script n'est pas idéale, car elle entraîne une altération importante des performances. Pour éiter toute altération des performances lorsque ous utilisez des scripts non compilés, définissez otre sereur sur not_compiled au lieu d'utiliser l'option de désactiation de la compilation au nieau du script. Si le paramètre de sereur du fichier common.properties est défini sur not_compiled, la compilation de script pour des scripts indiiduels ne peut pas être actiée à l'aide de directies de nieau de script. Remarque : L'utilisation d'une combinaison de scripts compilés et non compilés altère les performances et n'est pas idéale. Si ous deez néanmoins utiliser une telle combinaison, sachez qu'il existe une limitation : un script non compilé peut lancer des fonctions dans un script compilé, mais un script compilé ne peut pas lancer une fonction dans un script non compilé. Erreurs de compilation de script courantes Lorsque ous traaillez aec des scripts compilés, un script peut être enregistré dans la console de scripts s'il se compile correctement. Si une erreur se produit, érifiez sc.out dans le répertoire des journaux appsr afin de consulter la sortie jaac complète et le message d'erreur. Voici quelques erreurs de compilation courantes : 1. Une instruction break ou return à l'intérieur d'un bloc foreach*element() ne se compile pas en raison d'une erreur "Code inaccessible". Pour résoudre cet incident : Copyright IBM Corp. 2000,

68 foreachitemsetelement(itemset, item) { return item; } A remplacer par : foreachitemsetelement(itemset, item) { if (item!= null) { return item; } } Ce code est équialent, mais conient mieux au compilateur. 2. Si ous renoyez une aleur à partir d'une fonction, ous deez renoyer une aleur dans tous les cas. En d'autres termes, ce code ne se compile pas : function sample() { ar e = null; catcherror (e) { // faire quelque chose... return "a string"; } if (e!= null) { reporterror(...); } } Aucune aleur n'est renoyée si une exception se produit dans le bloc catcherror. Vous deez le modifier. function sample() { ar e = null; catcherror (e) { // faire quelque chose... return "a string"; } if (e!= null) { reporterror(...); } return null; } 3. Pour les incidents de compilation plus sérieux, ous pouez consulter les fichiers Jaa générés. Ces fichiers Jaa générés se trouent dans le répertoire spécifié par le paramètre tmp_dir dans common.properties. La conention de dénomination des fichiers Jaa a été récemment modifiée afin d'inclure le nom du script ainsi qu'une séquence générée, par exemple : MyScript12345.jaa. 4. En outre, le chemin d'accès absolu au script depuis le magasin de documents est indiqué sous forme de commentaire en haut de chaque fichier Jaa généré. Si ous mappez le magasin de documents au système de fichiers, ous pouez exécuter une commande grep récursie pour trouer le fichier Jaa qui correspond à un script. Erreurs et incidents d'exécution courants Vous pouez rencontrer certains problèmes lorsque ous exécutez des scripts. Les exemples suiants illustrent certains problèmes connus et ous donnent un aperçu des contournements et solutions possibles. Type d'argument non alide : Cette erreur se produit lorsque ous transférez le mauais type d'argument à une fonction (par exemple, HashMap lorsque Sring est requis). Vous 50 InfoSphere MDM Collaboration Serer : Guide de migration

69 pouez également être confronté à ce type d'erreur lorsqu'ibm InfoSphere Master Data Management Collaboration Serer ne peut pas déduire le type correctement. Pour résoudre cet incident, ous derez peut-être utiliser une opération de script telle que checkstring() afin de rendre le type explicite. Non concordance de type d'arguments dans les comparaisons : Si un même type de données, tel que ==, >, <, <=, n'apparaît pas aux deux extrémités d'un opérateur conditionnel, l'expression a un résultat "false". Dans ce cas, aucun message d'erreur ne s'affiche, mais le code correspondant ne s'exécute pas. Par exemple, le code suiant ne fonctionne pas. ar id = ; ar my_id = item.getentryattrib(chemin d accès à un attribut de type séquence) ; if ( id == my_id) { // instructions qui doient être exécutées mais ne le seront pas } Dans ce cas de figure, la solution consiste à utiliser de manière explicite le code suiant : ar id = ; ar my_id = checkstring(item.getentryattrib(//attribut de type séquence), ) ; if ( id == my_id) { // instructions à exécuter } Analyse XML : Le code suiant utilise le mode non compilé et également le mode compilé lorsqu'il est exécuté depuis l'enironnement sandbox de scripts : new XmlDocument(xmlDoc) ; foreachxmlnode("item") { //faire le nécessaire } Toutefois, en mode compilé, si ce code est utilisé dans une fonction de bibliothèque de scripts lancée par plusieurs utilisateurs, les instructions dans le bloc foreachxmlnode ne sont pas exécutées. Aucun message d'erreur ne s'affiche, mais ous pouez toutefois utiliser le code suiant comme solution de contournement. ar doc = new new XmlDocument(xmlDoc) ; ar xmlnode ; foreachxmlnode(doc, "item", xmlnode) { //faire le nécessaire } Résolution des erreurs et incidents d'exécution Pour résoudre les erreurs d'exécution sur le sereur d'applications, consultez le fichier sc.out dans le répertoire appsr log. L'examen des fichiers exception.log et default.log peut s'aérer utile dans certains cas. Grâce à la nouelle conention de dénomination de fichier Jaa, ous pouez aisément identifier le script défectueux. Le message d'erreur identifie également le numéro de ligne dans le fichier Jaa généré. Pour résoudre l'incident, affichez le fichier Jaa généré et accédez à la ligne qui a engendré l'erreur d'exécution. Le code Jaa généré inclut à présent le code de script actuel sous forme de commentaires, toutes les quelques lignes. Considérons, par exemple, la portion de code suiante issue d'un exemple de fichier Jaa généré : // function checkifpartypartytypeexist(party, partytype) public static Object ScriptFunction checkifpartypartytypeexist(hashmap hmcontext, Object party, Object partytype) throws Exception { // ar bret = false; Object bret = (jaa.lang.boolean) Boolean.FALSE; // ar rootentry = party.getrootentrynode(); Object rootentry = GenGetRootEntryNodeOperation.execute(hmContext, (IEntry) party); // ar entrynodes = rootentry.getentrynodes(getcatalogspecname() + "/Party Types/Party Type Code"); Chapitre 5. Identification et résolution des incidents 51

70 Object entrynodes = GenGetEntryNodesOperation.execute(hmContext, (EntryNode) rootentry, (String) BinaryOperation.execute(BinaryOperation.PLUS, ScriptFunction getcatalogspecname(hmcontext), "/Party Types/Party Type Code")); // ar entrynodessize = entrynodes.size(); Object entrynodessize = (jaa.lang.integer) GenSizeOperation.execute(hmContext, (HashMap) entrynodes); Chaque ligne commençant par // dans les commentaires précédents correspond au code réel issu du script IBM InfoSphere Master Data Management Collaboration Serer correspondant. Cette indication permet ainsi d'identifier plus facilement la ligne qui a engendré l'incident dans le script. Identification et résolution des problèmes de migration Décrit certains problèmes courants pouant surenir lors de la migration dans IBM InfoSphere Master Data Management Collaboration Serer ainsi que des solutions pour y remédier. Problème : exportation de groupes de contrôle d'accès Lors de la migration ers InfoSphere MDM Collaboration Serer, l'erreur suiante, qui est liée à l'exportation des groupes de contrôle d'accès et des des rôles, peut s'afficher : AccessControlGroups Exportation du groupe de contrôle d accès et de rôles pour la société : trigo 7/4/13 6:27 AM DEMARRE : Exporter 7/4/13 6:27 AM DEMARRE : Exportation de AccessControlGroups 7/4/13 6:27 AM INFO : Exclusion de l exportation de [Défaut] 7/4/13 6:27 AM ECHEC : Exportation de AccessControlGroups Cette erreur signale que l'exportation du groupe de contrôle d'accès (ACG) a échoué. Consultez les journaux situés dans le répertoire $TOP/logs/default pour trouer la raison de l'échec. Problème : les questions de migration GDS sont sensibles à la casse Toutes les migrations de groupe de contrôle d'accès GDS antérieures à InfoSphere MDM Collaboration Serer ersion FP011 sont sensibles à la casse et y ou n doit être saisi en minuscules. Aant les migrations InfoSphere MDM Collaboration Serer ersion FP12, un Y ou un N majuscule deait être utilisé pour les questions de migration GDS. Problème : index manquants Lors de la migration ers InfoSphere MDM Collaboration Serer, des index peuent ne pas figurer dans le rapport de la console de migration. Les erreurs suiantes liées aux index manquants peuent se produire lors de la migration : Index manquants dans la table SCA Missing Indexes ============================================================ SCA_0_PK SCA_CATEGORY_IDSCA_SELECTION_IDSCA_COMPANY_IDSCA_ CATALOG_IDSCA_CAT_TREE_ID Vous pouez exécuter ce script PERL pour résoudre ce problème. Choisissez le répertoire db2 ou oracle comme approprié. 52 InfoSphere MDM Collaboration Serer : Guide de migration

71 perl $PERL5LIB/runSQL.pl --sql_file=$top/src/db/schema /dbscripts/<db2 or oracle>/sca_pk.sql Index manquants dans la table DBV Missing Indexes ============================================================ DBV_0_UK DBV_VERSION Vous pouez exécuter ce script PERL pour résoudre ce problème. Choisissez le répertoire db2 ou oracle comme approprié. perl $PERL5LIB/runSQL.pl --sql_file=$top/src/db/schema /gen/<db2 or oracle>/ddl_er_synchronize.sql. $TOP/bin/compat.sh $JAVA_RT com.ibm.ccd.synchronize.dbschemaversion --autoupd Index manquants dans les tables DOA et CTG (DB2 uniquement) Missing Indexes ============================================== CTG_1_UK CTG_COMPANY_IDCTG_NAME DOA_0_UK DOA_DOC_IDDOA_CMP_IDDOA_NAME Vous pouez exécuter ce script PERL pour résoudre ce problème : perl $PERL5LIB/runSQL.pl --sql_command="alter table tctg_ctg_catalog drop constraint ctg_1_uk ;" perl $PERL5LIB/runSQL.pl --sql_command="drop index ictg_ctg_2;" perl $PERL5LIB/runSQL.pl --sql_command="alter table tctg_ctg_catalog add constraint ctg_1_uk unique (ctg_company_id, ctg_name);" perl $PERL5LIB/runSQL.pl --sql_command="create index ictg_ctg_2 on tctg_ctg_catalog ( ctg_name, ctg_company_id) ALLOW REVERSE SCANS;" perl $PERL5LIB/runSQL.pl --sql_command="alter table TDOC_DOA_DOC_ATTRIBUTES drop constraint doa_0_uk ;" perl $PERL5LIB/runSQL.pl --sql_command="drop index idoc_doa_0;" perl $PERL5LIB/runSQL.pl --sql_command="alter table tdoc_doa_doc_attributes add constraint doa_0_uk unique (doa_doc_id, doa_cmp_id, doa_name);" perl $PERL5LIB/runSQL.pl --sql_command="create index idoc_doa_0 on tdoc_doa_doc_attributes ( doa_name, doa_doc_id, doa_cmp_id) ALLOW REVERSE SCANS;" Problème : tables ITX et CAX manquantes Lors de la migration ers InfoSphere MDM Collaboration Serer, l'erreur suiante peut figurer dans le rapport de érification BD : Missing Tables =========================================================== TCTG_CAX_CATEGORY_CONTENT TCTG_ITX_ITEM_CONTENT Chapitre 5. Identification et résolution des incidents 53

72 Missing Indexes CAX_0_PK CAX_ENTRY_IDCAX_NEXT_VERSION_ID ITX_0_PK ITX_ENTRY_IDITX_NEXT_VERSION_ID Cette erreur indique un problème de création d'espace table, d'installation XDB ou de paramètres db. Vérifiez le fichier errfile.log dans le répertoire $TOP/logs pour connaître le message exact. Vérifiez que la base de données est correctement configurée et exécutez de noueau le script de migration. Problème : priilèges insuffisants Lorsque ous exécutez un script de migration ers InfoSphere MDM Collaboration Serer, une erreur de priilèges insuffisants peut figurer sur la console. Exemples d'erreurs types : Base de données Oracle Lorsque ous utilisez une base de données Oracle, l'erreur peut se présenter comme suit : create index icnt_eem_2 on tcnt_eem_entry_entry_map ( * ERROR at line 1: ORA-01031: insufficient priileges Base de données DB2 Dans le cas d'une base de données DB2, l'erreur se présente comme suit : SQL0551N "USERNAME" does not hae the priilege to perform operation "CREATE INDEX" on object "USERNAME.TWFL_WFE_WORKFLOW_EVENT". SQLSTATE=42501 L'utilisateur de la base de données ne possède pas de priilèges suffisants lui permettant de créer un index dans la base de données. Vous deez accorder le priilège "create index" à l'utilisateur de la base de données, puis exécuter de noueau le script de migration. Vous deez également accorder l'accès à l'utilisateur afin qu'il puisse créer et modifier des tables. Problème : échec du script de migration Lorsque ous exécutez un script de migration ers InfoSphere MDM Collaboration Serer, le script peut échouer. Scénario type d'échec de script : Echec dans module data_maintenance_reports Summary of the migration Migration of the following modules failed: data_maintenance_reports Le fichier $TOP/logs/errfile.log a le contenu suiant : net.sf.ehcache.distribution. MulticastKeepalieHeartbeatReceier$MulticastReceierThreadrun SEVERE: Multicast receier thread caught throwable. Cause was null. Continuing... Cette erreur indique un problème au nieau des paramètres de configuration de cache, mais le script de migration s'est exécuté et a abouti. Vérifiez les paramètres de configuration de cache. Il n'est pas nécessaire de réexécuter le script de migration. 54 InfoSphere MDM Collaboration Serer : Guide de migration

73 Remarques Remarques Le présent document a été déeloppé pour des produits et des serices disponibles aux Etats-Unis et peut être mis à disposition par IBM dans d'autres langues. Toutefois, il peut être nécessaire de posséder une copie du produit ou de la ersion du produit dans cette langue pour pouoir y accéder. Le présent document peut contenir des informations ou des références concernant certains produits, logiciels ou serices IBM non annoncés dans ce pays. Pour plus d'informations sur les produits et serices disponibles dans otre pays, contactez otre partenaire commercial IBM. Toute référence à un produit, programme ou serice IBM n'implique pas que seul ce produit, programme ou serice IBM peut être utilisé. Tout autre élément fonctionnellement équialent peut être utilisé, s'il n'enfreint aucun droit d'ibm. Il est de la responsabilité de l'utilisateur d'éaluer et de érifier lui-même les installations et applications réalisées aec des produits, logiciels ou serices non expressément référencés par IBM. IBM peut détenir des breets ou des demandes de breets courant les produits mentionnés dans le présent document. La remise de ce document ne ous donne aucun droit de licence sur ces breets ou demandes de breet. Si ous désirez receoir des informations concernant l'acquisition de licences, euillez en faire la demande par écrit à l'adresse suiante : IBM Director of Licensing IBM Corporation North Castle Drie Armonk, NY U.S.A. Pour le Canada, euillez adresser otre courrier à : IBM Director of Commercial Relations IBM Canada Ltd 3600 Steeles Aenue East Markham, Ontario L3R 9Z7 Canada Les informations sur les licences concernant les produits utilisant un jeu de caractères double octet peuent être obtenues par écrit à l'adresse suiante : Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan Ltd , Nihonbashi-Hakozakicho, Chuo-ku Tokyo , Japon Le paragraphe suiant ne s'applique ni au Royaume-Uni, ni dans aucun pays dans lequel il serait contraire aux lois locales. LE PRESENT DOCUMENT EST LIVRE "EN L'ETAT" SANS AUCUNE GARANTIE EXPLICITE OU IMPLICITE. IBM DECLINE NOTAMMENT TOUTE RESPONSABILITE RELATIVE A CES INFORMATIONS EN CAS DE CONTREFACON AINSI QU'EN CAS DE DEFAUT Copyright IBM Corp. 2000,

74 D'APTITUDE A L'EXECUTION D'UN TRAVAIL DONNE. Certaines juridictions n'autorisent pas l'exclusion des garanties implicites, auquel cas l'exclusion ci-dessus ne ous sera pas applicable. Le présent document peut contenir des inexactitudes ou des coquilles. Ce document est mis à jour périodiquement. Chaque nouelle édition inclut les mises à jour. IBM peut, à tout moment et sans préais, modifier les produits et logiciels décrits dans ce document. Les références à des sites Web non IBM sont fournies à titre d'information uniquement et n'impliquent en aucun cas une adhésion aux données qu'ils contiennent. Les éléments figurant sur ces sites Web ne font pas partie des éléments du présent produit IBM et l'utilisation de ces sites relèe de otre seule responsabilité. IBM pourra utiliser ou diffuser, de toute manière qu'elle jugera appropriée et sans aucune obligation de sa part, tout ou partie des informations qui lui seront fournies. Les licenciés souhaitant obtenir des informations permettant : (i) l'échange des données entre des logiciels créés de façon indépendante et d'autres logiciels (dont celui-ci), et (ii) l'utilisation mutuelle des données ainsi échangées, doient adresser leur demande à : IBM Corporation J46A/G4 555 Bailey Aenue San Jose, CA U.S.A. Ces informations peuent être soumises à des conditions particulières, préoyant notamment le paiement d'une redeance. Le logiciel sous licence décrit dans ce document et tous les éléments sous licence disponibles s'y rapportant sont fournis par IBM conformément aux dispositions du Liret contractuel IBM ou des Conditions Internationales d'utilisation de Logiciels IBM o u de tout autre contrat équialent. Les données de performance indiquées dans ce document ont été déterminées dans un enironnement contrôlé. Par conséquent, les résultats peuent arier de manière significatie selon l'enironnement d'exploitation utilisé. Certaines mesures éaluées sur des systèmes en cours de déeloppement ne sont pas garanties sur tous les systèmes disponibles. En outre, elles peuent résulter d'extrapolations. Les résultats peuent donc arier. Il incombe aux utilisateurs de ce document de érifier si ces données sont applicables à leur enironnement d'exploitation. Les informations concernant des produits non IBM ont été obtenues auprès des fournisseurs de ces produits, par l'intermédiaire d'annonces publiques ou ia d'autres sources disponibles. IBM n'a pas testé ces produits et ne peut confirmer l'exactitude de leurs performances ni leur compatibilité. Elle ne peut receoir aucune réclamation concernant des produits. Toute question concernant les performances de produits non IBM doit être adressée aux fournisseurs de ces produits. Toute instruction relatie aux intentions d'ibm pour ses opérations à enir est susceptible d'être modifiée ou annulée sans préais, et doit être considérée uniquement comme un objectif. 56 InfoSphere MDM Collaboration Serer : Guide de migration

75 Le présent document peut contenir des exemples de données et de rapports utilisés couramment dans l'enironnement professionnel. Ces exemples mentionnent des noms fictifs de personnes, de sociétés, de marques ou de produits à des fins illustraties ou explicaties uniquement. Toute ressemblance aec des noms de personnes, de sociétés ou des données réelles serait purement fortuite. LICENCE DE COPYRIGHT : Le présent logiciel contient des exemples de programme d'application en langage source destinés à illustrer les techniques de programmation sur différentes plateformes d'exploitation. Vous aez le droit de copier, de modifier et de distribuer ces exemples de programmes sous quelque forme que ce soit et sans paiement d'aucune redeance à IBM à des fins de déeloppement, d'utilisation, de ente ou de distribution de programmes d'application conformes aux interfaces de programmation des plateformes pour lesquels ils ont été écrits ou aux interfaces de programmation IBM. Ces exemples de programmes n'ont pas été rigoureusement testés dans toutes les conditions. Par conséquent, IBM ne peut garantir expressément ou implicitement la fiabilité, la maintenabilité ou le fonctionnement de ces programmes. Les programmes exemples sont fournis "EN L'ÉTAT", sans garantie d'aucune sorte. IBM ne sera en aucun cas responsable des dommages liés à l'utilisation de ces programmes. Toute copie totale ou partielle de ces programmes exemples et des oeures qui en sont dériées doit comprendre une notice de copyright, libellée comme suit : (nom de otre entreprise) (année). Des segments de code sont dériés des Programmes exemples d'ibm Corp. Copyright IBM Corp. _saisissez l'année ou les années_. All rights resered. Si ous isualisez ces informations en ligne, il se peut que les photographies et illustrations en couleur n'apparaissent pas à l'écran. Politique de protection des renseignements personnels Les produits logiciels IBM, y compris les logiciels sous forme de solutions de serice ("offres logicielles") peuent utiliser des cookies ou d'autres technologies en ue de collecter des informations sur l'utilisation des produits, d'améliorer l'expérience de l'utilisateur final et d'adapter les interactions aec celui-ci ou à d'autres fins. Dans de nombreux cas, aucune information identifiant la personne n'est collectée par les offres logicielles. Certaines de nos offres logicielles peuent ous permettre de collecter des informations identifiant la personne. Si cette offre logicielle utilise des cookies pour collecter des informations identifiant la personne, les informations collectées par les cookies sont stipulées ci-dessous. Selon les configurations déployées, cette offre logicielle peut utiliser des cookies persistants et de session qui collectent pour chaque utilisateur un nom d'utilisateur, un mot de passe, un nom de profil ou d'autres informations identifiant la personne à des fins de gestion de session, d'authentification, de coniialité utilisateur aancée, de configuration de connexion unique ou d'identification de page Web que l'utilisateur a tenté de charger aant de se connecter. Ces cookies peuent être désactiés, mais dans ce cas, les fonctionnalités qui leur sont associées seront très probablement désactiées. Si les configurations déployées pour cette offre logicielle ous permettent, en tant que client, de collecter des informations identifiant la personne à partir des utilisateurs finals ia des cookies et d'autres technologies, ous deez consulter Remarques 57

76 otre conseiller juridique au sujet des lois qui s'appliquent à une telle opération de collecte de données, y compris les exigences en matière de notification et d'accord. Pour plus d'informations sur les différentes technologies, y compris les cookies, utilisées à ces fins, consultez les Points principaux de la Déclaration IBM de confidentialité sur Internet ( et la Déclaration IBM de confidentialité sur Internet ( et notamment la section intitulée "Cookies, pixels espions et autres technologies", ainsi que l'article "IBM Software Products and Software-as-a-Serice Priacy Statement" ( Remarques générales relaties à la sécurité du produit L'implémentation des systèmes et produits IBM repose sur une approche de sécurité globale pouant impliquer l'utilisation d'autres systèmes, produits ou serices pour être pleinement efficaces. Cette approche de sécurité globale doit être érifiée dès qu'un système ou un produit est ajouté à otre enironnement. Aucun système ou produit informatique ne peut être complètement sécurisé et aucun produit ni aucune mesure de sécurité ne peut être totalement infaillible contre les accès non autorisés. La sécurité des systèmes informatiques implique la protection des systèmes et des informations par la préention, la détection et la réponse aux accès non autorisés au sein et à l'extérieur de otre entreprise. Un accès non autorisé peut se traduire par la modification, la destruction ou l'appropriation illicite de os informations, ainsi que par l'utilisation maleillante de os systèmes en ue d'attaquer d'autres systèmes. IBM ne garantit en aucun cas l'immunité des systèmes et produits contre les conduites illicites ou maleillantes de tiers. IBM ne connaît aucun processus totalement efficace pour aider à identifier et à adresser les problèmes de ulnérabilité en matière de sécurité. IBM adopte une approche de superposition multiple : Une initiatie interne encourage en continu l'adoption cohérente de pratiques de sécurité lors du déeloppement de produits et de serices dans le but d'améliorer de manière durable les caractéristiques de qualité et de sécurité de tous les produits et serices IBM. Cette initiatie est décrite dans la section Security in Deelopment: The IBM Secure Engineering Framework du IBM Redguide, qui contient des informations publiques sur les pratiques d'ibm en matière de déeloppement logiciel. Les tests et analyses des produits IBM utilisent dierses technologies IBM isant à identifier et à résoudre les défauts et problèmes de ulnérabilité, y compris les cas séères ou critiques. Une résolution est mise en place à l'intérieur d'un délai de réponse cible défini par IBM pour l'analyse, l'éaluation de l'impact et la liraison d'un correctif. L'équipe PSIRT (IBM Product Security Incident Response Team) gère la réception, l'inestigation et la coordination interne des informations relaties à la ulnérabilité de l'offre IBM en matière de sécurité. L'équipe PSIRT d'ibm agit en tant que coordinateur et peut être contactée par les chercheurs, groupes industriels, organisations gouernementales, fournisseurs et clients ia le portail PSIRT d'ibm dès qu'un cas de ulnérabilité potentiel est détecté sur un produit IBM. Cette équipe se met alors en relation aec les équipes produits et solutions d'ibm afin d'examiner et d'identifier le plan de réponse adéquat. 58 InfoSphere MDM Collaboration Serer : Guide de migration

77 Une structure et un programme d'intégrité de la chaîne d'approisionnement d'ordre mondial offre aux acheteurs de produits informatiques une sélection de fournisseurs et de partenaires technologiques accrédités dans le forum OTTF (Open Group Trusted Technology Forum). La sécurité des logiciels et des systèmes informatiques étant très complexe, IBM ne fournit aucun type d'information sur les pratiques de déeloppement de produits spécifiques autres que celles publiées dans la documentation produit standard ou ia les actiités publiques d'ibm. Les informations publiques portant sur les pratiques de déeloppement logiciel recommandées par IBM sont documentées dans l'ibm Secure Engineering Framework. Ces informations compilent les pratiques des dierses unités commerciales et équipes de déeloppement d'ibm. Dans la plupart des cas, les ulnérabilités publiées sont documentées de façon périodique ia les IBM Security Bulletins, ainsi que le score de base CVSS associé. Il peut également arrier qu'ibm contacte ses clients par oie directe et discrète au sujet d'un problème de ulnérabilité particulier. Les clients souhaitant pousser l'analyse de la ulnérabilité de l'offre logicielle IBM au delà de analyses réalisées en interne par IBM sont inités à réaliser leurs propres analyses sur des logiciels sous licence. Pour ceci, ils pourront utiliser l'outil de leur choix dans la mesure où celui-ci répond aux termes de licence existants du logiciel. Par exemple, l'analyse est autorisée, mais la compilation inerse ou l'ingénierie inerse d'un logiciel IBM est interdite, sauf autorisation légale expresse sans possibilité de renonciation contractuelle. Marques IBM, le logo IBM et ibm.com sont des marques d'international Business Machines Corp., dans de nombreux pays. Les autres noms de produits et de serices peuent être des marques d'ibm ou d'autres sociétés. La liste actualisée de toutes les marques d'ibm est disponible sur la page Web "Copyright and trademark information" à l'adresse Les termes qui suient sont des marques d'autres sociétés : Adobe, le logo Adobe, PostScript et le logo PostScript sont des marques d'adobe Systems Incorporated aux Etats-Unis et/ou dans d'autres pays. IT Infrastructure Library est une marque de The Central Computer and Telecommunications Agency qui fait désormais partie de The Office of Goernment Commerce. Linear Tape-Open, LTO, le logo LTO, Ultrium et le logo Ultrium sont des marques de HP, IBM Corp. et Quantum aux Etats-Unis et dans d'autres pays. Intel, le logo Intel, Intel Inside, le logo Intel Inside, Intel Centrino, le logo Intel Centrino, Celeron, Intel Xeon, Intel SpeedStep, Itanium, et Pentium sont des marques d'intel Corporation ou de ses filiales aux Etats-Unis et dans certains autres pays. Linux est une marque de Linus Toralds aux Etats-Unis et/ou dans certains autres pays. Remarques 59

78 Microsoft, Windows, Windows NT et le logo Windows sont des marques de Microsoft Corporation aux Etats-Unis et/ou dans certains autres pays. Jaa ainsi que tous les logos et les marques incluant Jaa sont des marques d'oracle et/ou de ses sociétés affiliées. Cell Broadband Engine est une marque de Sony Computer Entertainment, Inc. aux Etats-Unis et/ou dans d'autres pays et est utilisée sous licence. ITIL est une marque communautaire du Bureau du Cabinet britannique déposée auprès de l'office des breets américain. UNIX est une marque enregistrée de The Open Group aux Etats-Unis et/ou dans d'autres pays. 60 InfoSphere MDM Collaboration Serer : Guide de migration

79 Index Nombres , 46 A api jaa énumérations 42 interfaces 46 méthodes 42 B base de données gds 46 C commentaires enoi xi D différences des API Jaa 42 différences entre les scripts 27 E enoi de commentaires F fonctions noueautés dans la ersion 11.4 I identification et résolution des incidents contacter le support logiciel IBM xiii problèmes de migration 52 informations associées xi informations sur les prérequis xi J Jaa points d'extension 46 xi xi mentions légales 55 migration identification et résolution des incidents liés aux scripts de migration 49 initiation 3 migration depuis des ersions antérieures 5 migration depuis 10.0 ers migration depuis ers migration depuis ers migration depuis 11.3 ers migration depuis ers présentation 1 problèmes 49 scripts 27, 49 O optimisation 46 S script différences 28 méthodes dans V scripts changement de comportement à compter des ersions V6.0 et V changements de comportement à compter des ersions V5.3.2 et V compilation et débogage 49 erreurs d'exécution courantes 50 erreurs de compilation courantes 49 résolution des erreurs d'exécution 51 serices logiciels contacter 63 support client 63 Support clients contacter 63 V V M marques liste de 55 Copyright IBM Corp. 2000,

80 62 InfoSphere MDM Collaboration Serer : Guide de migration

81 Comment prendre contact aec IBM Vous pouez contacter IBM pour bénéficier du serice de support technique et des serices de logiciels et pour obtenir des informations sur les produits et des informations générales. Vous pouez également transmettre os commentaires à IBM sur les produits et la documentation. Le tableau ci-dessous répertorie les ressources disponibles dans les domaines suiants : support technique, serices logiciels, formation et informations relaties aux produits et aux solutions. Tableau 8. Ressources IBM Ressource Documentation produit d'infosphere MDM Documentation du produit InfoSphere MDM Custom Domain Hub, y compris InfoSphere MDM Reference Data Management Portail de support IBM Serices de logiciels Mon site IBM Formation et certification Interlocuteurs IBM Description et emplacement Vous pouez parcourir tous les documents InfoSphere MDM et y faire des recherches à l'adresse infocenter/mdm/11r0/index.jsp. Vous pouez effectuer des recherches dans tous les documents InfoSphere MDM Custom Domain Hub et les parcourir à l'adresse infocenter/mih/11r0/index.jsp. Vous pouez personnaliser les informations de support en sélectionnant les produits et les rubriques qui ous intéressent sur le site Pour plus d informations sur les serices de conseil en logiciels, en technologies de l'information et sur les serices-conseils en affaires, isitez le site businesssolutions/. Vous pouez gérer les liens ers les sites Web IBM et ers les informations de support technique qui correspondent à os besoins spécifiques en créant un compte Mon site IBM à l'adresse Vous pouez décourir les serices de formation et les formations techniques conçus pour permettre aux indiidus, sociétés et organismes publics d'acquérir, d'entretenir et d'optimiser leurs compétences en informatique à l'adresse Vous pouez contacter un interlocuteur IBM pour en saoir plus sur les solutions à l'adresse en/. Enoyer un commentaire Le tableau ci-dessous explique comment adresser os commentaires sur les produits et la documentation à IBM. Copyright IBM Corp. 2000,

82 Tableau 9. Transmission de commentaires à IBM Type de commentaires Action Commentaires sur le produit Vous pouez transmettre des commentaires généraux sur les produits ia l'enquête de satisfaction sur la coniialité et la qualité des produits disponible sur le site consumability/. Commentaires sur la documentation Pour laisser un commentaire sur le centre de documentation, cliquez sur le lien Commentaires en haut à droite dans n'importe quelle rubrique du centre de documentation. Vous pouez également enoyer des commentaires sur les manuels au format PDF, le centre de documentation ou d'autres documentations en suiant l'une des procédures ci-dessous : Utilisation du formulaire de commentaire en ligne : rcf/ Message électronique : [email protected] 64 InfoSphere MDM Collaboration Serer : Guide de migration

83

84 SC