Adobe Workfront módulos

Você pode usar o Adobe Workfront Fusion Adobe Workfront conector para automatizar os processos no Workfront. Se você tiver uma Workfront Fusion para Automação e integração do trabalho licença, você também pode usá-la para se conectar a aplicativos e serviços de terceiros.

A variável Workfront O conector do não é contabilizado em relação ao número de aplicativos ativos disponíveis para sua organização. Todos os cenários, mesmo que usem apenas o Workfront , não contem com a contagem total de cenários de sua organização.

Para obter mais informações sobre os aplicativos e cenários disponíveis em sua organização, consulte Organizações in Adobe Workfront Fusion organizações e equipes.

Se precisar de instruções sobre como criar um cenário, consulte Criar um cenário no Adobe Workfront Fusion. Para obter informações sobre módulos, consulte Módulos no Adobe Workfront Fusion.

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: Não Workfront Fusion requisito de licença.

Ou

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

Produto

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

Ou

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

Para descobrir que plano, tipo de licença ou acesso você tem, entre em contato com o Workfront administrador.

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

Conectar Workfront para Workfront Fusion

A variável Workfront O conector usa o OAuth 2.0 para se conectar a Workfront.

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

  1. Em qualquer módulo do Adobe Workfront, clique em Adicionar ao lado do campo Connection.

  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 a nova conexão.
    Ambiente Selecione se estão se conectando a um ambiente de produção ou não produção.
    Tipo de conexão Selecione se você está se conectando a uma conta de serviço ou a uma conta pessoal.
    ID do Cliente Insira seu Workfront ID do cliente. 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 do cliente.
    Segredo do Cliente Insira seu Workfront ID do cliente. 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 do cliente.
    URL de Autenticação

    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

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

NOTE
  • Se você não vir um botão de logon SAML, sua organização não habilitou o Logon único (SSO). Você pode fazer logon com seu Nome de usuário e Senha.

    Para obter mais informações sobre SSO, consulte Visão geral do logon único no Adobe Workfront

  • Conexões OAuth 2.0 com o Workfront A API não depende mais das chaves de API.

Workfront módulos e seus campos

Ao configurar Workfront módulos, Workfront Fusion exibe os campos listados abaixo. Junto com esses, Workfront Os campos podem ser exibidos, dependendo de fatores como seu 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 no Adobe Workfront Fusion.

NOTE
Se você não vir os campos mais atualizados em um módulo do Workfront, isso pode ser devido a problemas de cache. Aguarde uma hora e tente novamente.

Triggers

Assistir a eventos

Esse módulo de acionador executa um cenário em tempo real quando objetos de um tipo específico são adicionados, atualizados ou excluídos no Workfront

O módulo retorna quaisquer campos padrão associados ao registro, juntamente com quaisquer campos e valores personalizados que a conexão acessa. Você pode mapear essas informações em módulos subsequentes no cenário.

  1. Clique em Adicionar à direita do Webhook caixa.

  2. Configure o webhook no Adicionar um gancho que é exibida.

    Ao configurar esse módulo, os campos a seguir são exibidos.

    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 do Webhook (Opcional) Digite um novo nome para o webhook
    Conexão Para obter instruções sobre como conectar seu Workfront aplicativo para Workfront Fusion, consulte Conectar Workfront para Workfront Fusion neste artigo.
    Tipo de Registro Selecione o tipo de Workfront registre que você deseja que o módulo assista.
    Estado

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

    • Novo estado

      Acionar um cenário quando o registro for alterado para um determinado valor.

      Por exemplo, se o estado estiver definido como Novo Estado e o filtro estiver definido como Status Igual a Em Andamento, o webhook acionará um cenário quando o Status for alterado para Em Andamento, independentemente do status anterior.

    • Estado antigo

      Acionar um cenário quando o registro for alterado de um determinado valor.

      Por exemplo, se o estado estiver definido como Estado Antigo e o filtro estiver definido como Status Igual a Em Andamento, o webhook acionará um cenário quando um Status atual Em Andamento for alterado para outro status.

    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 no existente Workfront webhooks. Para configurar filtros diferentes para Workfront assinaturas de evento, remova o webhook atual e crie um novo.

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

    Excluir eventos feitos por esta conexão

    Habilite essa opção para excluir eventos criados ou atualizados usando o mesmo conector que esse módulo de acionador usa. Isso pode evitar situações em que um cenário pode ser acionado, fazendo com que ele se repita em um loop infinito.

    NOTA O tipo de registro Assignment não inclui essa opção.

    Origem do Registro

    Escolha se deseja que o cenário assista Somente Novos Registros, Atualizou Somente Registros, Registros Novos e Atualizados ou Deleted Records Only.

    Observação: se você escolher Registros Novos e Atualizados, a criação do webhook cria 2 assinaturas de evento (para o mesmo endereço de webhook).

