Partage des définitions des types de Global Configuration Management entre les différents domaines de projet

Vous pouvez partager les définitions de type pour les composants et les configurations globales afin de maintenir la cohérence entre les différents domaines du projet de Global Configuration Management.

Tout d'abord, exportez les définitions de type, puis importez-les dans d'autres domaines du projet de Global Configuration Management, même les définitions de type qui se trouvent sur d'autres serveurs. Vous pouvez également gérer les types de manière centralisée en les marquant comme définitifs pour empêcher toute autre modification après leur importation.

Les définitions de type incluent les types d'artefact, attributs, types de données et types de lien.

Avant de commencer

Lorsque vous effectuez une importation ou une exportation, vous utilisez toutes les définitions de type dans une zone de projet en même temps. Vous ne pouvez pas importer ni exporter des définitions de type spécifiques.

Exportation : Attribuer des URI aux définitions de types définies localement. Si vous ne le faites pas, de nouvelles définitions de type sont créées et peuvent être répertoriées comme des doublons.
- Chaque type de données délimité, type de données énuméré et membre d'énumération doit avoir un URI.
- Chaque attribut d'artefact et chaque type de lien doit avoir un URI de prédicat RDF.
- Les URI facilitent également l'établissement de rapports, par exemple avec Jazz® Reporting Service
Importation de :
- Pour créer et modifier des définitions de type, vous devez disposer du privilège correspondant ou être responsable de la configuration.
- Pour importer des définitions de type ou modifier les définitions de type marquées comme définitives, vous devez disposer des privilèges correspondants ou être administrateur.

A propos de cette tâche

Gestion centralisée des définitions de type

Pour que les définitions de type soient cohérentes dans toutes les zones de projet, conservez-en un exemplaire dans une seule zone de projet et propagez-les dans les zones de projet qui en ont besoin. Voici deux exemples de cohérence :

Simple : choisissez une zone de projet dans laquelle vous créez et conservez toutes les définitions de type. Exporter les définitions de type de ce domaine de projet et les importer dans chaque domaine de projet qui les utilise.
Complexe : désignez deux zones de projet (ou plus) pour gérer de manière centralisée les types de définition et gérer une définition de type dans une seule zone de projet.
Dans ce scénario, ne marquez pas les définitions de type comme étant définitives lorsque vous les exportez à partir de ces zones de projet et que vous les importez ailleurs. De cette manière, les définitions de type provenant des différentes zones de projets sont fusionnées.

Pour plus d'informations sur l'impact du marquage final sur les définitions de type importées, voir le tableau de la section Importation de définitions de type.

Si vous modifiez une définition de type dans plusieurs zones de projet et que vous la propagez dans la même zone de projet de destination, des résultats inattendus risquent de survenir. Par exemple, la cardinalité des attributs d'artefact ou des types de lien peut être incorrecte, ou les limites des types de données limités peuvent être incorrectes.

Valeurs URI

Le système utilise des valeurs URI pour les correspondances des définitions de type. Si vous modifiez l'URI d'une ressource importée et exportez ensuite les définitions de type ou apportez la même modification dans d'autres zones de projet, vous risquez d'obtenir des résultats inattendus.

Pour éviter cette erreur, désignez une zone de projet pour gérer les définitions de type de manière centralisée.

Marquage comme définitif

Le fait de marquer les définitions de type comme définitives s'applique à toutes les définitions de type dans une zone de projet (types d'artefact, attributs, types de données et types de lien). Vous ne pouvez en marquer certaines spécifiques comme définitives.

Exportation des définitions de type

Tout membre d'une zone de projet peut exporter des définitions de type, en générant un fichier " .gcmt. Utilisez le tableau ci-dessous pour décider s'il convient de marquer les définitions de type comme étant définitives.

Facteurs	Non marquée comme définitive	Marquée comme définitive
Pourquoi	Pour combiner des définitions de type provenant de plusieurs domaines de projet. Sauvegarder le système de types afin de pouvoir revenir aux définitions de types originales après vos expériences.	Appliquer un ensemble de définitions de type à toutes les zones de projet. Le marquage comme final indique que le système de type est géré par des importations uniquement, et non par des mises à jour manuelles.
Conséquences pour l'importation	Tout utilisateur important ce fichier peut choisir de marquer les définitions de type comme définitives.	Les définitions de type sont importées comme définitives. Vous n'avez pas le choix.

Importation des définitions de type

Les administrateurs ou les personnes disposant de l'autorisation correspondante peuvent importer des définitions de type à partir d'un fichier '.gcmt Si les définitions de type n'étaient pas marquées comme définitives lors de leur exportation, vous pouvez choisir de les importer en tant que telles.

