My Tasks Introduction
Associer SharePoint Online et Azure DevOps permet aux équipes de travailler avec des données d'ingénierie en temps réel, sans quitter l'espace collaboratif où elles planifient, documentent et communiquent déjà.
Cet article vous guide dans l'installation et la configuration du composant WebPart Azure DevOps Query Viewer dans SharePoint Online afin d'afficher les résultats d'une requête Azure DevOps.
Que vous soyez développeur et souhaitiez rationaliser votre flux de travail, ou administrateur et souhaitiez améliorer la gestion de projet de votre équipe, ce guide pas à pas vous aidera à configurer et à personnaliser le composant WebPart selon vos besoins.
Composant WebPart Azure DevOps Query Viewer
Le composant WebPart Azure DevOps Query fait partie de la solution My Tasks et est disponible depuis la version 6.x.
📝 Remarque
Pour utiliser ce composant WebPart, assurez-vous que votre solution My Tasks est mise à jour vers la dernière version. Pour des instructions pas à pas, consultez le guide de mise à jour de la solution.
Prérequis
Avant d'installer et de configurer le composant WebPart sur votre site SharePoint Online, assurez-vous que les prérequis suivants sont remplis :
1. Accès API approuvé pour la solution SharePoint
Dans Accès API du centre d’administration SharePoint, approuvez l’autorisation demandée par le package My Tasks : ressource Azure DevOps, étendue user_impersonation. Elle permet au composant WebPart d’appeler les API REST d’Azure DevOps au nom de l’utilisateur connecté.
Sans cet accès, le composant WebPart ne peut ni récupérer ni afficher les données d'Azure DevOps.
💡 Astuce
Pour des instructions d'installation détaillées, consultez l'article Comment installer un produit Vitextra dans SharePoint Online.
2. Accès à l'organisation Azure DevOps
Vous devez avoir accès à l'organisation Azure DevOps qui servira de source de données au composant WebPart. Cela implique de disposer d'un compte Azure DevOps actif et d'être membre de l'organisation dans laquelle les requêtes sont stockées.
Sans cet accès, le composant WebPart ne peut pas récupérer les données dont il a besoin.
📝 Remarque
Dans SharePoint Online et Azure DevOps, la solution My Tasks appelle l'API et les autres services au nom de l'utilisateur connecté.
Pour en savoir plus sur la confidentialité et la protection des données, consultez l'article Protection des données lors de l'utilisation de l'application Vitextra.
3. Autorisations nécessaires pour lire les informations sur les projets et les requêtes
Chaque utilisateur du composant WebPart a besoin des autorisations Azure DevOps appropriées pour lire les projets et les requêtes - généralement au moins un accès en lecture aux projets et aux requêtes affichés sur la page SharePoint.
Vérifiez que les rôles Azure DevOps des utilisateurs leur accordent ces autorisations afin d'éviter tout problème d'accès à l'usage.
Ajouter le composant WebPart
Une fois tous les prérequis remplis, vous pouvez ajouter le composant WebPart Azure DevOps Query à votre site SharePoint Online.
Accédez à la page sur laquelle vous souhaitez placer le composant WebPart et cliquez sur Edit (Modifier). Cliquez ensuite sur l'icône + pour ajouter un nouveau composant WebPart - la liste des composants WebPart disponibles s'affiche.
Recherchez le composant WebPart Azure DevOps Query dans la liste et sélectionnez-le pour l'ajouter à la page.
Une fois ajouté, le composant WebPart affiche un message indiquant qu'il n'est pas encore configuré :
Configurez-le pour afficher les résultats de requête souhaités.
Configuration du composant WebPart
Cliquez sur l'icône Modifier le composant WebPart (crayon) ou sur le bouton Configurer le composant WebPart pour ouvrir le volet de configuration.
Source de données
Dans le volet de configuration, saisissez les informations nécessaires pour vous connecter à votre organisation Azure DevOps :
- l'Organisation Azure DevOps ;
- le Projet dont vous souhaitez afficher les résultats de requête ;
- la Requête précise à afficher.
Types de requêtes pris en charge
La liste déroulante Requête propose les requêtes enregistrées des types suivants :
| Type de requête dans Azure DevOps | Affichage |
|---|---|
| Liste plate d'éléments de travail | Un tableau, que vous pouvez trier et regrouper. |
| Arborescence d'éléments de travail | Une hiérarchie qu'il est possible de développer ; le tri et le regroupement sont désactivés. |
| Éléments de travail et liens directs (one-hop) | Une hiérarchie qu'il est possible de développer, comme pour une requête arborescente. |
Les autres types de requêtes ne sont pas proposés. Une requête est chargée avec ses propres colonnes et son propre ordre, et 1000 éléments de travail au maximum sont chargés par requête.
📝 Remarque
Les versions antérieures du composant WebPart ne prenaient en charge que les requêtes plates. Les requêtes arborescentes et de liens directs sont prises en charge dans la version actuelle de My Tasks ; assurez-vous que la solution est mise à jour vers la dernière version.
Options d'affichage
Utilisez le curseur Limitation des lignes pour définir le nombre d'éléments de travail affichés à la fois.
Pour activer la pagination, sélectionnez Afficher les éléments par groupes de la taille spécifiée. et choisissez l'emplacement du contrôle de pagination (en haut, en bas ou aux deux endroits).
Pour désactiver la pagination, sélectionnez Limiter le nombre total d'éléments retournés à la quantité spécifiée. et saisissez le nombre souhaité.
Apparence
La dernière section vous permet de personnaliser l'affichage des résultats de la requête sur votre site SharePoint Online. Deux options clés :
Liste compacte. Affiche la liste des résultats dans un format plus condensé, ce qui permet d'afficher davantage d'informations à l'écran avec moins de défilement.
Barre de commandes. Donne aux utilisateurs un accès rapide aux actions applicables aux résultats affichés, comme l'actualisation des données et l'exportation vers Excel.
Résultat
Une fois ces étapes terminées, les résultats de la requête Azure DevOps sont intégrés à votre site SharePoint Online. Votre équipe peut désormais consulter les données Azure DevOps en temps réel directement dans SharePoint, ce qui améliore la collaboration et l'efficacité de la gestion de projet.
Conclusion
Le composant WebPart Azure DevOps Query apporte dans SharePoint des résultats de requête à jour issus d'Azure DevOps : votre équipe voit toujours les dernières informations, sans passer d'une plateforme à l'autre. Grâce à des options comme le mode compact et la barre de commandes, vous pouvez adapter l'affichage à vos besoins et offrir à tous une vue commune des tâches et de l'avancement du projet.