Depois que o webhook for criado, você poderá exibir o endereço do endpoint para o qual os eventos são enviados.

Para obter mais informações, consulte a seção Exemplos de payloads de evento no Workfront Artigo de ajuda API de assinatura de evento.

Veja uma lista dos Workfront tipos de objeto para os quais você pode usar este módulo em Workfront tipos de objeto disponíveis para cada Workfront módulo.

Campo de observação

Esse módulo de acionamento executa um cenário quando um campo especificado é atualizado. O módulo retorna o valor antigo e o novo do campo especificado. Você pode mapear essas informações em módulos subsequentes no cenário.

Ao configurar esse módulo, os campos a seguir são exibidos.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
Conexão Para obter instruções sobre como conectar seu Workfront aplicativo para Workfront Fusion, consulte Conectar Workfront para Workfront Fusion neste artigo.
Tipo de Registro

Selecione o tipo de Workfront registre que você deseja que o módulo assista.

Por exemplo, selecione Tarefa se desejar começar a executar o cenário sempre que um campo de registro for atualizado em uma tarefa.

Campo Selecione o campo que você deseja que o módulo veja por atualizações. Esses campos refletem os campos que Workfront O administrador configurou o para rastreamento.
Saídas Selecione as informações que deseja incluir no pacote de saída deste módulo.
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.

Veja uma lista dos Workfront tipos de objeto para os quais você pode usar este módulo em Workfront tipos de objeto disponíveis para cada Workfront módulo.

Assistir ao registro

Esse módulo de acionamento executa um cenário quando objetos de um tipo específico são adicionados, atualizados ou ambos. O módulo retorna todos os campos padrão associados ao registro ou aos registros, juntamente com quaisquer campos e valores personalizados que a conexão acesse. Você pode mapear essas informações em módulos subsequentes no cenário. Na saída, o módulo indica se cada registro é novo ou atualizado.

Os registros que foram adicionados e atualizados no período determinado são retornados como novos registros.

Ao configurar esse módulo, os campos a seguir são exibidos.

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 conectar seu Workfront aplicativo para Workfront Fusion, consulte Conectar Workfront para Workfront Fusion neste artigo.
Filtro Escolha se deseja que o cenário assista Somente Novos Registros, Atualizou Somente Registros ou Registros Novos e Atualizados.
Tipo de Registro

(É exibido depois que você escolhe um Filtro.) Selecione o tipo de Workfront registre que você deseja que o módulo assista.

Por exemplo, se você deseja iniciar o cenário sempre que um novo projeto for criado, selecione Projeto

Saídas Selecione as informações que deseja incluir no pacote de saída deste módulo.
Filtro Opcional (Avançado) Digite uma string de código da API para definir parâmetros ou códigos adicionais que refinarão seus critérios.
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.

Veja uma lista dos Workfront tipos de objeto para os quais você pode usar este módulo em Workfront tipos de objeto disponíveis para cada Workfront módulo.

Ações

Converter objeto

Esse módulo de ação faz uma das seguintes conversões:

  • Converter Problema em Projeto
  • Converter problema em tarefa
  • Converter Tarefa em Projeto
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
Conexão Para obter instruções sobre como conectar seu Workfront aplicativo para Workfront Fusion, consulte Conectar Workfront para Workfront Fusion neste artigo.
Tipo de objeto Selecione o tipo de objeto que deseja converter. Esse é o tipo que o objeto tem antes da conversão.
Converter em Selecione o objeto para o qual você deseja convertê-lo. Esse é o tipo que o objeto tem após a conversão.
<object> ID

Insira a ID do objeto.

Observação: Ao informar o ID de um objeto, você pode começar a digitar o nome do objeto e, em seguida, selecioná-lo na lista. O módulo insere a ID apropriada no campo.

ID de Modelo

Se estiver convertendo em um projeto, selecione a ID do modelo que deseja usar para o projeto.

Observação: Ao informar o ID de um objeto, você pode começar a digitar o nome do objeto e, em seguida, selecioná-lo na lista. O módulo insere a ID apropriada no campo.

Formulários personalizados Selecione os formulários personalizados que deseja adicionar ao objeto recém-convertido e insira valores para os campos do formulário personalizado.
Opções Ative as opções desejadas ao converter o objeto. As opções estão disponíveis dependendo do objeto para o qual você está convertendo ou a partir do.
Criar um registro (anexar formulários personalizados)

Este módulo de ação cria um objeto, como um projeto, tarefa ou problema no Workfronte permite adicionar um formulário personalizado ao novo objeto. O módulo permite selecionar quais dos campos do objeto estão disponíveis no módulo.

Especifique a ID do registro.

