Le fichier de spécification de promotion des modifications administratives est un mécanisme permettant de définir des critères pour sélectionner des objets administratifs au niveau des macros à exporter via un fichier XML. Par exemple, vous pouvez spécifier un critère de filtrage afin d'exporter uniquement les profils qui proviennent d'une organisation ou d'un contexte spécifiques, ou les règles de contrôle d'accès aux politiques pour une identité donnée, et ainsi de suite. Le fichier BACSpec.xsd contient les règles et contraintes qui s'appliquent lors de la création d'un fichier de spécification. Ce fichier se trouve à l'emplacement suivant : <Windchill_Home>\prog_examples\BAC\schema. Le filtrage des objets à l'aide d'un fichier de spécification est pris en charge sur les modes Sélection et Synchronisation. Les sections suivantes de cette rubrique décrivent la structure d'élément et les informations associées qui doivent être utilisées dans un fichier de spécification pour chaque objet, ainsi que l'exemple de code XML de spécification. En outre, certains exemples de fichiers de spécifications pour chaque type d'objet sont fournis à titre de référence à l'emplacement <Windchill_Home>\prog_examples\BAC.

Utilisez l'option -s ou --objectType de la commande d'exportation pour charger et traiter le fichier XML de spécifications. L'option -s ou --objectType est disponible uniquement lorsque vous définissez la propriété com.ptc.windchill.bac.features.enabled du fichier wt.properties sur 2666518. En l'absence de cette configuration, toute tentative de chargement d'un fichier de spécifications sera rejetée avec une erreur. Cette option est disponible en modes Sélection et Synchronisation.

Outre l'utilisation des attributs d'identité d'un objet en tant que critères de filtrage, vous pouvez utiliser la balise GlobalContainerCriteria du fichier de spécification pour filtrer des objets au niveau conteneur. Pour plus d'informations, consultez la section Critères de conteneur globaux dans cette rubrique.

Chaque type d'objet du système ne prend en charge qu'un ensemble spécifique de critères de filtrage. Lorsque vous créez le fichier de spécification, vérifiez que les critères que vous avez fournis sont corrects pour ce type d'objet. Par exemple, pour les règles de contrôle d'accès aux politiques, le nom n'est pas un critère de filtrage pris en charge. Ainsi, vous ne pouvez pas exporter des règles d'accès aux politiques en fonction de leur nom. De même, l'état du cycle de vie ou l'ID du type ne sont pas des critères de filtrage pris en charge pour les profils. Les sections ci-après fournissent des détails sur les différents éléments utilisables pour chaque type d'objet lors de la création d'un fichier de spécification de promotion des modifications administratives.

Les valeurs de chaîne spécifiées pour un élément, un sous-élément ou un attribut dans le fichier de spécifications sont sensibles à la casse.

Le fichier de spécification vous permet de filtrer les profils en fonction du nom de ces derniers à partir d'un conteneur d'organisation spécifique ou du conteneur d'échange. Cette section décrit les éléments XML qui peuvent être utilisés pour filtrer des objets en fonction des profils dans les systèmes en mode Sélection. Le schéma du profil contient les éléments suivants :

Vous pouvez créer un fichier XML de spécifications pour sélectionner tous les profils appelés Profile1 dans l'organisation ExchangeContainer ou PTC, comme indiqué ci-dessous :

Cette section décrit les éléments XML utilisés pour filtrer et exporter des enregistrements de règle d'initialisation d'objet (OIR) dans les systèmes en mode Sélection. Seuls les éléments TypeBasedRule sont pris en charge pour les règles d'initialisation d'objet. Vous pouvez filtrer les règles d'initialisation d'objet en fonction de leur nom à partir d'un conteneur d'organisation, d'un conteneur d'application, d'un conteneur d'échange ou d'un type d'objet spécifique. Les éléments suivants sont inclus dans le schéma de règle d'initialisation d'objet :

Voici un exemple de fichier de spécification permettant de filtrer et d'exporter des enregistrements de règle d'initialisation d'objet portant les noms OIR-part-org, OIR-doc-org et OIR-doc-prod1 à partir de l'organisation PTC et en fonction du type d'objet WTDocument :

Cette section décrit les éléments XML utilisés pour filtrer et exporter des préférences dans les systèmes en mode Sélection. Les éléments suivants sont inclus dans le schéma des préférences :

Vous pouvez filtrer les préférences en fonction du type des conteneurs, de l'utilisateur Windchill, ainsi que de la catégorie, de la définition et du client de préférence.

Les informations sur les conteneurs, les informations sur les utilisateurs et le paramètre excludeInstances correspondent à des options mutuellement exclusives pour le filtrage des préférences.

Il s'agit d'un exemple de fichier de spécification pour filtrer et exporter une définition de préférence nommée Intro du conteneur d'application GOLF_CART sous Test Organization. Le fichier de spécifications indique également les critères de filtrage permettant d'exporter les enregistrements d'une préférence nommée AAA d'un client de préférence appelé Windchill et du client de préférence DEMO, et d'exclure le filtrage des préférences bénéficiant d'une visibilité masquée dans des instances User et Container :

Pour l'obtention des noms internes : pour spécifier des critères de filtrage en fonction de la catégorie de préférence, de la définition de préférence et du client de préférence, vous devez fournir le nom interne des préférences. Utilisez la commande suivante pour obtenir les noms internes des préférences d'une langue spécifique :

Lors de l'exécution de cette commande, un rapport CSV est généré et enregistré à l'emplacement indiqué. Le rapport CSV fournit des informations sur le type d'objet, le nom interne et le nom affiché dans la langue spécifiée dans la commande.

