Módulos de Azure DevOps

En un escenario de Adobe Workfront Fusion, es posible automatizar los flujos de trabajo que utilizan Azure DevOps, así como conectarlo a varias aplicaciones y servicios de terceros.

Para obtener instrucciones sobre cómo crear un escenario, vea los artículos en Crear escenarios: índice de artículos.

Para obtener información acerca de los módulos, vea los artículos en Módulos: índice de artículos.

Requisitos de acceso

Expanda para ver los requisitos de acceso para la funcionalidad en este artículo.

Para utilizar la funcionalidad de este artículo debe tener el siguiente acceso:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
paquete de Adobe Workfront Cualquiera
Licencia de Adobe Workfront

Nuevo: estándar

O

Actual: Trabajo o superior

Licencia de Adobe Workfront Fusion**

Actual: no se requiere licencia de Workfront Fusion.

O

Heredado: Workfront Fusion para la automatización e integración del trabajo

Producto

Nuevo:

  • Seleccione o paquete de Prime Workfront: su organización debe adquirir Adobe Workfront Fusion.
  • Paquete de Ultimate Workfront: Workfront Fusion está incluido.

O

Actual: Su organización debe adquirir Adobe Workfront Fusion.

Para obtener más información sobre esta tabla, consulte Requisitos de acceso en la documentación.

Para obtener información sobre Adobe Workfront Fusion licencias, consulte Adobe Workfront Fusion licencias.

Requisitos previos

Para usar módulos de Azure DevOps, debe tener una cuenta de DevOps de Azure.

Información de la API Azure DevOps

El conector de Azure DevOps utiliza lo siguiente:

Versión de API
Versión 5.1
Etiqueta de API
Versión 1.29.33

Conectar Azure DevOps a Workfront Fusion connect-azure-devops-to-workfront-fusion

  1. Añada un módulo de Azure DevOps a su escenario.

  2. Haga clic en Add junto al campo Connection.

  3. En el campo Connection Type, seleccione Azure DevOps.

    note important
    IMPORTANT
    El tipo de conexión Azure DevOps (Request All Scopes) quedará obsoleto en un futuro próximo. Por lo tanto, no se recomienda su uso.
  4. Rellene los campos siguientes:

    table 0-row-2 1-row-2 layout-auto html-authored no-header
    Connection name Introduzca un nombre para la conexión que está creando.
    Organization Introduzca el nombre de la organización en la que ha creado la aplicación Azure DevOps.
  5. Para escribir un id. de aplicación o secreto de cliente de Azure DevOps, haga clic en Mostrar configuración avanzada e ingréselos en los campos que se abren.

  6. Haga clic en Continue para finalizar la configuración de la conexión y continuar creando el escenario.

Módulos de Azure DevOps y sus campos

Al configurar módulos de Azure DevOps, Workfront Fusion muestra los campos que se indican a continuación. Junto con estos, podrían mostrarse Azure DevOps campos adicionales, según factores como el nivel de acceso en la aplicación o el servicio. El título en negrita en un módulo indica un campo obligatorio.

Si ve el botón Asignar encima de un campo o función, puede utilizarlo para establecer variables y funciones para ese campo. Para obtener más información, vea Asignar información de un módulo a otro.

Conmutador Asignar

Activadores

Watch for work items

Este módulo de déclencheur instantáneo ejecuta un escenario cuando se agrega, actualiza o elimina un registro en Azure DevOps.

El módulo devuelve cualquier campo estándar asociado con el registro, junto con los campos y valores personalizados a los que accede la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.

Al configurar este módulo, se muestran los campos siguientes.

Webhook

Seleccione o añada un webhook para el módulo.

Para obtener más información sobre los webhooks en los módulos de déclencheur, consulte déclencheur instantáneos (webhooks).

Para obtener información sobre cómo crear un webhook, consulte Webhooks.

Acciones

Create a record

Este módulo de acción crea un nuevo proyecto o elemento de trabajo.

El módulo genera el ID de objeto para el elemento de trabajo recién creado o la URL y el código de estado de un proyecto recién creado.

