Módulos de Adobe Workfront Planning

Con los módulos Adobe Workfront Planning, puede almacenar en déclencheur un escenario cuando se produzcan eventos en Workfront Planning. También puede crear, leer, actualizar y eliminar registros, o realizar una llamada de API personalizada a su cuenta de Adobe Workfront Planning.

Requisitos de acceso

Expanda para ver los requisitos de acceso para la funcionalidad en este artículo.
table 0-row-2 1-row-2 2-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

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.

s## requisitos previos

Debe tener lo siguiente para acceder a Workfront Planning:

  • Un nuevo paquete y licencia de Workfront. Workfront Planning no está disponible para paquetes o licencias de Workfront heredados.
  • Un paquete de Workfront Planning.
  • La instancia de Workfront de su organización debe incorporarse a la experiencia unificada de Adobe.

Información de API de Adobe Workfront Planning

El conector de Adobe Workfront Planning utiliza lo siguiente:

URL base
https://{{connection.host}}/maestro/api/{{common.maestroApiVersion}}/
Etiqueta de API
Versión 1.13.7

Conexión de Workfront Planning a Workfront Fusion

El conector de Workfront Planning utiliza OAuth 2.0 para conectarse a Workfront Planning.

Puede crear una conexión a su cuenta de Workfront Planning directamente desde un módulo de Workfront Planning Fusion.

Conectarse a Workfront Planning mediante el ID de cliente y el secreto de cliente

  1. En cualquier módulo de Adobe Workfront Planning, haga clic en Agregar junto al campo Conexión.

  2. Rellene los campos siguientes:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header
    Connection type Seleccione conexión con autenticación de Adobe Workfront.
    Connection name Introduzca un nombre para la nueva conexión.
    Client ID Introduzca su ID de cliente de Workfront. Esto se puede encontrar en el área Aplicaciones OAuth2 del área Configuración en Workfront. Abra la aplicación específica a la que se está conectando para ver el ID de cliente.
    Client Secret Introduzca el secreto de cliente de Workfront. Esto se puede encontrar en el área Aplicaciones OAuth2 del área Configuración en Workfront. Si no dispone de un secreto de cliente para la aplicación OAuth2 en Workfront, puede generar otro. Para obtener instrucciones, consulte la documentación de Workfront.
    Authentication URL

    Este puede seguir siendo el valor predeterminado, o bien puede introducir la dirección URL de su instancia de Workfront, seguida de /integrations/oauth2.

    Ejemplo: https://mydomain.my.workfront.com/integrations/oauth2

    Host prefix En la mayoría de los casos, este valor debe ser origin.
  3. Haga clic en Continuar para guardar la conexión y volver al módulo.

    Si no ha iniciado sesión en Workfront Planning, se le dirigirá a una pantalla de inicio de sesión. Después de iniciar sesión, puede permitir la conexión.

NOTE
  • Las conexiones de OAuth 2.0 a la API de Workfront ya no dependen de las claves API.
  • Para crear una conexión con un entorno de zona protegida de Workfront, debe crear una aplicación OAuth2 en ese entorno y, a continuación, utilizar el ID de cliente y el secreto de cliente generados por esa aplicación en la conexión.

Conectar con Workfront Planning mediante una conexión de servidor a servidor

  1. En cualquier módulo de Adobe Workfront Planning, haga clic en Agregar junto al campo Conexión.

  2. Rellene los campos siguientes:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 layout-auto html-authored no-header
    Connection type Seleccione Conexión de servidor a servidor de Adobe Workfront.
    Connection name Introduzca un nombre para la nueva conexión.
    Instance name

    Introduzca el nombre de su instancia, también conocido como su dominio.

    Ejemplo: si su URL es https://example.my.workfront.com, introduzca example.

    Instance lane

    Introduzca el tipo de entorno al que se conectará esta conexión.

    Ejemplo: si su URL es https://example.my.workfront.com, introduzca my.

    Client ID Introduzca su ID de cliente de Workfront. Esto se puede encontrar en el área Aplicaciones OAuth2 del área Configuración en Workfront. Abra la aplicación específica a la que se está conectando para ver el ID de cliente.
    Client Secret Introduzca el secreto de cliente de Workfront. Esto se puede encontrar en el área Aplicaciones OAuth2 del área Configuración en Workfront. Si no dispone de un secreto de cliente para la aplicación OAuth2 en Workfront, puede generar otro. Para obtener instrucciones, consulte la documentación de Workfront.
    Scopes Escriba los ámbitos aplicables para esta conexión.
    Host prefix En la mayoría de los casos, este valor debe ser origin.
  3. Haga clic en Continuar para guardar la conexión y volver al módulo.

    Si no ha iniciado sesión en Workfront Planning, se le dirigirá a una pantalla de inicio de sesión. Después de iniciar sesión, puede permitir la conexión.

