Commande d'importation des modifications

Administration d'entreprise > Promotion Business Administrative Change > Exécution de l'utilitaire de ligne de commande Business Administrative Change Promotion > Commande d'importation des modifications

Après avoir copié le fichier ZIP exporté dans le système cible, vous pouvez exécuter la commande import dans le système cible.

Option

Obligatoire ?

Description

-f

--filepath

Oui

Emplacement ou chemin absolu du fichier ZIP du lot à importer.

-o

--outputDirectory

Non

Emplacement où un fichier journal d'importation est enregistré. Si cette option n'est pas spécifiée, le fichier est enregistré dans le répertoire en cours.

L'emplacement par défaut du journal des importations est <WT_HOME>/${wt.temp}/bac/reports. Vous pouvez configurer la propriété com.ptc.windchill.bac.import.report.location dans wt.properties pour modifier l'emplacement par défaut du fichier journal des importations.

-d

--defaultResolutions

Non

Utilise les résolutions par défaut fournies par Windchill pour tous les conflits qui surviennent lors de l'importation. Tous les conflits non prioritaires avec une résolution par défaut applicable sont résolus en utilisant la résolution par défaut et ne sont pas signalés dans l'utilitaire Gestion des événements.

-s

--saveResolutions

Non

Enregistre toutes les résolutions que vous sélectionnez et que vous souhaitez utiliser à nouveau avec ce système source. Vous pouvez sélectionner des résolutions pour tous les conflits signalés dans l'utilitaire Gestion des événements.

Si vous sélectionnez cette option avec l'option --reuseResolutions, toutes les résolutions déjà enregistrées sont appliquées en premier. Les résolutions de tous les problèmes qui surviennent peuvent être sélectionnées à l'aide de l'utilitaire Gestion des événements. Si ces deux options sont activées, les résolutions sélectionnées durant cette importation sont ajoutées aux résolutions déjà enregistrées.

-c

--conflictResolutionFile

Non

Indique le chemin d'accès au fichier XML de résolution des conflits qui sera utilisé lors de l'importation. Le fichier XML de résolution des conflits spécifie les différents types de conflits et les résolutions correspondantes. Si vous sélectionnez cette option avec l'option --defaultResolutions, --saveResolutions, --reuseResolutions ou l'ensemble de ces options, toutes les résolutions fournies dans le fichier de chargement XML sont implémentées en premier. Si une résolution n'est pas disponible dans le fichier XML, les résolutions précédemment enregistrées sont appliquées.

-b

--useBundledConflictResolutionFile

Non

Utilise le fichier de résolution de conflit en paquet disponible dans le fichier ZIP du lot pour résoudre les conflits lors de l'importation. Si vous sélectionnez cette option avec l'option --defaultResolutions, --saveResolutions, --reuseResolutions ou l'ensemble de ces options, toutes les résolutions fournies dans le fichier de résolution de conflit en paquet sont implémentées en premier. Si une résolution n'est pas disponible dans le fichier, les résolutions précédemment enregistrées sont appliquées.

Si vous utilisez les commandes -b, -c et -r en même temps, la priorité est donnée à la commande -b, puis à la commande -c et enfin à la commande -r. Le système recherche d'abord les fichiers dans le fichier ZIP du lot. S'il ne trouve aucun fichier, il les recherche à l'extérieur du lot. S'il n'y a pas de fichiers à l'extérieur du lot, il recherche dans la base de données.

-n

--useBundledMapFile

Non

Utilise le fichier de mappage disponible dans le fichier ZIP du lot pour mapper les attributs source aux attributs cible lors de l'importation.

Si vous utilisez les commandes -n, -m et mapping values defined under Import mapping on UI en même temps, la priorité est donnée à la commande -n, puis à la commande -m et enfin à la commande mapping values defined under Import mapping on UI. Le système recherche d'abord les fichiers dans le fichier ZIP du lot. S'il ne trouve aucun fichier, il les recherche à l'extérieur du lot. S'il n'y a pas de fichiers à l'extérieur du lot, il recherche dans mapping values defined under Import mapping on UI.