Utilisez le tableau ci-dessous pour décider s'il convient de marquer les définitions de type comme étant définitives. Vous pouvez également vous référer à l'exemple simple décrit plus loin.

Facteurs	Non marquée comme définitive	Marquée comme définitive
Pourquoi	Pour combiner des définitions de type provenant de plusieurs domaines de projet.	Assurer la cohérence en imposant l'utilisation des définitions de type d'un domaine de projet dans un ensemble de domaines de projet. Attention : Si vous modifiez des définitions de type définitives après l'importation, vous perdez l'avantage de cohérence de la gestion centralisée et toute modification est remplacée lors de l'importation suivante.
Qui peut modifier les définitions de type importées ?	Les responsables de configuration (ou rôles supérieurs) ou les membres de zone de projet disposant du privilège Créer et modifier des définitions de type peuvent modifier les définitions de type après l'importation.	Les administrateurs ou membres de zone de projet disposant du privilège Modifier les définitions de type importées définies comme étant définitives peuvent déverrouiller et modifier des définitions de type définitives importées.
Résultats	Les types d'artefacts (configurations globales et composants globaux) sont fusionnés pour combiner les attributs et les types de liens du domaine de projet à partir duquel vous importez et ceux qui sont utilisés par le domaine de projet existant. Les attributs, types de données et types de lien importés depuis d'autres zones de projet sont retirés des types d'artefact mais restent disponibles dans les autres onglets.	Types d'artefacts, " écrasé et " seulement " les attributs et les types de liens de la zone de projet à partir de laquelle vous effectuez l'importation. Des attributs, types de données et types de lien sont créés ou mis à jour. Les éléments importés remplacent les éléments existants si la sémantique est identique.

Vous pouvez également importer et exporter des définitions de type à l'aide de l'API REST de Global Configuration Management. Voir 'https://host:port/gc/doc/scenarios.

Procédure

Ouvrez la page Gérer les définitions de type. Cliquez sur Administration > Gérer les définitions de type.
Exportez ou importez les définitions de type.
- Exporter
  1. Cliquez sur Exporter en haut à droite de l'écran pour ouvrir la boîte de dialogue Définitions du type d'exportation.
  2. Si vous êtes invité à spécifier des URI manquants, retournez à la page Gérer les définitions de type et affectez les URI nécessaires. Cliquez ensuite sur actualisez cette liste dans la boîte de dialogue Définitions de type d'exportation.
    N'oubliez pas que la spécification d'URI facilite la production de rapports et empêche une duplication inintentionnelle des définitions de type.
  3. Si vous souhaitez empêcher d'autres modifications lorsque les définitions de type sont importées dans d'autres domaines de projet, sélectionnez Marquer comme définitif pour vous assurer que les définitions de type sont gérées de manière centralisée à partir du domaine de projet actuel. Si vous choisissez d'ignorer cette étape, la personne qui importe ces définitions de type a la possibilité de les marquer comme définitives.
  4. Cliquez sur Terminer et sauvegardez le fichier .gcmt généré.
- Importer
  1. Cliquez sur Importer.
  2. Dans la boîte de dialogue Importer les définitions de type, accédez au fichier .gcmt à importer et cliquez sur Suivant.
  3. Si les définitions de type n'ont pas été marquées comme définitives lors de leur exportation, vous pouvez empêcher toute modification ultérieure en sélectionnant Marquer comme définitif.
  4. Cliquez sur Suivant et, dans chaque onglet, passez en revue les modifications proposées. Vérifiez les avertissements et corrigez les éventuelles erreurs dans la zone de projet cible de l'importation. Cliquez ensuite sur actualiser cet aperçu dans la boîte de dialogue Importer les définitions de type.
  5. Cliquez sur Terminer.
  6. Les définitions de type importées affichent l'ID utilisateur de la personne qui les a exportées depuis le domaine de projet source. Ces informations sont capturées à des fins d'audit. Pour supprimer le nom pour des raisons de confidentialité :
    1. Dans la zone de projet que vous venez d'importer, suivez les étapes décrites dans le wiki Exportation et importation des définitions de type et des informations personnelles stockées.
    2. Supprimez le fichier .gcmt que vous avez importé.

Exemple

Votre entreprise construit des véhicules qui comprennent des voitures de sport et des camionnettes, chacun ayant son propre domaine de projet qui contient de nombreux composants globaux. Pour faciliter les audits, la conformité et la traçabilité entre les zones de projet, vous souhaitez que les deux zones de projet utilisent les mêmes définitions de type. Votre organisation décide que tous les domaines de projet doivent utiliser les définitions de type SportsCar. Dans cet exemple, vous exportez donc à partir de SportsCar et importez dans PickupTruck.

