Creación de un enlace de servicio para Azure DevOps Services y TFS con Trello

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2017

Cree tarjetas y listas en Trello en respuesta a eventos de Azure DevOps. Por ejemplo, cuando se inserta código o se produce una compilación.

Obtener un token de autorización de Trello

  1. Si no tiene una cuenta de Trello, regístrese en Trello.

  2. Vaya a la página Autorizar Azure DevOps Services para Trelloe inicie sesión con sus credenciales de Trello.

  3. Permita Azure DevOps usar su cuenta de Trello.

    Permitir Azure DevOps Services

  4. Copie el token de autorización.

    Token de autorización de Trello

Cree una tarjeta o lista de Trello a partir de Azure DevOps Services evento.

  1. Vaya a la página Service Hooks (Enlaces de servicio) del proyecto:

    https://{orgName}/{project_name}/_settings/serviceHooks

    Project de administración

    Seleccione Crear suscripción.

  2. Elija el servicio Trello.

    Página servicio, Trello seleccionado

  3. Configure el desencadenador Visual Studio evento. En este caso, vamos a hacer que la suscripción responda cuando se cree un elemento de trabajo.

    Página Configuración del desencadenador

  4. Configure la acción que Trello realizará en respuesta al desencadenador: cree una tarjeta o una lista.

    Página configuración de la acción

    Puede usar marcadores de posición para insertar contenido del evento en el nombre y la descripción de las tarjetas o listas que crea la suscripción. Por ejemplo, cuando ejecutamos la notificación de prueba, la tarjeta que se crea se denomina "Error n.º 5: Alguna idea nueva excelente" porque el elemento de trabajo de prueba es un error (ID=5) con el título "Some great new idea!".

  5. Pruebe la suscripción de enlace de servicio y finalice el asistente.

    Notificación de prueba

  1. Vaya a la página Service Hooks (Enlaces de servicio) del proyecto:

    https://dev.azure.com/{orgName}/{project_name}/_apps/hub/ms.vss-servicehooks-web.manageServiceHooks-project

    Project de administración

    Seleccione Crear suscripción.

  2. Elija el servicio Trello.

    Página servicio, Trello seleccionado

  3. Configure el desencadenador Visual Studio evento. En este caso, vamos a hacer que la suscripción responda cuando se cree un elemento de trabajo.

    Página Configuración del desencadenador

  4. Configure la acción que Trello realizará en respuesta al desencadenador: cree una tarjeta o una lista.

    Página configuración de la acción

    Puede usar marcadores de posición para insertar contenido del evento en el nombre y la descripción de las tarjetas o listas que crea la suscripción. Por ejemplo, cuando ejecutamos la notificación de prueba, la tarjeta que se crea se denomina "Error n.º 5: Alguna idea nueva excelente" porque el elemento de trabajo de prueba es un error (ID=5) con el título "Some great new idea!".

  5. Pruebe la suscripción de enlace de servicio y finalice el asistente.

Notificación de prueba

Ahora está configurado. Vaya a Trello y vea que aparecen las tarjetas.

Placa de bienvenida con una tarjeta para el error n.º 5

Marcadores de posición

Puede insertar marcadores de posición en el nombre de una lista o el nombre o la descripción de una tarjeta que va a crear la suscripción. Cuando se crea una lista o tarjeta, los marcadores de posición se reemplazarán por valores del evento que se generó. En el ejemplo que se usa para el nombre de la tarjeta en esta página se usa:

    {{workitem.workItemType}} #{{workitem.id}}: {{workitem.title}}

Por lo tanto, cuando se crea un error con el identificador 5 y el título "Some great new idea!", el nombre de la tarjeta es "Error n.º 5: ¡Una buena idea nueva!".

La forma básica del marcador de posición es donde resource es el nombre del recurso que genera el evento (elemento de trabajo, compilación, entre otros) y field es un campo dentro de la sección de recursos del evento, como {{resource.field}} ID. Por lo tanto, si la suscripción es para una compilación completada, podría ser algo parecido a

    Build {{build.id}} completed at {{build.finishTime}}

Donde build es el nombre del recurso y el identificador, finishTime son los campos disponibles en este recurso. Para comprender los tipos de eventos, los campos y los recursos disponibles para su uso, vea la referencia de eventos.

Campos de elementos de trabajo

Los campos de elemento de trabajo aparecen en el evento en la matriz fields, como en este ejemplo:

    " fields": {
                " System.AreaPath": "Fabrikam-Fiber-Git", 
                " System.TeamProject": "Fabrikam-Fiber-Git", 
                " System.IterationPath": "Fabrikam-Fiber-Git", 
                " System.WorkItemType": "Product Backlog Item", 
                " System.State": "New", 
                " System.Reason": "New backlog item", 
                " System.CreatedDate": "2014-11-05T21:11:28.85Z", 
                " System.CreatedBy": "Normal Paulk", 
                " System.ChangedDate": "2014-11-05T21:11:29.23Z", 
                " System.ChangedBy": "Normal Paulk", 
                " System.Title": "Test PBI", 
                " Microsoft.Azure DevOps Services.Common.BacklogPriority": 999999999, 
                " WEF_6CB513B6E70E43499D9FC94E5BBFB784_Kanban.Column": "New"
           },

Al trabajar directamente desde la definición de evento, habríamos creado el nombre de la tarjeta como en este ejemplo:

    {{workitem.fields["System.workItemType"]}} #{{workitem.fields["System.id"]}: {{workitem.fields["System.title"]}}

Como acceso directo, puede hacer referencia a cualquier campo del sistema o microsoft. Azure DevOps Services. Espacios de nombres comunes como si fueran campos del recurso. De esta forma, {{workitem.fields["System.workItemType"]}} se convierte en {{workitem.workItemType}}.

Expresiones de marcador de posición

Estos marcadores de posición usan una implementación de plantillas de barras de identificador que es en gran medida compatible con Mustache. Algunas expresiones útiles incluyen

Tipo de expresión ejemplos
expresiones básicas {{workitem.name}}
expresiones de matriz {{pullRequest.reviewers.[0].displayName}}
Secciones de Mustache {{#workitem.assignedTo}} Esta wi-fi está asignada {{/workitem.assignedTo}}
Secciones invertidas de Mustache {{^workitem.assignedTo}} Esta wi-fi no está asignada {{/workitem.assignedTo}}
Asistentes de bloques de barras de identificadores con
if/else
Salvo
Cada
Rutas de acceso de las barras de control ...
this
Por ejemplo, {{../comment/id}} o {{this/title}}.
Comentarios de plantilla {{!-- this is a handlebar comment --}}

Precios

Azure DevOps no cobra por el marco de trabajo por la integración con servicios externos. Consulte el sitio del servicio específico para ver los precios relacionados con sus servicios.

Preguntas & y respuestas

P: ¿Puedo crear suscripciones mediante programación?

A. Sí, consulte los detalles aquí.

P: ¿Puedo obtener más información sobre Trello?

A: Sí, trello.com.