Behaviors - List

İşlemdeki tüm davranışların listesini döndürür.

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 Parametreleri

Name İçinde Gerekli Tür Description
organization
path True

string

Azure DevOps kuruluşunun adı.

processId
path True

string

uuid

İşlemin kimliği

api-version
query True

string

Kullanılacak API sürümü. Api'nin bu sürümünü kullanmak için bu değer '5.0-preview.2' olarak ayarlanmalıdır.

$expand
query

GetBehaviorsExpand

Yanıtlar

Name Tür Description
200 OK

ProcessBehavior[]

başarılı işlem

Güvenlik

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 Description
vso.work İş öğelerini, sorguları, panoları, alan ve yineleme yollarını ve diğer iş öğesi izlemeyle ilgili meta verileri okuma yeteneği verir. Ayrıca sorguları yürütme, iş öğelerini arama ve hizmet kancaları aracılığıyla iş öğesi olayları hakkında bildirim alma olanağı verir.

Örnekler

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"
      }
    ]
  }
}

Tanımlar

Name Description
CustomizationType

Bu iş öğesindeki özelleştirme türünü gösterir. Sistem davranışları üst işlemden devralınır ancak değiştirilmez. Devralınan davranışlar, üst işlemden devralınan değiştirilmiş değiştirilmiş davranışlardır. Özel davranışlar, geçerli işlemde kullanıcı tarafından oluşturulan davranışlardır.

GetBehaviorsExpand
ProcessBehavior

İşlem Davranışı Modeli.

ProcessBehaviorField

İşlem Davranışı Alanı.

ProcessBehaviorReference

İşlem davranışı Başvurusu.

CustomizationType

Bu iş öğesindeki özelleştirme türünü gösterir. Sistem davranışları üst işlemden devralınır ancak değiştirilmez. Devralınan davranışlar, üst işlemden devralınan değiştirilmiş değiştirilmiş davranışlardır. Özel davranışlar, geçerli işlemde kullanıcı tarafından oluşturulan davranışlardır.

Name Tür Description
custom

string

Özelleştirme türü, yeni oluşturulan workitemtype özelleştirilmişse Özel'dir.

inherited

string

Devralınan işlemin mevcut workitemtype'i özelleştirilmişse özelleştirme türü Devralınır.

system

string

Özelleştirme türü, sistem tarafından oluşturulan workitemtype ise Sistem'dir.

GetBehaviorsExpand

Name Tür Description
combinedFields

string

Bu seçenek, bu davranışla ilişkili alanları ve devraldığı tüm davranışları döndürür.

fields

string

Bu seçenek bir davranışla ilişkili alanları döndürür.

none

string

Varsayılan yok seçeneği.

ProcessBehavior

İşlem Davranışı Modeli.

Name Tür Description
color

string

Renk.

customization

CustomizationType

Bu iş öğesindeki özelleştirme türünü gösterir. Sistem davranışları üst işlemden devralınır ancak değiştirilmez. Devralınan davranışlar, üst işlemden devralınan değiştirilmiş değiştirilmiş davranışlardır. Özel davranışlar, geçerli işlemde kullanıcı tarafından oluşturulan davranışlardır.

description

string

. Description

fields

ProcessBehaviorField[]

İşlem Davranışı Alanları.

inherits

ProcessBehaviorReference

Üst davranış başvurusu.

name

string

Davranış Adı.

rank

integer

Davranışın sırası

referenceName

string

Davranış Kimliği

url

string

Davranışın URL'si.

ProcessBehaviorField

İşlem Davranışı Alanı.

Name Tür Description
name

string

Alanın adı.

referenceName

string

Alanın başvuru adı.

url

string

Alanın URL'si.

ProcessBehaviorReference

İşlem davranışı Başvurusu.

Name Tür Description
behaviorRefName

string

Bir Davranışın Kimliği.

url

string

Davranışın URL'si.