Behaviors - List
Gibt eine Liste aller Verhaltensweisen im Prozess zurück.
GET https://dev.azure.com/{organization}/_apis/work/processes/{processId}/behaviors?api-version=5.0-preview.2
GET https://dev.azure.com/{organization}/_apis/work/processes/{processId}/behaviors?$expand={$expand}&api-version=5.0-preview.2
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
organization
|
path | True |
string |
Der Name der Azure DevOps-Organisation. |
process
|
path | True |
string uuid |
Die ID des Prozesses |
api-version
|
query | True |
string |
Version der zu verwendenden API. Dies sollte auf "5.0-preview.2" festgelegt werden, um diese Version der API zu verwenden. |
$expand
|
query |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Erfolgreicher Vorgang |
Sicherheit
oauth2
Type:
oauth2
Flow:
accessCode
Authorization 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
Scopes
Name | Beschreibung |
---|---|
vso.work | Ermöglicht das Lesen von Arbeitselementen, Abfragen, Boards, Bereichs- und Iterationspfaden und anderen Metadaten zur Nachverfolgung von Arbeitselementen. Bietet außerdem die Möglichkeit, Abfragen auszuführen, Arbeitselemente zu durchsuchen und Benachrichtigungen über Arbeitselementereignisse über Diensthooks zu erhalten. |
Beispiele
Get the list of process behaviors |
Get the list of process behaviors with Combined |
Get the list of process behaviors with Fields option |
Get the list of process behaviors
Sample Request
GET https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors?$expand=Fields&api-version=5.0-preview.2
Sample Response
{
"count": 7,
"value": [
{
"name": "MyCustomBehavior",
"referenceName": "Custom.4b8fdba0-7064-458d-b55c-522b39059a62",
"color": "009CDD",
"rank": 50,
"description": null,
"customization": "custom",
"inherits": {
"behaviorRefName": "System.PortfolioBacklogBehavior",
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.PortfolioBacklogBehavior"
},
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/Custom.4b8fdba0-7064-458d-b55c-522b39059a62"
},
{
"name": "Stories",
"referenceName": "System.RequirementBacklogBehavior",
"color": "009CCC",
"rank": 20,
"description": "Requirement level backlog and board",
"customization": "inherited",
"inherits": {
"behaviorRefName": "System.OrderedBehavior",
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.OrderedBehavior"
},
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.RequirementBacklogBehavior"
},
{
"name": "Epics",
"referenceName": "Microsoft.VSTS.Agile.EpicBacklogBehavior",
"color": "FF7B00",
"rank": 40,
"description": "Epic level backlog and board",
"customization": "system",
"inherits": {
"behaviorRefName": "System.PortfolioBacklogBehavior",
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.PortfolioBacklogBehavior"
},
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/Microsoft.VSTS.Agile.EpicBacklogBehavior"
},
{
"name": "Features",
"referenceName": "Microsoft.VSTS.Agile.FeatureBacklogBehavior",
"color": "773B93",
"rank": 30,
"description": "Feature level backlog and board",
"customization": "system",
"inherits": {
"behaviorRefName": "System.PortfolioBacklogBehavior",
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.PortfolioBacklogBehavior"
},
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/Microsoft.VSTS.Agile.FeatureBacklogBehavior"
},
{
"name": "Ordered",
"referenceName": "System.OrderedBehavior",
"color": null,
"rank": 0,
"description": "Enables work items to be ordered relative to other work items",
"customization": "system",
"inherits": null,
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.OrderedBehavior"
},
{
"name": "Tasks",
"referenceName": "System.TaskBacklogBehavior",
"color": "F2CB1D",
"rank": 10,
"description": "Task level backlog and board",
"customization": "system",
"inherits": {
"behaviorRefName": "System.OrderedBehavior",
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.OrderedBehavior"
},
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.TaskBacklogBehavior"
},
{
"name": "Portfolio",
"referenceName": "System.PortfolioBacklogBehavior",
"color": null,
"rank": 0,
"description": "Portfolio level backlog and board",
"customization": "system",
"inherits": {
"behaviorRefName": "System.OrderedBehavior",
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.OrderedBehavior"
},
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.PortfolioBacklogBehavior"
}
]
}
Get the list of process behaviors with CombinedFields option
Sample Request
GET https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors?$expand=CombinedFields&api-version=5.0-preview.2
Sample Response
{
"count": 7,
"value": [
{
"name": "MyCustomBehavior",
"referenceName": "Custom.4b8fdba0-7064-458d-b55c-522b39059a62",
"color": "009CDD",
"rank": 50,
"description": null,
"customization": "custom",
"fields": [
{
"name": "Stack Rank",
"referenceName": "Microsoft.VSTS.Common.StackRank",
"url": "https://dev.azure.com/fabrikam/_apis/wit/fields/Microsoft.VSTS.Common.StackRank"
}
],
"inherits": {
"behaviorRefName": "System.PortfolioBacklogBehavior",
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.PortfolioBacklogBehavior"
},
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/Custom.4b8fdba0-7064-458d-b55c-522b39059a62"
},
{
"name": "Stories",
"referenceName": "System.RequirementBacklogBehavior",
"color": "009CCC",
"rank": 20,
"description": "Requirement level backlog and board",
"customization": "inherited",
"fields": [
{
"name": "Stack Rank",
"referenceName": "Microsoft.VSTS.Common.StackRank",
"url": "https://dev.azure.com/fabrikam/_apis/wit/fields/Microsoft.VSTS.Common.StackRank"
},
{
"name": "Story Points",
"referenceName": "Microsoft.VSTS.Scheduling.StoryPoints",
"url": "https://dev.azure.com/fabrikam/_apis/wit/fields/Microsoft.VSTS.Scheduling.StoryPoints"
}
],
"inherits": {
"behaviorRefName": "System.OrderedBehavior",
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.OrderedBehavior"
},
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.RequirementBacklogBehavior"
},
{
"name": "Epics",
"referenceName": "Microsoft.VSTS.Agile.EpicBacklogBehavior",
"color": "FF7B00",
"rank": 40,
"description": "Epic level backlog and board",
"customization": "system",
"fields": [
{
"name": "Stack Rank",
"referenceName": "Microsoft.VSTS.Common.StackRank",
"url": "https://dev.azure.com/fabrikam/_apis/wit/fields/Microsoft.VSTS.Common.StackRank"
}
],
"inherits": {
"behaviorRefName": "System.PortfolioBacklogBehavior",
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.PortfolioBacklogBehavior"
},
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/Microsoft.VSTS.Agile.EpicBacklogBehavior"
},
{
"name": "Features",
"referenceName": "Microsoft.VSTS.Agile.FeatureBacklogBehavior",
"color": "773B93",
"rank": 30,
"description": "Feature level backlog and board",
"customization": "system",
"fields": [
{
"name": "Stack Rank",
"referenceName": "Microsoft.VSTS.Common.StackRank",
"url": "https://dev.azure.com/fabrikam/_apis/wit/fields/Microsoft.VSTS.Common.StackRank"
}
],
"inherits": {
"behaviorRefName": "System.PortfolioBacklogBehavior",
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.PortfolioBacklogBehavior"
},
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/Microsoft.VSTS.Agile.FeatureBacklogBehavior"
},
{
"name": "Ordered",
"referenceName": "System.OrderedBehavior",
"color": null,
"rank": 0,
"description": "Enables work items to be ordered relative to other work items",
"customization": "system",
"fields": [
{
"name": "Stack Rank",
"referenceName": "Microsoft.VSTS.Common.StackRank",
"url": "https://dev.azure.com/fabrikam/_apis/wit/fields/Microsoft.VSTS.Common.StackRank"
}
],
"inherits": null,
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.OrderedBehavior"
},
{
"name": "Tasks",
"referenceName": "System.TaskBacklogBehavior",
"color": "F2CB1D",
"rank": 10,
"description": "Task level backlog and board",
"customization": "system",
"fields": [
{
"name": "Stack Rank",
"referenceName": "Microsoft.VSTS.Common.StackRank",
"url": "https://dev.azure.com/fabrikam/_apis/wit/fields/Microsoft.VSTS.Common.StackRank"
},
{
"name": "Remaining Work",
"referenceName": "Microsoft.VSTS.Scheduling.RemainingWork",
"url": "https://dev.azure.com/fabrikam/_apis/wit/fields/Microsoft.VSTS.Scheduling.RemainingWork"
},
{
"name": "Activity",
"referenceName": "Microsoft.VSTS.Common.Activity",
"url": "https://dev.azure.com/fabrikam/_apis/wit/fields/Microsoft.VSTS.Common.Activity"
}
],
"inherits": {
"behaviorRefName": "System.OrderedBehavior",
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.OrderedBehavior"
},
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.TaskBacklogBehavior"
},
{
"name": "Portfolio",
"referenceName": "System.PortfolioBacklogBehavior",
"color": null,
"rank": 0,
"description": "Portfolio level backlog and board",
"customization": "system",
"fields": [
{
"name": "Stack Rank",
"referenceName": "Microsoft.VSTS.Common.StackRank",
"url": "https://dev.azure.com/fabrikam/_apis/wit/fields/Microsoft.VSTS.Common.StackRank"
}
],
"inherits": {
"behaviorRefName": "System.OrderedBehavior",
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.OrderedBehavior"
},
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.PortfolioBacklogBehavior"
}
]
}
Get the list of process behaviors with Fields option
Sample Request
GET https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors?$expand=Fields&api-version=5.0-preview.2
Sample Response
{
"count": 7,
"value": {
"count": 7,
"value": [
{
"name": "MyCustomBehavior",
"referenceName": "Custom.4b8fdba0-7064-458d-b55c-522b39059a62",
"color": "009CDD",
"rank": 50,
"description": null,
"customization": "custom",
"fields": [],
"inherits": {
"behaviorRefName": "System.PortfolioBacklogBehavior",
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.PortfolioBacklogBehavior"
},
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/Custom.4b8fdba0-7064-458d-b55c-522b39059a62"
},
{
"name": "Stories",
"referenceName": "System.RequirementBacklogBehavior",
"color": "009CCC",
"rank": 20,
"description": "Requirement level backlog and board",
"customization": "inherited",
"fields": [
{
"name": "Story Points",
"referenceName": "Microsoft.VSTS.Scheduling.StoryPoints",
"url": "https://dev.azure.com/fabrikam/_apis/wit/fields/Microsoft.VSTS.Scheduling.StoryPoints"
}
],
"inherits": {
"behaviorRefName": "System.OrderedBehavior",
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.OrderedBehavior"
},
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.RequirementBacklogBehavior"
},
{
"name": "Epics",
"referenceName": "Microsoft.VSTS.Agile.EpicBacklogBehavior",
"color": "FF7B00",
"rank": 40,
"description": "Epic level backlog and board",
"customization": "system",
"fields": [],
"inherits": {
"behaviorRefName": "System.PortfolioBacklogBehavior",
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.PortfolioBacklogBehavior"
},
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/Microsoft.VSTS.Agile.EpicBacklogBehavior"
},
{
"name": "Features",
"referenceName": "Microsoft.VSTS.Agile.FeatureBacklogBehavior",
"color": "773B93",
"rank": 30,
"description": "Feature level backlog and board",
"customization": "system",
"fields": [],
"inherits": {
"behaviorRefName": "System.PortfolioBacklogBehavior",
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.PortfolioBacklogBehavior"
},
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/Microsoft.VSTS.Agile.FeatureBacklogBehavior"
},
{
"name": "Ordered",
"referenceName": "System.OrderedBehavior",
"color": null,
"rank": 0,
"description": "Enables work items to be ordered relative to other work items",
"customization": "system",
"fields": [
{
"name": "Stack Rank",
"referenceName": "Microsoft.VSTS.Common.StackRank",
"url": "https://dev.azure.com/fabrikam/_apis/wit/fields/Microsoft.VSTS.Common.StackRank"
}
],
"inherits": null,
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.OrderedBehavior"
},
{
"name": "Tasks",
"referenceName": "System.TaskBacklogBehavior",
"color": "F2CB1D",
"rank": 10,
"description": "Task level backlog and board",
"customization": "system",
"fields": [
{
"name": "Remaining Work",
"referenceName": "Microsoft.VSTS.Scheduling.RemainingWork",
"url": "https://dev.azure.com/fabrikam/_apis/wit/fields/Microsoft.VSTS.Scheduling.RemainingWork"
},
{
"name": "Activity",
"referenceName": "Microsoft.VSTS.Common.Activity",
"url": "https://dev.azure.com/fabrikam/_apis/wit/fields/Microsoft.VSTS.Common.Activity"
}
],
"inherits": {
"behaviorRefName": "System.OrderedBehavior",
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.OrderedBehavior"
},
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.TaskBacklogBehavior"
},
{
"name": "Portfolio",
"referenceName": "System.PortfolioBacklogBehavior",
"color": null,
"rank": 0,
"description": "Portfolio level backlog and board",
"customization": "system",
"fields": [],
"inherits": {
"behaviorRefName": "System.OrderedBehavior",
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.OrderedBehavior"
},
"url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.PortfolioBacklogBehavior"
}
]
}
}
Definitionen
Name | Beschreibung |
---|---|
Customization |
Gibt den Typ der Anpassung für dieses Arbeitselement 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. |
Get |
|
Process |
Prozessverhaltensmodell. |
Process |
Prozessverhaltensfeld. |
Process |
Prozessverhaltensreferenz. |
CustomizationType
Gibt den Typ der Anpassung für dieses Arbeitselement 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.
Name | Typ | Beschreibung |
---|---|---|
custom |
string |
Customization-type ist Benutzerdefiniert, wenn der neu erstellte Arbeitselementtyp angepasst wird. |
inherited |
string |
Der Anpassungstyp wird geerbt, wenn der vorhandene Arbeitselementtyp des geerbten Prozesses angepasst wird. |
system |
string |
Customization-type ist System, wenn vom System generierter Arbeitselementtyp ist. |
GetBehaviorsExpand
Name | Typ | Beschreibung |
---|---|---|
combinedFields |
string |
Diese Option gibt Felder zurück, die diesem Verhalten zugeordnet sind, sowie alle Verhaltensweisen, von denen sie erbt. |
fields |
string |
Diese Option gibt Felder zurück, die einem Verhalten zugeordnet sind. |
none |
string |
Standardoption "keine". |
ProcessBehavior
Prozessverhaltensmodell.
Name | Typ | Beschreibung |
---|---|---|
color |
string |
Farbe |
customization |
Gibt den Typ der Anpassung für dieses Arbeitselement 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. |
|
description |
string |
. BESCHREIBUNG |
fields |
Prozessverhaltensfelder. |
|
inherits |
Referenz zum übergeordneten Verhalten. |
|
name |
string |
Verhaltensname. |
rank |
integer |
Rang des Verhaltens |
referenceName |
string |
Verhaltens-ID |
url |
string |
URL des Verhaltens. |
ProcessBehaviorField
Prozessverhaltensfeld.
Name | Typ | Beschreibung |
---|---|---|
name |
string |
Der Name des Felds. |
referenceName |
string |
Verweisname des Felds. |
url |
string |
Url zu Feld. |
ProcessBehaviorReference
Prozessverhaltensreferenz.
Name | Typ | Beschreibung |
---|---|---|
behaviorRefName |
string |
ID eines Verhaltens. |
url |
string |
Url zum Verhalten. |
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für