Les éléments ci-après figurent dans le schéma de règle de contrôle d'accès aux politiques pour les systèmes en mode Sélection :

Vous pouvez filtrer les règles de contrôle d'accès aux politiques en fonction des attributs d'identité pour les seuls systèmes en mode Sélection. Vous pouvez définir le filtre sous la forme d'une combinaison d'éléments d'identité avec des conteneurs, des domaines ou uniquement des attributs.

Lorsque vous créez un fichier de spécification relatif aux règles de contrôle d'accès aux politiques pour les systèmes en mode Synchronisation, spécifiez uniquement le type d'objet. Aucun autre critère de filtrage n'est pris en charge.

Voici un exemple de fichier de spécification permettant de filtrer et d'exporter toutes les règles de contrôle d'accès aux politiques qui présentent l'ID de type WTPart, l'état de cycle de vie APPROVED et l'élément allExceptPrincipal défini sur la valeur vrai.

Voici un exemple de fichier de spécification permettant de filtrer et d'exporter toutes les règles de contrôle d'accès aux politiques à partir du domaine de conteneur d'échange System, du domaine d'organisation Test Organization et de domaines de conteneur d'application tels que GOLF_CART, Test_Lib et Test_Project.

Voici un exemple de fichier de spécification permettant de filtrer et d'exporter tous les profils à partir du conteneur d'échange et du domaine Test Organization, ainsi que toutes les règles de contrôle d'accès aux politiques à partir du conteneur d'échange et des conteneurs d'application de types produit, projet et bibliothèque.

Voici un exemple de fichier de spécification permettant d'exporter l'ensemble des profils, des règles d'initialisation d'objet et des règles de contrôle d'accès aux politiques à partir d'un système en mode Synchronisation :

Cette section décrit les éléments XML utilisés pour filtrer et exporter les enregistrements de modèle de cycle de vie dans les systèmes en mode Sélection. Vous pouvez filtrer les modèles de cycle de vie en fonction de leur nom à partir d'un conteneur d'organisation, d'un conteneur d'application ou du conteneur d'échange.

Lorsque vous développez le fichier de spécification relatif aux modèles de cycle de vie, tenez compte des principes suivants :

Les éléments ci-après figurent dans le schéma de modèle de cycle de vie pour les systèmes en mode Sélection :

Voici un exemple de fichier de spécification permettant de filtrer et d'exporter tous les modèles de cycle de vie à partir du conteneur Exchange et du produit GOLF_CART dans Demo Organization :

Voici un exemple de fichier de spécification permettant de filtrer et d'exporter tous les modèles de cycle de vie nommés Default dans Demo Organization :

Voici un exemple de fichier de spécification permettant de filtrer et d'exporter tous les modèles de cycle de vie nommés Basic et Default :

Cette section décrit les éléments XML utilisés pour filtrer et exporter les enregistrements de modèle de processus dans les systèmes en mode Sélection. Vous pouvez filtrer les modèles de processus en fonction de leur nom à partir d'un conteneur d'organisation, d'un conteneur d'application ou du conteneur d'échange.

Lorsque vous développez le fichier de spécification relatif aux modèles de processus, tenez compte des principes suivants :

Les éléments ci-après figurent dans le schéma de modèle de processus pour les systèmes en mode Sélection :

Voici un exemple de fichier de spécification permettant de filtrer et d'exporter tous les modèles de processus à partir du conteneur Exchange et du produit GOLF_CART dans Demo Organization :

Voici un exemple de fichier de spécification permettant de filtrer et d'exporter tous les modèles de processus nommés Submit dans Demo Organization :

Voici un exemple de fichier de spécification permettant de filtrer et d'exporter tous les modèles de processus nommés Review et Submit :

Le fichier de spécification permet de filtrer et d'exporter le modèle d'attribut sur la base du nom interne de la définition de type. Le schéma du module d'attribut contient les éléments suivants :

Voici un exemple de fichier de spécification permettant de filtrer et d'exporter le modèle d'attribut :

Vous pouvez créer un fichier de spécification en utilisant un élément unique ou une combinaison d'éléments d'identité. Si vous utilisez tous les éléments d'identité dans un fichier de spécification, vous devez spécifier les éléments du schéma dans l'ordre indiqué dans la figure suivante.

Les éléments suivants sont inclus dans le schéma d'identité :

Voici un exemple de fichier de spécification qui référence tous les éléments d'identité dans la séquence mandatée :

Utilisez GlobalContainerCriteria pour spécifier un conteneur commun en tant que critère de filtrage global pour tous les types d'objets indiqués dans le fichier de spécification. Les conteneurs spécifiés dans le paramètre GlobalContainerCriteria sont appliqués de façon cumulative à tous les types d'objets du fichier de spécification. L'utilisation du paramètre GlobalContainerCriteria dans un fichier de spécification pour l'importation ou l'exportation d'enregistrements est uniquement prise en charge sur les systèmes en mode Sélection.

Par exemple, si vous souhaitez filtrer et exporter tous les profils à partir de l'organisation PTC dans GlobalContainerCriteria et du conteneur d'échange, tous les enregistrements de profil à partir de PTC et d'ExchangeContainer sont récupérés. Voici un exemple de fichier XML correspondant à ce scénario :

Lorsque vous créez un fichier de spécification en utilisant le paramètre GlobalContainerCriteria, prenez en compte les points suivants :

Voici un exemple de fichier de spécification permettant de filtrer et d'exporter tous les profils dans le conteneur d'échange et les règles de contrôle d'accès aux politiques à partir du conteneur d'application "Drive System" sous l'organisation PTC :