Módulos de Azure DevOps
En un escenario de Adobe Workfront Fusion, puede 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, consulte los artículos en Crear escenarios: índice de artículos.
Para obtener información acerca de los módulos, consulte los artículos en Módulos: índice de artículos.
Requisitos de acceso
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Paquete de Adobe Workfront |
Cualquier paquete del flujo de trabajo de Adobe Workfront y cualquier paquete de integración y automatización de Adobe Workfront Workfront Ultimate Paquetes Workfront Prime y Select, con una compra adicional de Workfront Fusion. |
| Licencias de Adobe Workfront |
Estándar Trabajo o superior |
| Licencia de Adobe Workfront Fusion |
Basado en operaciones: disponible para organizaciones con licencias basadas en operaciones Basado en conector (heredado): Workfront Fusion for Work Automation and Integration |
| Producto | Si su organización tiene un paquete de Workfront Select o Prime que no incluye la automatización y la integración de Workfront, su organización debe adquirir Adobe Workfront Fusion. |
Para obtener más información sobre el contenido de esta tabla, consulte Requisitos de acceso en la documentación.
Para obtener información sobre las licencias de Adobe Workfront Fusion, consulte licencias de Adobe Workfront Fusion.
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 DevOps de Azure utiliza lo siguiente:
Conexión de Azure DevOps a Workfront Fusion connect-azure-devops-to-workfront-fusion
Conexión de Azure DevOps a Workfront Fusion mediante EntraApp
-
Añada un módulo de Azure DevOps a su escenario.
-
Haga clic en Añadir junto al campo conexión.
-
En el campo Tipo de conexión, seleccione el tipo de conexión que desea utilizar.
note NOTE Azure DevOps (EntraApp) le permite solicitar todos los ámbitos de la conexión. -
Rellene los campos siguientes:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-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. App ID Introduzca el ID de la aplicación DevOps a la que se está conectando. Client Secret Escriba el secreto de cliente para las aplicaciones DevOps a las que se está conectando. Solicitar todos los ámbitos Si está usando el tipo de conexión Azure DevOps (EntraApp), habilite esta opción para solicitar todos los ámbitos de la conexión. -
Para escribir un ID de aplicación o un secreto de cliente de Azure DevOps, haga clic en Mostrar configuración avanzada e ingréselos en los campos que se abren.
-
Haga clic en Continuar para finalizar la configuración de la conexión y continuar creando el escenario.
Conexión de Azure DevOps a Workfront Fusion mediante una entidad de servicio
Puede crear una conexión que utilice una entidad de seguridad de servicio (una conexión API de aplicación) en lugar de una cuenta personal. Esto resulta útil cuando desea que la conexión se ejecute como una identidad de aplicación o servicio en lugar de como una persona específica. Esto puede resultar útil para que la integración no se interrumpa si, por ejemplo, esa persona abandona la empresa o cambia su contraseña.
Este tipo de conexión está disponible para todos los módulos DevOps de Azure.
- Requisitos previos para conectar Azure DevOps a Workfront Fusion mediante una entidad de servicio
- Creación del registro de la aplicación en Microsoft Entra ID
- Crear un secreto de cliente
- Recopilar los detalles de la conexión
- Añada la entidad de seguridad de servicio a su organización de DevOps de Azure
- Creación de la conexión
Requisitos previos para conectar Azure DevOps a Workfront Fusion mediante una entidad de servicio
Para crear esta conexión, necesita lo siguiente:
- Administrador global o Administrador de aplicaciones tienen acceso a la Microsoft Entra ID para registrar la aplicación. Si no tiene este acceso, pida a alguien de su equipo de TI o de identidad que complete ese paso por usted.
- Administrador de recopilación de proyectos tiene acceso a en su organización de Azure DevOps para agregar la entidad de seguridad de servicio como miembro. A menudo se trata de una persona diferente a la persona que administra el Microsoft Entra ID.
- Nombre de su organización de DevOps de Azure. Puede encontrar esto en su URL de DevOps de Azure:
dev.azure.com/<your organization name>.
Creación del registro de la aplicación en Microsoft Entra ID
- Inicie sesión en el centro de administración de Microsoft Entra.
- Vaya a Registros de aplicaciones > Nuevo registro.
- Asigne a la aplicación un nombre claro y reconocible. Por ejemplo,
Workfront Fusion Azure DevOps Integration. - Deje URI de redireccionamiento en blanco. Esta conexión no implica iniciar sesión a través de un explorador.
- Seleccione Registrar.
- Continuar a Crear un secreto de cliente.
Crear un secreto de cliente
- En el registro de la nueva aplicación, ve a Certificados y secretos.
- Seleccione Nuevo secreto de cliente, agregue una descripción y elija un período de caducidad.
- Seleccione Agregar.
- Copie el Valor del secreto inmediatamente. Se muestra solo una vez. Si se aleja antes de copiarlo, debe crear uno nuevo.
- Continúe a Recopilar sus detalles de conexión.
Recopilar los detalles de la conexión
-
En la página Información general del registro de la aplicación, tenga en cuenta los siguientes valores. Estos se introducen al crear la conexión en el módulo.
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Tenant ID En la página Información general, con la etiqueta Directorio (inquilino) ID. Client ID En la página Información general, ID de aplicación (cliente). Client Secret El valor que copió en Crear un secreto de cliente. Organization Nombre de su organización de Azure DevOps. Por ejemplo, si la dirección URL es dev.azure.com/yourorg, escribayourorg.note NOTE Puede omitir el área permisos de API del registro de la aplicación. Si agrega las DevOps de Azure, solo están disponibles permisos delegados. Los permisos de la aplicación aparecen atenuados. Esto es de esperar, ya que Azure DevOps no admite la concesión de acceso de esta manera. En su lugar, el acceso se concede directamente dentro de las operaciones de desarrollo de Azure, en la siguiente parte. -
Continuar a Agregar la entidad de seguridad de servicio a su organización de DevOps de Azure.
Añada la entidad de seguridad de servicio a su organización de DevOps de Azure
Al registrar la aplicación en Microsoft Entra ID, solo se crea su identidad. Todavía no da a la aplicación acceso a los datos de Azure DevOps. Este procedimiento concede ese acceso.
-
Inicie sesión en su organización de DevOps de Azure, en
dev.azure.com/<your organization name>. -
Seleccione Configuración de la organización en la esquina inferior izquierda, luego seleccione Usuarios.
-
Seleccione Agregar usuarios.
-
En el cuadro de búsqueda, busque por el nombre para mostrar de la aplicación, que es el nombre que le dio al registrar la aplicación. No buscar por ID de cliente.
-
Seleccione un nivel de acceso:
- Básico suele ser suficiente para leer y escribir elementos de trabajo, tableros y repositorios.
- Si el flujo de trabajo necesita examinar los procesos disponibles, como Agile, Scrum o plantillas personalizadas, como parte de la configuración, agregue la entidad de seguridad de servicio al grupo Administradores de la colección de proyectos en su lugar. Se trata de un nivel de acceso más amplio, por lo que solo debe otorgarlo si necesita esa capacidad.
-
Asigne el principal de servicio al proyecto o proyectos específicos que necesite, siguiendo las prácticas de acceso habituales de su organización.
-
Seleccione Agregar.
-
Continuar a Crear la conexión.
Creación de la conexión
-
En la pantalla de configuración de la conexión del módulo, seleccione el tipo de conexión Service Principal.
-
Introduzca lo siguiente:
- Id. de inquilino
- ID de cliente
- Secreto de cliente
- Organización
-
Guarde la conexión.
Si todo está configurado correctamente, la conexión se valida correctamente.
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 a estos, pueden aparecer campos de Azure DevOps adicionales, en función de factores como el nivel de acceso del que disponga 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, consulte Asignar información de un módulo a otro.
Activadores
Ver elementos de trabajo
Este módulo de activador instantáneo ejecuta un escenario cuando se añade, 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.
Acciones
Creación de un registro
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.
Llamada API personalizada
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.
Introduzca la dirección URL relativa a la que desea conectarse para esta llamada de API.
Ejemplo: {organization}/_apis[/{area}]/{resource}
Añada los encabezados de la solicitud en forma de objeto JSON estándar.
Por ejemplo: {"Content-type":"application/json"}
Añada la consulta para la llamada de API en forma de objeto JSON estándar.
Por ejemplo: {"name":"something-urgent"}
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.
Descargar un archivo adjunto
Este módulo de acción descarga un archivo adjunto.
El módulo devuelve el contenido del archivo adjunto.
Vincular elementos de trabajo
Este módulo de acción vincula dos elementos de trabajo y define la relación entre ellos.
Leer registro
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.
Actualizar un elemento de trabajo
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.
Cargar un archivo adjunto
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.
Búsquedas
Lista de elementos de trabajo
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.