DocumentaciónWorkfrontAdobe Workfront Fusion

Módulos de Adobe Workfront

Last update: Thu Jan 30 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Puede utilizar el conector Adobe Workfront Fusion Adobe Workfront para automatizar sus procesos dentro de Workfront. También puede conectar Workfront a otras aplicaciones y servicios.

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: cualquiera
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.

note note
NOTE
  • Si su organización utiliza el paquete de licencias heredado (basado en conectores), debe tener una licencia de integración y automatización del trabajo de Workfront Fusion para conectarse a aplicaciones y servicios de terceros. El conector de Workfront no se cuenta contra el número de aplicaciones activas disponibles para su organización. Todos los escenarios, incluso si solo utilizan la aplicación de Workfront, no se contabilizan en el recuento total de escenarios de su organización.

Conexión de Workfront a Workfront Fusion

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

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

  1. En cualquier módulo de Adobe Workfront, haga clic en Añadir 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 layout-auto html-authored no-header
    Connection name Introduzca un nombre para la nueva conexión.
    Environment Seleccione si se está conectando a un entorno de producción o de no producción.
    Connection type Seleccione si desea conectarse a una cuenta de servicio o a una personal.
    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 Escriba 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 Continue para guardar la conexión y volver al módulo.

    Si no ha iniciado sesión en Workfront, 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 de API.
  • Para crear una conexión con un entorno limitado 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 Workfront 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

NOTE
  • Si no ve los campos más actualizados en un módulo de Workfront, puede deberse a problemas de almacenamiento en caché. Espere una hora e inténtelo de nuevo.
  • Los códigos de estado HTTP 429 de Adobe Workfront no deben provocar desactivaciones, sino activar una breve pausa en la ejecución en el escenario.

Activadores

Watch Events

Este módulo de activación ejecuta un escenario en tiempo real cuando se añaden, actualizan o eliminan objetos de un tipo específico en Workfront

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.

  1. Haga clic en Add a la derecha del cuadro Gancho web.

  2. Configure el webhook en el cuadro Add a hook que aparece.

    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
    Webhook name Introducir un nombre para el webhook
    Connection Para obtener instrucciones sobre cómo conectar la aplicación de Workfront a Workfront Fusion, consulte Conectar Workfront a Workfront Fusion en este artículo.
    Record Type Seleccione el tipo de registro de Workfront que desea que vea el módulo.
    State

    Seleccione si desea ver el estado antiguo o el nuevo.

    • New state

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

      Por ejemplo, si el estado se establece en New State y el filtro se establece en Status Equals In Progress, el webhook crea un déclencheur cuando Status cambie a In Progress, independientemente del estado anterior.

    • Old state

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

      Por ejemplo, si el estado se establece en Old State y el filtro se establece en Status Equals In Progress, el webhook crea un déclencheur cuando un Status que actualmente es In Progress cambia a otro estado.
    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: no puede editar filtros 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 > Watch Events módulos en este artículo.
    Excluir eventos realizados por esta conexión

    Habilite esta opción para excluir los eventos creados o actualizados con el mismo conector que utiliza este módulo de activador. Así pueden evitarse situaciones en las que un escenario podría activarse a sí mismo y provocar su repetición en un bucle interminable.

    NOTA: El tipo de registro de asignación no incluye esta opción.
    Record Origin

    Elija si desea que el escenario vea New Records Only, Updated Records Only, New and Updated Records o Deleted Records Only.

    NOTA: Si elige New and Updated Records, la creación del gancho web crea 2 suscripciones de evento (para la misma dirección de gancho web).

Una vez creado el webhook, podrá ver la dirección del punto final al que se envían los eventos.

Para obtener más información, consulte la sección Ejemplos de cargas útiles de eventos en el artículo API de suscripción de eventos en la documentación de Workfront.

Vea una lista de los tipos de objetos Workfront para los que puede usar este módulo en tipos de objetos Workfront disponibles para cada módulo Workfront.

Watch Field

Este módulo de activador ejecuta un escenario cuando se actualiza un campo que se haya especificado. El módulo devuelve el valor antiguo y el nuevo del campo especificado. Puede asignar esta información en módulos subsiguientes en el escenario.

Al configurar este módulo, se muestran 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 Para obtener instrucciones sobre cómo conectar la aplicación de Workfront a Workfront Fusion, consulte Conectar Workfront a Workfront Fusion en este artículo.
Record Type

Seleccione el tipo de registro de Workfront que desea que vea el módulo.

Por ejemplo, seleccione Task si desea comenzar a ejecutar el escenario cada vez que se actualice un campo de registro en una tarea.
Field Seleccione el campo en el que desea que el módulo observe las actualizaciones. Estos campos reflejan los campos que el administrador de Workfront ha configurado para el seguimiento.
Outputs Seleccione los campos de objeto que desea incluir en el paquete de salida para este módulo.
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.

Vea una lista de los tipos de objetos Workfront para los que puede usar este módulo en tipos de objetos Workfront disponibles para cada módulo Workfront.

Watch Record