O módulo retorna a ID do registro e quaisquer campos associados, juntamente com quaisquer campos e valores personalizados que a conexão acessa. Você pode mapear essas informações em módulos subsequentes no cenário.

Você pode usar esse módulo, por exemplo, para criar uma tarefa no Workfront quando um cliente adiciona uma nova linha em um Google Sheets lista de tarefas que precisam ser feitas.

Ao configurar esse módulo, os campos a seguir são exibidos.

Forneça o número mínimo de campos de entrada. Por exemplo, se você deseja criar um problema, é necessário fornecer uma ID de projeto principal válida no campo ID do projeto para indicar onde o problema deve residir na Workfront. Você pode usar o painel de mapeamento para mapear essas informações de outro módulo em seu cenário ou pode inseri-las manualmente digitando o nome e selecionando-o na lista.

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Conexão Para obter instruções sobre como conectar seu Workfront aplicativo para Workfront Fusion, consulte Conectar Workfront para Workfront Fusion neste artigo.
Tipo de Registro

Selecione o tipo de Workfront registro que você deseja que o módulo crie.

Por exemplo, se você deseja criar um Projeto, selecione Project na lista suspensa e verifique se você tem acesso aos dados (dos módulos anteriores no cenário) que preencherão o projeto.

Selecionar campos a serem mapeados

Selecione os campos que deseja disponibilizar para entrada de dados. Isso permite usar esses campos sem precisar percorrer os que não são necessários.

Para campos em formulários personalizados, use o Anexar Formulário Personalizado campo.

Anexar Formulário Personalizado Selecione quaisquer formulários personalizados que deseja adicionar ao novo objeto e insira valores para esses campos.

Veja uma lista dos Workfront tipos de objeto para os quais você pode usar este módulo em Workfront tipos de objeto disponíveis para cada Workfront módulo.

note note
NOTE
  • Ao inserir a ID de um objeto, você pode começar a digitar o nome do objeto e, em seguida, selecioná-lo na lista. O módulo insere a ID apropriada no campo.

  • Ao inserir o texto para um campo personalizado ou uma Nota (Comentário ou resposta), você pode usar tags HTML na variável Texto da Nota para criar rich text, como negrito ou itálico.

    Para obter mais informações sobre rich text em atualizações, consulte Adicionar uma atualização a um item de trabalho in Atualizar trabalho.

Criar registro

Esse módulo de ação cria um objeto, como um projeto, tarefa ou problema no Workfront. O módulo permite selecionar quais dos campos do objeto estão disponíveis no módulo.

Especifique a ID do registro.

O módulo retorna a ID do registro e quaisquer campos associados, juntamente com quaisquer campos e valores personalizados que a conexão acessa. Você pode mapear essas informações em módulos subsequentes no cenário.

Você pode usar esse módulo, por exemplo, para criar uma tarefa no Workfront quando um cliente adiciona uma nova linha em uma lista de tarefas do Google Sheets que precisam ser feitas.

Ao configurar esse módulo, os campos a seguir são exibidos.

Forneça o número mínimo de campos de entrada. Por exemplo, se você deseja criar um problema, é necessário fornecer uma ID de projeto principal válida no campo ID do projeto para indicar onde o problema deve residir na Workfront. Você pode usar o painel de mapeamento para mapear essas informações de outro módulo em seu cenário ou pode inseri-las manualmente digitando o nome e selecionando-o na lista.

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Conexão Para obter instruções sobre como conectar seu Workfront aplicativo para Workfront Fusion, consulte Conectar Workfront para Workfront Fusion neste artigo.
Tipo de Registro

Selecione o tipo de Workfront registro que você deseja que o módulo crie.

Por exemplo, se você deseja criar um Projeto, selecione Project na lista suspensa e verifique se você tem acesso aos dados (dos módulos anteriores no cenário) que preencherão o projeto.

Selecionar campos a serem mapeados Selecione os campos que deseja disponibilizar para entrada de dados. Isso permite usar esses campos sem precisar percorrer os que não são necessários.

Veja uma lista dos Workfront tipos de objeto para os quais você pode usar este módulo em Workfront tipos de objeto disponíveis para cada Workfront módulo.

note note
NOTE
  • Ao inserir a ID de um objeto, você pode começar a digitar o nome do objeto e, em seguida, selecioná-lo na lista. O módulo insere a ID apropriada no campo.

  • Ao inserir o texto para um campo personalizado ou uma Nota (Comentário ou resposta), você pode usar tags HTML na variável Texto da Nota para criar rich text, como negrito ou itálico.

    Para obter mais informações sobre rich text em atualizações, consulte Adicionar uma atualização a um item de trabalho in Atualizar trabalho.

Chamada de API personalizada

Esse módulo de ação permite fazer uma chamada autenticada personalizada para o Workfront API. Dessa forma, você pode criar uma automação de fluxo de dados que não pode ser realizada pelo outro Workfront módulos.

