DocumentaciónWorkfrontGuía de Workfront

Conectar Adobe Workfront Fusion a un servicio web que use la autorización de token de API

Last update: Wed Jul 17 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

  • Usuario

Algunos servicios no permiten soluciones de integración como Adobe Workfront Fusion para crear una aplicación que pueda usar fácilmente en su escenario.

Hay una solución alternativa para esta situación. Puede conectar el servicio (aplicación) deseado a Workfront Fusion mediante el módulo HTTP de Workfront Fusion.

Este artículo explica cómo conectar casi cualquier servicio web a Workfront Fusion mediante una clave de API/token de API.

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

Product

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.

Conectarse a un servicio web que utiliza un token de API

El procedimiento para conectar el servicio a través de un token de API es similar para la mayoría de los servicios web.

  1. Cree una aplicación en el sitio web del servicio web, como se explica en la sección Cree una nueva aplicación y obtenga el token de API en este artículo.
  2. Obtenga la clave de API o el token de API.
  3. Agregue el módulo HTTP > Realizar una solicitud de Workfront Fusion a su escenario.
  4. Configure el módulo según la documentación de API del servicio web y ejecute el escenario, tal como se explica en la sección Configurar el módulo HTTP en este artículo.
NOTE
Utilizaremos el servicio de notificación Pushover como ejemplo en este artículo.

Cree una nueva aplicación y obtenga el token de API

NOTE
Existen muchas maneras diferentes en que los servicios web crean y distribuyen claves API o tokens API. Para obtener instrucciones sobre la obtención de una clave de API y un token para el servicio web deseado, vaya al sitio web del servicio y busque "clave de API" o "token de API".
Solo incluimos instrucciones para obtener una clave de API de Pushover como ejemplo de lo que podría encontrar.
  1. Inicie sesión en su cuenta de Pushover.
  2. Haga clic en Crear una aplicación/token de API en la parte inferior de la página.
  3. Rellene la información de la aplicación y haga clic en Crear una aplicación.
  4. Almacene el token de API proporcionado en un lugar seguro. Lo necesitará para el módulo Workfront Fusion HTTP

    Realizar una solicitud para conectarse al servicio web deseado (Pushover, en este caso).

Configurar el módulo HTTP

Para conectar un servicio web al escenario Workfront Fusion, debe usar el módulo HTTP >Realizar una solicitud en el escenario y configurar el módulo según la documentación de la API del servicio web.

  1. Agregue el módulo HTTP >Realizar una solicitud a su escenario.

  2. Para insertar un mensaje mediante Workfront Fusion, configure el módulo HTTP de la siguiente manera.

    note note
    NOTE
    Esta configuración del módulo se corresponde con la documentación de la API del servicio web Pushover. La configuración puede ser diferente para otros servicios web. Por ejemplo, el token de API se puede insertar en el encabezado y no en el campo Cuerpo.
    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
    URL

    https://api.pushover.net/1/messages.json

    El campo URL contiene el extremo que puede encontrar en la documentación de API del servicio web.
    Método

    POST

    El método utilizado depende del punto de conexión correspondiente. El punto final de Pushover para insertar mensajes utiliza el método POST.
    Encabezados Algunos servicios web pueden utilizar encabezados para especificar la autenticación de token de API u otros parámetros. Este no es el caso en nuestro ejemplo, ya que el extremo de Pushover para insertar mensajes utiliza Body (ver a continuación) para todos los tipos de solicitud.
    Cadena de consulta Algunos servicios web pueden utilizar una cadena de consulta para especificar otros parámetros. Este no es el caso en nuestro ejemplo, ya que el servicio web Pushover utiliza Body (ver a continuación) para todos los tipos de solicitud.
    Tipo de cuerpo

    Raw

    Esta configuración le permite seleccionar el tipo de contenido JSON en el siguiente campo Tipo de contenido.
    Tipo de contenido

    JSON (application/json)

    JSON es el tipo de contenido requerido por la aplicación Pushover. Esto puede diferir de otros servicios web.
    Solicitar contenido

    Escriba el contenido de la solicitud de Body en formato JSON. Puede usar el módulo JSON > Crear JSON tal como se explica en Cuerpo de JSON asignado usando el módulo JSON > Crear JSON en este artículo. O puede introducir el contenido JSON manualmente, como se explica en Cuerpo de JSON introducido manualmente en este artículo.

    Consulte la documentación de la API del servicio web para conocer los parámetros necesarios para ese servicio web.

Cuerpo de JSON introducido manualmente

Especifique parámetros y valores en formato JSON.

INFO
Ejemplo:
code language-none 
{"user":"12345c2ecu1hq42ypqzhswbyam34",
"token":"123459evz8aepwtxydndydgyumbfx",
"message":"Hello World!",
"title":"The Push Notification"}
usuario
Su USER_KEY. Esto se puede encontrar en el tablero Pushover.
token
Su token de API/clave de API que se generó al crear su aplicación Pushover.
mensaje
El contenido de texto de la notificación push que se envía a los dispositivos.
title
(Opcional) Título del mensaje. Si no se introduce ningún valor, se utiliza el nombre de la aplicación.

Cuerpo de JSON asignado usando el módulo JSON >Crear JSON

El módulo Crear JSON facilita la especificación de JSON. También le ofrece la posibilidad de definir valores de forma dinámica.

Para obtener más información sobre los módulos JSON, consulte módulos JSON.

  1. Introduzca o asigne los valores desde los que desea crear un JSON.

  2. Conecte el módulo JSON > Crear JSON al módulo HTTP > Crear una solicitud.

  3. Asigne la cadena JSON del módulo Crear JSON al campo Solicitar contenido en el módulo HTTP >Realizar una solicitud.

    Ahora, cuando ejecute el escenario, la notificación push se enviará al dispositivo que se haya registrado en su cuenta de Pushover.

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