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.

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: Automação e integração do Workfront Fusion for Work

Produto

Novo menu:

  • Selecionar ou pacote do Prime Workfront: sua organização deve comprar o Adobe Workfront Fusion.
  • Pacote 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.

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:

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.

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.

WARNING
A exclusão de um tipo de registro no Workfront Planning também exclui todos os registros na tabela de tipo de registro.
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.

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.

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.

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.

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.

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.

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.

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.

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.

(
    $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