Módulos de Adobe Workfront Planning
Con los módulos Adobe Workfront Planning, puede almacenar en déclencheur un escenario cuando se produzcan eventos en Workfront Planning. También puede crear, leer, actualizar y eliminar registros, o realizar una llamada de API personalizada a su cuenta de Adobe Workfront Planning.
Requisitos de acceso
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
|---|---|
| Paquete de Adobe Workfront |
Cualquier paquete del flujo de trabajo de Adobe Workfront y cualquier paquete de integración y automatización de Adobe Workfront Workfront Ultimate Paquetes Workfront Prime y Select, con una compra adicional de Workfront Fusion. |
| Licencias de Adobe Workfront |
Estándar Trabajo o superior |
| Producto | Si su organización tiene un paquete de Workfront Select o Prime que no incluye la automatización y la integración de Workfront, su organización debe adquirir Adobe Workfront Fusion. |
Para obtener más información sobre el contenido de esta tabla, consulte Requisitos de acceso en la documentación.
Requisitos previos
Debe tener lo siguiente para acceder a Workfront Planning:
- Un nuevo paquete y licencia de Workfront. Workfront Planning no está disponible para paquetes o licencias de Workfront heredados.
- Un paquete de Workfront Planning.
- La instancia de Workfront de su organización debe incorporarse a la experiencia unificada de Adobe.
Información de API de Adobe Workfront Planning
El conector de Adobe Workfront Planning utiliza lo siguiente:
Conexión de Workfront Planning a Workfront Fusion
El conector de Workfront Planning utiliza OAuth 2.0 para conectarse a Workfront Planning.
Puede crear una conexión a su cuenta de Workfront Planning directamente desde un módulo de Workfront Planning Fusion.
Conectarse a Workfront Planning mediante el ID de cliente y el secreto de cliente
-
En cualquier módulo de Adobe Workfront Planning, haga clic en Agregar junto al campo Conexión.
-
Rellene los campos siguientes:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header Connection type Seleccione la conexión Adobe Workfront auth. Connection name Introduzca un nombre para la nueva conexión. Client ID Introduzca su ID de cliente de Workfront. Esto se puede encontrar en el área Aplicaciones OAuth2 del área Configuración en Workfront. Abra la aplicación específica a la que se está conectando para ver el ID de cliente. Client Secret Introduzca el secreto de cliente de Workfront. Esto se puede encontrar en el área Aplicaciones OAuth2 del área Configuración en Workfront. Si no dispone de un secreto de cliente para la aplicación OAuth2 en Workfront, puede generar otro. Para obtener instrucciones, consulte la documentación de Workfront. Authentication URL Este puede seguir siendo el valor predeterminado, o bien puede introducir la dirección URL de su instancia de Workfront, seguida de
/integrations/oauth2.Ejemplo:
https://mydomain.my.workfront.com/integrations/oauth2Host prefix En la mayoría de los casos, este valor debe ser origin. -
Haga clic en Continuar para guardar la conexión y volver al módulo.
Si no ha iniciado sesión en Workfront Planning, se le dirigirá a una pantalla de inicio de sesión. Después de iniciar sesión, puede permitir la conexión.
- Las conexiones de OAuth 2.0 a la API de Workfront ya no dependen de las claves API.
- Para crear una conexión con un entorno de zona protegida de Workfront, debe crear una aplicación OAuth2 en ese entorno y, a continuación, utilizar el ID de cliente y el secreto de cliente generados por esa aplicación en la conexión.
Conectar con Workfront Planning mediante una conexión de servidor a servidor
-
En cualquier módulo de Adobe Workfront Planning, haga clic en Agregar junto al campo Conexión.
-
Rellene los campos siguientes:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 layout-auto html-authored no-header Connection type Seleccione Conexión de servidor a servidor de Adobe Workfront. Connection name Introduzca un nombre para la nueva conexión. Instance name Introduzca el nombre de su instancia, también conocido como su dominio.
Ejemplo: si su URL es
https://example.my.workfront.com, introduzcaexample.Instance lane Introduzca el tipo de entorno al que se conectará esta conexión.
Ejemplo: si su URL es
https://example.my.workfront.com, introduzcamy.Client ID Introduzca su ID de cliente de Workfront. Esto se puede encontrar en el área Aplicaciones OAuth2 del área Configuración en Workfront. Abra la aplicación específica a la que se está conectando para ver el ID de cliente. Client Secret Introduzca el secreto de cliente de Workfront. Esto se puede encontrar en el área Aplicaciones OAuth2 del área Configuración en Workfront. Si no dispone de un secreto de cliente para la aplicación OAuth2 en Workfront, puede generar otro. Para obtener instrucciones, consulte la documentación de Workfront. Scopes Escriba los ámbitos aplicables para esta conexión. Host prefix En la mayoría de los casos, este valor debe ser origin. -
Haga clic en Continuar para guardar la conexión y volver al módulo.
Si no ha iniciado sesión en Workfront Planning, se le dirigirá a una pantalla de inicio de sesión. Después de iniciar sesión, puede permitir la conexión.
- Las conexiones de OAuth 2.0 a la API de Workfront ya no dependen de las claves API.
- Para crear una conexión con un entorno de zona protegida de Workfront, debe crear una aplicación OAuth2 en ese entorno y, a continuación, utilizar el ID de cliente y el secreto de cliente generados por esa aplicación en la conexión.
Adobe Workfront Planning módulos de versión 2 y sus campos
Al configurar los módulos de Workfront Planning, Workfront Fusion muestra los campos que se indican a continuación. Junto con estos, podrían mostrarse campos adicionales de Workfront, según factores como el nivel de acceso en la aplicación o el servicio. El título en negrita en un módulo indica un campo obligatorio.
Si ve el botón Asignar encima de un campo o función, puede utilizarlo para establecer variables y funciones para ese campo. Para obtener más información, consulte Asignar información de un módulo a otro.
Espacios de trabajo (V2)
Creación de un espacio de trabajo (V2)
Este módulo de acción crea un nuevo espacio de trabajo en Planning.
Eliminación de un espacio de trabajo (V2)
Este módulo de acción elimina un solo espacio de trabajo, especificado por ID.
Obtener todos los espacios de trabajo (V2)
Este módulo recupera una lista de todos los espacios de trabajo.
Obtener un espacio de trabajo (V2)
Este módulo recupera un espacio de trabajo por su ID.
Actualización de un espacio de trabajo (V2)
Este módulo de acción actualiza un nuevo espacio de trabajo en Planning.
Tipos de registro (V2)
Creación de un tipo de registro (V2)
Este módulo de acción crea un nuevo tipo de registro en el espacio de trabajo seleccionado.
Eliminación de un tipo de registro (V2)
Este módulo de acción elimina un solo tipo de registro, especificado por ID.
Obtener tipos de registros globales (V2)
Este módulo recupera una lista de tipos de registros en una cuenta de Adobe Workfront Planning.
Obtener un tipo de registro (V2)
Este módulo recupera un tipo de registro por su ID.
Obtener tipos de registros (V2)
Este módulo recupera una lista de tipos de registros disponibles en un espacio de trabajo determinado.
Actualización de un tipo de registro (V2)
Este módulo actualiza un tipo de registro.
Registros (V2)
Creación de un registro (V2)
Esta acción crea un único registro en Workfront Planning.
Eliminación de un registro (V2)
Este módulo de acción elimina un único registro, especificado por ID.
Obtener un registro (V2)
Este módulo de acción recupera un registro, especificado por su ID.
Obtención de registros por tipo de registro (V2)
Este módulo recupera una lista de todos los registros del tipo de registro dado.
Movimiento de registros (V2)
Este módulo reordena uno o más registros dentro de un tipo de registro especificando dónde colocarlos.
Buscar registros (V2)
Devolver registros según los criterios especificados
Actualización de un registro (V2)
Este módulo actualiza el registro especificado.
Campos (V2)
Creación de un campo (V2)
Este módulo de acción crea un nuevo campo en el tipo de registro especificado.
Eliminación de un campo (V2)
Este módulo de acción elimina un solo campo, especificado por ID.
Obtener un campo (V2)
Este módulo recupera un campo por su ID.
Obtener campos por tipo de registro (V2)
Este módulo recupera una lista de campos para un tipo de registro específico.
Actualización de un campo (V2)
Este módulo actualiza parcialmente un campo por su ID.
Vistas (V2)
Creación de una vista (V2)
Este módulo de acción crea una nueva vista para el tipo de registro seleccionado.
Eliminación de una vista (V2)
Este módulo de acción elimina una sola vista, especificada por el ID.
Obtener una vista (V2)
Este módulo recupera una vista por su ID.
Obtener vistas por tipo de registro (V2)
Este módulo recupera una lista de vistas para el tipo de registro específico.
Actualización de una vista (V2)
Este módulo de acción actualiza la vista especificada.
Permisos (V2)
Descartar solicitudes de acceso (V2)
Este módulo de acción descarta una o más solicitudes de acceso, especificadas por el ID.
Obtener todos los miembros y sus funciones para un recurso (V2)
Este módulo enumera todos los usuarios, grupos y equipos que tienen una relación de uso compartido explícita en el recurso. Las credenciales utilizadas en la conexión para este módulo deben tener permiso de administración en el recurso.
Obtener los permisos efectivos del usuario actual de un recurso (V2)
Este módulo devuelve la vista, edición, eliminación y adición de permisos del usuario actual para un recurso determinado.
Enumeración de solicitudes de acceso pendientes para un recurso (V2)
Este módulo devuelve todas las solicitudes de acceso pendientes del recurso determinado.
Solicitud de acceso a un recurso (V2)
Este módulo crea o actualiza una solicitud de acceso para el usuario actual en el recurso determinado.
Otros (V2)
Obtener el ID de autenticación de Workfront ID (V2)
Este módulo toma un ID de usuario de Workfront y devuelve el ID de autorización coincidente que utiliza Planning.
Realizar una llamada de API personalizada (V2)<table
Este módulo realiza una llamada personalizada a la API de Workfront Planning.
Ver eventos (V2)
Este módulo de déclencheur inicia un escenario cuando se crea, actualiza o elimina un registro, tipo de registro o espacio de trabajo en Workfront Planning.
- Las suscripciones a eventos de Workfront tratan el webhook editado como una suscripción nueva. El historial de suscripción de eventos no se conserva para la configuración de ganchos web anterior, ya que se considera una suscripción de evento independiente.
- Es posible que el cambio de la suscripción de evento antigua a la nueva no esté perfectamente sincronizado. Por lo tanto, es posible recibir un evento dos veces (si la nueva suscripción empieza a ejecutarse antes de que la anterior se detenga) o perderse un evento (si la antigua suscripción se detiene antes de que la nueva comience a ejecutarse).
Para ver un ejemplo de uso de lógica avanzada en este módulo, vea Ejemplo de lógica avanzada en el módulo de eventos de inspección.
Adobe Workfront Planning módulos de versión 1 y sus campos
Al configurar los módulos de Workfront Planning, Workfront Fusion muestra los campos que se indican a continuación. Junto con estos, podrían mostrarse campos adicionales de Workfront, según factores como el nivel de acceso en la aplicación o el servicio. El título en negrita en un módulo indica un campo obligatorio.
Si ve el botón Asignar encima de un campo o función, puede utilizarlo para establecer variables y funciones para ese campo. Para obtener más información, consulte Asignar información de un módulo a otro.
Activadores
Ver eventos
Este módulo de déclencheur inicia un escenario cuando se crea, actualiza o elimina un registro, tipo de registro o espacio de trabajo en Workfront Planning.
- Las suscripciones a eventos de Workfront tratan el webhook editado como una suscripción nueva. El historial de suscripción de eventos no se conserva para la configuración de ganchos web anterior, ya que se considera una suscripción de evento independiente.
- Es posible que el cambio de la suscripción de evento antigua a la nueva no esté perfectamente sincronizado. Por lo tanto, es posible recibir un evento dos veces (si la nueva suscripción empieza a ejecutarse antes de que la anterior se detenga) o perderse un evento (si la antigua suscripción se detiene antes de que la nueva comience a ejecutarse).
Para ver un ejemplo de uso de lógica avanzada en este módulo, vea Ejemplo de lógica avanzada en el módulo de eventos de inspección.
Acciones
Eliminación de un tipo de registro
Este módulo de acción elimina un solo tipo de registro en Workfront Planning por su ID.
Realizar una llamada API personalizada
Este módulo realiza una llamada de API personalizada a la API de Adobe Workfront Planning.
Búsquedas
Búsqueda de registros
Este módulo de acción recupera una lista de registros en función de los criterios especificados.
Sin categoría
Crear un registro
Esta acción crea un único registro en Workfront Planning.
Eliminación de un registro
Este módulo de acción elimina el registro especificado en Workfront Planning.
Obtener un registro
Este módulo de acción recupera un único registro de Adobe Workfront Planning, especificado por su identificador.
Obtener registros por tipo de registro
Este módulo de acción recupera todos los registros del tipo especificado.
Obtener tipos de registros
Este módulo de acción recupera una lista de tipos de registro en una cuenta de Adobe Workfront Planning.
Actualizar registro
Esta acción actualiza un único registro en Workfront Planning.
Usar JSONata para el desglose legible record-types
La siguiente expresión JSONata crea un resultado legible en lenguaje natural de la consulta de Planning que le proporciona el desglose de tipos de registros. Esto hace que el nombre del tipo de registro, los nombres de campo y los nombres de opciones de campo (cuando corresponda) sean legibles por un nombre y mantiene el resto de la estructura intacta.
(
$s0 := ({"data":$ ~> | fields | {"options":(options){name:$}} |});
$s1 := ({"data":$s0.data ~> | **.fields | {"options_name":(options.*){displayName:$}} | });
$s2 := $s1 ~> | data | {"fields":(fields){displayName:$}} |;
$s2.data{displayName:$}
)
Para obtener información sobre el uso de módulos JSONata, consulte módulos JSONata.
Ejemplo de lógica avanzada en el módulo Ver eventos
Este es un ejemplo del formato que adopta la lógica avanzada al utilizar el módulo Workfront Planning > Ver eventos.
[
{
"fieldName": "recordTypeId",
"fieldValue": "Rt68c886502d4b5554ee80896b",
"comparison": "eq",
"state": "newState"
},
{
"fieldName": "data",
"fieldValue": {
"F68c886502d4b5554ee808975": "planning"
},
"comparison": "eq",
"state": "newState"
},
{
"fieldName": "data",
"fieldValue": {
"F68c886502d4b5554ee808975": "active"
},
"comparison": "eq",
"state": "newState"
}
]
Tenga en cuenta lo siguiente al utilizar la lógica avanzada en el módulo Ver evento:
- La primera entrada
"fieldvalue":es el identificador de tipo de registro de planificación extraído de la dirección URL. En este ejemplo, el identificador del tipo de registro de planificación esRt68c886502d4b5554ee80896b. - Los datos de Planning se devuelven dentro de una matriz denominada
data, que aparece en este ejemplo como"fieldName": "data". - Los nombres de los campos de planificación se devuelven como identificadores que comienzan por
F. - Dado que este ejemplo está evaluando con un conector de filtro
OR, tiene dos entradas para el mismo campo (F68c886502d4b5554eec808975). Las dos opciones desplegables con las que filtra el módulo son"planning"y"active".