Este módulo de activación ejecuta un escenario cuando se añaden, actualizan o ambos objetos de un tipo específico. El módulo devuelve todos los campos estándar asociados con el registro o registros, junto con cualquier campo personalizado y valor al que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.

En la salida, el módulo indica si cada registro es nuevo o se ha actualizado.

Los registros que se agregaron y actualizaron desde la última vez que se ejecutó el escenario se devuelven como registros nuevos.

Al configurar este módulo, se muestran 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 Para obtener instrucciones sobre cómo conectar la aplicación de Workfront a Workfront Fusion, consulte Conectar Workfront a Workfront Fusion en este artículo.
Filter Elija si desea que el escenario vea New Records Only, Updated Records Only o New and Updated Records.
Record Type

Seleccione el tipo de registro de Workfront que desea que vea el módulo.

Por ejemplo, si desea iniciar el escenario cada vez que se cree un nuevo proyecto, seleccione Project
Outputs Seleccione los campos que desea incluir en el paquete de salida para este módulo.
Reference Seleccione los campos de referencia que desee incluir en el paquete de salida para este módulo.
Outputs Seleccione los campos de recopilación que desea incluir en el paquete de salida para este módulo.
Optional Filter (Avanzado) Escriba una cadena de código de API para definir cualquier parámetro o código adicional que restrinja sus criterios.
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.

Vea una lista de los tipos de objetos Workfront para los que puede usar este módulo en tipos de objetos Workfront disponibles para cada módulo Workfront.

Acciones

Convert object

Este módulo de acción realiza una de las siguientes conversiones:

  • Convertir problema a proyecto
  • Convertir problema a tarea
  • Convertir tarea a proyecto
note note
NOTE
A partir de julio de 2024, los formularios personalizados se pueden incluir al convertir un objeto.
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 8-row-2 layout-auto html-authored no-header
Connection Para obtener instrucciones sobre cómo conectar la aplicación de Workfront a Workfront Fusion, consulte Conectar Workfront a Workfront Fusion en este artículo.
Object type Seleccione el tipo de objeto que desea convertir. Es el tipo que tiene el objeto antes de la conversión.
Convert to Seleccione el objeto al que desea convertirlo. Es el tipo que tiene el objeto después de la conversión.
<Object> ID

Introduzca el ID del objeto.

Nota: Al introducir el ID de un objeto, puede empezar a escribir su nombre y, a continuación, seleccionarlo en la lista. A continuación, el módulo introducirá el ID adecuado en el campo.
Template ID

Si está realizando una conversión a un proyecto, seleccione el ID de plantilla que desee utilizar para el proyecto.

Nota: Al introducir el ID de un objeto, puede empezar a escribir su nombre y, a continuación, seleccionarlo en la lista. A continuación, el módulo introducirá el ID adecuado en el campo.
Custom forms Seleccione los formularios personalizados que desee añadir al objeto recién convertido y, a continuación, introduzca los valores de los campos de formulario personalizado.
Options Habilite las opciones que desee al convertir el objeto. Las opciones están disponibles en función del objeto al que se convierta o desde el que se convierta.
Copy native fields Habilite esta opción para copiar cualquier campo nativo del objeto original al nuevo.
Copy custom forms Habilite esta opción para copiar cualquier campo nativo del objeto original al nuevo.
Create a record (attaching custom forms)

Este módulo de acción crea un objeto, como un proyecto, una tarea o un problema en Workfront, y le permite agregar un formulario personalizado al nuevo objeto. El módulo le permite seleccionar qué campos del objeto están disponibles en el módulo.

Especifique el identificador del registro.

El módulo devuelve el identificador 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.

Asegúrese de proporcionar el número mínimo de campos de entrada. Por ejemplo, si desea crear un problema, debe proporcionar un ID de proyecto principal válido en el campo ID de proyecto para indicar dónde debe residir el problema en Workfront. Puede utilizar el panel de asignación para asignar esta información desde otro módulo del escenario o puede introducirla manualmente escribiendo el nombre y seleccionándolo a continuación en la lista.

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

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Connection Para obtener instrucciones sobre cómo conectar la aplicación de Workfront a Workfront Fusion, consulte Conectar Workfront a Workfront Fusion en este artículo.
Record Type

Seleccione el tipo de registro de Workfront que desea que cree el módulo.

Por ejemplo, si desea crear un proyecto, seleccione Project en la lista desplegable.
Select fields to map

Seleccione los campos que desea que estén disponibles para la entrada de datos. Esto le permite utilizar estos campos sin tener que desplazarse por los que no necesita. A continuación, puede introducir o asignar datos en estos campos.

Para los campos de los formularios personalizados, utilice el campo Attach Custom Form.
Attach Custom Form Seleccione cualquier formulario personalizado que desee agregar al nuevo objeto y, a continuación, introduzca o asigne valores para esos campos.

Vea una lista de los tipos de objetos Workfront para los que puede usar este módulo en tipos de objetos Workfront disponibles para cada módulo Workfront.

