Módulos do Adobe Workfront Planning

Com os módulos Adobe Workfront Planning, é possível acionar um cenário quando os eventos ocorrem no Workfront Planning. Você também pode criar, ler, atualizar e excluir registros ou executar uma chamada de API personalizada para sua conta do Adobe Workfront Planning.

Requisitos de acesso

Expanda para visualizar os requisitos de acesso da funcionalidade neste artigo.
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Pacote do Adobe Workfront

Qualquer pacote de fluxo de trabalho do Adobe Workfront e qualquer pacote do Adobe Workfront Automation and Integration

Workfront Ultimate

Os pacotes Workfront Prime e Select, com uma compra adicional do Workfront Fusion.

Licenças do Adobe Workfront

Padrão

Trabalho ou maior

Produto Se sua organização tiver um pacote Workfront Select ou Prime, ele não inclui o Workfront Automation and Integration. É necessário comprar o Adobe Workfront Fusion.

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

Pré-requisitos do s##

Para acessar o Workfront Planning, é necessário ter o seguinte:

  • Um novo pacote e licença do Workfront. O Workfront Planning não está disponível para pacotes ou licenças herdadas do Workfront.
  • Um pacote do Workfront Planning.
  • A instância da Workfront de sua organização deve ser integrada à Adobe Unified Experience.

Informações da API do Adobe Workfront Planning

O conector do Adobe Workfront Planning usa o seguinte:

URL básica
https://{{connection.host}}/maestro/api/{{common.maestroApiVersion}}/
Tag da API
v1.13.7

Conectar o Workfront Planning ao Workfront Fusion

O conector do Workfront Planning usa o OAuth 2.0 para se conectar ao Workfront Planning.

Você pode criar uma conexão com sua conta do Workfront Planning diretamente de um módulo do Workfront Planning Fusion.

Conectar-se ao Workfront Planning usando a ID do cliente e o segredo do cliente

  1. Em qualquer módulo do Adobe Workfront Planning, clique em Adicionar ao lado do campo Conexão.

  2. Preencha os seguintes campos:

    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 Selecione Conexão de autenticação do Adobe Workfront.
    Connection name Insira um nome para a nova conexão.
    Client ID Insira sua ID de cliente do Workfront. Isso pode ser encontrado na área Aplicativos OAuth2 da área Configuração no Workfront. Abra o aplicativo específico ao qual você está se conectando para ver a ID de cliente.
    Client Secret Insira o segredo do cliente do Workfront. Isso pode ser encontrado na área Aplicativos OAuth2 da área Configuração no Workfront. Se não tiver um segredo do cliente para o aplicativo OAuth2 no Workfront, você poderá gerar outro. Para obter instruções, consulte a documentação do Workfront.
    Authentication URL

    Isso pode permanecer como o valor padrão, ou você pode inserir o URL da sua instância do Workfront, seguido por /integrations/oauth2.

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

    Host prefix Na maioria dos casos, esse valor deve ser origin.
  3. Clique em Continuar para salvar a conexão e retornar ao módulo.

    Se você não estiver conectado ao Workfront Planning, será direcionado para uma tela de logon. Depois de fazer logon, é possível permitir a conexão.

NOTE
  • As conexões do OAuth 2.0 com a API do Workfront não dependem mais das chaves de API.
  • Para criar uma conexão com um ambiente de Sandbox do Workfront, crie um aplicativo OAuth2 nesse ambiente e use a ID do cliente e o segredo do cliente gerados por esse aplicativo em sua conexão.