Connection
Para obtener instrucciones sobre la conexión de su cuenta de Azure DevOps a Workfront Fusion, consulte Conectar Azure DevOps a Workfront Fusion en este artículo.
Record type

Seleccione si desea crear un elemento de trabajo o un proyecto.

  • Project

    Rellene los campos siguientes:

    • Name: introduzca o asigne un nombre para el nuevo proyecto.

    • Description: introduzca o asigne una descripción para el nuevo proyecto.

    • Visibility: seleccione si desea que el proyecto sea público o privado. Para poder interactuar con un proyecto privado, los usuarios deben haber iniciado sesión en su organización y se les debe haber concedido acceso al proyecto. Los proyectos públicos son visibles para los usuarios que no han iniciado sesión en su organización.

    • Version control: Seleccione si desea que el proyecto use Git o Team Foundation Version Control (TFCV) para el control de versiones.

    • Work item process: seleccione el proceso de trabajo que desea utilizar para el proyecto. Las opciones son Basic, Scrum, Capability Maturity Model Integration (CMMI) y Agile.

      Para obtener más información sobre Azure DevOps procesos, consulte Procesos predeterminados y plantillas de proceso en la documentación de Azure DevOps.

  • Work item

    Rellene los campos siguientes:

    • Project: seleccione el proyecto donde desea crear el elemento de trabajo.

    • Work item type: seleccione el tipo de elemento de trabajo que desea crear.

    • Other fields: en estos campos, introduzca el valor que desea que tenga el elemento de trabajo para una propiedad determinada. Los campos disponibles dependen del tipo de elemento de trabajo.

Custom API Call

Este módulo de acción le permite realizar una llamada autenticada personalizada a la API Azure DevOps. De este modo, puede crear una automatización del flujo de datos imposibles de realizar por los otros Azure DevOps módulos.

Al configurar este módulo, se muestran los campos siguientes.

Connection
Para obtener instrucciones sobre la conexión de su cuenta de Azure DevOps a Workfront Fusion, consulte Conectar Azure DevOps a Workfront Fusion en este artículo.
Base URL
Seleccione o asigne la dirección URL base que utiliza para conectarse a su cuenta de Azure DevOps
Relative URL

Introduzca la dirección URL relativa a la que desea conectarse para esta llamada de API.

Ejemplo: {organization}/_apis[/{area}]/{resource}

API Version
Seleccione o asigne la versión de la API de Azure DevOps a la que desee conectarse para esta llamada de API. Si no se ha seleccionado ninguna versión, Workfront Fusion se conecta a la versión 5.1 de la API de Azure DevOps.
Method
Seleccione el método de petición HTTP que necesita para configurar la llamada de la API. Para obtener más información, vea Métodos de solicitud HTTP.
Headers

Añada los encabezados de la solicitud en forma de objeto JSON estándar.

Por ejemplo: {"Content-type":"application/json"}

Query String

Añada la consulta para la llamada de API en forma de objeto JSON estándar.

Por ejemplo: {"name":"something-urgent"}

Body

Añada el contenido del cuerpo para la llamada de API en forma de objeto JSON estándar.

Nota:

Cuando utilice afirmaciones condicionales como if en su JSON, coloque las comillas fuera de la afirmación condicional.

Download an attachment

Este módulo de acción descarga un archivo adjunto.

El módulo devuelve el contenido del archivo adjunto.

Connection
Para obtener instrucciones sobre la conexión de su cuenta de Azure DevOps a Workfront Fusion, consulte Conectar Azure DevOps a Workfront Fusion en este artículo.
Attachment URL
Introduzca o asigne la dirección URL del archivo adjunto que desea descargar.

Este módulo de acción vincula dos elementos de trabajo y define la relación entre ellos.

Connection
Para obtener instrucciones sobre la conexión de su cuenta de Azure DevOps a Workfront Fusion, consulte Conectar Azure DevOps a Workfront Fusion en este artículo.
Work item ID
Escriba o asigne el identificador del elemento de trabajo principal al que desee vincular otro elemento de trabajo.
Linked work item ID
Introduzca o asigne el ID del elemento de trabajo que desee vincular al elemento de trabajo principal.
Link Type

