IBM Enterprise Records, Version 5.1.+            

Utilisation de l'outil d'exportation et d'importation de plan de fichiers

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 : 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 de l'outil

Avant de lancer l'outil en mode importation ou exportation, vous devez tout d'abord le configurer. Pour configurer l'outil :
  1. Accédez au dossier d'installation de l'outil d'importation/exportation de plan de fichiers.
  2. Exécutez l'une des instructions suivantes sur la ligne de commande :
    Système d'exploitation Commande
    Windows FilePlanTool -mode configure
    UNIX FilePlanTool.sh -mode configure
    Entrez les données suivantes dans la boîte de dialogue de l'outil d'importation/exportation de plan de fichiers :

Exportation d'un plan de fichiers

Si le plan de fichiers que vous souhaitez exporter contient l'un des éléments suivants : 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

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

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

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.

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 : 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.


Commentaires

Dernière mise à jour : Août 2011


© Copyright IBM Corp. 2011.
Ce centre de documentation est basé sur la Technologie Eclipse. (http://www.eclipse.org)