Conectar-se ao Workfront Planning usando uma conexão Servidor a Servidor

  1. Em qualquer módulo do Adobe Workfront Planning, clique em Adicionar ao lado do campo Conexão.

  2. Preencha os seguintes campos:

    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 Selecione Conexão de servidor para servidor do Adobe Workfront.
    Connection name Insira um nome para a nova conexão.
    Instance name

    Insira o nome da instância, também conhecido como domínio.

    Exemplo: se a URL for https://example.my.workfront.com, insira example.

    Instance lane

    Insira o tipo de ambiente ao qual esta conexão será feita.

    Exemplo: se a URL for https://example.my.workfront.com, insira my.

    Client ID Insira sua ID de cliente do Workfront. Isso pode ser encontrado na área Aplicativos OAuth2 da área Configuração no Workfront. Abra o aplicativo específico ao qual você está se conectando para ver a ID de cliente.
    Client Secret Insira o segredo do cliente do Workfront. Isso pode ser encontrado na área Aplicativos OAuth2 da área Configuração no Workfront. Se não tiver um segredo do cliente para o aplicativo OAuth2 no Workfront, você poderá gerar outro. Para obter instruções, consulte a documentação do Workfront.
    Scopes Insira todos os escopos aplicáveis para esta conexão.
    Host prefix Na maioria dos casos, esse valor deve ser origin.
  3. Clique em Continuar para salvar a conexão e retornar ao módulo.

    Se você não estiver conectado ao Workfront Planning, será direcionado para uma tela de logon. Depois de fazer logon, é possível permitir a conexão.

NOTE
  • As conexões do OAuth 2.0 com a API do Workfront não dependem mais das chaves de API.
  • Para criar uma conexão com um ambiente de Sandbox do Workfront, crie um aplicativo OAuth2 nesse ambiente e use a ID do cliente e o segredo do cliente gerados por esse aplicativo em sua conexão.

Módulos do Adobe Workfront Planning e seus campos

Ao configurar módulos do Workfront, o Workfront Fusion exibe os campos listados abaixo. Junto com esses campos, podem ser exibidos campos adicionais do Workfront, dependendo de fatores como nível de acesso no aplicativo ou serviço. Um título em negrito em um módulo indica um campo obrigatório.

Se você vir o botão de mapa acima de um campo ou função, poderá usá-lo para definir variáveis e funções para esse campo. Para obter mais informações, consulte Mapear informações de um módulo para outro.

Botão de alternância Mapear

Acionadores

Assistir a eventos

Este módulo de acionamento inicia um cenário quando um registro, tipo de registro ou espaço de trabalho é criado, atualizado ou excluído no Workfront Planning.

Webhook
Selecione o webhook que deseja usar ou clique em Adicionar para criar um novo.
Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Object type
Selecione se deseja observar registros, tipos de registro ou espaços de trabalho.
State

Selecione se deseja monitorar o estado antigo ou novo.

  • New state

    Acione um cenário quando o registro é alterado para um valor específico.

  • Old state

    Acione um cenário quando o registro é alterado de um valor específico.

Workspace
Se estiver observando registros, selecione o Workspace que deseja observar para os registros.
Record type
Se estiver observando registros, selecione o tipo de registro que deseja observar.
Events filters

É possível definir filtros para monitorar apenas os registros que atendem aos critérios selecionados.

Para cada filtro, insira o campo que você deseja que o filtro avalie, bem como o operador e o valor que deseja que o filtro permita. Você pode usar mais de um filtro adicionando regras AND.

Observação: não é possível editar filtros em webhooks existentes do Workfront. Para configurar filtros diferentes para assinaturas de eventos do Workfront, remova o webhook atual e crie um novo.

Para obter mais informações sobre filtros de evento, consulte Filtros de assinatura de evento no Workfront > Watch Events módulos no artigo sobre módulos do Workfront.

Objetos a serem observados
Selecione se você deseja observar novos. registros atualizados, novos e atualizados ou excluídos.
Excluir atualizações feitas por esta conexão
Habilite esta opção para impedir que o cenário seja acionado quando uma alteração for feita pela conexão usada por este módulo. Isso impede que outra instância do cenário seja acionada se esse cenário executar uma ação de acionamento.

Ações

Excluir um tipo de registro

Este módulo de ação exclui um único tipo de registro no Workfront Planning por sua ID.

WARNING
A exclusão de um tipo de registro no Workfront Planning também exclui todos os registros na tabela de tipo de registro.
Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
ID de tipo de registro
Informe ou mapeie a ID do tipo de registro que deseja deletar.