note note
NOTE
  • Al introducir el ID de un objeto, puede empezar a escribir su nombre y, a continuación, seleccionarlo en la lista. A continuación, el módulo introducirá el ID adecuado en el campo.
  • Al escribir el texto de un campo personalizado o de un objeto Note (Comentario o respuesta), puede utilizar etiquetas de HTML en el campo Note Text para crear texto enriquecido, como negrita o cursiva.
Create Record

Este módulo de acción crea un objeto en Workfront, como un proyecto, una tarea o un problema. El módulo le permite seleccionar qué campos del objeto están disponibles en el módulo.

Especifique el identificador del registro.

El módulo devuelve el identificador 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.

Asegúrese de proporcionar el número mínimo de campos de entrada. Por ejemplo, si desea crear un problema, debe proporcionar un ID de proyecto principal válido en el campo ID de proyecto para indicar dónde debe residir el problema en Workfront. Puede utilizar el panel de asignación para asignar esta información desde otro módulo del escenario o puede introducirla manualmente escribiendo el nombre y seleccionándolo a continuación en la lista.

Este módulo no adjunta formularios personalizados al crear el objeto. Para adjuntar formularios personalizados al crear un objeto, utilice el módulo Create a record (attaching custom forms).

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

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Connection Para obtener instrucciones sobre cómo conectar la aplicación de Workfront a Workfront Fusion, consulte Conectar Workfront a Workfront Fusion en este artículo.
Record Type

Seleccione el tipo de registro de Workfront que desea que cree el módulo.

Por ejemplo, si desea crear un proyecto, seleccione Project en la lista desplegable.
Select fields to map Seleccione los campos que desea que estén disponibles para la entrada de datos. Así podrá utilizar estos campos sin tener que desplazarse por los que no necesita.

Vea una lista de los tipos de objetos Workfront para los que puede usar este módulo en tipos de objetos Workfront disponibles para cada módulo Workfront.

note note
NOTE
  • Al introducir el ID de un objeto, puede empezar a escribir su nombre y, a continuación, seleccionarlo en la lista. A continuación, el módulo introducirá el ID adecuado en el campo.
  • Al escribir el texto de un campo personalizado o de un objeto Note (Comentario o respuesta), puede utilizar etiquetas de HTML en el campo Note Text para crear texto enriquecido, como negrita o cursiva.
Custom API Call

Este módulo de acción le permite realizar una llamada autenticada personalizada a la API de Workfront. De este modo, puede crear una automatización del flujo de datos que no puedan realizar los demás módulos de Workfront.

El módulo devuelve la siguiente información:

  • Status Code (número): esto indica el éxito o el error de la solicitud HTTP. Se trata de códigos estándar que puede buscar en internet.

  • Headers (objeto): contexto más detallado para el código de respuesta/estado que no está relacionado con el cuerpo de salida. No todos los encabezados que aparecen en un encabezado de respuesta son de respuesta, por lo que algunos podrían no resultarle útiles.

    Los encabezados de respuesta dependen de la petición HTTP elegida al configurar el módulo.

  • Body (objeto): Según la solicitud HTTP elegida al configurar el módulo, es posible que vuelva a recibir algunos datos. Esos datos, como los de una petición GET, están incluidos en este objeto.

Puede asignar esta información en módulos subsiguientes en el escenario.

Al configurar este módulo, se muestran 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 Para obtener instrucciones sobre cómo conectar la aplicación de Workfront a Workfront Fusion, consulte Conectar Workfront a Workfront Fusion en este artículo.
URL Introduzca una ruta relativa a https://<WORKFRONT_DOMAIN>/attask/api/<API_VERSION>/.
API Version Seleccione la versión de la API de Workfront que desea que utilice el módulo.
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 solicitud HTTP en Adobe Workfront Fusion.
Headers

Añada los encabezados de la solicitud en forma de objeto JSON estándar. Determina el tipo de contenido de la petición.

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

Nota: Si se producen errores y es difícil determinar su origen, considere la posibilidad de modificar los encabezados según la documentación de Workfront. Si su llamada de API personalizada devuelve un error de petición HTTP 422, intente utilizar un encabezado "Content-Type":"text/plain".
Query String

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

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

Sugerencia: Le recomendamos que envíe información a través del cuerpo de JSON en lugar de como parámetros de consulta.
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.

Vea una lista de los tipos de objetos Workfront para los que puede usar este módulo en tipos de objetos Workfront disponibles para cada módulo Workfront.

Delete Record

Este módulo de acción elimina un objeto, como un proyecto, una tarea o un problema en Workfront.

Especifique el identificador del registro.

El módulo devuelve el identificador 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.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
Connection Para obtener instrucciones sobre cómo conectar la aplicación de Workfront a Workfront Fusion, consulte Conectar Workfront a Workfront Fusion en este artículo.
Force delete Habilite esta opción para asegurarse de que se elimina el registro, incluso si la interfaz de usuario de Workfront solicitara confirmación de la eliminación.
Async delete Active esta opción para permitir que el módulo elimine de forma asíncrona.
Identificador

Introduzca el ID único de Workfront del registro que desea que elimine el módulo.

