Work Items - Get Work Items Batch

Référence

Service:: Work Item Tracking

Version d'API:: 7.1

Obtient les éléments de travail pour une liste d’ID d’élément de travail (maximum 200)

POST https://dev.azure.com/{organization}/{project}/_apis/wit/workitemsbatch?api-version=7.1

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
organization	path	True	string	Nom de l’organisation Azure DevOps.
project	path		string	ID de projet ou nom du projet
api-version	query	True	string	Version de l’API à utiliser. Cette valeur doit être définie sur « 7.1 » pour utiliser cette version de l’API.

Corps de la demande

Nom	Type	Description
$expand	WorkItemExpand	Paramètres de développement pour les attributs d’élément de travail. Les options possibles sont { None, Relations, Fields, Links, All }
asOf	string (date-time)	Chaîne d’heure de date UTC AsOf
errorPolicy	WorkItemErrorPolicy	Indicateur permettant de contrôler la stratégie d’erreur dans une demande d’éléments de travail get en bloc. Les options possibles sont {Fail, Omit}.
fields	string[]	Champs demandés
ids	integer[] (int32)	ID d’élément de travail demandé

Réponses

Nom	Type	Description
200 OK	WorkItem[]	opération réussie

Sécurité

oauth2

Type: oauth2
Flux: accessCode
URL d’autorisation: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL du jeton: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Étendues

Nom	Description
vso.work	Octroie la possibilité de lire des éléments de travail, des requêtes, des tableaux, des zones et des itérations, ainsi que d’autres métadonnées associées au suivi des éléments de travail. Accorde également la possibilité d’exécuter des requêtes, de rechercher des éléments de travail et de recevoir des notifications sur les événements d’élément de travail via des hooks de service.

Nom

Description

vso.work

Octroie la possibilité de lire des éléments de travail, des requêtes, des tableaux, des zones et des itérations, ainsi que d’autres métadonnées associées au suivi des éléments de travail. Accorde également la possibilité d’exécuter des requêtes, de rechercher des éléments de travail et de recevoir des notifications sur les événements d’élément de travail via des hooks de service.

Exemples

Get list of work items for specific fields

Exemple de requête

HTTP

POST https://dev.azure.com/fabrikam/_apis/wit/workitemsbatch?api-version=7.1

{
  "ids": [
    297,
    299,
    300
  ],
  "fields": [
    "System.Id",
    "System.Title",
    "System.WorkItemType",
    "Microsoft.VSTS.Scheduling.RemainingWork"
  ]
}

Exemple de réponse

Code d’état:: 200

{
  "count": 3,
  "value": [
    {
      "id": 297,
      "rev": 1,
      "fields": {
        "System.Id": 297,
        "System.WorkItemType": "Product Backlog Item",
        "System.Title": "Customer can sign in using their Microsoft Account"
      },
      "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/297"
    },
    {
      "id": 299,
      "rev": 7,
      "fields": {
        "System.Id": 299,
        "System.WorkItemType": "Task",
        "System.Title": "JavaScript implementation for Microsoft Account",
        "Microsoft.VSTS.Scheduling.RemainingWork": 4
      },
      "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/299"
    },
    {
      "id": 300,
      "rev": 1,
      "fields": {
        "System.Id": 300,
        "System.WorkItemType": "Task",
        "System.Title": "Unit Testing for MSA login",
        "Microsoft.VSTS.Scheduling.RemainingWork": 3
      },
      "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/300"
    }
  ]
}

Définitions

Nom	Description
ReferenceLinks	Classe à représenter une collection de liens de référence REST.
WorkItem	Décrit un élément de travail.
WorkItemBatchGetRequest	Décrit une requête pour obtenir un ensemble d’éléments de travail
WorkItemCommentVersionRef	Représente la référence à une version spécifique d’un commentaire sur un élément de travail.
WorkItemErrorPolicy	Indicateur permettant de contrôler la stratégie d’erreur dans une demande d’éléments de travail get en bloc. Les options possibles sont {Fail, Omit}.
WorkItemExpand	Paramètres de développement pour les attributs d’élément de travail. Les options possibles sont { None, Relations, Fields, Links, All }
WorkItemRelation

ReferenceLinks

Object

Classe à représenter une collection de liens de référence REST.

Nom	Type	Description
links	object	Vue en lecture seule des liens. Étant donné que les liens de référence sont en lecture seule, nous voulons uniquement les exposer en lecture seule.

WorkItem

Object

Décrit un élément de travail.

Nom	Type	Description
_links	ReferenceLinks	Lier des références aux ressources REST associées.
commentVersionRef	WorkItemCommentVersionRef	Référence à une version spécifique du commentaire ajouté/modifié/supprimé dans cette révision.
fields	object	Mappage du champ et des valeurs de l’élément de travail.
id	integer (int32)	ID de l’élément de travail.
relations	WorkItemRelation[]	Relations de l’élément de travail.
rev	integer (int32)	Numéro de révision de l’élément de travail.
url	string

WorkItemBatchGetRequest

Object

Décrit une requête pour obtenir un ensemble d’éléments de travail

Nom	Type	Description
$expand	WorkItemExpand	Paramètres de développement pour les attributs d’élément de travail. Les options possibles sont { None, Relations, Fields, Links, All }
asOf	string (date-time)	Chaîne d’heure de date UTC AsOf
errorPolicy	WorkItemErrorPolicy	Indicateur permettant de contrôler la stratégie d’erreur dans une demande d’éléments de travail get en bloc. Les options possibles sont {Fail, Omit}.
fields	string[]	Champs demandés
ids	integer[] (int32)	ID d’élément de travail demandé

WorkItemCommentVersionRef

Object

Représente la référence à une version spécifique d’un commentaire sur un élément de travail.

Nom	Type	Description
commentId	integer (int32)	ID affecté au commentaire.
createdInRevision	integer (int32)	[Interne] Révision de l’élément de travail dans laquelle ce commentaire a été ajouté à l’origine.
isDeleted	boolean	[Interne] Spécifie si le commentaire a été supprimé.
text	string	[Interne] Texte du commentaire.
url	string
version	integer (int32)	Numéro de version.

WorkItemErrorPolicy

Énumération

Indicateur permettant de contrôler la stratégie d’erreur dans une demande d’éléments de travail get en bloc. Les options possibles sont {Fail, Omit}.

Valeur	Description
fail	Échec de la stratégie d’erreur de travail.
omit	Omettre la stratégie d’erreur de travail.

WorkItemExpand

Énumération

Paramètres de développement pour les attributs d’élément de travail. Les options possibles sont { None, Relations, Fields, Links, All }

Valeur	Description
all	Développe tout.
fields	Développez l’élément de travail Champs.
links	L’élément de travail liens se développe.
none	Comportement par défaut.
relations	L’élément de travail Relations se développe.

WorkItemRelation

Object

Nom	Type	Description
attributes	object	Collection d’attributs de lien.
rel	string	Type de relation.
url	string	URL du lien.

Partager via

Work Items - Get Work Items Batch

Paramètres URI

Corps de la demande

Réponses

Sécurité

oauth2

Étendues

Exemples

Get list of work items for specific fields

Exemple de requête

Exemple de réponse

Définitions

ReferenceLinks

WorkItem

WorkItemBatchGetRequest

WorkItemCommentVersionRef

WorkItemErrorPolicy

WorkItemExpand

WorkItemRelation