Fazer uma chamada de API personalizada

Este módulo faz uma chamada de API personalizada para a API Adobe Workfront Planning.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
URL
Insira um caminho relativo a https://(YOUR_WORKFRONT_DOMAIN)/maestro/api/
Method
Selecione o método de solicitação HTTP necessário para configurar a chamada de API. Para obter mais informações, consulte Métodos de solicitação HTTP.
Headers

Adicione os cabeçalhos da solicitação no formulário de um objeto JSON padrão.

Por exemplo, {"Content-type":"application/json"}

O Workfront Fusion adiciona cabeçalhos de autorização automaticamente.

Query String
Para cada par de chave/valor que você deseja adicionar à sequência de consulta, clique em Adicionar item e insira a chave e o valor.
Body

Adicione o conteúdo do corpo para a chamada de API na forma de um objeto JSON padrão.

Observação:

Ao usar instruções condicionais, como if em seu JSON, coloque as aspas fora da instrução condicional.

Pesquisas

Pesquisar registros

Este módulo de ação recupera uma lista de registros com base nos critérios que você especificar.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Workspace
Insira ou mapeie a Workspace que contém os registros que você deseja pesquisar.
Record type
Selecione o tipo de registro que deseja pesquisar.
Campos de Registro
Para cada campo que deseja usar na pesquisa, localize esse campo, selecione o operador e insira ou mapeie o valor que deseja pesquisar. Os campos estão disponíveis com base no tipo de registro selecionado.
Condição para filtros

Selecione a condição para seus filtros:

  • E

    O módulo retorna registros que correspondem a todos dos valores de campo selecionados.

  • OR

    O módulo retorna registros que correspondem a qualquer dos valores de campo selecionados.

Limit
Insira ou mapeie o número máximo de registros que deseja que o módulo retorne durante cada ciclo de execução de cenário.

Sem categoria

Criar um registro

Essa ação cria um único registro no Workfront Planning.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
ID de tipo de registro
Insira ou mapeie o tipo de registro que deseja criar. Os tipos de registro disponíveis baseiam-se na sua conta do Workfront Planning.
Outros campos
Insira os valores que você deseja que o novo registro tenha. Esses campos se baseiam no tipo de registro selecionado.

Excluir um registro

Este módulo de ação exclui o registro especificado no Workfront Planning.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
ID de Registro
Informe ou mapeie a ID do registro que deseja deletar.

Obter um registro

Este módulo de ação recupera um único registro de Adobe Workfront Planning, especificado por sua ID.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
ID de Registro
Insira ou mapeie a ID do registro que deseja recuperar.

Obter registros por tipo de registro

Este módulo de ação recupera todos os registros do tipo especificado.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Workspace
Selecione ou mapeie o espaço de trabalho que contém os registros que deseja recuperar.
Record type
Selecione o tipo de registro que deseja recuperar.

Obter tipos de registro

Este módulo de ação recupera uma lista de tipos de registros em uma conta Adobe Workfront Planning.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Workspace
Selecione ou mapeie o espaço de trabalho que contém os tipos de registro que deseja recuperar.

Atualizar registro

Essa ação atualiza um único registro no Workfront Planning.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
ID de Registro
Insira ou mapeie o tipo de registro que deseja atualizar. Os tipos de registro disponíveis baseiam-se na sua conta do Workfront Planning.
Outros campos
Informe os novos valores que deseja que o registro tenha. Esses campos se baseiam no tipo de registro selecionado.

Usar JSONata para o detalhamento record-types legível

A expressão JSONata a seguir cria uma saída legível da consulta do Planning que fornece o detalhamento dos tipos de registro. Isso torna o nome do tipo de registro, os nomes dos campos e os nomes das opções de campo (quando aplicável) legíveis por um nome e mantém o restante da estrutura 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 obter informações sobre o uso de módulos JSONata, consulte módulos JSONata.

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3