-i

--ignoreTargetCheckforGUID

Non

Indique le GUID du système source pour lequel la vérification du système cible sera ignorée

Lors du processus d'importation, le GUID du système source permet de vérifier s'il est enregistré auprès du système cible. Si vous définissez cette option, cette vérification est ignorée et vous pouvez importer les modifications administratives à partir d'un système source non enregistré.

Cette option est uniquement disponible pour le mode Synchronisation.

Vous pouvez également configurer la propriété com.ptc.windchill.bac.ignoreGUIDList dans wt.properties sur le système cible pour spécifier le GUID du système source. Cela permet de contourner la vérification de la liste d'ID du système source spécifiée lors de l'importation. Si vous spécifiez des valeurs GUID distinctes pour --ignoreTargetCheckforGUID et pour com.ptc.windchill.bac.ignoreGUIDList, le GUID indiqué pour --ignoreTargetCheckforGUID sera prioritaire.

-v

--ValidateTarget

Non

Commande permettant de valider le GUID du système cible. Ceci n'est valide que pour le mode de développement. Par défaut, la validation du GUID n'est pas effectuée pour le système cible.

-r

--reuseResolutions

Non

Utilise les résolutions disponibles que vous avez définies avec l'utilitaire Gestion des événements dans le cadre d'une importation précédente à partir de ce système source.

Si vous spécifiez cette option avec l'option --defaultResolutions, toutes les résolutions enregistrées sont appliquées. Si aucune résolution enregistrée n'est disponible pour le conflit, la résolution par défaut est appliquée.

-m

--mapFile

Non

Emplacement où un fichier XSL contenant des informations de mappage est stocké. Par exemple, le fichier de mappage peut spécifier comment un participant du système source doit être mappé au même participant du système cible si les deux participants ont des noms globaux autorisés différents.

Pour plus d'informations, consultez la section Mappage des attributs de modification administrative métier.

-u

--user

Non

Nom de l'utilisateur Windchill qui exécute la commande. L'utilisateur exécutant la commande doit être un utilisateur Windchill valide qui dispose de droits d'administrateur d'organisation, avec un accès à tous les objets requis, ainsi qu'un administrateur de site.

-p

--password

Non

Mot de passe de l'utilisateur Windchill exécutant la commande.

-h

--help

Non

Utilisez cette option pour afficher le texte d'aide de l'utilitaire. Le texte d'aide contient les descriptions complètes de chaque option, ainsi que de la syntaxe permettant d'exécuter l'utilitaire.

Pour exécuter l'utilitaire dans un shell Windchill, spécifiez la commande suivante avec les options appropriées, indiquées dans le tableau correspondant à l'action à effectuer : windchill wt.scm.client.SCMCMD import

Par exemple, pour importer un ensemble de modifications administratives à l'aide des résolutions de conflit par défaut avec les conflits et résolutions consignés dans un fichier journal, la commande ci-après doit être utilisée : windchill wt.scm.client.SCMCMD import -u "<nom de l'utilisateur>" -p "<mot de passe>" -f "<chemin d'accès au fichier ZIP>" -d -o "<chemin d'accès au répertoire de sortie>"

Journal d'importation des modifications administratives métier

Les fichiers journaux d'importation sont générés à l'exécution de la commande d'importation, que cette opération ait ou non abouti. Les informations contenues dans un fichier journal des importations fournissent davantage de détails sur l'ensemble de la transaction d'importation.

Le journal des importations contient les informations suivantes :

• En-tête du fichier journal : ID de la livraison reçue BAC, nom du lot, version du lot et référentiel source

• Sommaire

• Type d'objet

• Identité

• Statut de l'importation

• Mécanisme de recherche

• Conflits

En cas d'échec d'une importation, le journal des importations affiche les informations d'en-tête et les motifs de l'échec.

L'exemple suivant illustre un rapport du journal des importations :