States - Get

Referenz

Dienst:: Work Item Tracking Process

API-Version:: 7.1

Gibt eine einzelne Statusdefinition in einem Arbeitsaufgabentyp des Prozesses zurück.

GET https://dev.azure.com/{organization}/_apis/work/processes/{processId}/workItemTypes/{witRefName}/states/{stateId}?api-version=7.1

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
organization	path	True	string	Der Name der Azure DevOps-Organisation.
processId	path	True	string (uuid)	Die ID des Prozesses
stateId	path	True	string (uuid)	Die ID des Zustands
witRefName	path	True	string	Der Verweisname des Arbeitsaufgabentyps
api-version	query	True	string	Version der zu verwendenden API. Dies sollte auf "7.1" festgelegt werden, um diese Version der API zu verwenden.

Antworten

Name	Typ	Beschreibung
200 OK	WorkItemStateResultModel	Erfolgreicher Vorgang

Sicherheit

oauth2

Typ: oauth2
Ablauf: accessCode
Autorisierungs-URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token-URL: 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

Bereiche

Name	Beschreibung
vso.work	Gewährt die Möglichkeit, Arbeitsaufgaben, Abfragen, Boards, Flächen- und Iterationspfade und andere Metadaten zur Nachverfolgung von Arbeitsaufgaben zu lesen. Gewährt außerdem die Möglichkeit, Abfragen auszuführen, Arbeitsaufgaben zu durchsuchen und Benachrichtigungen über Arbeitsaufgabenereignisse über Dienst-Hooks zu erhalten.

Beispiele

Get state definition

Beispielanforderung

HTTP

GET https://dev.azure.com/{organization}/_apis/work/processes/{processId}/workItemTypes/{witRefName}/states/{stateId}?api-version=7.1

Beispiel für eine Antwort

Statuscode:: 200

{
  "id": "7b7e3e8c-e500-40b6-ad56-d59b8d64d757",
  "name": "New",
  "color": "b2b2b2",
  "stateCategory": "Proposed",
  "order": 1,
  "url": "https://dev.azure.com/fabrikam/_apis/work/processDefinitions/a6c1d9b6-ea27-407d-8c40-c9b7ab112bb6/workItemTypes/Microsoft.VSTS.WorkItemTypes.Bug/states/7b7e3e8c-e500-40b6-ad56-d59b8d64d757"
}

Definitionen

Name	Beschreibung
CustomizationType	Gibt den Typ der Anpassung für diese Arbeitsaufgabe an. Systemverhalten wird vom übergeordneten Prozess geerbt, aber nicht geändert. Geerbte Verhaltensweisen sind geänderte Verhaltensweisen, die vom übergeordneten Prozess geerbt wurden. Benutzerdefinierte Verhaltensweisen sind Verhaltensweisen, die vom Benutzer im aktuellen Prozess erstellt werden.
WorkItemStateResultModel	Klasse, die ein Arbeitsaufgabenstatusergebnis darstellt.

CustomizationType

Enumeration

Gibt den Typ der Anpassung für diese Arbeitsaufgabe an. Systemverhalten wird vom übergeordneten Prozess geerbt, aber nicht geändert. Geerbte Verhaltensweisen sind geänderte Verhaltensweisen, die vom übergeordneten Prozess geerbt wurden. Benutzerdefinierte Verhaltensweisen sind Verhaltensweisen, die vom Benutzer im aktuellen Prozess erstellt werden.

Wert	Beschreibung
custom	Der Anpassungstyp ist "Benutzerdefiniert", wenn der neu erstellte Arbeitselementtyp angepasst wird.
inherited	Der Anpassungstyp wird geerbt, wenn der vorhandene Arbeitselementtyp des geerbten Prozesses angepasst wird.
system	Der Anpassungstyp ist System, wenn vom System generierter Arbeitselementtyp.

WorkItemStateResultModel

Objekt

Klasse, die ein Arbeitsaufgabenstatusergebnis darstellt.

Name	Typ	Beschreibung
color	string	Arbeitselementstatusfarbe.
customizationType	CustomizationType	Anpassungstyp des Arbeitselementstatus.
hidden	boolean	Wenn der Status "Arbeitselement" ausgeblendet ist.
id	string (uuid)	ID des Workitemstate.
name	string	Name des Arbeitselementstatus.
order	integer (int32)	Arbeitsaufgabenstatusreihenfolge.
stateCategory	string	Statusstatus der Arbeitsaufgabe.
url	string	Url des Arbeitsaufgabenstatus.

Freigeben über