O módulo retorna as seguintes informações:

  • Código de status (número): isso indica o sucesso ou a falha de sua solicitação HTTP. Esses são códigos padrão que você pode pesquisar na Internet.

  • Cabeçalhos (objeto): um contexto mais detalhado para o código de resposta/status que não está relacionado ao corpo de saída. Nem todos os cabeçalhos que aparecem em um cabeçalho de resposta são cabeçalhos de resposta, portanto, alguns podem não ser úteis para você.

    Os cabeçalhos de resposta dependem da solicitação HTTP escolhida ao configurar o módulo.

  • Corpo (objeto): dependendo da solicitação HTTP escolhida ao configurar o módulo, talvez você receba alguns dados de volta. Esses dados, como os dados de uma solicitação GET, estão contidos neste objeto.

Você pode mapear essas informações em módulos subsequentes no cenário.

Ao configurar esse módulo, os campos a seguir são exibidos.

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
Conexão Para obter instruções sobre como conectar seu Workfront aplicativo para Workfront Fusion, consulte Conectar Workfront para Workfront Fusion neste artigo.
URL Insira um caminho relativo a https://<WORKFRONT_DOMAIN>/attask/api/<API_VERSION>/.
Versão da API Selecione a versão do Workfront API que você deseja que o módulo use.
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 em Adobe Workfront Fusion.
Cabeçalhos

Adicione os cabeçalhos da solicitação no formulário de um objeto JSON padrão. Isso determina o tipo de conteúdo da solicitação.

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

Observação: se você estiver recebendo erros e for difícil determinar sua origem, considere modificar cabeçalhos com base na Workfront documentação. Se sua chamada de API personalizada retornar um erro de solicitação HTTP 422, tente usar um "Content-Type":"text/plain" cabeçalho.

Cadeia de Consulta

Adicione a consulta da chamada à API na forma de um objeto JSON padrão.

Por exemplo: {"name":"something-urgent"}

Dica: recomendamos que você envie informações por meio do corpo JSON, em vez de como parâmetros de consulta.

Corpo

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

Nota:

Ao usar declarações condicionais como if no JSON, coloque as aspas fora da declaração condicional.

Veja uma lista dos Workfront tipos de objeto para os quais você pode usar este módulo em Workfront tipos de objeto disponíveis para cada Workfront módulo.

Excluir registro

Esse módulo de ação exclui um objeto, como um projeto, tarefa ou problema no Workfront.

Especifique a ID do registro.

O módulo retorna a ID do registro e quaisquer campos associados, juntamente com quaisquer campos e valores personalizados que a conexão acessa. Você pode mapear essas informações em módulos subsequentes no cenário.

Ao configurar esse módulo, os campos a seguir são exibidos.

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Conexão Para obter instruções sobre como conectar seu Workfront aplicativo para Workfront Fusion, consulte Conectar Workfront para Workfront Fusion neste artigo.
Forçar exclusão Habilite essa opção para garantir que o registro seja excluído, mesmo que a variável Workfront A interface do solicitaria a confirmação da exclusão.
ID

Insira o único Workfront ID do registro que você deseja que o módulo exclua.

Para obter a ID, abra o Workfront no navegador e copie o texto no final do URL após "ID=". Por exemplo: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

Tipo de Registro Selecione o tipo de Workfront registro que você deseja que o módulo exclua.

Veja uma lista dos Workfront tipos de objeto para os quais você pode usar este módulo em Workfront tipos de objeto disponíveis para cada Workfront módulo.

note note
NOTE
Recomendamos a configuração do cenário a seguir para evitar a possibilidade de registros não serem excluídos devido a operações assíncronas.
  1. Excluir o registro de forma síncrona.
  2. Adicione a manipulação de erros ao módulo Delete Record para Ignorar o erro causado pelo tempo limite de 40 segundos.
Baixar documento

Este módulo de ação baixa um documento do Workfront.

Especifique a ID do registro.

O módulo retorna o conteúdo do documento, o nome do arquivo, a extensão do arquivo e o tamanho do arquivo. Você pode mapear essas informações em módulos subsequentes no cenário.

Ao configurar esse módulo, os campos a seguir são exibidos.

table 0-row-2 1-row-2 layout-auto html-authored no-header
Conexão Para obter instruções sobre como conectar seu Workfront aplicativo para Workfront Fusion, consulte Conectar Workfront para Workfront Fusion neste artigo.
ID de Documento

Mapeie ou insira manualmente o Workfront ID do documento que você deseja que o módulo baixe.

Para obter a ID, abra o Workfront no navegador e copie o texto no final do URL após "ID=". Por exemplo: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

Veja uma lista dos Workfront tipos de objeto para os quais você pode usar este módulo em Workfront tipos de objeto disponíveis para cada Workfront módulo.

