Connecteur Microsoft Graph Azure DevOps Work Items

Le connecteur Microsoft Graph Azure DevOps Work Items permet à votre organization d’indexer des éléments de travail dans son instance du service Azure DevOps. Après avoir configuré le connecteur, les utilisateurs finaux peuvent rechercher des éléments de travail à partir d’Azure DevOps dans Recherche et Microsoft 365 Copilot Microsoft.

Cet article est destiné aux administrateurs Microsoft 365 ou à toute personne qui configure, exécute et surveille un connecteur Microsoft Graph Azure DevOps Work Items.

Fonctionnalités

• Indexer des éléments de travail à partir d’Azure DevOps
• Permettre à vos utilisateurs finaux de poser des questions relatives aux éléments de travail.
• Utilisez la recherche sémantique dans Copilot pour permettre aux utilisateurs de trouver du contenu pertinent en fonction des mots clés, des préférences personnelles et des connexions sociales.

Limitations

• Le connecteur indexe uniquement un organization ADO par connexion.

Configuration requise

• Vous devez être l’administrateur de recherche du locataire Microsoft 365 de votre organization.

• Pour permettre au connecteur de se connecter à votre organization Azure DevOps, vous devez activer l’accès aux applications tierces via OAuth. Pour en savoir plus, consultez la documentation Azure DevOps pour gérer les stratégies de sécurité .

  

• Compte de service : pour vous connecter à Azure DevOps et permettre au connecteur Microsoft Graph de mettre à jour régulièrement les éléments de travail, vous avez besoin d’un compte de service avec les autorisations suivantes qui lui sont accordées.

  Nom de l’autorisation	Type d’autorisation	Requis pour
  Afficher les informations au niveau du projet	Autorisation de projet	Analyse des éléments de travail Azure DevOps. Cette autorisation est obligatoire pour les projets qui doivent être indexés.
  Afficher l’analytique	Autorisation de projet	Analyse des éléments de travail Azure DevOps. Cette autorisation est obligatoire pour les projets qui doivent être indexés.
  Afficher les éléments de travail dans ce nœud	Chemin d’accès à la zone	Analyse des éléments de travail dans un chemin de zone. Cette autorisation est facultative. Seuls les chemins de zone pour lesquels le compte d’utilisateur dispose d’une autorisation sont analysés.

  Importante

  Le compte de service doit avoir un niveau d’accès De base . Pour en savoir plus sur les niveaux d’accès dans Azure DevOps, lisez niveaux d’accès pris en charge.

Prise en main

1. Nom d’affichage

Un nom d’affichage est utilisé pour identifier chaque citation dans Copilot, ce qui permet aux utilisateurs de reconnaître facilement le fichier ou l’élément associé. Le nom d’affichage indique également le contenu approuvé. Le nom d’affichage est également utilisé comme filtre de source de contenu. Une valeur par défaut est présente pour ce champ, mais vous pouvez la personnaliser avec un nom que les utilisateurs de votre organization reconnaître.

2. Organisation ADO

Le connecteur Azure DevOps permet l’indexation d’un organization par connexion. Pour vous connecter à votre service Azure DevOps, indiquez le nom du organization à indexer.

3. Type d’authentification

Pour authentifier et synchroniser des éléments de travail à partir d’Azure DevOps, choisissez l’une des deux méthodes prises en charge :

a. Microsoft Entra ID OAuth

Vérifiez que votre organisation ADO est connectée à Microsoft Entra

Le connecteur Azure DevOps Graph indexe uniquement le contenu d’un organization ADO connecté à Microsoft Entra de votre locataire. Pour vous assurer que votre organization ADO est connecté à Microsoft Entra compte, procédez comme suit.

1. Accédez à Azure DevOps et sélectionnez le organization requis.
2. Sélectionnez Organization settings.
3. Dans le volet de navigation gauche, sélectionnez Microsoft Entra sous l’en-tête « Général ».
4. Vérifiez que le organization est connecté au compte Microsoft Entra de votre locataire.