Para obtener el ID, abra el objeto Workfront en el explorador y copie el texto al final de la dirección URL después de "ID=". Por ejemplo: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e
Record Type Seleccione el tipo de registro de Workfront que desea que elimine el módulo.

Vea una lista de los tipos de objetos Workfront para los que puede usar este módulo en tipos de objetos Workfront disponibles para cada módulo Workfront.

note note
NOTE
Se recomienda la siguiente configuración de escenario para evitar la posibilidad de que no se eliminen registros debido a operaciones asíncronas.
  1. Elimine el registro de forma sincrónica.
  2. Añada la administración de errores al módulo Eliminar registro para ignorar el error causado por el tiempo de espera de 40 segundos.
Download Document

Este módulo de acción descarga un documento de Workfront.

Especifique el identificador del registro.

El módulo devuelve el contenido, el nombre de archivo y la extensión y el tamaño de archivo del documento. Puede asignar esta información en módulos subsiguientes en el escenario.

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

table 0-row-2 1-row-2 layout-auto html-authored no-header
Connection Para obtener instrucciones sobre cómo conectar la aplicación de Workfront a Workfront Fusion, consulte Conectar Workfront a Workfront Fusion en este artículo.
Document ID

Asigne o introduzca manualmente el ID único de Workfront del documento que desea que descargue el módulo.

Para obtener el ID, abra el objeto Workfront en el explorador y copie el texto al final de la dirección URL después de "ID=". Por ejemplo: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

Vea una lista de los tipos de objetos Workfront para los que puede usar este módulo en tipos de objetos Workfront disponibles para cada módulo Workfront.

Misc Action

Este módulo de acción le permite realizar acciones en la API.

note note
NOTE
En julio de 2024, la acción convertToProject incluye el campo copyCategories. Cuando se establece en TRUE, todos los formularios personalizados se incluirán en el proyecto al que se convierte el problema.

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

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Connection Para obtener instrucciones sobre cómo conectar la aplicación de Workfront a Workfront Fusion, consulte Conectar Workfront a Workfront Fusion en este artículo.
Record Type Seleccione el tipo de registro de Workfront con el que desea que interactúe el módulo.
Action

Seleccione la acción que desea que realice el módulo.

Es posible que tenga que rellenar campos adicionales, según los Record Type y Action que elija. Algunas combinaciones de estas dos configuraciones pueden requerir solamente un id. de registro, mientras que otras (como Proyecto para Record Type y Attach Template para Action) requieren información adicional (como un id. de objeto y un id. de plantilla).

Para ver las opciones disponibles para algunas acciones, consulte Otras opciones de acción en este artículo.

Para obtener detalles sobre campos individuales, consulte la documentación para desarrolladores de Workfront.

Nota: El sitio de documentación para desarrolladores incluye información solamente a través de la versión 14 de la API, pero aún contiene información valiosa para las llamadas de la API.

  1. Seleccione el tipo de registro en el panel de navegación izquierdo de la página Documentación para desarrolladores de Workfront. Los siguientes tipos tienen sus propias páginas:

    • Projects

    • Tasks

    • Issues

    • Users

    • Documents

    Para el resto de tipos de registros, seleccione Other objects and endpoints y busque el tipo de registro en las páginas ordenadas alfabéticamente.

  2. En la página del tipo de registro adecuado, busque (Ctrl-F o Cmd-F) la acción.

  3. Vea las descripciones de los campos disponibles en la acción seleccionada.

Nota:

Al crear una revisión a través del módulo Workfront SOAP Misc Action, se recomienda crear una revisión sin ninguna opción avanzada y luego actualizar la revisión a través de la API de Workfront Proof.

Para obtener más información sobre cómo crear una revisión con la API de Workfront (que usa este módulo), consulte Agregar opciones avanzadas de revisión al crear una revisión mediante la API de Adobe Workfront
ID

Introduzca o asigne el ID de Workfront único del registro con el que desea que interactúe el módulo.

Para obtener el ID, abra el objeto Workfront en el explorador y copie el texto al final de la dirección URL después de "ID=". Por ejemplo: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

Vea una lista de los tipos de objetos Workfront para los que puede usar este módulo en tipos de objetos Workfront disponibles para cada módulo Workfront.

Varias opciones de acción

Tarea
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored
Acción Opciones
Copiar

  • clearApprovers

  • clearAssignments

  • clearConstraints

  • clearCustomData

  • clearDocuments

  • clearExpenses

  • clearFinancials

    Borra los datos financieros

  • clearPermissions

  • clearPredecessors

  • clearProgress

  • clearTimedNotifications

    Borra las notificaciones de recordatorio
Mover

  • clearApprovers

  • clearAssignments

  • clearDocuments

  • clearConstraints

  • clearExpenses

  • clearFinancials

    Borra los datos financieros

  • clearPermissions

  • clearPredecessors

  • clearProgress

  • clearTimedNotifications

    Borra las notificaciones de recordatorio
Problema
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored
Acción Opciones
Copiar
  • clearApprovers
  • clearAssignments
  • clearCustomData
  • clearDocuments
  • clearPermissions
  • clearProgress