Ação Diversa

Esse módulo de ação permite executar ações na API.

Ao configurar esse módulo, os campos a seguir são exibidos.

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Conexão Para obter instruções sobre como conectar seu Workfront aplicativo para Workfront Fusion, consulte Conectar Workfront para Workfront Fusion neste artigo.
Tipo de Registro Selecione o tipo de Workfront registro com o qual você deseja que o módulo interaja.
Ação

Selecione a ação que deseja que o módulo execute.

Talvez seja necessário preencher campos adicionais, dependendo do Record Type e da Action escolhidos. Algumas combinações dessas duas configurações podem exigir apenas uma ID de registro, enquanto outras (como Project para o Tipo de Registro e Anexar Modelo para o Ação) exigem informações adicionais (como uma ID de objeto e uma ID de modelo).

Para obter detalhes sobre campos individuais, consulte a Documentação do desenvolvedor do Workfront.

Nota: o site de documentação do desenvolvedor inclui informações somente por meio da API versão 14, mas ainda contém informações valiosas para chamadas de API.

  1. Selecione o tipo de registro na navegação à esquerda no Workfront página da documentação do desenvolvedor. Os seguintes tipos têm suas próprias páginas:

    • Projetos

    • Tarefas

    • Problemas

    • Usuários

    • Documentos

    Para todos os outros tipos de registro, selecione Outros objetos e pontos de extremidade e localize o tipo de registro nas páginas classificadas alfabeticamente.

  2. Na página do tipo de registro apropriado, pesquise (Ctrl-F ou Cmd-F) a ação.

  3. Exibir descrições para campos disponíveis sob a ação selecionada.

Nota:

Ao criar uma prova por meio da Workfront Módulo Misc Action, a prática recomendada é criar uma prova sem nenhuma opção avançada e, em seguida, atualizar a prova usando o Workfront Proof API SOAP.

Para obter mais informações sobre como criar uma prova com o Workfront API (que este módulo usa), consulte Adicionar opções de prova avançada ao criar uma prova por meio da Adobe Workfront API

ID

Insira ou mapeie o Workfront ID do registro com o qual você deseja que o módulo interaja.

Para obter a ID, abra o Workfront no navegador e copie o texto no final do URL após "ID=". Por exemplo: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

Veja uma lista dos Workfront tipos de objeto para os quais você pode usar este módulo em Workfront tipos de objeto disponíveis para cada Workfront módulo.

Ler um Registro

Este módulo de ação recupera dados de um único registro.

Especifique a ID do registro. Você também pode especificar quais registros relacionados deseja que o módulo leia.

Por exemplo, se o registro que o módulo está lendo for um projeto, você pode especificar que deseja ler as tarefas do projeto.

O módulo retorna uma matriz de dados dos campos padrão para a saída especificada.

Ao configurar esse módulo, os campos a seguir são exibidos.

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 conectar seu Workfront aplicativo para Workfront Fusion, consulte Conectar Workfront para Workfront Fusion neste artigo.
Tipo de Registro Escolha o Workfront tipo de objeto que você deseja que o módulo leia.
Saídas Selecione as informações que deseja incluir no pacote de saída deste módulo.
Referências Selecione os campos de referência que deseja incluir na saída.
Coleções Selecione os campos de referência que deseja incluir na saída.
ID

Insira o único Workfront ID do registro que você deseja que o módulo leia.

Para obter a ID, abra o Workfront no navegador e copie o texto no final do URL após "ID=". Por exemplo: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

Veja uma lista dos Workfront tipos de objeto para os quais você pode usar este módulo em Workfront tipos de objeto disponíveis para cada Workfront módulo.

Atualizar registro

Esse módulo de ação atualiza um objeto, como um projeto, tarefa ou problema. O módulo permite selecionar quais dos campos do objeto estão disponíveis no módulo.

Especifique a ID do registro.

O módulo retorna a ID do objeto e quaisquer campos associados, juntamente com quaisquer campos e valores personalizados que a conexão acessa. Você pode mapear essas informações em módulos subsequentes no cenário.

Ao configurar esse módulo, os campos a seguir são exibidos.

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Conexão Para obter instruções sobre como conectar seu Workfront aplicativo para Workfront Fusion, consulte Conectar Workfront para Workfront Fusion neste artigo.
ID

Insira o único Workfront ID do registro que você deseja que o módulo atualize.

Para obter a ID, abra o Workfront no navegador e copie o texto no final do URL após "ID=". Por exemplo: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

Record Type Selecione o tipo de Workfront registro que você deseja que o módulo atualize.
Select fields to map Selecione os campos que deseja disponibilizar para entrada de dados. Isso permite usar esses campos sem precisar percorrer os que não são necessários.

