Adobe Workfront módulos

Puede usar el conector Adobe Workfront Fusion Adobe Workfront para automatizar los procesos en Workfront. Si dispone de una licencia de Workfront Fusion para automatización e integración del trabajo, también puede utilizarla para conectarse a aplicaciones y servicios de terceros.

El conector Workfront no cuenta con respecto al número de aplicaciones activas disponibles para su organización. Todos los escenarios, incluso si solo usan la aplicación Workfront, no se contabilizan en el recuento total de escenarios de su organización.

Para obtener más información sobre las aplicaciones y los escenarios disponibles en tu organización, consulta Organizaciones en Adobe Workfront Fusion organizaciones y equipos.

Si necesita instrucciones para crear un escenario, consulte Crear un escenario en Adobe Workfront Fusion. Para obtener información acerca de los módulos, vea Módulos en Adobe Workfront Fusion.

Requisitos de acceso

Debe tener el siguiente acceso para utilizar la funcionalidad de este artículo:

Adobe Workfront plan*
Pro o superior
Adobe Workfront licencia*
Plan, Trabajo
Adobe Workfront Fusion licencia**

Requisito de licencia actual: no se requiere licencia de Workfront Fusion.

O

Requisito de licencia heredado: Workfront Fusion para automatización e integración de trabajo, Workfront Fusion para automatización de trabajo

Producto

Requisito de producto actual: si tiene el plan Select o Prime Adobe Workfront, su organización debe adquirir Adobe Workfront Fusion así como Adobe Workfront para utilizar la funcionalidad descrita en este artículo. Workfront Fusion está incluido en el plan Workfront de Ultimate.

O

Requisito de productos heredados: su organización debe comprar Adobe Workfront Fusion y Adobe Workfront para utilizar la funcionalidad descrita en este artículo.

Para saber qué plan, tipo de licencia o acceso tiene, póngase en contacto con el administrador de Workfront.

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

Conectar Workfront a Workfront Fusion

El conector Workfront utiliza OAuth 2.0 para conectarse a Workfront.

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

  1. En cualquier módulo de Adobe Workfront, 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 layout-auto html-authored no-header
    Nombre de conexión Introduzca un nombre para la nueva conexión.
    Entorno Seleccione si desea conectarse a un entorno de producción o de no producción.
    Tipo de conexión Seleccione si desea conectarse a una cuenta de servicio o a una cuenta personal.
    ID de cliente Escriba su ID de cliente 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.
    Secreto de cliente Escriba su ID de cliente 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.
    URL de autenticación

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

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

    Prefijo de host 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.

NOTE
  • Si no ve un botón de inicio de sesión de SAML, significa que su organización no ha habilitado el inicio de sesión único (SSO). Puede iniciar sesión con su nombre de usuario y contraseña.

    Para obtener más información sobre SSO, consulte Información general sobre el inicio de sesión único en Adobe Workfront

  • Las conexiones de OAuth 2.0 a la API Workfront ya no dependen de las claves 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.

    Para obtener instrucciones sobre cómo crear una aplicación OAuth2 en Workfront, consulte Crear una aplicación OAuth2 con credenciales de usuario (Flujo de código de autorización) en el artículo Crear aplicaciones OAuth2 para integraciones de Workfront.

Workfront módulos y sus campos

Al configurar Workfront módulos, Workfront Fusion muestra los campos que se indican a continuación. Junto con estos, podrían mostrarse Workfront campos adicionales, según factores como el nivel de acceso en la aplicación o el servicio. Un 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 en Adobe Workfront Fusion.

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 almacenar en déclencheur una breve pausa en la ejecución en el escenario.

Déclencheur

Ver eventos

