IBM Enterprise Records version 5.1.2    

Utilisation de l'outil d'importation/exportation du plan de fichiers

Pour les déploiements IBM® Enterprise Records, utilisez l'outil d'importation/exportation du plan de fichiers pour importer un plan de fichiers externe ou 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é dans le but d'inclure l'héritage de planning, d'autres conservations, des déclencheurs d'élimination et des mises en attente dynamiques, voir Identification et résolution des problèmes liés à l'outil d'importation/exportation du plan de fichiers.

Limitations

Utilisez l'outil d'importation/exportation du plan de fichiers pour migrer des plans de fichiers. Toutefois, l'outil ne prend pas en charge les scénarios suivants : Commencez par exporter et importer les propriétés personnalisées dans un fichier XML distinct, telles que les listes d'options et les classes, avant d'importer le 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 exécuter l'outil d'importation/exportation du plan de fichiers à partir d'un programme de ligne de commande exécutable sous Java. Sinon, vous pouvez démarrer l'outil à l'aide du fichier de commandes : FilePlanTool.bat ou FilePlanTool.sh. L'outil peut être exécuté sous 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 dans lequel l'outil d'importation/exportation du plan de fichiers est installé.
  2. Exécutez l'une des instructions suivantes sur la ligne de commande :
    Système d'exploitation Commande
    Windows FilePlanTool -mode configure
    AIX, HP-UX, Linux et Solaris FilePlanTool.sh -mode configure
    Entrez les données suivantes dans la boîte de dialogue de l'outil du 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 étant le nom du plan de fichiers à exporter (nom obligatoire). Si le nom du plan de fichiers contient des espaces ou des caractères spéciaux, placez nom_plan_fichiers entre guillemets.

nom_fichier_XML est le nom et le chemin du fichier à créer. Si vous n'indiquez aucun nom de fichier sur la ligne de commande, l'outil utilise le nom de fichier par défaut spécifié dans la zone Nom du fichier de sortie. Cette zone se situe dans la boîte de dialogue de configuration. 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 étant le nom du plan de fichiers à exporter (nom obligatoire). Si le nom du plan de fichiers contient des espaces ou des caractères spéciaux, placez nom_plan_fichiers entre guillemets.

nom_fichier_XML est le nom et le chemin du fichier à créer. Si vous n'indiquez aucun nom de fichier sur la ligne de commande, l'outil utilise le nom de fichier par défaut spécifié dans la zone Nom du fichier de sortie. Cette zone se situe dans la boîte de dialogue de configuration. L'utilisation de l'outil avec l'option étendue implique la création d'un fichier XML pour chaque partie du plan de fichiers. Par conséquent, vous devez spécifier un nom de fichier XML différent à chaque fois que vous utilisez l'outil en mode exportation. Pour obtenir des informations sur la spécification du nom de fichier de sortie XML par défaut, voir Configuration de l'outil.

paramètre peut être l'un des éléments suivants :
  • metadata : Ce paramètre est requis si votre plan de fichiers contient des classes ou des 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 les 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 de catégorie d'enregistrements" : Utilisez ce paramètre pour exporter une catégorie d'enregistrements spécifique. Lorsque vous utilisez includecategory, l'outil exporte toutes les sous-catégories et tous les sous-dossiers contenus dans la catégorie d'enregistrements spécifiée. Le nom de catégorie d'enregistrements doit inclure le chemin complet dans IBM Enterprise Records. Par exemple, pour exporter tous les enfants de la catégorie d'enregistrements nommée Cat03, entrez la commande suivante. Cat03 est contenue dans Cat02, elle-même contenue dans Cat01.

FilePlanTool.bat -mode export -scope includecategory "/Cat01/Cat02/Cat03" -o fichier_export.xml

FilePlanTool.bat -mode export -scope includecategories fichier01.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 plan de fichiers ou un segment de plan de fichiers, exécutez l'outil en mode importation. Spécifiez le fichier XML que l'outil a 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. La première étape importe les classes et les propriétés personnalisées du plan de fichiers. La seconde étape importe le reste du plan de fichiers. Commencez par importer les classes et les propriétés personnalisées. Ensuite, attendez au moins 5 minutes avant d'importer le plan de fichiers car les métadonnées relatives aux propriétés et aux classes personnalisées se trouvent dans la mémoire cache. La durée de vie (TTL) du cache est de 5 minutes, après quoi le cache est effacé. 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 n'indiquez aucun nom de fichier, l'outil utilise le nom de fichier par défaut spécifié dans la zone Nom du fichier de sortie de la boîte de dialogue de configuration. Pour obtenir des 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 de l'outil lorsqu'une entité pré-existante dans le plan de fichiers est importée. 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 indiquer un nom de fichier XML différent pour les métadonnées (classes et propriétés personnalisées) et pour le plan de fichiers.

Avertissement : La balise ClassificationScheme dans le fichier XML indique le nom du plan de fichiers.

Pour effectuer des modifications mineures après l'importation initiale d'un plan de fichiers, exécutez l'outil en mode Mise à jour. Faites une distinction entre les mises à jour ultérieures et les fichiers XML initialement importés. 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 vous recevez un message d'erreur ou si le processus d'importation s'interrompt, consultez le noeud de Support et d'Identification de résolution des problèmes du centre de documentation, ou bien la page du guide IBM FileNet P8 Troubleshooting Guide de la documentation du produit FileNet P8 Platform. 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 des mises 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 avoir créé manuellement un fichier XML, vérifiez qu'il ne contient aucune erreur ou problème de non-conformité. Vous pouvez valider le fichier à l'aide de l'outil d'importation/exportation du plan 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 n'indiquez aucun nom de fichier, l'outil utilise le nom de fichier par défaut spécifié dans la zone Nom du fichier de sortie de la boîte de dialogue de configuration. Pour obtenir des 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 lorsqu'une entité pré-existante dans le plan de fichiers est importée. L'option de réimportation dispose de trois paramètres différents : Utilisez l'option Ignorer après l'échec d'importation d'un plan de fichiers volumineux. Lors de la deuxième tentative d'importation du même plan de fichiers, utilisez l'option Ignorer pour éviter de réimporter les entités importées avec succès. Toutefois, si des entités initialement importées avec succès nécessitent des modifications mineures lors de la deuxième tentative d'importation, utilisez l'option Remplacer. La prochaine fois que vous importerez les modifications mineures apportées à ces quelques entités, indiquez Action="Modify" (dans la section RMEntityObjectType du fichier XML) pour les entités. Modifiez ces entités au lieu 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 : Novembre 2013
fileplan_import_export.htm

© Copyright IBM Corp. 2013