Conectar o Adobe Workfront Fusion a um serviço Web que usa a autorização do token de API

Alguns serviços não permitem que soluções de integração, como o Adobe Workfront Fusion, criem um aplicativo que pode ser usado facilmente em seu cenário.

A solução alternativa para essa situação é conectar o serviço (aplicativo) desejado ao Workfront Fusion usando o módulo HTTP > Fazer uma solicitação.

Este artigo explica como conectar quase qualquer serviço Web ao Workfront Fusion usando uma chave de API/token de API.

Requisitos de acesso

Expanda para visualizar os requisitos de acesso para a funcionalidade neste artigo.

Você deve ter o seguinte acesso para usar a funcionalidade neste artigo:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Pacote do Adobe Workfront Qualquer
Licença do Adobe Workfront

Novo: Padrão

Ou

Atual: trabalho ou superior

Licença do Adobe Workfront Fusion**

Atual: nenhum requisito de licença do Workfront Fusion.

Ou

Herdados: Qualquer um

Produto

Novo:

  • Selecione ou Prime Workfront Plan: sua organização deve comprar o Adobe Workfront Fusion.
  • Plano do Ultimate Workfront: o Workfront Fusion está incluído.

Ou

Atual: sua organização deve comprar o Adobe Workfront Fusion.

Para obter mais detalhes sobre as informações nesta tabela, consulte Requisitos de acesso na documentação.

Para obter informações sobre licenças do Adobe Workfront Fusion, consulte licenças do Adobe Workfront Fusion.

Conexão com um serviço Web que usa um token de API

O procedimento de conexão do serviço por meio de um token de API é semelhante para a maioria dos serviços da Web.

  1. Crie um aplicativo no site do serviço Web, conforme explicado na seção Crie um novo aplicativo e obtenha o token de API neste artigo.
  2. Obtenha a chave de API ou o token de API.
  3. Adicione o módulo HTTP do Workfront Fusion > Fazer uma solicitação ao seu cenário.
  4. Configure o módulo de acordo com a documentação da API do serviço Web e execute o cenário, conforme explicado na seção Configurar o módulo HTTP deste artigo.
NOTE
Este exemplo se conecta ao serviço de notificação Pushover.

Crie um novo aplicativo e obtenha o token da API

NOTE
Há várias maneiras diferentes pelas quais os serviços da Web criam e distribuem chaves de API ou tokens de API. Para obter instruções sobre como obter uma chave de API e um token para o serviço da Web desejado, vá para o site do serviço e pesquise por "Chave de API" ou "Token de API".
Estamos incluindo instruções para obter uma chave de API Pushover somente como exemplo do que você pode encontrar.
  1. Faça logon na sua conta Pushover.
  2. Clique em Criar um token de aplicativo/API na parte inferior da página.
  3. Preencha as Informações do Aplicativo e clique em Criar um Aplicativo.
  4. Armazene o token de API fornecido em um local seguro. Você precisará dele para o módulo Workfront Fusion HTTP > Fazer uma solicitação para se conectar ao serviço Web desejado (Pushover, neste caso).

Configurar o módulo HTTP

Para conectar um serviço Web ao seu cenário do Workfront Fusion, é necessário usar o módulo HTTP > Fazer uma solicitação no cenário e configurar o módulo de acordo com a documentação da API do serviço Web.

  1. Adicione o módulo HTTP > Fazer uma solicitação ao seu cenário.

  2. Para enviar uma mensagem usando o Workfront Fusion, configure o módulo HTTP da seguinte maneira.

    note note
    NOTE
    Essas configurações do módulo correspondem à documentação da API do serviço Web Pushover. As configurações podem ser diferentes para outros serviços da Web. Por exemplo, o token da API pode ser inserido no cabeçalho e não no campo Corpo.
    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

    O campo URL contém o endpoint que pode ser encontrado na documentação da API do serviço Web.

    Método

    POST

    O método usado depende do endpoint correspondente. O endpoint Pushover para enviar mensagens usa o método POST.

    Cabeçalhos Alguns serviços da Web podem usar Cabeçalhos para especificar a autenticação do token de API ou outros parâmetros. Esse não é o caso em nosso exemplo, pois o endpoint do Pushover para enviar mensagens usa Corpo (veja abaixo) para todos os tipos de solicitação.
    Sequência de consulta Alguns serviços da Web podem usar uma sequência de consulta para especificar outros parâmetros. Esse não é o caso em nosso exemplo, pois o serviço Web Pushover usa Corpo (veja abaixo) para todos os tipos de solicitação.
    Tipo de corpo

    Raw

    Essa configuração permite selecionar o tipo de conteúdo JSON no campo Tipo de conteúdo abaixo.

    Tipo de conteúdo

    JSON (application/json)

    JSON é o tipo de conteúdo necessário para o aplicativo Pushover. Isso pode diferir de outros serviços da Web.

    Solicitar conteúdo

    Insira o conteúdo da solicitação de corpo no formato JSON. Você pode usar o módulo JSON > Criar JSON, conforme explicado em Mapear o corpo JSON usando JSON > Criar módulo JSON neste artigo. Ou você pode inserir o conteúdo JSON manualmente, como explicado em Inserir o corpo JSON manualmente neste artigo.

    Consulte a documentação da API do serviço Web para obter os parâmetros necessários para esse serviço Web.

Insira o corpo JSON manualmente

Especifique parâmetros e valores no formato JSON.

recommendation-more-help

Exemplo:

{"user":"12345c2ecu1hq42ypqzhswbyam34",
"token":"123459evz8aepwtxydndydgyumbfx",
"message":"Hello World!",
"title":"The Push Notification"}

Este exemplo inclui as seguintes informações.

usuário
Sua USER_KEY. Isso pode ser encontrado no seu painel Pushover.
token
O token de API/Chave de API gerado criou seu aplicativo Pushover.
mensagem
O conteúdo de texto da notificação por push enviada para o(s) dispositivo(s).
título
(Opcional) O título da sua mensagem. Se nenhum valor for inserido, o nome do aplicativo será usado.

Mapeie o corpo JSON usando o módulo JSON > Criar JSON

O módulo Criar JSON facilita a especificação do JSON. Ela também oferece a possibilidade de definir valores dinamicamente.

Para obter mais informações sobre os módulos JSON, consulte módulos JSON.

  1. Insira ou mapeie os valores a partir dos quais deseja criar JSON.

    Valores de JSON

  2. Conecte o JSON > Criar módulo JSON ao HTTP > Fazer um módulo de solicitação.

  3. Mapeie a string JSON do módulo Criar JSON para o campo Solicitar conteúdo no módulo HTTP > Fazer uma solicitação.

Quando você executa o cenário, a notificação por push é enviada para o dispositivo que foi registrado na sua conta Pushover.

7e1891ad-4d59-4355-88ab-a2e62ed7d1a3