Veja uma lista dos Workfront tipos de objeto para os quais você pode usar este módulo em Workfront tipos de objeto disponíveis para cada Workfront módulo.

note note
NOTE
  • Ao inserir a ID de um objeto, você pode começar a digitar o nome do objeto e, em seguida, selecioná-lo na lista. O módulo insere a ID apropriada no campo.

  • Ao inserir o texto para um campo personalizado ou uma Nota (Comentário ou resposta), você pode usar tags HTML na variável Texto da Nota para criar rich text, como negrito ou itálico.

    Para obter mais informações sobre rich text em atualizações, consulte Adicionar uma atualização a um item de trabalho in Atualizar trabalho.

Carregar documento

Esse módulo de ação faz upload de um documento em um Workfront como um projeto, tarefa ou problema.

Especifique o local do documento, o arquivo que deseja fazer upload e um novo nome opcional para o arquivo.

O módulo retorna a ID do documento e quaisquer campos associados, juntamente com quaisquer campos e valores personalizados que a conexão acessa. Você pode mapear essas informações em módulos subsequentes no cenário.

Ao configurar esse módulo, os campos a seguir são exibidos.

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Conexão Para obter instruções sobre como conectar seu Workfront aplicativo para Workfront Fusion, consulte Conectar Workfront para Workfront Fusion neste artigo.
ID de Registro Relacionado Insira o único Workfront ID do registro no qual você deseja fazer upload do documento.
Tipo de Registro Relacionado Selecione o tipo de Workfront registre onde deseja que o módulo carregue o documento.
Arquivo de origem Selecione um arquivo de origem de um módulo anterior ou mapeie o nome e os dados do arquivo de origem.

Veja uma lista dos Workfront tipos de objeto para os quais você pode usar este módulo em Workfront tipos de objeto disponíveis para cada Workfront módulo.

Pesquisas

Ler registros relacionados

Esse módulo de pesquisa lê registros que correspondem à consulta de pesquisa especificada em um determinado objeto pai.

Você especifica quais campos deseja incluir na saída. Você pode mapear essas informações em módulos subsequentes no cenário.

Ao configurar esse módulo, os campos a seguir são exibidos.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
Conexão Para obter instruções sobre como conectar seu Workfront aplicativo para Workfront Fusion, consulte Conectar Workfront para Workfront Fusion neste artigo.
Tipo de Registro

Selecione o tipo do registro pai (objeto Workfront) cujos registros associados você deseja ler.

Veja uma lista dos Workfront tipos de objeto para os quais você pode usar este módulo em Workfront tipos de objeto disponíveis para cada Workfront módulo neste artigo.

ID de Registro Pai

Informe ou mapeie o ID do registro-pai cujos registros associados você deseja ler.

Para obter a ID, abra o Workfront no navegador e copie o texto no final do URL após "ID=". Por exemplo: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

Coleções Selecione ou mapeie o tipo de registro filho que você deseja que o módulo leia.
Saídas Selecione as informações que deseja incluir no pacote de saída deste módulo.
Pesquisa

Este módulo de pesquisa procura registros em um objeto no Workfront que correspondam à consulta de pesquisa especificada.

Você pode mapear essas informações em módulos subsequentes no cenário.

Ao configurar esse módulo, os campos a seguir são exibidos.

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
Conexão Para obter instruções sobre como conectar seu Workfront aplicativo para Workfront Fusion, consulte Conectar Workfront para Workfront Fusion neste artigo.
Tipo de Registro Selecione o tipo de Workfront registro que você deseja que o módulo procure.
Conjunto de Resultados Selecione uma opção para especificar se você deseja que o módulo obtenha o primeiro resultado que corresponda aos seus critérios de pesquisa ou todos os resultados que correspondam a ele.
Máximo 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.
Pesquisar critérios

Digite o campo pelo qual deseja pesquisar, o operador que deseja usar na consulta e o valor que está procurando no campo.

Observação: não use username em seus critérios de pesquisa. Incluindo username em uma consulta de API para Workfront O conecta o usuário no Workfront e a pesquisa não será bem-sucedida.

Nota: In e NotIntrabalhar com arrays. As entradas devem estar em formato de matriz.

Saídas Selecione os campos que deseja incluir na saída deste módulo.
Referências Selecione os campos de referência que deseja incluir na pesquisa.
Coleções Selecione todas as coleções que deseja adicionar à pesquisa.

Veja uma lista dos Workfront tipos de objeto para os quais você pode usar este módulo em Workfront tipos de objeto disponíveis para cada Workfront módulo.

Workfront tipos de objeto disponíveis para cada Workfront módulo