Este módulo de déclencheur 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 cualquier campo y valor personalizados a los que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.

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

  2. Configure el webhook en el cuadro Agregar un gancho que se muestra.

    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
    Nombre de webhook de (Opcional) Escriba un nuevo nombre para el webhook
    Conexión Para obtener instrucciones acerca de cómo conectar su aplicación Workfront a Workfront Fusion, vea Conectar Workfront a Workfront Fusion en este artículo.
    Tipo de registro Seleccione el tipo de registro Workfront que desea que el módulo vea.
    Estado

    Seleccione si desea ver el estado antiguo o el nuevo.

    • Nuevo estado

      Almacene en déclencheur un escenario cuando el registro cambie a un valor determinado.

      Por ejemplo, si el estado se establece en Nuevo estado y el filtro se establece en estado igual a en curso, el webhook crea un déclencheur cuando el estado cambia a en curso, independientemente del estado anterior.

    • Estado anterior

      Almacene en déclencheur un escenario cuando el registro cambie de a un valor determinado.

      Por ejemplo, si el estado se establece en Estado anterior y el filtro se establece en Estado Es igual a En curso, el webhook genera un déclencheur cuando un Estado que está actualmente En curso cambia a otro estado.

    Filtros de eventos

    Puede establecer filtros para inspeccionar sólo 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 Workfront webhooks existentes. Para configurar diferentes filtros para Workfront suscripciones de evento, 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 los módulos Workfront > Watch Events de este artículo.

    Excluir eventos realizados por esta conexión

    Active esta opción para excluir los eventos creados o actualizados con el mismo conector que utiliza este módulo de déclencheur. Esto puede evitar situaciones en las que un escenario podría entrar en déclencheur y provocar que se repita en un bucle interminable.

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

    Origen de registro

    Elija si desea que el escenario vea Solo registros nuevos, Solo registros actualizados, Registros nuevos y actualizados o Deleted Records Only.

    Nota: Si elige Registros nuevos y actualizados, la creación del gancho web crea 2 suscripciones de evento (para la misma dirección de gancho web).

Una vez creado el gancho web, puede ver la dirección del extremo 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 de ayuda de Workfront API de suscripción a eventos.

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

Campo de observación

Este módulo de déclencheur ejecuta un escenario cuando se actualiza un campo que usted especifica. 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
Conexión Para obtener instrucciones acerca de cómo conectar su aplicación Workfront a Workfront Fusion, vea Conectar Workfront a Workfront Fusion en este artículo.
Tipo de registro

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

Por ejemplo, seleccione Tarea si desea comenzar a ejecutar el escenario cada vez que se actualice un campo de registro en una tarea.

Campo Seleccione el campo en el que desea que el módulo inspeccione las actualizaciones. Estos campos reflejan los campos que el administrador de Workfront ha configurado para el seguimiento.
Salidas Seleccione la información que desee incluir en el paquete de salida para este módulo.
Límite Introduzca o asigne el número máximo de registros que desea que devuelva el módulo durante cada ciclo de ejecución de escenario.

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

Registro de observación

Este módulo de déclencheur 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 en el período de tiempo determinado 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 layout-auto html-authored no-header
Conexión Para obtener instrucciones acerca de cómo conectar su aplicación Workfront a Workfront Fusion, vea Conectar Workfront a Workfront Fusion en este artículo.
Filtro Elija si desea que el escenario vea Solo registros nuevos, Solo registros actualizados o Registros nuevos y actualizados.
Tipo de registro

(Se muestra después de elegir un Filtro.) Seleccione el tipo de registro de Workfront que desea que el módulo vea.

Por ejemplo, si desea iniciar el escenario cada vez que se cree un nuevo proyecto, seleccione Proyecto

Salidas Seleccione la información que desee incluir en el paquete de salida para este módulo.
Filtro opcional (Avanzado) Escriba una cadena de código de API para definir cualquier parámetro o código adicional que restrinja sus criterios.
Límite Introduzca o asigne el número máximo de registros que desea que devuelva el módulo durante cada ciclo de ejecución de escenario.

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

Acciones

Convertir objeto

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

  • Convertir problema a proyecto
  • Convertir problema a tarea
  • Convertir tarea al 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
