Adobe Workfront Planning módulos

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 para a 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 de Automação e Integração do Adobe Workfront

Workfront Ultimate

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

Licenças do Adobe Workfront

Standard

Trabalhar ou superior

Produto Se sua organização tiver um pacote Select ou Prime Workfront que não inclua a Automação e Integração do Workfront, ela deverá comprar o Adobe Workfront Fusion.

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

accordion
## Pré-requisitos

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:

table 0-row-2 1-row-2 layout-auto html-authored no-header
URL básica https://{{connection.host}}/maestro/api/{{common.maestroApiVersion}}/
Tag da API v1.13.7

Criar uma conexão com Adobe Workfront Planning create-a-connection-to-adobe-workfront-planning

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

  1. Em qualquer módulo Adobe Workfront Planning, clique em Adicionar ao lado da caixa 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 layout-auto html-authored no-header
    Nome da Conexão Insira um nome para esta conexão.
    Ambiente Selecione se você está se conectando a um ambiente de produção ou não produção.
    Tipo Selecione se você deseja se conectar a uma conta de serviço ou a uma conta pessoal.

    ID do Cliente

    (Opcional)

    Insira sua Adobe ID do Cliente. Isso pode ser encontrado na seção Credentials details do Adobe Developer Console.

    Segredo do Cliente

    (Opcional)

    Insira seu Adobe Segredo do Cliente. Isso pode ser encontrado na seção Credentials details do Adobe Developer Console.
    URL de Autenticação

    Insira o URL que sua instância do Workfront usará para autenticar essa conexão.

    O valor padrão é https://oauth.my.workfront.com/integrations/oauth2.

    Prefixo de host

    Insira seu prefixo de host.

    O valor padrão é origin-.

  3. Clique em Continuar para salvar a conexão e retornar ao módulo.

Adobe Workfront Planning módulos e seus campos

Ao configurar módulos do Workfront, o Workfront Fusion exibe os campos listados abaixo. Junto com esses, campos adicionais do Workfront podem ser exibidos, 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.

Alternância de mapa

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.

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 8-row-2 layout-auto html-authored no-header
Webhook Selecione o webhook que deseja usar ou clique em Adicionar para criar um novo.
Conexão Para obter instruções sobre como criar uma conexão com Adobe Workfront Planning, consulte Criar uma conexão com Adobe Workfront Planning neste artigo.
Tipo de objeto Selecione se deseja observar registros, tipos de registro ou espaços de trabalho.
Estado

Selecione se deseja observar o estado antigo ou o novo estado.

  • Novo estado

    Acione um cenário quando o registro alterar para um determinado valor.

  • Estado antigo

    Acione um cenário quando o registro alterar de um determinado valor.

Workspace Se estiver observando registros, selecione o Workspace que deseja observar para os registros.
Tipo de registro Se estiver observando registros, selecione o tipo de registro que deseja observar.
Eventos filtros

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

Para cada filtro, insira o campo que deseja que o filtro avalie, 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 diferentes filtros 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.

note warning
WARNING
A exclusão de um tipo de registro no Workfront Planning também exclui todos os registros na tabela de tipo de registro.
table 0-row-2 1-row-2 layout-auto html-authored no-header
Conexão Para obter instruções sobre como criar uma conexão com Adobe Workfront Planning, consulte Criar uma conexão com 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.

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
Conexão Para obter instruções sobre como criar uma conexão com Adobe Workfront Planning, consulte Criar uma conexão com Adobe Workfront Planning neste artigo.
URL Insira um caminho relativo a https://(YOUR_WORKFRONT_DOMAIN)/maestro/api/
Método 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.
Cabeçalhos

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.

Cadeia de Consulta 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.
Corpo

Adicione o conteúdo do corpo para a chamada à 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.

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
Conexão Para obter instruções sobre como criar uma conexão com Adobe Workfront Planning, consulte Criar uma conexão com Adobe Workfront Planning neste artigo.
Workspace Insira ou mapeie a Workspace que contém os registros que você deseja pesquisar.
Tipo de registro 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.

Limite 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.

table 0-row-2 1-row-2 2-row-2 3-row-0 layout-auto html-authored no-header
Conexão Para obter instruções sobre como criar uma conexão com Adobe Workfront Planning, consulte Criar uma conexão com 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.

table 0-row-2 1-row-2 layout-auto html-authored no-header
Conexão Para obter instruções sobre como criar uma conexão com Adobe Workfront Planning, consulte Criar uma conexão com 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.

table 0-row-2 1-row-2 layout-auto html-authored no-header
Conexão Para obter instruções sobre como criar uma conexão com Adobe Workfront Planning, consulte Criar uma conexão com 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.

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Conexão Para obter instruções sobre como criar uma conexão com Adobe Workfront Planning, consulte Criar uma conexão com Adobe Workfront Planning neste artigo.
Workspace Selecione ou mapeie o espaço de trabalho que contém os registros que deseja recuperar.
Tipo de registro 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.

table 0-row-2 1-row-2 layout-auto html-authored no-header
Conexão Para obter instruções sobre como criar uma conexão com Adobe Workfront Planning, consulte Criar uma conexão com 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.

table 0-row-2 1-row-2 2-row-2 3-row-0 layout-auto html-authored no-header
Conexão Para obter instruções sobre como criar uma conexão com Adobe Workfront Planning, consulte Criar uma conexão com 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.

code language-none
(
    $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