Tipos de objeto disponíveis para cada Workfront módulo acionador
table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4 15-row-4 16-row-4 17-row-4 18-row-4 19-row-4 20-row-4 21-row-4 22-row-4 23-row-4 24-row-4 25-row-4 26-row-4 27-row-4 28-row-4 29-row-4 30-row-4 31-row-4 32-row-4 33-row-4 34-row-4 35-row-4 36-row-4 37-row-4 38-row-4 39-row-4 40-row-4 41-row-4 layout-auto
Observar Registro Campo de Observação Observar Eventos
Processo de aprovação ✓ µ
Atribuição ✓ µ ✓ µ
Linha de base ✓ µ
Registro de Cobrança ✓ µ
Taxa de faturamento ✓ µ
Empresa ✓ µ ✓ µ ✓ µ
Painel ✓ µ
Documento ✓ µ ✓ µ ✓ µ
Pasta de documento ✓ µ ✓ µ
Solicitação de documento ✓ µ
Versão do Documento ✓ µ ✓ µ
Despesa ✓ µ ✓ µ ✓ µ
Tipo de Despesa
Grupo ✓ µ ✓ µ
Hora ✓ µ ✓ µ
Tipo de hora ✓ µ
Problema ✓ µ ✓ µ ✓ µ
Iteração ✓ µ ✓ µ
Função no trabalho ✓ µ ✓ µ
Entrada no Relatório ✓ µ
Etapa ✓ µ
Caminho de Etapas ✓ µ ✓ µ
Nota ✓ µ ✓ µ ✓ µ
Etiqueta de nota ✓ µ
Portfólio ✓ µ ✓ µ ✓ µ
Programa ✓ µ ✓ µ ✓ µ
Projeto ✓ µ ✓ µ ✓ µ
Usuário de Projeto ✓ µ
Aprovação da revisão ✓ µ
Tempo reservado* ✓ µ
Relatório ✓ µ
Risco
Tipo de Risco
Aprovador da etapa ✓ µ
Tarefa ✓ µ ✓ µ ✓ µ
Equipe ✓ µ
Modelo ✓ µ ✓ µ ✓ µ
Modelo de Tarefa ✓ µ ✓ µ
Planilha de horas ✓ µ ✓ µ ✓ µ
Usuário ✓ µ ✓ µ ✓ µ
Atualizar
Tipos de objeto disponíveis para cada Workfront módulo de ação
note note
NOTE
A variável Baixar documento O módulo não está incluído nesta tabela porque Workfront tipos de objeto não fazem parte de sua configuração.
table 0-row-8 1-row-8 2-row-8 3-row-8 4-row-8 5-row-8 6-row-8 7-row-8 8-row-8 9-row-8 10-row-8 11-row-8 12-row-8 13-row-8 14-row-8 15-row-8 16-row-8 17-row-8 18-row-8 19-row-8 20-row-8 21-row-8 22-row-8 23-row-8 24-row-8 25-row-8 26-row-8 27-row-8 28-row-8 29-row-8 30-row-8 31-row-8 32-row-8 33-row-8 34-row-8 35-row-8 36-row-8 layout-auto
Criar um registro Atualizar um registro Excluir um registro Carregar Documento Ler um registro Chamada de API Personalizada Ação Diversa
Processo de aprovação ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Atribuição ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Registro de Cobrança ✓ µ ✓ µ ✓ µ ✓ µ
Taxa de faturamento ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Empresa ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Documento ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Pasta de documento ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Versão do Documento ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Despesa ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Tipo de Despesa ✓ µ ✓ µ ✓ µ ✓ µ
Grupo ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Hora ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Tipo de hora ✓ µ ✓ µ ✓ µ ✓ µ
Problema ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Iteração ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Função no trabalho ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Entrada no Relatório ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Etapa ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Caminho de Etapas ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Nota ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Etiqueta de nota ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Portfólio ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Programa ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Projeto ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Usuário de Projeto ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Tempo reservado* ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Risco ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Tipo de Risco ✓ µ ✓ µ ✓ µ ✓ µ
Aprovador da etapa ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Tarefa ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Equipe ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Modelo ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Modelo de Tarefa ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Planilha de horas ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Usuário ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
Atualizar ✓ µ
Tipos de objeto disponíveis para cada Workfront módulo de pesquisa
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3 14-row-3 15-row-3 16-row-3 17-row-3 18-row-3 19-row-3 20-row-3 21-row-3 22-row-3 23-row-3 24-row-3 25-row-3 26-row-3 27-row-3 28-row-3 29-row-3 30-row-3 31-row-3 32-row-3 33-row-3 34-row-3 35-row-3 36-row-3 layout-auto
Pesquisar Ler registros relacionados
Processo de aprovação ✓ µ ✓ µ
Atribuição ✓ µ ✓ µ
Registro de Cobrança ✓ µ
Taxa de faturamento ✓ µ
Empresa ✓ µ ✓ µ
Documento ✓ µ ✓ µ
Pasta de documento ✓ µ ✓ µ
Versão do Documento ✓ µ
Despesa ✓ µ
Tipo de Despesa ✓ µ
Grupo ✓ µ ✓ µ
Hora ✓ µ
Tipo de hora ✓ µ
Problema ✓ µ ✓ µ
Iteração ✓ µ
Função no trabalho ✓ µ
Entrada no Relatório ✓ µ
Etapa ✓ µ
Caminho de Etapas ✓ µ
Nota ✓ µ
Etiqueta de nota ✓ µ
Portfólio ✓ µ ✓ µ
Programa ✓ µ
Projeto ✓ µ ✓ µ
Usuário de Projeto ✓ µ
Tempo reservado* ✓ µ
Risco ✓ µ
Tipo de Risco ✓ µ
Aprovador da etapa ✓ µ
Tarefa ✓ µ ✓ µ
Equipe ✓ µ
Modelo ✓ µ
Modelo de Tarefa ✓ µ
Planilha de horas ✓ µ ✓ µ
Usuário ✓ µ ✓ µ
Delegação de usuários ✓ µ

