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 :
- 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. De plus, l'importation d'un planning d'élimination dans une autre librairie ne permet pas de mettre à jour la période de conservation en lui affectant une valeur nulle. Vous pouvez néanmoins modifier manuellement le fichier XML pour mettre à jour la période de conservation. Pour plus d'informations, voir Identification et résolution des problèmes liés à l'outil d'importation/exportation du plan de fichiers.
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 :
- Configurer : ouvre une boîte de dialogue dans laquelle vous pouvez spécifier les informations requises. Les informations requises sont : le nom du serveur Content Platform Engine, le nom de la librairie, le nom et le mot de passe de l'utilisateur administrateur et le mode (importation ou exportation).
- Exporter : crée un fichier XML entièrement compatible et conforme que vous pourrez importer ultérieurement dans un autre environnement.
- Importer/Mettre à jour : importe un fichier XML spécifié dans un environnement.
- Valider : lit un fichier XML pour en vérifier la compatibilité et la 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 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
- includecategories fichier 01 :
Utilisez ce paramètre pour n'exporter que les catégories d'enregistrements et leurs enfants spécifiés dans le fichier texte d'entrée fichier 01. Utilisez le paramètre includecategories pour exporter un grand nombre de catégories d'enregistrements vers un même fichier, sans spécifier le nom de chaque catégorie d'enregistrements dans la ligne de commande. Pour utiliser ce paramètre, tapez la ligne de commande suivante ;:
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.
- excludecategory "nom de catégorie d'enregistrements exclue" : Utilisez ce paramètre pour exclure une catégorie d'enregistrements spécifique et ses enfants. Par exemple, si le nom de catégorie d'enregistrements exclue est "Cat01/Cat02/Catlarge", l'outil exporte toutes les catégories et tous les dossiers d'enregistrements du plan de fichiers, à une exception près. Cette exception concerne les catégories et les dossiers d'enregistrements contenus dans le noeud "Cat01/Cat02/CatLarge". Ce paramètre opère de façon similaire à includecategory.
- excludecategories fichier 02 :
Utilisez ce paramètre pour exclure les sous-arborescences des noms racines 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 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 :
- Aucun : Lorsqu'une entité est ajoutée, l'outil émet un avertissement dans le journal des exceptions si cette entité existe déjà ; il ne l'ajoute pas et poursuit son activité.
- Ignorer : Lorsqu'une entité est ajoutée, l'outil ignore toute entité pré-existante ; il poursuit son activité et signale cette action dans le journal d'activité.
- Remplacer : Lorsqu'une entité est ajoutée, l'outil remplace toute entité pré-existante ; il poursuit son activité, puis signale cette action de modification dans le journal d'activité.
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.