Convertir a tarea

  • preserveIssue

    Mantener el problema original y enlazar su solución a esta tarea

  • preservePrimaryContact

    Permitir que el contacto principal de los problemas acceda a esta tarea

  • preserveCompletionDate

    Conservar la fecha planificada de finalización del problema
Convertir en proyecto

  • preserveIssue

    Mantener el problema original y enlazar su solución a esta tarea

  • preservePrimaryContact

    Permitir que el contacto principal de los problemas acceda a esta tarea
Proyecto
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored
Acción Opciones
Copiar

  • clearApprovers

  • clearAssignments

  • clearCustomData

  • clearDocuments

  • clearExpenses

  • clearFinancials

    Borra los datos financieros

  • clearPermissions

  • clearPredecessors

  • clearProgress

  • clearTimedNotifications

    Borra las notificaciones de recordatorio
Adjuntar plantilla / Guardar como plantilla

  • clearApprovers

  • clearAssignments

  • clearBillingRates

  • clearConstraints

  • clearDeliverables

    Borra metas

  • clearDocuments

  • clearExpenses

  • clearFinancials

    Borra los datos financieros

  • clearHourTypes

  • clearIssueSetup

    Borra las propiedades de cola y la configuración de problemas

  • clearPredecessors

  • clearRisks

  • clearSharingOptions

  • clearTimedNotifications

    Borra las notificaciones de recordatorio
Read a Record

Este módulo de acción recupera datos de un único registro.

Especifique el identificador del registro. También puede especificar qué registros relacionados desea que lea el módulo.

Por ejemplo, si el registro que está leyendo el módulo es un proyecto, puede especificar que desea que se lean las tareas del proyecto.

El módulo devuelve una matriz de datos de los campos de salida especificados.

Al configurar este módulo, se muestran 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 Para obtener instrucciones sobre cómo conectar la aplicación de Workfront a Workfront Fusion, consulte Conectar Workfront a Workfront Fusion en este artículo.
Record Type Elija el tipo de objeto Workfront que desea que lea el módulo.
Outputs Seleccione la información que desea incluir en el paquete de salida para este módulo.
References Seleccione cualquier campo de referencia que desee incluir en la salida.
Collections Seleccione cualquier campo de referencia que desee incluir en la salida.
ID

Introduzca el ID único de Workfront del registro que desea que lea el módulo.

Para obtener el ID, abra el objeto Workfront en el explorador y copie el texto al final de la dirección URL después de "ID=". Por ejemplo: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

Vea una lista de los tipos de objetos Workfront para los que puede usar este módulo en tipos de objetos Workfront disponibles para cada módulo Workfront.

Update Record

Este módulo de acción actualiza un objeto, como un proyecto, una tarea o un problema. El módulo le permite seleccionar qué campos del objeto están disponibles en el módulo.

Especifique el identificador del registro.

El módulo devuelve el ID del objeto y cualquier campo asociado, junto con cualquier campo personalizado y valor al 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.

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Connection Para obtener instrucciones sobre cómo conectar la aplicación de Workfront a Workfront Fusion, consulte Conectar Workfront a Workfront Fusion en este artículo.
ID

Introduzca el ID único de Workfront del registro que desea que actualice el módulo.

Para obtener el ID, abra el objeto Workfront en el explorador y copie el texto al final de la dirección URL después de "ID=". Por ejemplo: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e
Record Type Seleccione el tipo de registro de Workfront que desea que actualice el módulo.
Select fields to map Seleccione los campos que desea que estén disponibles para la entrada de datos. Esto le permite utilizar estos campos sin tener que desplazarse por los que no necesita. A continuación, puede introducir o asignar datos en estos campos.

Vea una lista de los tipos de objetos Workfront para los que puede usar este módulo en tipos de objetos Workfront disponibles para cada módulo Workfront.

note note
NOTE
  • Al introducir el ID de un objeto, puede empezar a escribir su nombre y, a continuación, seleccionarlo en la lista. A continuación, el módulo introducirá el ID adecuado en el campo.
  • Al escribir el texto de un campo personalizado o de un objeto Note (Comentario o respuesta), puede utilizar etiquetas de HTML en el campo Note Text para crear texto enriquecido, como negrita o cursiva.
Upload Document

Este módulo de acción carga un documento en un objeto de Workfront, como un proyecto, una tarea o un problema. Este módulo carga el documento en fragmentos, lo que facilita el proceso de carga para Workfront.

Este módulo puede gestionar archivos de mayor tamaño que el módulo heredado y forma parte de un despliegue gradual para organizaciones con un paquete de Ultimate Workfront.

Especifique la ubicación del documento, el archivo que desea cargar y un nuevo nombre opcional para el archivo.

