Compartir a través de


Behaviors - List

Devuelve una lista de todos los comportamientos del proceso.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
organization
path True

string

El nombre de la organización de Azure DevOps.

processId
path True

string

uuid

El identificador del proceso

api-version
query True

string

Versión de la API que se va a usar. Debe establecerse en "5.0-preview.2" para usar esta versión de la API.

$expand
query

GetBehaviorsExpand

Respuestas

Nombre Tipo Description
200 OK

ProcessBehavior[]

operación correcta

Seguridad

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

Nombre Description
vso.work Concede la capacidad de leer elementos de trabajo, consultas, paneles, rutas de acceso de área e iteraciones y otros metadatos relacionados con el seguimiento de elementos de trabajo. También concede la capacidad de ejecutar consultas, buscar elementos de trabajo y recibir notificaciones sobre eventos de elementos de trabajo a través de enlaces de servicio.

Ejemplos

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

Definiciones

Nombre Description
CustomizationType

Indica el tipo de personalización en este elemento de trabajo. Los comportamientos del sistema se heredan del proceso primario, pero no se modifican. Los comportamientos heredados son comportamientos modificados modificados que se heredaron del proceso primario. Los comportamientos personalizados son comportamientos creados por el usuario en el proceso actual.

GetBehaviorsExpand
ProcessBehavior

Modelo de comportamiento del proceso.

ProcessBehaviorField

Campo Comportamiento del proceso.

ProcessBehaviorReference

Referencia del comportamiento del proceso.

CustomizationType

Indica el tipo de personalización en este elemento de trabajo. Los comportamientos del sistema se heredan del proceso primario, pero no se modifican. Los comportamientos heredados son comportamientos modificados modificados que se heredaron del proceso primario. Los comportamientos personalizados son comportamientos creados por el usuario en el proceso actual.

Nombre Tipo Description
custom

string

El tipo de personalización es Personalizado si se personaliza el workitemtype recién creado.

inherited

string

El tipo de personalización se hereda si se personaliza el tipo de trabajo existente del proceso heredado.

system

string

El tipo de personalización es System si es workitemtype generado por el sistema.

GetBehaviorsExpand

Nombre Tipo Description
combinedFields

string

Esta opción devuelve campos asociados a este comportamiento y todos los comportamientos de los que hereda.

fields

string

Esta opción devuelve campos asociados a un comportamiento.

none

string

Opción predeterminada none.

ProcessBehavior

Modelo de comportamiento del proceso.

Nombre Tipo Description
color

string

Color.

customization

CustomizationType

Indica el tipo de personalización en este elemento de trabajo. Los comportamientos del sistema se heredan del proceso primario, pero no se modifican. Los comportamientos heredados son comportamientos modificados modificados que se heredaron del proceso primario. Los comportamientos personalizados son comportamientos creados por el usuario en el proceso actual.

description

string

. Descripción

fields

ProcessBehaviorField[]

Campos de comportamiento del proceso.

inherits

ProcessBehaviorReference

Referencia de comportamiento principal.

name

string

Nombre del comportamiento.

rank

integer

Clasificación del comportamiento

referenceName

string

Id. de comportamiento

url

string

Dirección URL del comportamiento.

ProcessBehaviorField

Campo Comportamiento del proceso.

Nombre Tipo Description
name

string

Nombre del campo.

referenceName

string

Nombre de referencia del campo.

url

string

Dirección URL al campo.

ProcessBehaviorReference

Referencia del comportamiento del proceso.

Nombre Tipo Description
behaviorRefName

string

Identificador de un comportamiento.

url

string

Dirección URL al comportamiento.