L'outil d'importation/exportation de plans de fichiers d'IBM InfoSphere Enterprise Records 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. Pour plus d'informations sur le schéma XML et les éléments qui le composent, consultez la rubrique Schéma XML de plan de fichiers.
Pour plus d'informations sur la modification d'un fichier XML exporté pour inclure un héritage de planning, les conservations alternatives, les déclencheurs d'élimination et les mises en attente dynamique (conditionnelles), consultez la section Outil d'importation/exportation de plans de fichiers, à la page Product Documentation for FileNet P8 Platform
L'outil d'importation/exportation de plans 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.
Vous pouvez lancer l'outil d'importation/exportation de plans de fichiers à partir d'une ligne de commande Java exécutable ou démarrer l'outil grâce au fichier batch FilePlanTool.bat ou FilePlanTool.sh.
Vous pouvez exécuter l'outil dans l'un des cinq modes suivants :
Avant de lancer l'outil en mode importation ou exportation, vous devez tout d'abord le configurer.
Pour configurer l'outil :
Sous Windows :
FilePlanTool -mode configure
Sous UNIX :
./FilePlanTool.sh -mode configure
REMARQUE Si vous sélectionnez iiop, vous devez désactiver le protocole SSL. Pour désactiver le protocole SSL, consultez la rubrique Désactiver le protocole SSL.
Si le plan de fichiers que vous souhaitez exporter contient l'un des éléments suivants :
Consultez 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, saisissez la commande suivante :
FilePlanTool -mode export -fileplan <nom du plan de fichiers> -o <nom du fichier XML.xml>
où nom de plan de 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 de plan de fichiers entre guillemets.
Nom de 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 de 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 XML de sortie par défaut, reportez-vous à la rubrique Configuration de l'outil.
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 du plan de fichiers> -o <nom du fichier XML.xml> -scope <paramètre>
où nom de plan de 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 de plan de fichiers entre guillemets.
Nom de 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 de 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 XML de sortie par défaut, reportez-vous à la rubrique Configuration de l'outil.
paramètre peut prendre les valeurs suivantes :
FilePlanTool.bat -mode export scope includecategory "/Cat01/Cat02/Cat03" o expfile.xml
FilePlanTool.bat -mode export scope includecategories file01.txt o export01.xml
File01.txt contient :
/categoryB
/CategoryC/SubcategoryC2
/CatogoryA/SubcategoryA1Le nom de catégorie est représenté par le chemin complet et une catégorie d'enregistrement par ligne.
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 fichier, 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 du fichier XML.xml> -reimportoption <option>
FilePlanTool -mode update -f <nom du fichier XML.xml> -reimportoption <option>
Nom de 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 de 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 XML de sortie par défaut, reportez-vous à la rubrique 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 de détails sur l'option de réimportation, reportez-vous à la rubrique Utiliser 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.
REMARQUE 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, reportez-vous au manuel 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. Reportez-vous à la rubrique Limitations.
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 du fichier XML.xml>
Nom de 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 de 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 XML de sortie par défaut, reportez-vous à la rubrique Configuration de l'outil.
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 un é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 de l'importation de modifications mineures dans un petit nombre d'entités, indiquez Action="Modify" dans la section RMEntityObjectType des fichiers XML des 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. Reportez-vous à la rubrique Importer / Mettre à jour un plan de fichiers.