NOTE
  • Las conexiones de OAuth 2.0 a la API de Workfront ya no dependen de las claves API.
  • Para crear una conexión con un entorno de zona protegida de Workfront, debe crear una aplicación OAuth2 en ese entorno y, a continuación, utilizar el ID de cliente y el secreto de cliente generados por esa aplicación en la conexión.

Módulos de Adobe Workfront Planning y sus campos

Al configurar los módulos de Workfront, Workfront Fusion muestra los campos que se indican a continuación. Junto con estos, podrían mostrarse campos adicionales de Workfront, 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, consulte Asignar información de un módulo a otro.

Conmutador Asignar

Activadores

Ver eventos

Este módulo de déclencheur inicia un escenario cuando se crea, actualiza o elimina un registro, tipo de registro o espacio de trabajo en Workfront Planning.

Webhook
Seleccione el webhook que desee utilizar o haga clic en Agregar para crear uno nuevo.
Connection
Para obtener instrucciones sobre cómo crear una conexión con Adobe Workfront Planning, consulte Crear una conexión con Adobe Workfront Planning en este artículo.
Object type
Seleccione si desea ver registros, tipos de registros o espacios de trabajo.
State

Seleccione si desea ver el estado antiguo o el nuevo.

  • New state

    Active un escenario cuando el registro cambia a un valor determinado.

  • Old state

    Activa un escenario cuando el registro cambia de un valor determinado.

Workspace
Si observa registros, seleccione el Workspace que desee ver para ver los registros.
Record type
Si inspecciona registros, seleccione el tipo de registro que desee inspeccionar.
Events filters

Puede establecer filtros para ver solo los registros que cumplan los criterios seleccionados.

Para cada filtro, introduzca el campo que desea que evalúe el filtro, el operador y el valor que desea que permita el filtro. Puede utilizar más de un filtro añadiendo reglas AND.

Nota: Los filtros no se pueden editar en los webhooks de Workfront existentes. Para configurar diferentes filtros para suscripciones a eventos de Workfront, elimine el webhook actual y cree uno nuevo.

Para obtener más información sobre los filtros de eventos, consulte Filtros de suscripción de eventos en Workfront > Módulos de Watch Events en el artículo Módulos de Workfront.

Objetos que ver
Seleccione si desea ver las nuevas. registros actualizados, nuevos y actualizados o eliminados.
Excluir actualizaciones realizadas por esta conexión
Habilite esta opción para evitar que el escenario se active cuando la conexión utilizada por este módulo realice un cambio. Esto evita que se active otra instancia del escenario si este realiza una acción de activación.

Acciones

Eliminación de un tipo de registro

Este módulo de acción elimina un solo tipo de registro en Workfront Planning por su ID.

WARNING
Al eliminar un tipo de registro en Workfront Planning también se eliminan todos los registros de la tabla de tipo de registro.
Connection
Para obtener instrucciones sobre cómo crear una conexión con Adobe Workfront Planning, consulte Crear una conexión con Adobe Workfront Planning en este artículo.
ID de tipo de registro
Introduzca o asigne el ID del tipo de registro que desea eliminar.

Realizar una llamada API personalizada

Este módulo realiza una llamada de API personalizada a la API de Adobe Workfront Planning.

Connection
Para obtener instrucciones sobre la creación de una conexión a Adobe Workfront Planning, consulte Crear una conexión a Adobe Workfront Planning en este artículo.
URL
Introduzca una ruta relativa a https://(YOUR_WORKFRONT_DOMAIN)/maestro/api/
Method
Seleccione el método de petición HTTP que necesita para configurar la llamada de la API. Para obtener más información, consulte Métodos de petición HTTP.
Headers

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

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

Workfront Fusion añade encabezados de autorización automáticamente.

Query String
Para cada par clave/valor que desee agregar a la cadena de consulta, haga clic en Agregar elemento e introduzca la clave y el valor.
Body

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

Nota:

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

Búsquedas

Búsqueda de registros

