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

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 do 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
    Connection name Insira um nome para essa conexão.
    Environment Selecione se você está se conectando a um ambiente de produção ou não produção.
    Type Selecione se você deseja se conectar a uma conta de serviço ou a uma conta pessoal.

    Client ID

    (Opcional)

    Insira sua Client ID do Adobe. Essa informação pode ser encontrada na seção Credentials details do Adobe Developer Console.

    Client Secret

    (Opcional)

    Insira o Client Secret do Adobe. Essa informação pode ser encontrada na seção Credentials details do Adobe Developer Console.
    Authentication URL

    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.

    Host prefix

    Insira seu prefixo de host.

    O valor padrão é origin-.

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

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