DocumentaçãoWorkfrontGuia do Workfront

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

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

Criado para:

  • Usuário

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

Há uma solução alternativa para essa situação. Você pode conectar o serviço (aplicativo) desejado a Workfront Fusion usando o módulo HTTP de Workfront Fusion.

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

Requisitos de acesso

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

Adobe Workfront plano*
Pro ou superior
Adobe Workfront licença*
Plano, Trabalho
Adobe Workfront Fusion licença**

Requisito de licença atual: nenhum requisito de licença Workfront Fusion.

Ou

Requisito de licença herdada: Workfront Fusion para Automação e Integração do Trabalho

Produto

Requisito atual do produto: se você tiver o Plano Adobe Workfront da Select ou da Prime, sua organização deve comprar o Adobe Workfront Fusion e o Adobe Workfront para usar a funcionalidade descrita neste artigo. Workfront Fusion está incluído no plano Workfront do Ultimate.

Ou

Requisito de produto herdado: sua organização deve comprar o Adobe Workfront Fusion e o Adobe Workfront para usar a funcionalidade descrita neste artigo.

Para saber que plano, tipo de licença ou acesso você tem, contate o administrador do Workfront.

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

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 > Fazer uma solicitação de Workfront Fusion 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
Usaremos o serviço de notificação Pushover como exemplo neste artigo.

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 em sua conta do 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 Workfront Fusion, você precisa 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 Workfront Fusion, configure o módulo HTTP da seguinte maneira.

    note note
    NOTE
    Essas configurações de 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 de 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.
    Cadeia de Consulta Alguns serviços da Web podem usar uma sequência de consulta para especificar outros parâmetros. Este 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 Body no formato JSON. Você pode usar o módulo JSON > Criar JSON como explicado no Corpo JSON mapeado usando o módulo JSON > Criar JSON neste artigo. Ou você pode inserir o conteúdo JSON manualmente, como explicado em Corpo JSON inserido 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.

Corpo JSON inserido manualmente

Especifique parâmetros e valores no formato JSON.

INFO
Exemplo:
code language-none 
{"user":"12345c2ecu1hq42ypqzhswbyam34",
"token":"123459evz8aepwtxydndydgyumbfx",
"message":"Hello World!",
"title":"The Push Notification"}
usuário
Sua USER_KEY. Isto pode ser encontrado no seu painel Pushover.
token
O token de API/Chave de API gerado criou o 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.

Corpo JSON mapeado 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.

  2. Conecte o módulo JSON > Criar JSON ao módulo HTTP > Fazer uma Solicitação.

  3. Mapeie a cadeia de caracteres JSON do módulo Criar JSON para o campo Solicitar conteúdo no módulo HTTP >Fazer uma Solicitação.

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

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