Este módulo de acción recupera una lista de registros en función de los criterios especificados.

Connection
Para obtener instrucciones sobre cómo crear una conexión con Adobe Workfront Planning, consulte Crear una conexión con Adobe Workfront Planning en este artículo.
Workspace
Introduzca o asigne el Workspace que contiene los registros que desea buscar.
Record type
Seleccione el tipo de registro que desea buscar.
Record Fields
Para cada campo que desee utilizar en la búsqueda, busque ese campo, seleccione el operador e introduzca o asigne el valor que desee buscar. Los campos están disponibles en función del tipo de registro seleccionado.
Condición para filtros

Seleccione la condición de los filtros:

  • Y

    El módulo devuelve registros que cumplen todos los valores de campo que seleccionó.

  • O

    El módulo devuelve registros que cumplen cualquier de los valores de campo que seleccionó.

Limit
Introduzca o asigne el número máximo de registros que desea que el módulo devuelva durante cada ciclo de ejecución de escenario.

Sin categoría

Crear un registro

Esta acción crea un único registro en Workfront Planning.

Connection
Para obtener instrucciones sobre cómo crear una conexión con Adobe Workfront Planning, consulte Crear una conexión con Adobe Workfront Planning en este artículo.
ID de tipo de registro
Introduzca o asigne el tipo de registro que desea crear. Los tipos de registro disponibles se basan en su cuenta de Workfront Planning.
Otros campos
Introduzca los valores que desea que tenga el nuevo registro. Estos campos se basan en el tipo de registro seleccionado.

Eliminación de un registro

Este módulo de acción elimina el registro especificado en Workfront Planning.

Connection
Para obtener instrucciones sobre cómo crear una conexión con Adobe Workfront Planning, consulte Crear una conexión con Adobe Workfront Planning en este artículo.
Record ID
Introduzca o asigne el ID del registro que desea eliminar.

Obtener un registro

Este módulo de acción recupera un único registro de Adobe Workfront Planning, especificado por su identificador.

Connection
Para obtener instrucciones sobre cómo crear una conexión con Adobe Workfront Planning, consulte Crear una conexión con Adobe Workfront Planning en este artículo.
Record ID
Introduzca o asigne el ID del registro que desea recuperar.

Obtener registros por tipo de registro

Este módulo de acción recupera todos los registros del tipo especificado.

Connection
Para obtener instrucciones sobre cómo crear una conexión con Adobe Workfront Planning, consulte Crear una conexión con Adobe Workfront Planning en este artículo.
Workspace
Seleccione o asigne el espacio de trabajo que contiene los registros que desea recuperar.
Record type
Seleccione el tipo de registro que desea recuperar.

Obtener tipos de registros

Este módulo de acción recupera una lista de tipos de registro en una cuenta de Adobe Workfront Planning.

Connection
Para obtener instrucciones sobre cómo crear una conexión con Adobe Workfront Planning, consulte Crear una conexión con Adobe Workfront Planning en este artículo.
Workspace
Seleccione o asigne el espacio de trabajo que contiene los tipos de registro que desea recuperar.

Actualizar registro

Esta acción actualiza un único registro en Workfront Planning.

Connection
Para obtener instrucciones sobre cómo crear una conexión con Adobe Workfront Planning, consulte Crear una conexión con Adobe Workfront Planning en este artículo.
Record ID
Introduzca o asigne el tipo de registro que desea actualizar Los tipos de registro disponibles se basan en su cuenta de Workfront Planning.
Otros campos
Introduzca los nuevos valores que desea que tenga el registro. Estos campos se basan en el tipo de registro seleccionado.

Usar JSONata para el desglose legible record-types

La siguiente expresión JSONata crea un resultado legible en lenguaje natural de la consulta de Planning que le proporciona el desglose de tipos de registros. Esto hace que el nombre del tipo de registro, los nombres de campo y los nombres de opciones de campo (cuando corresponda) sean legibles por un nombre y mantiene el resto de la estructura intacta.

(
    $s0 := ({"data":$ ~> | fields | {"options":(options){name:$}} |});
    $s1 := ({"data":$s0.data ~> | **.fields | {"options_name":(options.*){displayName:$}} | });
    $s2 := $s1 ~> | data | {"fields":(fields){displayName:$}} |;
    $s2.data{displayName:$}
)

Para obtener información sobre el uso de módulos JSONata, consulte módulos JSONata.

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3