Conexión Para obtener instrucciones acerca de cómo conectar su aplicación Workfront a Workfront Fusion, vea Conectar Workfront a Workfront Fusion en este artículo.
Tipo de objeto Seleccione el tipo de objeto que desea convertir. Es el tipo que tiene el objeto antes de la conversión.
Convertir a Seleccione el objeto al que desea convertirlo. Es el tipo que tiene el objeto después de la conversión.
<objeto> ID

Introduzca la 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 introduce el ID adecuado en el campo.

Id. de plantilla

Si está convirtiendo 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 introduce el ID adecuado en el campo.

Formularios personalizados Seleccione los formularios personalizados que desee agregar al objeto recién convertido y, a continuación, introduzca los valores de los campos del formulario personalizado.
Opciones Active 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.
Copiar campos nativos Active esta opción para copiar cualquier campo nativo del objeto original al nuevo objeto.
Copiar formularios personalizados Active esta opción para copiar cualquier campo nativo del objeto original al nuevo objeto.
Crear un registro (adjuntando formularios personalizados)

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 ID 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.

Puede usar este módulo, por ejemplo, para crear una tarea en Workfront cuando un cliente agregue una nueva fila a una lista Google Sheets de tareas que es necesario realizar.

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

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ándola a continuación en la lista.

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Conexión Para obtener instrucciones acerca de cómo conectar su aplicación Workfront a Workfront Fusion, vea Conectar Workfront a Workfront Fusion en este artículo.
Tipo de registro

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

Por ejemplo, si desea crear un proyecto, seleccione Proyecto en la lista desplegable y, a continuación, asegúrese de que tiene acceso a los datos (de módulos anteriores en el escenario) que rellenarán el proyecto.

Seleccionar campos para asignar

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.

Para los campos de los formularios personalizados, utilice el campo Adjuntar formulario personalizado.

Adjuntar formulario personalizado Seleccione los formularios personalizados que desee agregar al nuevo objeto y, a continuación, introduzca los valores de esos campos.

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

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 introduce el ID adecuado en el campo.

  • Al escribir el texto de un campo personalizado o un objeto Note (Comentario o respuesta), puede usar etiquetas de HTML en el campo Texto de nota para crear texto enriquecido, como texto en negrita o en cursiva.

    Para obtener más información sobre el texto enriquecido en las actualizaciones, consulte Agregar una actualización a un elemento de trabajo en Actualización del trabajo.

Crear registro

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

Especifique el ID 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.

Puede usar este módulo, por ejemplo, para crear una tarea en Workfront cuando un cliente agregue una nueva fila a una lista de hojas de Google de tareas que es necesario realizar.

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

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ándola a continuación en la lista.

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Conexión Para obtener instrucciones acerca de cómo conectar su aplicación Workfront a Workfront Fusion, vea Conectar Workfront a Workfront Fusion en este artículo.
Tipo de registro

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

Por ejemplo, si desea crear un proyecto, seleccione Proyecto en la lista desplegable y, a continuación, asegúrese de que tiene acceso a los datos (de módulos anteriores en el escenario) que rellenarán el proyecto.

Seleccionar campos para asignar 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.

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

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 introduce el ID adecuado en el campo.

  • Al escribir el texto de un campo personalizado o un objeto Note (Comentario o respuesta), puede usar etiquetas de HTML en el campo Texto de nota para crear texto enriquecido, como texto en negrita o en cursiva.

    Para obtener más información sobre el texto enriquecido en las actualizaciones, consulte Agregar una actualización a un elemento de trabajo en Actualización del trabajo.

Llamada de API personalizada

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

El módulo devuelve la siguiente información:

  • Código de estado (número): esto indica si la solicitud HTTP se realizó correctamente o no. Estos son 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 encabezados de respuesta, por lo que algunos podrían no ser útiles para usted.

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

  • Cuerpo (objeto): Según la solicitud HTTP elegida al configurar el módulo, es posible que vuelva a recibir algunos datos. Esos datos, como los datos de una solicitud de GET, están contenidos 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
