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.

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 comprar 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 las licencias de Adobe Workfront Fusion, consulte licencias de Adobe Workfront Fusion.

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:

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

Crear una conexión a Adobe Workfront Planning create-a-connection-to-adobe-workfront-planning

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

  1. En cualquier módulo de Adobe Workfront Planning, haga clic en Añadir junto al cuadro 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 layout-auto html-authored no-header
    Connection name Introduzca un nombre para esta conexión.
    Environment Seleccione si desea conectarse a un entorno de producción o de no producción.
    Type Seleccione si le importa conectarse a una cuenta de servicio o a una cuenta personal.

    Client ID

    (Opcional)

    Introduzca su Client ID Adobe. Esto se puede encontrar en la sección Credentials details de Adobe Developer Console.

    Client Secret

    (Opcional)

    Introduzca su Adobe Client Secret.  Esto se puede encontrar en la sección Credentials details de Adobe Developer Console.
    Authentication URL

    Introduzca la dirección URL que utilizará su instancia de Workfront para autenticar esta conexión.

    El valor predeterminado es https://oauth.my.workfront.com/integrations/oauth2.

    Host prefix

    Introduzca el prefijo de host.

    El valor predeterminado es origin-.

  3. Haga clic en Continuar para guardar la conexión y volver al módulo.

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 a estos, pueden mostrarse campos de Workfront 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

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 las 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 de 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, 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"}

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