Share via


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.

processId
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

GetBehaviorsExpand

Antworten

Name Typ Beschreibung
200 OK

ProcessBehavior[]

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 CombinedFields option
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
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.

GetBehaviorsExpand
ProcessBehavior

Prozessverhaltensmodell.

ProcessBehaviorField

Prozessverhaltensfeld.

ProcessBehaviorReference

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

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.

description

string

. BESCHREIBUNG

fields

ProcessBehaviorField[]

Prozessverhaltensfelder.

inherits

ProcessBehaviorReference

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.