Partager une requête d'élément de travail

Article
08/10/2011

Vous pouvez partager une requête d'élément de travail à partir de Team Explorer ou de Team Web Access en l'envoyant dans un message électronique ou en la stockant dans un fichier que vous pouvez partager. Vous pouvez également générer un lien hypertexte qui exécute une requête d'élément de travail, puis partager le lien hypertexte. Pour plus d'informations sur la génération d'une requête pour rechercher des éléments de travail dans Team Foundation, consultez Recherche de bogues, de tâches et d'autres éléments de travail.

Si vous recevez un message électronique auquel une requête d'élément de travail est jointe, vous pouvez exécuter la requête pour afficher le ou les éléments de travail spécifiques que la requête identifie. Pour ouvrir et exécuter la requête, vous devez utiliser un ordinateur sur lequel Team Explorer est installé. Si Team Explorer est connecté à un serveur différent de celui auquel la requête jointe fait référence, lorsque vous ouvrez la requête, Team Explorer ferme la connexion actuelle et établit une connexion avec le serveur référencé par la requête.

Dans cette rubrique

Envoi d'une requête en tant que message électronique
Ouverture d'une requête jointe à un message électronique
Enregistrement d'une requête en tant que fichier à l'aide de Team Explorer
Génération d'un lien hypertexte à l'aide du langage de syntaxe de requête

Autorisations requises

Pour exécuter ces procédures, vous devez être membre du groupe Readers ou disposer de l'autorisation Afficher les éléments de travail dans ce nœud avec la valeur Autoriser pour le projet d'équipe référencé par la requête jointe. D'autres restrictions peuvent s'appliquer. Pour plus d'informations, consultez Organiser les requêtes d'élément de travail et définir les autorisations associées et Autorisations de Team Foundation Server.

Envoi d'une requête en tant que message électronique

Pour copier une requête et l'envoyer à l'aide d'une application de messagerie

Effectuez l'une des étapes suivantes :
- Dans Team Web Access, ouvrez la requête que vous voulez envoyer et copiez l'URL figurant dans la barre d'adresses du navigateur.
- (Avec Office Outlook configuré) Dans Team Explorer, cliquez avec le bouton droit sur la requête à envoyer, puis cliquez sur Envoyer à Microsoft Outlook.
- Dans votre application de messagerie, créez un message électronique, puis collez la requête dans celui-ci.
- Dans Team Explorer, cliquez avec le bouton droit sur la requête à envoyer, puis cliquez sur Copier. Dans votre application de messagerie, créez un message électronique et collez la requête dedans.

Ouverture d'une requête jointe à un message électronique

Pour ouvrir une requête qui vous a été envoyée dans un message électronique

Sur un ordinateur sur lequel Team Explorer est installé, utilisez votre programme de messagerie électronique pour ouvrir le message auquel la requête est jointe.
Si vous utilisez Office Outlook, double-cliquez sur la pièce jointe pour l'ouvrir. Si vous utilisez un autre programme de messagerie électronique et ne savez pas comment ouvrir une pièce jointe, consultez l'Aide de votre programme de messagerie électronique.

La requête s'exécute dans Team Explorer et affiche les résultats.
(Facultatif) Si vous souhaitez enregistrer la requête pour une utilisation ultérieure, dans le menu Fichier, cliquez sur Enregistrer NomRequête.wiq [Éditeur] sous.

Pour plus d'informations, consultez Enregistrer, copier, renommer et supprimer des requêtes d'élément de travail.

Enregistrement d'une requête en tant que fichier à l'aide de Team Explorer

Pour enregistrer une requête en tant que fichier à l'aide de Team Explorer

Dans Team Explorer, cliquez avec le bouton droit sur la requête à envoyer, puis cliquez sur Modifier la requête.
Dans le menu Fichier, cliquez sur Enregistrer NomRequête [Éditeur] sous.

La requête est enregistrée avec l'extension de fichier .wiq.
Sous Sélectionnez le type de requête et enregistrez l'emplacement, cliquez sur Fichier.

Si vous voulez enregistrer le fichier de requête dans un dossier autre que l'emplacement par défaut, cliquez sur Parcourir et spécifiez le dossier.
Cliquez sur Enregistrer.

Vous pouvez joindre le fichier enregistré à un message électronique, copier le fichier dans un dossier partagé ou encore modifier le fichier avec un éditeur de texte, tel que le Bloc-notes.

Génération d'un lien hypertexte à l'aide du langage de syntaxe de requête

Pour créer un lien hypertexte qui exécute une requête

Construisez un lien qui correspond à l'un des modèles suivants :

Team Web Access

http://NomServeur:Port/Chemin/web/q.aspx?pname=Projet&wiql=LangageWIQL

Exemple :

http://AdventureWorks:8080/tfs/web/q.aspx?pname=AdventureWorksProject&wiql==SELECT [System.ID], [System.Title], [System.State] FROM WorkItems WHERE [System.TeamProject]='AdventureWorksProject' AND [System.WorkItemType]='Bug' AND [System.FoundIn]='9.0.30304' http://Server1:8091/tfs/web/wi.aspx?id=9035

Team Explorer

http://NomServeur:Port/Chemin/q.aspx?pname=Projet&wiql=LangageWIQL

Exemple :

http://AdventureWorks:8080/q.aspx?pname=AdventureWorksProject&wiql==SELECT [System.ID], [System.Title], [System.State] FROM WorkItems WHERE [System.TeamProject]='AdventureWorksProject' AND [System.WorkItemType]='Bug' AND [System.FoundIn]='9.0.30304'

où :

NomServeur spécifie le nom du serveur qui exécute Team Foundation Server.
Port spécifie le port utilisé par Team Foundation Server. La valeur par défaut est 8080.
CheminAccès spécifie l'emplacement de répertoire où Team Foundation Server est installé.

Notes

Team Web Access est installé dans le sous-répertoire nommé « web », directement sous le répertoire où vous avez installé Team Foundation Server.
Projet spécifie le nom du projet d'équipe qui est la cible de la requête.
LangageWIQL est un langage similaire à SQL que vous pouvez utiliser pour lancer une requête par programmation pour les éléments de travail.

Dans les exemples précédents, l'URL exécute une requête sur le serveur AdventureWorks, port 8080, sur le projet AdventureWorksProject, et retourne l'ID, le titre et l'état de tous les bogues qui ont le numéro de build 9.0.30304.

Notes

Si vous n'êtes pas familiarisé avec le langage WIQL (Work Item Query Language), vous pouvez créer un exemple en enregistrant une nouvelle requête ou une requête existante en tant que fichier .wiq. Pour obtenir des étapes spécifiques, consultez Enregistrement d'une requête en tant que fichier à l'aide de Team Explorer. Vous pouvez ensuite ouvrir le fichier dans un éditeur de texte tel que le Bloc-notes, modifier le langage de requête en fonction de vos besoins, et le copier dans le lien hypertexte. Pour plus d'informations sur le langage de syntaxe de requête, consultez la page suivante sur le site Web Microsoft : Langage WIQL (Work Item Query Language) (page éventuellement en anglais).

Partagez le lien hypertexte en le copiant dans un message électronique ou en l'encodant sur une page Web ou un formulaire d'application logicielle.

Voir aussi

Partager via