El módulo devuelve el ID del documento y cualquier campo asociado, junto con cualquier campo personalizado y valor al 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.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
Connection Para obtener instrucciones sobre cómo conectar la aplicación de Workfront a Workfront Fusion, consulte Conectar Workfront a Workfront Fusion en este artículo.
Related Record ID Introduzca el ID único de Workfront del registro en el que desea cargar el documento.
Related Record Type Seleccione el tipo de registro de Workfront donde desea que el módulo cargue el documento.
Folder ID Según el tipo de registro relacionado, es posible que deba introducir o asignar un ID de carpeta.
Source file Seleccione un archivo de origen de un módulo anterior o asigne el nombre y los datos del archivo de origen.

Vea una lista de los tipos de objetos Workfront para los que puede usar este módulo en tipos de objetos Workfront disponibles para cada módulo Workfront.

Upload Document (Legacy)

Este módulo de acción carga un documento en un objeto de Workfront, como un proyecto, una tarea o un problema. Carga todo el documento a la vez.

Especifique la ubicación del documento, el archivo que desea cargar y un nuevo nombre opcional para el archivo.

El módulo devuelve el ID del documento y cualquier campo asociado, junto con cualquier campo personalizado y valor al 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.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
Connection Para obtener instrucciones sobre cómo conectar la aplicación de Workfront a Workfront Fusion, consulte Conectar Workfront a Workfront Fusion en este artículo.
Related Record ID Introduzca el ID único de Workfront del registro en el que desea cargar el documento.
Related Record Type Seleccione el tipo de registro de Workfront donde desea que el módulo cargue el documento.
Folder ID Según el tipo de registro relacionado, es posible que deba introducir o asignar un ID de carpeta.
Source file Seleccione un archivo de origen de un módulo anterior o asigne el nombre y los datos del archivo de origen.

Vea una lista de los tipos de objetos Workfront para los que puede usar este módulo en tipos de objetos Workfront disponibles para cada módulo Workfront.

Búsquedas

Read Related Records

Este módulo de búsqueda lee registros que coinciden con la consulta de búsqueda especificada, en un objeto principal concreto.

Especifique qué campos desea incluir en la salida. Puede asignar esta información en módulos subsiguientes en el escenario.

Al configurar este módulo, se muestran 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 Para obtener instrucciones sobre cómo conectar la aplicación de Workfront a Workfront Fusion, consulte Conectar Workfront a Workfront Fusion en este artículo.
Record Type

Seleccione el tipo de registro principal (objeto Workfront) cuyos registros asociados desea leer.

Vea una lista de los tipos de objetos de Workfront para los que puede usar este módulo en tipos de objetos de Workfront disponibles para cada módulo de Workfront en este artículo.
Parent Record ID

Introduzca o asigne el ID del registro principal cuyos registros asociados desea leer.

Para obtener el ID, abra el objeto Workfront en el explorador y copie el texto al final de la dirección URL después de "ID=". Por ejemplo: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e
Collections Seleccione o asigne el tipo de registro secundario que desea que el módulo lea.
Outputs Seleccione la información que desea incluir en el paquete de salida para este módulo.
Search

Este módulo de búsqueda busca registros en un objeto de Workfront que coincidan con la consulta de búsqueda especificada.

Puede asignar esta información en módulos subsiguientes en el escenario.

Al configurar este módulo, se muestran 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 8-row-2 layout-auto html-authored no-header
Connection Para obtener instrucciones sobre cómo conectar la aplicación de Workfront a Workfront Fusion, consulte Conectar Workfront a Workfront Fusion en este artículo.
Record Type Seleccione el tipo de registro de Workfront que desea que busque el módulo.
Result Set Seleccione una opción para especificar si desea que el módulo obtenga el primer resultado que coincida con sus criterios de búsqueda o todos los resultados que coincidan con estos.
Maximal 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.
Search criteria fields Seleccione los campos que desea utilizar para los criterios de búsqueda. Estos campos estarán disponibles en el menú desplegable Criterios de búsqueda.
Search criteria

Introduzca el campo por el que desea buscar, el operador que desea utilizar en la consulta y el valor que está buscando en el campo.

Nota: No use username en los criterios de búsqueda. Si se incluye username en una consulta de API en Workfront, el usuario inicia sesión en Workfront y la búsqueda no se realizará correctamente.

Nota: In y NotIn funcionan con matrices. Las entradas deben estar en formato de matriz.
Outputs Seleccione los campos que desea incluir en la salida para este módulo.
References Seleccione los campos de referencia que desea incluir en la búsqueda.
Collections Seleccione las colecciones que desea añadir a la búsqueda.

Tipos de objetos de Workfront disponibles para cada módulo de Workfront

