Intégration d'Operations Manager à des versions non-anglaises de Team Foundation Server (TFS) ou à un modèle de processus personnalisé dans TFS
S'applique à: System Center 2012 R2 Operations Manager, System Center 2012 SP1 - Operations Manager
Quand vous devez synchroniser des alertes Operations Manager et des éléments de travail TFS et que votre équipe de développement utilise un modèle de processus qui n'est pas en anglais dans TFS (inclus dans des versions non anglaises de TFS), vous devez configurer Operations Manager pour qu'il puisse synchroniser les alertes avec les éléments de travail TFS. Il s'agit d'un processus complexe et détaillé.
Conditions préalables
Vous devez exécuter System Center 2012 R2 Update Rollup 1 (UR1) ou version ultérieure ou System Center 2012 SP1 Update Rollup 5 (UR5) ou version ultérieure.
Lorsque vous téléchargez un correctif cumulatif, vous devez trouver une version mise à jour du pack d'administration Synchronisation de l'élément de travail Team Foundation Server, qui est inclus dans le téléchargement de la mise à jour cumulative.
Modèles de processus TFS : éléments à connaître
Chaque projet d'équipe dans TFS est basé sur un modèle de processus qui peut être personnalisé en fonction de vos besoins. Il existe de nombreuses versions des modèles de modèle de processus existants. Certaines sont fournies avec TFS tandis que d'autres sont accessibles dans la galerie Visual Studio et dans d'autres sources de la communauté. Beaucoup de ces versions de modèles de processus sont aussi dans une autre langue que l'anglais. Vous pouvez personnaliser n'importe quel modèle de processus en fonction de votre style de gestion des projets de développement. Pour plus d'informations, consultez Personnalisation des types d'éléments de travail dans Team Foundation Server. Comme il existe de nombreuses variantes des modèles de modèle de processus TFS, vous devrez peut-être configurer Operations Manager pour qu'il fonctionne avec le modèle de processus utilisé actuellement par vos projets d'équipe.
Personnalisation de l'intégration
Si vous utilisez une version non anglaise de TFS ou que vous souhaitez personnaliser une définition du type d'élément de travail du problème opérationnel prédéfinie, vous devez personnaliser l'intégration entre Operations Manager et TFS. Pour ce faire, vous devez modifier la version anglaise de la définition du type d'élément de travail (WITD, Work Item Type Definition) fournie avec Operations Manager pour qu'elle corresponde au modèle de processus et à la langue utilisés dans TFS. Votre personnalisation doit respecter les instructions figurant dans Localisation et globalisation d'éléments enfants d'un élément WITD.
Important
Si vous avez personnalisé la définition WITD ou que vous utilisez votre propre définition WITD, vous devez l'importer manuellement dans TFS, car l'importation automatique sélectionne par défaut une version anglaise d'un modèle de modèle de processus sans aucune personnalisation. Pour plus d'informations, consultez la rubrique Procédure d'importation manuelle d'une définition WITD de problème opérationnel dans TFS dans System Center 2012 R2.
Préparation d'Operations Manager
Pour préparer votre environnement Operations Manager pour l'intégration à une version non anglaise de TFS ou pour la synchronisation avec un modèle de processus personnalisé
-
Vérifiez que vous utilisez le pack d'administration Synchronisation de l'élément de travail Team Foundation Server fourni avec System Center 2012 R2 Update Rollup 1 ou version ultérieure et System Center 2012 SP1 Update Rollup 5 ou version ultérieure. Ce pack d'administration est inclus dans le téléchargement d'Update Rollup 1 et d'Update Rollup 5. Si vous utilisez un pack d'administration Synchronisation de l'élément de travail Team Foundation Server précédent, vous devez le supprimer avant d'importer la version la plus récente.
-
Vérifiez que vous avez importé le pack d'administration Alert Attachment. Pour plus d'informations, consultez Procédure de configuration des pièces jointes pour les alertes Operations Manager dans System Center 2012 R2.
-
Suivez les instructions de l'article Procédure de configuration de l'intégration avec TFS dans System Center 2012 R2, mais n'importez pas automatiquement le type d'élément de travail du problème opérationnel.
-
Après avoir terminé l'Assistant Configuration de la synchronisation de l'élément de travail TFS, cliquez sur Créer. Dans la page Importer la définition du type d'élément de travail du problème opérationnel, cliquez sur Annuler. Vous n'avez pas besoin de fournir un mot de passe. Ensuite, dans la page Synchronisation de l'élément de travail TFS, cliquez sur Enregistrer pour enregistrer les paramètres d'intégration sans importer automatiquement la définition du type d'élément de travail du problème opérationnel.
-
Votre configuration est enregistrée, mais vous ne pouvez pas encore l'utiliser. Vous recevrez une alerte du pack d'administration Synchronisation de l'élément de travail TFS indiquant que la synchronisation est dans un état défectueux. Cette alerte disparaîtra dès que vous aurez fourni une définition WITD valide et configuré les substitutions nécessaires.
Synchronisation avec une définition WITD autre que la définition du type d'élément de travail du problème opérationnel
Par défaut, la synchronisation se produit à l'aide de la définition WITD Operational Issue (en anglais), mais si vous souhaitez synchroniser avec une définition WITD différente ou personnaliser ou modifier le nom par défaut de la définition WITD, par exemple utiliser une traduction du terme Operational Issue, vous devez personnaliser le modèle Type d'élément de travail du problème opérationnel qui se trouve sur le support d'installation Operations Manager, puis l'importer manuellement pour chacun des projets d'équipe utilisés lors de la synchronisation. Pour plus d'informations, consultez la rubrique Procédure d'importation manuelle d'une définition WITD de problème opérationnel dans TFS dans System Center 2012 R2. Pour plus d'informations sur la personnalisation, consultez Personnalisation des types d'éléments de travail.
Combien puis-je effectuer une personnalisation ?
Vous pouvez modifier et personnaliser de nombreux éléments, mais le Type d'élément de travail utilisé dans la synchronisation doit inclure tous les champs qui sont définis par la définition WITD du problème opérationnel. En outre, tous les flux de travail parmi ces champs doivent conserver leur comportement général comme décrit dans la définition WITD du problème opérationnel. Les valeurs de substitution que vous entrez dans Operations Manager doivent correspondre à votre définition WITD.
Dois-je également modifier les substitutions ?
La synchronisation entre Operations Manager et TFS s'appuie sur les éléments suivants de la définition WITD :
Nom de la définition WITD
États et transitions de l'élément de travail
Codes de gravité des problèmes
Si vous avez personnalisé la définition WITD et modifié l'une de ces valeurs, vous devez aussi modifier les substitutions correspondantes.
En outre, vous devez modifier ces substitutions si vous avez modifié l'un de ces éléments dans votre définition WITD :
Nom du type d'élément de travail avec lequel vous synchronisez
Indiquez les valeurs pour les codes d'élément de travail System.State. Vous devez spécifier laquelle des valeurs de System.State d'élément de travail correspond à la définition d'origine de la définition WITD du problème opérationnel. Vous pouvez conserver les valeurs d'origine en anglais ou utiliser des valeurs que vous avez dans votre modèle de processus et/ou la langue souhaitée.
Indiquez les valeurs pour les codes d'élément de travail Microsoft.VSTS.Common.Severity. Valeurs correspondantes pour chacun des états de gravité d'alerte. Vous devez spécifier laquelle des valeurs de Microsoft.VSTS.Common.Severity d'élément de travail correspond à la définition d'origine de la définition WITD du problème opérationnel. Vous pouvez conserver les valeurs d'origine en anglais ou utiliser des valeurs que vous avez dans votre modèle de processus et/ou la langue souhaitée.
Pour personnaliser la définition WITD du problème opérationnel pour qu'elle fonctionne avec votre modèle de processus dans TFS
La personnalisation d'une définition WITD est une opération complexe qui nécessite une bonne compréhension de la gestion des artefacts d'équipe dans TFS. Pour plus d'informations, consultez Personnalisation des types d'éléments de travail dans Team Foundation Server.
Recherchez le fichier OperationalIssue.xml existant et créez-en une copie locale. Vous trouverez la définition WITD du problème opérationnel correcte pour votre version de TFS sur le support d'installation d'Operations Manager dans System Center 2012 R2 dans le dossier SupportTools.
Pour TFS 2010, le nom de fichier est OperationalIssue.xml.
Pour TFS 2012, le nom de fichier est OperationalIssue_11.xml.
Pour TFS 2013, le nom de fichier est OperationalIssue_11.xml.
Conseil
Vous souhaiterez peut-être modifier le nom de fichier pour qu'il corresponde au nom de votre définition WITD. Il est également préférable d'effectuer des copies supplémentaires du fichier, au cas où vous commettriez une erreur lors de ce processus complexe et où vous devriez annuler vos modifications.
Notes
Vous pouvez aussi choisir de commencer à partir de votre propre définition WITD, auquel cas vous devrez la fusionner manuellement avec la définition WITD du problème opérationnel fournie avec Operations Manager. Il s'agit d'une procédure plus complexe, mais elle offre la possibilité de réutiliser la logique d'une définition WITD existante.
Ouvrez une copie locale du fichier dans un éditeur xml et recherchez ces nœuds xml :
Sous le nœud WITD < WORKITEMTYPE name ="Operational Issue">, remplacez « Operational Issue » par le nom de votre élément de travail.
Par exemple, remplacez <WORKITEMTYPE name="Operational Issue"> par <WORKITEMTYPE name="Problème opérationnel" >.
Dans WITD/WORKITEMTYPE/FIELDS, spécifiez la valeur « name » souhaitée pour chaque champ utilisé dans la synchronisation (ils sont répertoriés ci-dessous dans le tableau de substitutions).
Par exemple, remplacez <FIELD name="Assigned To" refname="System.AssignedTo" type="String" syncnamechanges="true" reportable="dimension"> par <FIELD name="Affecté à" refname="Microsoft.VSTS.Common.ClosedDate" type="DateTime" reportable="dimension">.
Important
Les noms des champs doivent correspondre à d'autres définitions WITD dans votre modèle de processus pour le même refname.
Sous WITD/WORKITEMTYPE/FIELDS/FIELD où refname="Microsoft.VSTS.Common.Severity", modifiez les valeurs autorisées pour qu'elles correspondent à vos propres codes de gravité souhaités.
Par exemple, remplacez <FIELD name="Severity" refname="Microsoft.VSTS.Common.Severity" type="String" reportable="dimension"> <ALLOWEDVALUES expanditems="true"> <LISTITEM value="1 - Critical" /> <LISTITEM value="2 - High" /> <LISTITEM value="3 - Medium" /> <LISTITEM value="4 - Low" /> </ALLOWEDVALUES> </FIELD> par ceci : <FIELD name="Gravité" refname="Microsoft.VSTS.Common.Severity" type="String" reportable="dimension"> <ALLOWEDVALUES expanditems="true"> <LISTITEM value="1 - Critique" /> <LISTITEM value="2 - Élevée" /> <LISTITEM value="3 - Moyenne" /> <LISTITEM value="4 - Basse" /> </ALLOWEDVALUES>
Sous WITD/WORKFLOW/STATES, spécifiez les valeurs souhaitées pour chaque état des champs conformément à l'étape b.
Par exemple, modifiez <STATE value="Closed"> en <STATE value="Fermé">.
Sous WITD/TRANSITIONS, modifiez chaque « état » Transition from et Transition to, où les états doivent correspondre aux codes de sécurité choisis à l'étape c.
Par exemple, modifiez <TRANSITION from="Accepted" to="Closed"> en <TRANSITION from="Accepté" to="Fermé">.
Importer la définition WITD dans chaque projet TFS utilisé dans la synchronisation
Mettez en correspondance les valeurs que vous avez modifiées dans ce fichier avec les substitutions dans Operations Manager.
Vous pouvez aussi modifier d'autres constantes et étiquettes pour qu'elles correspondent à votre modèle de processus.
Importez manuellement la définition WITD que vous avez créée dans TFS pour chaque projet que vous souhaitez utiliser avec la synchronisation.
Configuration d'Operations Manager pour utiliser votre définition WITD personnalisée lors de la synchronisation avec TFS
Maintenant que vous avez modifié votre modèle de processus, vous devez modifier les substitutions correspondantes pour les règles dans Operations Manager pour que la synchronisation entre Operations Manager et TFS puisse reconnaître correctement votre définition WITD personnalisée.
Règles et substitutions qui doivent être modifiées dans Operations Manager pour qu'elles correspondent à votre définition WITD personnalisée
Paramètre |
Collection d'objets TFS, règle de synchronisation d'élément de travail TFS |
Collection d'objets TFS, règle de synchronisation d'attachement |
Connecteur d'objet TFS, règle de création d'élément de travail TFS |
Valeur par défaut définie dans la définition WITD du problème opérationnel |
Nom du type d'élément de travail |
Utiliser la valeur de la définition WITD personnalisée |
Utiliser la valeur de la définition WITD personnalisée |
Utiliser la valeur de la définition WITD personnalisée |
Problème opérationnel |
État du problème opérationnel accepté |
Utiliser la valeur de la définition WITD personnalisée |
Non applicable |
Utiliser la valeur de la définition WITD personnalisée |
Accepté |
État du problème opérationnel affecté |
Utiliser la valeur de la définition WITD personnalisée |
Non applicable |
Utiliser la valeur de la définition WITD personnalisée |
Affecté |
Problème opérationnel en attente de preuve |
Utiliser la valeur de la définition WITD personnalisée |
Non applicable |
Utiliser la valeur de la définition WITD personnalisée |
En attente d'une preuve |
Problème opérationnel fermé |
Utiliser la valeur de la définition WITD personnalisée |
Non applicable |
Utiliser la valeur de la définition WITD personnalisée |
Fermé |
Nouveau problème opérationnel |
Utiliser la valeur de la définition WITD personnalisée |
Non applicable |
Utiliser la valeur de la définition WITD personnalisée |
Nouveau |
Problème opérationnel résolu |
Utiliser la valeur de la définition WITD personnalisée |
Non applicable |
Utiliser la valeur de la définition WITD personnalisée |
Résolu |
Problème opérationnel planifié |
Utiliser la valeur de la définition WITD personnalisée |
Non applicable |
Utiliser la valeur de la définition WITD personnalisée |
Planifié |
Problème opérationnel interrompu |
Utiliser la valeur de la définition WITD personnalisée |
Non applicable |
Utiliser la valeur de la définition WITD personnalisée |
Suspendu |
Problème opérationnel en cours |
Utiliser la valeur de la définition WITD personnalisée |
Non applicable |
Utiliser la valeur de la définition WITD personnalisée |
Travail en cours |
Niveau de gravité critique |
Utiliser la valeur de la définition WITD personnalisée |
Non applicable |
Utiliser la valeur de la définition WITD personnalisée |
1 - Critique |
Gravité élevée |
Utiliser la valeur de la définition WITD personnalisée |
Non applicable |
Utiliser la valeur de la définition WITD personnalisée |
2 - Élevée |
Niveau de gravité moyenne |
Utiliser la valeur de la définition WITD personnalisée |
Non applicable |
Utiliser la valeur de la définition WITD personnalisée |
3 - Moyenne |
Informations sur le niveau de gravité |
Utiliser la valeur de la définition WITD personnalisée |
Non applicable |
Utiliser la valeur de la définition WITD personnalisée |
4 - Faible |