Conexión Para obtener instrucciones acerca de cómo conectar su aplicación Workfront a Workfront Fusion, vea Conectar Workfront a Workfront Fusion en este artículo.
URL Escriba una ruta relativa a https://<WORKFRONT_DOMAIN>/attask/api/<API_VERSION>/.
API Version Seleccione la versión de la API Workfront que desea que utilice el módulo.
Método Seleccione el método de solicitud HTTP que necesita para configurar la llamada de API. Para obtener más información, vea Métodos de solicitud HTTP en Adobe Workfront Fusion.
Encabezados

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

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 basados en la documentación de Workfront. Si su llamada de API personalizada devuelve un error de solicitud HTTP 422, intente utilizar un encabezado "Content-Type":"text/plain".

Cadena de consulta

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.

Cuerpo

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 Workfront tipos de objetos para los que puede usar este módulo en Workfront tipos de objetos disponibles para cada Workfront módulo.

Eliminar registro

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

Especifique el ID 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.

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Conexión Para obtener instrucciones acerca de cómo conectar su aplicación Workfront a Workfront Fusion, vea Conectar Workfront a Workfront Fusion en este artículo.
Forzar eliminación Habilite esta opción para asegurarse de que se elimine el registro, incluso si la interfaz de usuario de Workfront solicitara confirmación de la eliminación.
Identificador

Escriba el identificador único Workfront del registro que desea que elimine el módulo.

Para obtener el identificador, 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

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

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

note note
NOTE
Se recomienda la siguiente configuración de escenario para evitar la posibilidad de que no se eliminen registros debido a operaciones asincrónicas.
  1. Eliminar el registro sincrónicamente.
  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.
Descargar documento

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

Especifique el ID del registro.

El módulo devuelve el contenido, el nombre de archivo, 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
Conexión Para obtener instrucciones acerca de cómo conectar su aplicación Workfront a Workfront Fusion, vea Conectar Workfront a Workfront Fusion en este artículo.
ID de documento

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

Para obtener el identificador, 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 Workfront tipos de objetos para los que puede usar este módulo en Workfront tipos de objetos disponibles para cada Workfront módulo.

Acciones diversas

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
Conexión Para obtener instrucciones acerca de cómo conectar su aplicación Workfront a Workfront Fusion, vea Conectar Workfront a Workfront Fusion en este artículo.
Tipo de registro Seleccione el tipo de registro Workfront con el que desea que interactúe el módulo.
Acción

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

Es posible que tenga que rellenar campos adicionales, según el Tipo de registro y la Acción que elija. Algunas combinaciones de estas dos configuraciones pueden requerir solamente un id. de registro, mientras que otras (como Proyecto para Tipo de registro y Adjuntar plantilla para la Acción) 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 a 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:

    • Proyectos

    • Tareas

    • Problemas

    • Usuarios

    • Documentos

    Para todos los demás tipos de registro, seleccione Otros objetos y extremos y busque el tipo de registro en las páginas ordenadas alfabéticamente.

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

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

Nota:

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

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

ID

Escriba o asigne el identificador único Workfront del registro con el que desea que interactúe el módulo.

Para obtener el identificador, 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 Workfront tipos de objetos para los que puede usar este módulo en Workfront tipos de objetos disponibles para cada Workfront módulo.

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

Leer un registro

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

Especifique el ID 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 estándar para la salida especificada.

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
Conexión Para obtener instrucciones acerca de cómo conectar su aplicación Workfront a Workfront Fusion, vea Conectar Workfront a Workfront Fusion en este artículo.
Tipo de registro Elija el tipo de objeto Workfront que desea que lea el módulo.
Salidas Seleccione la información que desee incluir en el paquete de salida para este módulo.
Referencias de Seleccione cualquier campo de referencia que desee incluir en la salida.
Colecciones Seleccione cualquier campo de referencia que desee incluir en la salida.
ID