Tipos de objetos disponibles para cada módulo de déclencheur de Workfront
table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4 15-row-4 16-row-4 17-row-4 18-row-4 19-row-4 20-row-4 21-row-4 22-row-4 23-row-4 24-row-4 25-row-4 26-row-4 27-row-4 28-row-4 29-row-4 30-row-4 31-row-4 32-row-4 33-row-4 34-row-4 35-row-4 36-row-4 37-row-4 38-row-4 39-row-4 40-row-4 41-row-4 layout-auto
Watch Record Watch Field Watch Events
Proceso de aprobación ✓
Asignación ✓ ✓
Línea base ✓
Registro de facturación ✓
Tarifa de facturación ✓
Compañía ✓ ✓ ✓
Panel de control ✓
Documento ✓ ✓ ✓
Carpeta de documentos ✓ ✓
Solicitud de documento ✓
Versión de documento ✓ ✓
Gasto ✓ ✓ ✓
Tipo de gasto
Grupo ✓ ✓
Hora ✓ ✓
Tipo de hora ✓
Problema ✓ ✓ ✓
Iteración ✓ ✓
Función ✓ ✓
Entrada de cuaderno ✓
Hito ✓
Ruta de hitos ✓ ✓
Nota ✓ ✓ ✓
Etiqueta de nota ✓
Portafolio ✓ ✓ ✓
Programa ✓ ✓ ✓
Proyecto ✓ ✓ ✓
Usuario de proyecto ✓
Aprobación de revisión ✓
Tiempo reservado* ✓
Informe ✓
Riesgo
Tipo de riesgo
Aprobador de paso ✓
Tarea ✓ ✓ ✓
Equipo ✓
Plantilla ✓ ✓ ✓
Tarea de plantilla ✓ ✓
Plantilla de horas ✓ ✓ ✓
Usuario ✓ ✓ ✓
Actualizar
Tipos de objetos disponibles para cada módulo de acción de Workfront
note note
NOTE
El módulo Download Document no se incluye en esta tabla porque los tipos de objetos Workfront no forman parte de su configuración.
table 0-row-8 1-row-8 2-row-8 3-row-8 4-row-8 5-row-8 6-row-8 7-row-8 8-row-8 9-row-8 10-row-8 11-row-8 12-row-8 13-row-8 14-row-8 15-row-8 16-row-8 17-row-8 18-row-8 19-row-8 20-row-8 21-row-8 22-row-8 23-row-8 24-row-8 25-row-8 26-row-8 27-row-8 28-row-8 29-row-8 30-row-8 31-row-8 32-row-8 33-row-8 34-row-8 35-row-8 36-row-8 37-row-8 38-row-8 39-row-8 layout-auto
Create a record Update a record Delete a record Upload Document Read a record Custom API Call Misc Action
Proceso de aprobación ✓ ✓ ✓ ✓ ✓ ✓ ✓
Asignación ✓ ✓ ✓ ✓ ✓ ✓
Línea base ✓ ✓ ✓ ✓
Registro de facturación ✓ ✓ ✓ ✓
Tarifa de facturación ✓ ✓ ✓ ✓ ✓
Compañía ✓ ✓ ✓ ✓ ✓ ✓ ✓
Documento ✓ ✓ ✓ ✓ ✓ ✓ ✓
Carpeta de documentos ✓ ✓ ✓ ✓ ✓ ✓ ✓
Versión de documento ✓ ✓ ✓ ✓ ✓ ✓
Tipo de cambio ✓ ✓ ✓ ✓
Gasto ✓ ✓ ✓ ✓ ✓ ✓ ✓
Tipo de gasto ✓ ✓ ✓ ✓
Documento externo ✓
Grupo ✓ ✓ ✓ ✓ ✓ ✓ ✓
Hora ✓ ✓ ✓ ✓ ✓
Tipo de hora ✓ ✓ ✓ ✓
Problema ✓ ✓ ✓ ✓ ✓ ✓ ✓
Iteración ✓ ✓ ✓ ✓ ✓
Función ✓ ✓ ✓ ✓ ✓
Entrada de cuaderno ✓ ✓ ✓ ✓ ✓ ✓
Hito ✓ ✓ ✓ ✓ ✓
Ruta de hitos ✓ ✓ ✓ ✓ ✓
Nota ✓ ✓ ✓ ✓ ✓ ✓ ✓
Etiqueta de nota ✓ ✓ ✓ ✓ ✓
Portafolio ✓ ✓ ✓ ✓ ✓ ✓ ✓
Programa ✓ ✓ ✓ ✓ ✓ ✓ ✓
Proyecto ✓ ✓ ✓ ✓ ✓ ✓ ✓
Usuario de proyecto ✓ ✓ ✓ ✓ ✓
Tiempo reservado* ✓ ✓ ✓ ✓ ✓
Riesgo ✓ ✓ ✓ ✓ ✓
Tipo de riesgo ✓ ✓ ✓ ✓
Aprobador de paso ✓ ✓ ✓ ✓ ✓
Tarea ✓ ✓ ✓ ✓ ✓ ✓ ✓
Equipo ✓ ✓ ✓ ✓
Plantilla ✓ ✓ ✓ ✓ ✓
Tarea de plantilla ✓ ✓ ✓ ✓ ✓ ✓ ✓
Plantilla de horas ✓ ✓ ✓ ✓ ✓
Usuario ✓ ✓ ✓ ✓ ✓ ✓ ✓
Actualizar ✓
Tipos de objetos disponibles para cada módulo de búsqueda de Workfront
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3 14-row-3 15-row-3 16-row-3 17-row-3 18-row-3 19-row-3 20-row-3 21-row-3 22-row-3 23-row-3 24-row-3 25-row-3 26-row-3 27-row-3 28-row-3 29-row-3 30-row-3 31-row-3 32-row-3 33-row-3 34-row-3 35-row-3 36-row-3 layout-auto
Search Read Related Records
Proceso de aprobación ✓ ✓
Asignación ✓ ✓
Registro de facturación ✓
Tarifa de facturación ✓
Compañía ✓ ✓
Documento ✓ ✓
Carpeta de documentos ✓ ✓
Versión de documento ✓
Gasto ✓
Tipo de gasto ✓
Grupo ✓ ✓
Hora ✓
Tipo de hora ✓
Problema ✓ ✓
Iteración ✓
Función ✓
Entrada de cuaderno ✓
Hito ✓
Ruta de hitos ✓
Nota ✓
Etiqueta de nota ✓
Portafolio ✓ ✓
Programa ✓
Proyecto ✓ ✓
Usuario de proyecto ✓
Tiempo reservado* ✓
Riesgo ✓
Tipo de riesgo ✓
Aprobador de paso ✓
Tarea ✓ ✓
Equipo ✓
Plantilla ✓
Tarea de plantilla ✓
Plantilla de horas ✓ ✓
Usuario ✓ ✓
Delegación de usuario ✓