Vous voyez ici uniquement le type d'artefact de configuration globale et ses définitions de type pour les deux zones de projet avant l'importation. Le comportement d'importation est semblable pour les composants globaux.

L'attribut Geography de la zone de projet SportsCar et l'attribut TargetMarket de la zone de projet PickupTruck portent des noms différents mais sont utilisés de la même manière dans les deux zones de projet. Notez qu'ils présentent le même URI d'attribut et qu'ils utilisent tous deux le même type de données geo.
Le SportsCar possède un attribut Engine et un type de données engineType. La zone de projet PickupTruck n'utilise pas ces définitions de type.
La zone de projet PickupTruck contient un type de lien Brochure.

A présent, observez le type de données wheels dans chacune des zones de projet : l'URI est le même, mais les valeurs de membre sont différentes. Vous pouvez à nouveau examiner ce type de données après l'importation.

Vous exportez ensuite depuis SportsCar et importez dans PickupTruck. Lorsque vous importez, vous prévisualisez vos modifications dans l'assistant d'importation.

Maintenant, vous voyez en quoi les résultats d'importation diffèrent dans l'image suivante, selon que vous avez marqué ou non les définitions de type comme définitives. Remarquez les éléments renommés et préservés dans les images suivantes, une importation non finale comparée aux résultats d'une importation marquée comme finale, qui correspondent maintenant à la zone du projet SportsCar.

Après l'importation, ce que vous voyez dépend du marquage ou non comme définitives des définitions de type. Voici quelques points clés :

Non marquée comme définitive : les types d'artefact (configurations et composants globaux) sont mis à jour de façon à inclure :
- Attributs et types de liens utilisés par les types d'artefacts importés.
- Attributs et types de liens définis localement et utilisés par les types d'artefacts du domaine de projet dans lequel vous effectuez l'importation.
- Les attributs et les types de liens importés d'autres domaines de projet sont supprimés des types d'artefacts. Par exemple, si le type d'artefact de configuration globale PickupTruck présente un attribut reviewer importé depuis la zone de projet CubeVan, cet attribut est retiré de la configuration globale PickupTruck, mais il reste disponible dans l'onglet Attributs de la page Gérer les définitions de type.
Vous pouvez constater que le type de données " roues" de la camionnette a maintenant les mêmes valeurs de membre que le type de données "roues" de la SportsCar Si votre organisation décide que toutes les zones de projet doivent utiliser les mêmes définitions de type que la zone de projet SportsCar mais que certains véhicules requièrent une option de taille de roue de 20 pouces, pensez à ajouter cette valeur de membre au type de données wheels de la zone de projet SportsCar afin de l'inclure lors de l'importation dans d'autres zones de projet.

Les autres attributs, types de données et types de lien importés qui ne sont pas utilisés par les types d'artefact sont ajoutés à la zone de projet PickupTruck.
Marquée comme définitive : les types d'artefact sont remplacés de façon à ne contenir que les attributs et types de lien de la zone de projet depuis laquelle vous importez.
Les attributs, types de données et types de lien dont les URI ne correspondent pas à ceux importés sont retirés du type d'artefact, mais ils restent disponibles dans les autres onglets. Dans l'exemple, notez que le type de lien Brochure est retiré de la configuration globale PickupTruck, mais il reste disponible dans l'onglet Types de lien.
Vous pouvez déverrouiller le type d'artefact de configuration globale et les ajouter plus tard, si nécessaire, mais n'oubliez pas que vous perdez toute cohérence en gérant les définitions de type de manière centralisée.

Même si les URI du type de données " wheels" sont désormais identiques dans les domaines de projet SportsCar et PickupTruck, les valeurs des membres dans le domaine de projet PickupTruck sont écrasées (elles ne sont pas combinées même pour une importation non finale).

Etape suivante

Après l'importation, passez en revue les définitions de type dans les onglets de la page Gérer les définitions de type. Ces icônes vous aident à comprendre ce que vous voyez :

: Dans la liste de gauche, une définition de type importée.
: Une définition de type importée qui a été modifiée après l'importation. N'oubliez pas que les modifications risquent d'être écrasées par une autre importation.
: Dans les détails à droite, une définition de type marquée comme finale. Cliquez pour déverrouiller, éditer et sauvegarder vos modifications.

Les modifications de l'importation ne modifient pas automatiquement les attributs ou les liens des artefacts existants (flux, versions de référence ou composants). Elles possèdent les mêmes valeurs d'attribut et de lien que lors de leur dernière édition. Vous verrez les modifications la prochaine fois que vous éditerez un artefact.