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. |
process
|
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 |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
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 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"
}
]
}
}
Definiciones
Nombre | Description |
---|---|
Customization |
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. |
Get |
|
Process |
Modelo de comportamiento del proceso. |
Process |
Campo Comportamiento del proceso. |
Process |
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 |
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 |
Campos de comportamiento del proceso. |
|
inherits |
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. |
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de