Le recomendamos que lo verifique bien para asegurarse de que esto funciona de la manera prevista.

Filtros de suscripción de eventos en los módulos Workfront > Watch Events

NOTE
Recomendamos encarecidamente el uso de filtros de suscripción de evento en los módulos de Watch Events.

El módulo Workfront Watch Events déclencheur escenarios basados en un webhook que crea una suscripción de evento en la API de Workfront. La suscripción de eventos es un conjunto de datos que determina qué eventos se envían al webhook. Por ejemplo, si configura un módulo de Watch Events que está vigilando problemas, la suscripción de evento solo enviará eventos relacionados con los problemas.

Mediante filtros de suscripción de eventos, los usuarios de Fusion pueden crear suscripciones de eventos que se adapten mejor a sus casos de uso. Por ejemplo, puede configurar una suscripción de evento en la API de Workfront para enviar solo los problemas que están en un proyecto específico al webhook, asegurándose de que el módulo Watch Events solo entrará en déclencheur para los problemas de ese proyecto. La capacidad de crear activadores más limitados mejora el diseño de escenarios al reducir el número de activadores irrelevantes.

Esto es diferente a la configuración de un filtro en el escenario de Workfront Fusion. Sin un filtro de suscripción de eventos, el webhook recibe todos los eventos relacionados con el tipo de objeto seleccionado. La mayoría de estos eventos serían irrelevantes para el escenario y deben filtrarse para que el escenario pueda continuar.

Los siguientes operadores están disponibles en el filtro Workfront > Ver eventos:

  • Es igual a

  • No es igual a

  • Mayor que

  • Menor que

  • Mayor o igual que

  • Menor o igual que

  • Contiene

  • Existe

    • Este operador no requiere un valor y el campo de valor está ausente.

  • No existe

    • Este operador no requiere un valor y el campo de valor está ausente.

  • Cambiado

    • Este operador no requiere un valor y el campo de valor está ausente.
    • Este operador ignora el campo Estado.
    • Cuando use Changed, seleccione Solo eventos actualizados en el campo Origen del registro.
IMPORTANT
No puede editar filtros en webhooks de Workfront existentes. Para configurar diferentes filtros para las suscripciones a eventos de Workfront, elimine el webhook actual y cree uno nuevo.
INFO
Ejemplo: considere un escenario que procese nuevos problemas asignados a una usuaria específica, Ana.

Filtrado de eventos mediante un filtro de suscripción de eventos (recomendado) filtrado-de-eventos-mediante-un-filtro-de-suscripci%C3%B3n-de-eventos-(recomendado)

Mediante el filtro de eventos, puede configurar el webhook para que active el escenario cuando se asigne un problema a Ana cuando se cree el problema. Ana tiene el userID b378489d8f7cd3cee0539260720a84b7.
Filtro de eventos
Si se crean 100 problemas en un día, pero solo dos de ellos se asignan a Ana, el escenario se ejecutaría dos veces.

Filtrar eventos dentro del escenario (no recomendado) filtrar-eventos-dentro-del-escenario-(no-recomendado)

Para filtrar eventos de modo que solo se procesen los problemas asignados a Ana, puede crear un filtro después del módulo Watch Events.
Sin filtro de eventos
Si se crean 100 problemas en un día, pero solo dos de ellos se asignan a Ana, el escenario se ejecutaría 100 veces. 98 de las ejecuciones se detendrían en el filtro, pero el módulo de activador sigue consumiendo datos y realizando operaciones en todas las ejecuciones.

Para obtener más información sobre las suscripciones a eventos de Workfront, consulte Preguntas más frecuentes - Suscripciones a eventos.

Para obtener más información sobre los webhooks, consulte déclencheur instantáneos (webhooks) en Adobe Workfront Fusion

Para obtener más información sobre los filtros en los escenarios, vea Agregar un filtro a un escenario.

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