Dans le cadre des déploiements IBM® Enterprise
Records,
l'outil d'exportation et d'importation de plan de fichiers permet d'importer un plan de fichiers externe ou d'exporter un plan de fichiers vers un environnement externe. L'outil exécute les processus d'importation et d'exportation à l'aide d'un fichier XML.
Généralités
Pour plus d'informations sur la modification d'un fichier XML exporté en vue d'y inclure un héritage de planning, les conservations alternatives, les déclencheurs d'élimination et les mises en attente dynamique (conditionnelles), consultez la section relative à l'outil d'importation/exportation de plan de fichiers dans
http://www-01.ibm.com/support/docview.wss?rs=3247&uid=swg27010422.
Limitations
L'outil d'importation/exportation de plan de fichiers facilite la migration des plans de fichiers. Toutefois, l'outil ne prend pas en charge les éléments suivants :
- Exportation/importation entre modèles de données différents. Si l'exportation est effectuée à partir d'une librairie d'un modèle de données PRO, par exemple, vous ne pouvez pas réaliser d'importation vers une librairie d'un modèle de données DoD.
- Exportation ou importation d'enregistrements, de volumes, de documents, de données de sécurité et de marquages de sécurité.
- Mécanisme de retour arrière.
- Exportation de propriétés de valeur NULL. Par exemple, l'exportation d'une phase de planning d'élimination sans période de conservation, puis sa ré-importation dans une librairie différente ne redéfinit pas la période de conservation sur la valeur NULL. Vous pouvez néanmoins modifier manuellement le fichier XML pour mettre à jour la période de conservation. Pour plus d'informations, voir le manuel ftp://ftp.software.ibm.com/software/data/cm/filenet/docs/p8doc/40x/P840_Troubleshooting.pdf.
Par ailleurs, les propriétés et classes personnalisées (telles que les listes de choix) doivent d'abord être exportées et importées dans un fichier XML distinct avant l'importation du reste du plan de fichiers. De plus, après l'importation d'un plan de fichiers, les états d'entités du type
Fermé ou
Prêt pour l'élimination ne sont plus en vigueur.
Exécution de l'outil
Vous pouvez lancer l'outil d'importation/exportation de plan de fichiers à partir d'une ligne de commande Java exécutable ou démarrer l'outil grâce au fichier de commandes
FilePlanTool.bat ou
FilePlanTool.sh.
Vous pouvez exécuter l'outil dans l'un des cinq modes suivants :
- Configuration - affiche une boîte de dialogue qui permet de spécifier des données nécessaires telles que le nom de serveur Content Engine (CE), le nom de librairie, le nom d'utilisateur et le mot de passe de l'administrateur, ainsi que le mode (importation ou exportation).
- Exportation - crée un fichier XML entièrement compatible et conforme que vous pourrez ultérieurement importer dans un autre environnement.
- Importation/mise à jour - importe un fichier XML spécifié dans un environnement.
- Validation - parcourt un fichier XML pour vérifier sa compatibilité et sa conformité.
Exportation d'un plan de fichiers
Si le plan de fichiers que vous souhaitez exporter contient l'un des éléments suivants :
- classes ou propriétés personnalisées ;
- plus de 300 000 dossiers ;
- une catégorie d'enregistrement comprenant plus de 15 000 dossiers.
Voir
Exportation d'un plan de fichiers à l'aide de l'option étendue.
Après avoir configuré l'outil, vous pouvez l'utiliser pour exporter un plan de fichiers.
Pour exporter un plan de fichiers, entrez la commande suivante :
FilePlanTool -mode export -fileplan nom_plan_fichiers -o nom_fichier_XML.xml où nom_plan_fichiers est le nom du plan de fichiers à exporter et est obligatoire. Si le nom de plan de fichiers contient des espaces ou des caractère spéciaux, placez nom_plan_fichiers entre guillemets.
nom_fichier_XML est le nom et le chemin du fichier à créer. Si vous ne saisissez pas de nom de fichier dans la ligne de commande, l'outil utilise le nom de fichier par défaut spécifié dans le champ Nom du fichier de sortie de la boîte de dialogue de configuration de l'outil. Pour plus d'informations sur la spécification du nom de fichier de sortie XML par défaut, voir Configuration de l'outil.
Exportation d'un plan de fichiers à l'aide de l'option étendue
Lors de l'exportation d'un plan de fichiers, utilisez l'option étendue pour les plans de fichiers volumineux ou contenant des classes ou propriétés personnalisées. Pour exporter un plan de fichiers à l'aide de l'option étendue, saisissez la commande suivante :
FilePlanTool -mode export -fileplan nom_plan_fichiers -o nom_fichier_XML.xml -scope paramètre
où nom_plan_fichiers est le nom du plan de fichiers à exporter et est obligatoire. Si le nom de plan de fichiers contient des espaces ou des caractère spéciaux, placez nom_plan_fichiers entre guillemets.
nom_fichier_XML est le nom et le chemin du fichier à créer.
Si vous ne saisissez pas de nom de fichier dans la ligne de commande, l'outil utilise le nom de fichier par défaut spécifié dans le champ Nom du fichier de sortie de la boîte de dialogue de configuration de l'outil. L'utilisation de l'outil avec l'option étendue implique la création d'un fichier XML pour chaque partie du plan de fichiers.
Vous devez donc spécifier un nom de fichier XML différent à chaque utilisation de l'outil en mode exportation. Pour plus d'informations sur la spécification du nom de fichier de sortie XML par défaut, voir Configuration de l'outil.
La variable
paramètre peut prendre les valeurs suivantes :
- metadata - Ce paramètre est nécessaire si votre plan de fichiers comprend des classes ou propriétés personnalisées. L'option de paramètre metadata crée un fichier XML distinct pour les classes et propriétés personnalisées. Ainsi, lorsqu'un plan de fichiers comprend des classes ou propriétés personnalisées, les processus d'exportation et d'importation consistent chacun en deux étapes :
- une étape pour les classes et propriétés personnalisées
- une étape pour le reste du plan de fichiers. En l'absence d'utilisation du paramètre metadata, l'outil exporte le plan de fichiers sans les propriétés personnalisées.
- includecategory "nom_catégorie_enregistrement" - Ce paramètre sert à exporter une catégorie d'enregistrement spécifique.
Lorsque ce paramètre est employé, l'outil exporte toutes les sous-catégories et sous-dossiers compris dans la catégorie d'enregistrement spécifiée. Le nom_catégorie_enregistrement doit inclure le chemin complet dans IBM Enterprise
Records. Par exemple, pour exporter tous les enfants de la catégorie d'enregistrement nommée "Cat03" contenue dans "Cat02" à son tour contenue dans "Cat01", tapez la commande suivante :
FilePlanTool.bat -mode export -scope includecategory
"/Cat01/Cat02/Cat03" -o fichier_export.xml
- includecategories fichier 01 -
Ce paramètre permet de n'exporter que les catégories d'enregistrement et leurs enfants spécifiés dans le fichier texte d'entrée fichier 01.
Utilisez le paramètre includecategories pour exporter un nombre important de catégories d'enregistrement vers un même fichier sans spécifier chaque nom de catégorie d'enregistrement dans la ligne de commande. Pour utiliser ce paramètre, tapez la ligne de commande suivante ;:
FilePlanTool.bat -mode export -scope includecategories file01.txt -o export01.xml
File01.txt contient :
/categoryB /CategoryC/SubcategoryC2 /CatogoryA/SubcategoryA1
Le nom de catégorie est représenté par le chemin complet et une catégorie d'enregistrement par ligne.
- excludecategory "nom_catégorie_enregistrement_à_exclure" - Ce paramètre sert à exclure une catégorie d'enregistrement spécifique et ses enfants. Par exemple, si nom_catégorie_enregistrement_à_exclure est "Cat01/Cat02/Catlarge", l'outil exporte toutes les catégories et dossiers d'enregistrement du plan de fichiers à l'exception des catégories et dossiers d'enregistrement compris dans le noeud "Cat01/Cat02/Catlarge". Ce paramètre opère de façon similaire à includecategory.
- excludecategory fichier 02 - Ce paramètre permet d'exclure les sous-arborescences des noms racine spécifiés dans le fichier texte fichier 02. Ce paramètre opère de façon similaire à includecategories.
Importation/mise à jour d'un plan de fichiers
Pour importer un segment ou l'ensemble d'un plan de fichiers, exécutez l'outil en mode importation et spécifiez le fichier XML créé en mode exportation.
Si votre plan de fichiers comprend des classes ou propriétés personnalisées, le processus d'importation comporte deux étapes. Une étape importe les classes et propriétés personnalisées dans le plan de fichiers et la seconde importe le reste du plan de fichiers. Importez tout d'abord les classes et propriétés personnalisées, puis attendez au minimum cinq minutes avant d'importer le plan de fichiers, les métadonnées des classes et propriétés personnalisées étant mises en mémoire cache. La durée de vie (TTL) de la mémoire cache est de cinq minutes, puis elle est effacée.
Pour importer/mettre à jour un plan de fichiers, saisissez la commande suivante :
FilePlanTool -mode import -f nom_fichier_XML.xml -reimportoption option
FilePlanTool -mode update -f nom_fichier_XML.xml -reimportoption option
nom_fichier_XML est le nom et le chemin du fichier à importer.
Si vous ne saisissez pas de nom de fichier dans la ligne de commande, l'outil utilise le nom de fichier par défaut spécifié dans le champ Nom du fichier de sortie de la boîte de dialogue de configuration de l'outil. Pour plus d'informations sur la spécification du nom de fichier de sortie XML par défaut, voir Configuration de l'outil.
L'option de réimportation détermine le comportement par défaut lors de l'importation d'une entité pré-existante dans un plan de fichiers. Pour plus d'informations sur l'option de réimportation, voir Utilisation de l'option de réimportation.
En mode importation, l'outil n'utilise pas l'option étendue mais détermine les éléments à importer à partir des balises XML. Vous devez saisir un nom de fichier XML différent pour les métadonnées (classes et propriétés personnalisées) et le plan de fichiers.
Avertissement : La balise ClassificationScheme dans le fichier XML indique le nom du plan de fichiers.
Afin d'effectuer des modifications mineures après l'importation initiale d'un plan de fichiers, vous pouvez exécuter l'outil en mode Mise à jour. Vous pouvez alors faire une distinction entre les fichiers XML initialement importés et les mises à jour ultérieures. Spécifiez update pour l'attribut InputMode de la balise FilePlan du fichier XML. Il est impossible de modifier une propriété personnalisée (une liste de choix, par exemple) à l'aide du mode Mise à jour.
Si un message d'erreur s'affiche ou si le processus d'importation s'interrompt, voir le manuel IBM FileNet P8 Troubleshooting Guide. Dans la plupart des cas, en cas d'erreur, le processus d'importation s'interrompt sans afficher de message.
L'outil n'important pas les mises en attente conditionnelles, effectuez si nécessaire un balayage de mise en attente après l'importation pour appliquer les mises en attente aux entités. Voir Limitations.
Validation d'un plan de fichiers
Après la création manuelle d'un fichier XML, assurez-vous qu'il est exempt d'erreurs et de problèmes de conformité grâce à sa validation par l'outil d'importation/exportation de plans de fichiers. Pour exécuter l'outil d'importation/exportation en mode validation, tapez la commande suivante :
FilePlanTool -mode validate -f nom_fichier_XML.xml
Nom_fichier_XML est le nom et le chemin du fichier à valider. Si vous ne saisissez pas de nom de fichier dans la ligne de commande, l'outil utilise le nom de fichier par défaut spécifié dans le champ Nom du fichier de sortie de la boîte de dialogue de configuration de l'outil. Pour plus d'informations sur la spécification du nom de fichier de sortie XML par défaut, voir Configuration de l'outil.
Utilisation de l'option de réimportation
Utilisez l'option de réimportation pour déterminer le comportement par défaut de l'outil lors de l'importation d'une entité pré-existante dans un plan de fichiers. L'option de réimportation dispose de trois paramètres différents :
- Aucun - lors de l'ajout d'une entité préexistante, l'outil signale un avertissement dans le journal d'exceptions, n'ajoute pas l'entité et passe à la suite.
- Ignorer - lors de l'ajout d'une entité, l'outil ignore les entités préexistantes, passe à la suite et signale l'action Ignorer dans le journal d'activité.
- Remplacer - lors de l'ajout d'une entité, l'outil remplace les entités préexistantes, passe à la suite et signale l'action de modification dans le journal d'activité.
Après l'échec d'importation d'un plan de fichiers volumineux, employez l'option Ignorer.
Lors de la deuxième tentative d'importation du même plan de fichiers, l'option Ignorer permet d'éviter la réimportation des entités importées avec succès.
Si toutefois la deuxième tentative d'importation nécessite des modifications mineures des entités importées avec succès la première fois, employez l'option Remplacer. Lors des importations ultérieures de modifications mineures dans un petit nombre d'entités, il est recommandé d'indiquer Action="Modify" (dans la section RMEntityObjectType du ficher XML) pour les entités, plutôt que de modifier le fichier XML d'origine. Par ailleurs, le mode Mise à jour permet de distinguer plus facilement les mises à jour des importations complètes initiales. Voir
Importation/mise à jour d'un plan de fichiers.