Defina la relación entre los elementos de trabajo que desea vincular.

Para obtener más información, consulte Guía de referencia para tipos de vínculos en la documentación de Azure DevOps.

Comment
Escriba o asigne el texto de un comentario. Esto resulta útil para explicar el razonamiento o la intención del vínculo.

Read record

Este módulo de acción lee datos de un único registro en Azure DevOps.

Especifique el identificador del registro.

El módulo devuelve el ID del registro y cualquier campo asociado, junto con cualquier campo y valor personalizados a los que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.

Al configurar este módulo, se muestran los campos siguientes.

Connection
Para obtener instrucciones sobre la conexión de su cuenta de Azure DevOps a Workfront Fusion, consulte Conectar Azure DevOps a Workfront Fusion en este artículo.
Record type

Seleccione si desea leer un proyecto o un elemento de trabajo

  • Project: seleccione el proyecto que desea leer.

  • Work item: seleccione el proyecto que contiene el elemento de trabajo que desea leer y, a continuación, seleccione el tipo de elemento de trabajo.

Outputs
Seleccione la información que desea incluir en el paquete de salida para este módulo. Los campos disponibles dependen del tipo de elemento de trabajo.
ID
Introduzca o asigne el ID del registro que desea leer.

Update a work item

Este módulo de acción actualiza un elemento de trabajo existente mediante su ID.

El módulo devuelve el ID del elemento de trabajo actualizado.

Connection
Para obtener instrucciones sobre la conexión de su cuenta de Azure DevOps a Workfront Fusion, consulte Conectar Azure DevOps a Workfront Fusion en este artículo.
Project
Seleccione el proyecto que contiene el elemento de trabajo que desea actualizar.
Work Item Type
Seleccione el tipo de elemento de trabajo que desea actualizar.
Other Fields
En cada uno de estos campos, introduzca el valor que desea que tenga el elemento de trabajo para una propiedad determinada. Los campos disponibles dependen del tipo de elemento de trabajo.
Work item ID
Escriba o asigne el ID del elemento de trabajo que desea actualizar.

Upload an attachment

Este módulo de acción carga un archivo y lo adjunta a un elemento de trabajo.

El módulo devuelve el ID de archivo adjunto y una URL de descarga para el archivo adjunto.

Connection
Para obtener instrucciones sobre la conexión de su cuenta de Azure DevOps a Workfront Fusion, consulte Conectar Azure DevOps a Workfront Fusion en este artículo.
Project
Seleccione el proyecto en el que desea cargar un archivo adjunto.
Work item ID
Introduzca o asigne el ID del elemento de trabajo en el que desea cargar un archivo adjunto.
Comment
Escriba el texto del comentario que desee añadir al archivo adjunto cargado.
Source file
Seleccione un archivo de origen de un módulo anterior o introduzca o asigne el nombre y el contenido del archivo de origen.

Búsquedas

List work items

Este módulo de acción recupera todos los elementos de trabajo de un tipo específico en un proyecto de Azure DevOps.

El módulo devuelve el ID del elemento de trabajo principal y cualquier campo asociado, junto con cualquier campo y valor personalizados a los que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.

Al configurar este módulo, se muestran los campos siguientes.

Connection
Para obtener instrucciones sobre la conexión de su cuenta de Azure DevOps a Workfront Fusion, consulte Conectar Azure DevOps a Workfront Fusion en este artículo.
Project
Seleccione el proyecto cuyos elementos de trabajo desea recuperar.
Work item type
Seleccione el tipo de elemento de trabajo que desea recuperar.
Outputs
Seleccione las propiedades que desea que aparezcan en la salida del módulo. Los campos disponibles dependen del tipo de elemento de trabajo que desee recuperar. Debe seleccionar al menos una propiedad.
Limit
Escriba o asigne el número máximo de elementos de trabajo que Workfront Fusion devuelve durante un ciclo de ejecución.
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3