Escriba el identificador único Workfront del registro que desea que lea el módulo.

Para obtener el identificador, 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 Workfront tipos de objetos para los que puede usar este módulo en Workfront tipos de objetos disponibles para cada Workfront módulo.

Actualizar registro

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 ID 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
Conexión Para obtener instrucciones acerca de cómo conectar su aplicación Workfront a Workfront Fusion, vea Conectar Workfront a Workfront Fusion en este artículo.
ID

Escriba el identificador único Workfront del registro que desea que actualice el módulo.

Para obtener el identificador, 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 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.

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

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 introduce el ID adecuado en el campo.

  • Al escribir el texto de un campo personalizado o un objeto Note (Comentario o respuesta), puede usar etiquetas de HTML en el campo Texto de nota para crear texto enriquecido, como texto en negrita o en cursiva.

    Para obtener más información sobre el texto enriquecido en las actualizaciones, consulte Agregar una actualización a un elemento de trabajo en Actualización del trabajo.

Cargar documento

Este módulo de acción carga un documento en un objeto 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.

Especifique la ubicación del documento, el archivo que desea cargar y, opcionalmente, un nuevo nombre 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
Conexión Para obtener instrucciones acerca de cómo conectar su aplicación Workfront a Workfront Fusion, vea Conectar Workfront a Workfront Fusion en este artículo.
Identificador de registro relacionado Escriba el identificador único Workfront del registro en el que desea cargar el documento.
Tipo de registro relacionado Seleccione el tipo de registro Workfront donde desea que el módulo cargue el documento.
Identificador de carpeta Según el tipo de registro relacionado, es posible que deba introducir o asignar un ID de carpeta.
archivo Source 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 Workfront tipos de objetos para los que puede usar este módulo en Workfront tipos de objetos disponibles para cada Workfront módulo.

Cargar documento (heredado)

Este módulo de acción carga un documento en un objeto 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, opcionalmente, un nuevo nombre 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
Conexión Para obtener instrucciones acerca de cómo conectar su aplicación Workfront a Workfront Fusion, vea Conectar Workfront a Workfront Fusion en este artículo.
Identificador de registro relacionado Escriba el identificador único Workfront del registro en el que desea cargar el documento.
Tipo de registro relacionado Seleccione el tipo de registro Workfront donde desea que el módulo cargue el documento.
Identificador de carpeta Según el tipo de registro relacionado, es posible que deba introducir o asignar un ID de carpeta.
archivo Source 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 Workfront tipos de objetos para los que puede usar este módulo en Workfront tipos de objetos disponibles para cada Workfront módulo.

Búsquedas

Leer registros relacionados

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
Conexión Para obtener instrucciones acerca de cómo conectar su aplicación Workfront a Workfront Fusion, vea Conectar Workfront a Workfront Fusion en este artículo.
Tipo de registro

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

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

Id. de registro principal

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

Para obtener el identificador, 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

Colecciones Seleccione o asigne el tipo de registro secundario que desea que lea el módulo.
Salidas Seleccione la información que desee incluir en el paquete de salida para este módulo.
Búsqueda

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
Conexión Para obtener instrucciones acerca de cómo conectar su aplicación Workfront a Workfront Fusion, vea Conectar Workfront a Workfront Fusion en este artículo.
Tipo de registro Seleccione el tipo de registro Workfront que desea que busque el módulo.
Conjunto de resultados Seleccione una opción para especificar si desea que el módulo obtenga el primer resultado que coincida con los criterios de búsqueda o todos los resultados que coincidan con él.
Máximo Introduzca o asigne el número máximo de registros que desea que devuelva el módulo durante cada ciclo de ejecución de escenario.
Buscar campos de criterios Seleccione los campos que desee utilizar para los criterios de búsqueda. Estos campos están disponibles en la lista desplegable Criterios de búsqueda.
Criterios de búsqueda

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 para Workfront, el usuario inicia sesión en Workfront y la búsqueda no se realizará correctamente.