Créer une application sur Microsoft Entra ID

1. Accédez au Portail Azure et connectez-vous avec les informations d’identification d’administrateur du locataire.
2. Accédez à Microsoft Entra ID ->Gérer ->inscriptions d'applications dans le volet de navigation, puis sélectionnez Nouvelle inscription.
3. Fournissez un nom pour l’application, puis sélectionnez Inscrire.
4. Notez l’ID d’application (client). Cet ID est utilisé pour accorder à l’application Microsoft Entra l’accès aux projets dans le organization ADO.
5. Ouvrez autorisations d’API dans le volet de navigation et sélectionnez Ajouter une autorisation.
6. Sélectionnez Azure DevOps , puis Autorisations déléguées.
7. Recherchez les autorisations suivantes, puis sélectionnez Ajouter des autorisations.
   a. Identité (lecture)
   b. Éléments de travail (lecture)
   c. Variable Groupes (lecture)
   d. Projet et équipe (lecture)
   e. Graphe (lecture)
   f. Analytique (lecture)
   
8. Sélectionnez Accorder le consentement administrateur pour [TenantName] et confirmez en sélectionnant Oui.
9. Vérifiez que les autorisations sont dans l’état « Accordé ».
10. Ouvrez Authentification à partir du volet de navigation. Sélectionnez Add a platform et choisissez Web. Ajoutez l’un des URI suivants sous « URI de redirection » :
    • Pour M365 Enterprise : https:// gcs.office.com/v1.0/admin/oauth/callback
    • Pour le gouvernement M365 : https:// gcsgcc.office.com/v1.0/admin/oauth/callback
11. Sous Octroi implicite et flux hybrides, case activée l’option pour ID tokens (used for implicit and hybrid flows) et cliquez sur Configurer.
12. Dans le volet de navigation, sélectionnez Certificats et secrets sous Gérer.
13. Sélectionnez Nouvelle clé secrète client , puis sélectionnez une période d’expiration pour le secret. Copiez le secret généré (Valeur) et enregistrez-le, car il n’est plus affiché.
14. Utilisez cette clé secrète client et l’ID d’application pour configurer le connecteur.

Accorder à l’application Microsoft Entra l’accès aux projets dans le organization ADO

Vous devez fournir à l’application Microsoft Entra l’accès nécessaire aux projets qui doivent être indexés en procédant comme suit :

1. Accédez à Azure DevOps et sélectionnez le organization requis.
2. Sélectionnez Organization settings.
3. Dans le volet de navigation gauche, sélectionnez Users sous l’en-tête « Général ».
4. Sélectionnez Add users.
5. Copiez l’ID d’application (client) obtenu à partir de l’application dans « Utilisateurs ou principaux de service ».
6. Accordez le niveau d’accès Basic et sélectionnez les projets pour autoriser l’accès à l’index. Ajoutez également au Project Reader groupe Azure DevOps (ou équivalent) pour garantir l’accès. Désactivez la sélection de l’option permettant d’envoyer une invitation par e-mail aux utilisateurs.

b. Azure DevOps OAuth

Pour vous connecter à votre instance Azure DevOps, vous avez besoin de votre nom de organization Azure DevOps, de son ID d’application et de sa clé secrète client pour l’authentification OAuth.

Inscrire une application

Inscrivez une application dans Azure DevOps afin que l’application Recherche Microsoft et Microsoft 365 Copilot puissent accéder à la instance. Pour en savoir plus, consultez la documentation Azure DevOps sur l’inscription d’une application.

Le tableau suivant fournit des conseils sur la façon de remplir le formulaire d’inscription de l’application :

Lors de l’inscription de l’application, vous obtenez l’ID d’application et la clé secrète client qui sont utilisés pour configurer le connecteur.

4. Déployer pour un public limité