Recomendamos que você verifique novamente para garantir que isso funcione da maneira esperada.

Filtros de assinatura de evento na Workfront > Assistir a eventos módulos

NOTE
É altamente recomendável usar os filtros de assinatura de evento na Assistir a eventos módulos.

A variável Workfront Assistir a eventos O módulo aciona cenários com base em um webhook que cria uma assinatura de evento no Workfront API. A assinatura do evento é um conjunto de dados que determina quais eventos são enviados para o webhook. Por exemplo, se você configurar um Assistir a eventos que está observando problemas, a assinatura do evento envia somente eventos relacionados a problemas.

Ao usar filtros de subscrição de eventos, os usuários do Fusion podem criar subscrições de eventos que são mais adequadas para seus casos de uso. Por exemplo, você pode configurar uma assinatura de evento na variável Workfront API para enviar ao webhook somente problemas que estão em um projeto específico, garantindo que o Assistir a eventos O módulo do acionará somente para problemas nesse projeto. A capacidade de criar acionadores mais estreitos melhora o design do cenário ao reduzir o número de acionadores irrelevantes.

Isso é diferente da configuração de um filtro no Workfront Fusion cenário. Sem um filtro de inscrição de evento, seu webhook recebe todos os eventos relacionados ao tipo de objeto selecionado. A maioria desses eventos seria irrelevante para o cenário e deve ser filtrada para que o cenário possa continuar.

Os seguintes operadores estão disponíveis no filtro Workfront > Eventos de observação:

  • Igual

  • Não é igual

  • Maior que

  • Menor que

  • Maior que ou igual a

  • Menor que ou igual a

  • Contém

  • Existe

    • Esse operador não requer um valor e o campo de valor está ausente.
  • Não existe

    • Esse operador não requer um valor e o campo de valor está ausente.
  • Alterado

    • Esse operador não requer um valor e o campo de valor está ausente.
    • Este operador ignora o campo Estado.
    • Ao usar Changed, selecione Somente eventos atualizados no Origem do Registro campo.
IMPORTANT
Não é possível editar filtros em Workfront webhooks. Para configurar filtros diferentes para Workfront assinaturas de evento, remova o webhook atual e crie um novo.
INFO
Exemplo: Considere um cenário que processa novos problemas atribuídos a um usuário específico, Ana.

Filtrar eventos usando um filtro de assinatura de evento (recomendado) filtrar-eventos-usando-um-filtro-de-assinatura-de-evento-(recomendado)

Usando o filtro de eventos, você pode configurar o webhook para acionar o cenário quando um problema for atribuído a Ana quando o problema for criado. Ana tem a ID de usuário b378489d8f7cd3cee0539260720a84b7.
Se forem criados 100 problemas em um dia, mas apenas dois deles forem atribuídos a Ana, o cenário seria executado duas vezes.

Filtrar eventos dentro do cenário (não recomendado) filtrar-eventos-dentro-do-cen%C3%A1rio-(n%C3%A3o-recomendado)

Para filtrar eventos de modo que somente problemas atribuídos a Ana sejam processados, você pode criar um filtro após o Assistir a eventos módulo.
Se 100 edições forem criadas em um dia, mas apenas duas delas forem atribuídas a Ana, o cenário seria executado 100 vezes. 98 das execuções parariam no filtro, mas o módulo de acionamento ainda está consumindo dados e executando operações em todas as execuções.

Para obter mais informações sobre assinaturas de evento, consulte Perguntas frequentes - Assinaturas de eventos.

Para obter mais informações sobre webhooks, consulte Acionadores instantâneos (webhooks) no Adobe Workfront Fusion

Para obter mais informações sobre filtros em cenários, consulte Adicionar um filtro a um cenário no Adobe Workfront Fusion.

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