Nota: In y NotInfuncionan con matrices. Las entradas deben estar en formato de matriz.

Salidas Seleccione los campos que desea incluir en la salida para este módulo.
Referencias de Seleccione cualquier campo de referencia que desee incluir en la búsqueda.
Colecciones Seleccione las colecciones que desee añadir a la búsqueda.
Buscar (heredado)

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 layout-auto html-authored no-header
Conexión Para obtener instrucciones acerca de cómo conectar su aplicación Workfront a Workfront Fusion, vea Conectar Workfront a Workfront Fusion en este artículo.
Tipo de registro Seleccione el tipo de registro Workfront que desea que busque el módulo.
Conjunto de resultados Seleccione una opción para especificar si desea que el módulo obtenga el primer resultado que coincida con los criterios de búsqueda o todos los resultados que coincidan con él.
Máximo Introduzca o asigne el número máximo de registros que desea que devuelva el módulo durante cada ciclo de ejecución de escenario.
Criterios de búsqueda

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 para Workfront, el usuario inicia sesión en Workfront y la búsqueda no se realizará correctamente.

Nota: In y NotInfuncionan con matrices. Las entradas deben estar en formato de matriz.

Salidas Seleccione los campos que desea incluir en la salida para este módulo.
Referencias de Seleccione cualquier campo de referencia que desee incluir en la búsqueda.
Colecciones Seleccione las colecciones que desee añadir a la búsqueda.

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

Workfront tipos de objetos disponibles para cada módulo Workfront

Tipos de objetos disponibles para cada Workfront módulo de déclencheur
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
Registro del reloj Campo de observación Ver eventos
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
Programar
Proyecto
Usuario de proyecto
Aprobación de revisión
Tiempo reservado*
Informe
Riesgo
Tipo de riesgo
Aprobador de etapa
Tarea
Equipo
Plantilla
Tarea de plantilla
Hoja de horas
Usuario
Actualizar
Tipos de objetos disponibles para cada módulo de acción Workfront
note note
NOTE
El módulo Descargar documento no se incluye en esta tabla porque Workfront tipos de objetos 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
Crear un registro Actualizar un registro Eliminar un registro Cargar documento Leer un registro Llamada de API personalizada de 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
Programar
Proyecto
Usuario de proyecto
Tiempo reservado*
Riesgo
Tipo de riesgo
Aprobador de etapa
Tarea
Equipo
Plantilla
Tarea de plantilla
Hoja de horas
Usuario
Actualizar
Tipos de objetos disponibles para cada módulo de búsqueda 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
Buscar Leer registros relacionados
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
Programar
Proyecto
Usuario de proyecto
Tiempo reservado*
Riesgo
Tipo de riesgo
Aprobador de etapa
Tarea
Equipo
Plantilla
Tarea de plantilla
Hoja de horas
Usuario
Delegación de usuario

Le recomendamos que verifique dos veces para asegurarse de que esto funciona de la manera que esperaba.

Filtros de suscripción a eventos en los módulos Workfront > Ver eventos

NOTE
Recomendamos encarecidamente usar filtros de suscripción de eventos en sus módulos Ver eventos.

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

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

Esto es diferente a configurar un filtro en el escenario 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 State.
    • Cuando use Changed, seleccione Solo eventos actualizados en el campo Origen del registro.
IMPORTANT
No puede editar filtros en Workfront webhooks existentes. Para configurar diferentes filtros para Workfront suscripciones de evento, elimine el webhook actual y cree uno nuevo.
INFO
Ejemplo: Considere un escenario que procese nuevos problemas asignados a un usuario específico, 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 almacene en déclencheur el escenario cuando se asigne un problema a Ana cuando se cree el problema. Ana tiene el userID b378489d8f7cd3cee0539260720a84b7.
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 Ver 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 déclencheur sigue consumiendo datos y realizando operaciones en todas las ejecuciones.

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

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

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

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43