Déployez cette connexion sur une base d’utilisateurs limitée si vous souhaitez la valider dans Copilot et d’autres surfaces de recherche avant d’étendre le déploiement à un public plus large. Pour en savoir plus sur le déploiement limité, consultez Déploiement intermédiaire.

À ce stade, vous êtes prêt à créer la connexion pour les éléments de travail Azure DevOps. Vous pouvez cliquer sur Créer pour publier votre connexion et indexer des éléments de travail à partir de votre organization Azure DevOps.

Pour les autres paramètres, tels que les autorisations d’accès, lesrègles d’inclusion de données, le schéma, la fréquence d’analyse, etc., nous avons des valeurs par défaut basées sur ce qui fonctionne le mieux avec les données ADO. Vous pouvez voir les valeurs par défaut ci-dessous :

Si vous souhaitez modifier l’une de ces valeurs, vous devez choisir la « Configuration personnalisée »

Configuration personnalisée

L’installation personnalisée est destinée aux administrateurs qui souhaitent modifier les valeurs par défaut des paramètres répertoriés dans le tableau ci-dessus. Une fois que vous avez cliqué sur l’option « Configuration personnalisée », trois onglets supplémentaires s’affichent : Utilisateurs, Contenu et Synchronisation.

Utilisateurs

Autorisations d’accès

Le connecteur Éléments de travail Azure DevOps prend en charge les autorisations de recherche visibles pour tout le monde ou uniquement pour les personnes ayant accès à cette source de données. Si vous choisissez Tout le monde, les données indexées apparaissent dans les résultats de la recherche pour tous les utilisateurs. Si vous choisissez Uniquement les personnes ayant accès à cette source de données, les données indexées apparaissent dans les résultats de la recherche pour les utilisateurs qui y ont accès.

Contenu

Choisir des projets

Dans cette étape, vous spécifiez l’étendue des données que vous souhaitez indexer à l’aide du connecteur Microsoft Graph Azure DevOps Work Items. Vous pouvez ensuite choisir que la connexion indexe l’intégralité du organization ou des projets spécifiques dans le organization sélectionné.

Si vous choisissez d’indexer l’intégralité du organization, les éléments de travail de tous les projets du organization sont indexés. Les nouveaux projets et éléments de travail sont indexés lors de l’analyse suivante après leur création.

Si vous choisissez d’indexer des projets individuels, seuls les éléments de travail des projets sélectionnés sont indexés.

Gérer les propriétés

Ici, vous pouvez ajouter ou supprimer des propriétés disponibles de votre source de données Azure DevOps, affecter un schéma à la propriété (définir si une propriété peut faire l’objet d’une recherche, s’il est interrogeable, récupérable ou refinable), modifier l’étiquette sémantique et ajouter un alias à la propriété. Les propriétés sélectionnées par défaut sont répertoriées ci-dessous.

Afficher un aperçu des données

Utilisez le bouton d’aperçu des résultats pour vérifier les exemples de valeurs des propriétés sélectionnées.

Synchronisation

L’intervalle d’actualisation détermine la fréquence à laquelle vos données sont synchronisées entre la source de données et l’index du connecteur Graph. Il existe deux types d’intervalles d’actualisation : l’analyse complète et l’analyse incrémentielle. Pour plus d’informations, consultez Paramètres d’actualisation.

Vous pouvez modifier les valeurs par défaut de l’intervalle d’actualisation à partir d’ici si vous le souhaitez.

Résolution des problèmes

Après avoir publié votre connexion, vous pouvez consulter la status sous l’onglet Sources de données dans le Centre d’administration. Pour savoir comment effectuer des mises à jour et des suppressions, consultez Gérer votre connecteur. Vous trouverez les étapes de résolution des problèmes courants ici.

Si vous rencontrez des problèmes ou si vous souhaitez fournir des commentaires, contactez Microsoft Graph | Support.