Módulos do Adobe Workfront

Você pode usar o conector do Adobe Workfront Fusion Adobe Workfront para automatizar seus processos no Workfront. Você também pode conectar o Workfront a outros aplicativos e serviços.

Para obter instruções sobre como criar um cenário, consulte os artigos em Criar cenários: índice do artigo. Para obter informações sobre módulos, consulte os artigos em Módulos: índice do artigo.

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: Qualquer um

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.

note note
NOTE
  • Se sua organização usar o pacote de licenciamento herdado (com base em conectores), ela deverá ter uma licença do Workfront Fusion for Work Automation and Integration para se conectar a aplicativos e serviços de terceiros. O conector do Workfront 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 aplicativo Workfront, contam com a contagem total de cenários de sua organização.

Conectar o Workfront ao Workfront Fusion

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

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

  1. Em qualquer módulo do Adobe Workfront, 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 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 a ID do 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 do cliente.
    Segredo do Cliente Insira o segredo do cliente do Workfront. Isso pode ser encontrado na área Aplicativos OAuth2 da área Configuração no Workfront. Se você não tiver um Segredo do cliente para o aplicativo OAuth2 no Workfront, poderá gerar outro. Para obter instruções, consulte a documentação do Workfront.
    URL de Autenticação

    Isso pode permanecer como o valor padrão, ou você pode inserir a URL da sua instância do Workfront, seguida 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.

    Se você não estiver conectado ao Workfront, 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 da Workfront, você deve criar um aplicativo OAuth2 nesse ambiente e usar a ID do cliente e o Segredo do cliente gerados por esse aplicativo em sua conexão.

Módulos do Workfront 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

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.
  • Os códigos de status HTTP 429 do Adobe Workfront não devem causar desativações, mas acionar uma pausa de execução curta no cenário.

Acionadores

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 da caixa Webhook.

  2. Configure o webhook na caixa Adicionar um gancho que é exibida.

    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 Insira um nome para o webhook
    Conexão Para obter instruções sobre como conectar seu aplicativo Workfront ao Workfront Fusion, consulte Conectar o Workfront ao Workfront Fusion neste artigo.
    Tipo de Registro Selecione o tipo de registro Workfront que você deseja que o módulo assista.
    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.

      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

      Acione um cenário quando o registro alterar 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 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 nos módulos do Workfront > 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.

    OBSERVAÇÃO: o tipo de registro Assignment não inclui essa opção.

    Origem do Registro

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

    OBSERVAÇÃO: se você escolher Registros novos e atualizados, a criação do webhook criará duas assinaturas de evento (para o mesmo endereço do 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 cargas de evento no artigo API de assinatura de evento na documentação do Workfront.

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

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 aplicativo Workfront ao Workfront Fusion, consulte Conectar o Workfront ao Workfront Fusion neste artigo.
Tipo de Registro

Selecione o tipo de registro Workfront 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 o administrador do Workfront configurou para rastreamento.
Saídas Selecione os campos de objeto que você 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 tipos de objetos do Workfront para os quais você pode usar este módulo em tipos de objetos do Workfront disponíveis para cada módulo do Workfront.

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 desde a última vez que o cenário foi executado 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 6-row-2 7-row-2 layout-auto html-authored no-header
Conexão Para obter instruções sobre como conectar seu aplicativo Workfront ao Workfront Fusion, consulte Conectar o Workfront ao Workfront Fusion neste artigo.
Filtro Escolha se deseja que o cenário observe Somente Novos Registros, Somente Registros Atualizados ou Registros Novos e Atualizados.
Tipo de Registro

Selecione o tipo de registro Workfront 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 os campos que você deseja incluir no pacote de saída deste módulo.
Referência Selecione os campos de referência que você deseja incluir no pacote de saída deste módulo.
Saídas Selecione os campos de coleção que você 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 tipos de objetos do Workfront para os quais você pode usar este módulo em tipos de objetos do Workfront disponíveis para cada módulo do Workfront.

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
note note
NOTE
A partir de julho de 2024, formulários personalizados poderão ser incluídos ao converter um objeto.
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
Conexão Para obter instruções sobre como conectar seu aplicativo Workfront ao Workfront Fusion, consulte Conectar o Workfront ao 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.
<Objeto> 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.
Copiar campos nativos Ative esta opção para copiar quaisquer campos nativos do objeto original para o novo objeto.
Copiar formulários personalizados Ative esta opção para copiar quaisquer campos nativos do objeto original para o novo objeto.
Criar um registro

Esse módulo de ação cria um objeto, como um projeto, tarefa ou problema no Workfront, e 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.

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.

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 aplicativo Workfront ao Workfront Fusion, consulte Conectar o Workfront ao Workfront Fusion neste artigo.
Tipo de Registro

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

Por exemplo, se você deseja criar um projeto, selecione Project na lista suspensa.

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. Em seguida, você pode inserir ou mapear dados nesses campos.

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

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

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

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 um objeto Nota (Comentário ou resposta), você pode usar as marcas HTML no campo Texto da Nota para criar rich text, como negrito ou itálico.
note note
NOTE
Os usuários são criados com os status Desativado e Aprovação pendente. Se sua organização tiver migrado para a Adobe Admin Console e o selo Aprovação pendente não for removido em alguns minutos, você poderá aprovar o usuário.
  • Resolver usuários individuais

    code language-none
    Você pode resolver usuários individuais na lista Usuários.
    
  • Resolver usuários adicionados em um lote grande

    Para resolver usuários que foram adicionados em um lote grande, é possível adicionar o lote de usuários diretamente ao Adobe Admin Console.

    Para obter instruções, consulte Gerenciar vários usuários | Upload em massa de CSV na documentação do Adobe.

Criar Registro (Herdado)
note important
IMPORTANT
Esse módulo foi substituído pelo módulo Criar um registro. Recomendamos o uso desse módulo em novos cenários.
​>Os cenários existentes que usam esse módulo continuarão a funcionar conforme esperado. Este módulo será removido do seletor de módulos em maio de 2025.

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.

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.

Esse módulo não anexa formulários personalizados ao criar o objeto. Para anexar formulários personalizados ao criar um objeto, use o módulo Criar um registro (anexando formulários personalizados).

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

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 aplicativo Workfront ao Workfront Fusion, consulte Conectar o Workfront ao Workfront Fusion neste artigo.
Tipo de Registro

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

Por exemplo, se você deseja criar um projeto, selecione Project na lista suspensa.

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 tipos de objetos do Workfront para os quais você pode usar este módulo em tipos de objetos do Workfront disponíveis para cada módulo do Workfront.

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 um objeto Nota (Comentário ou resposta), você pode usar as marcas HTML no campo Texto da Nota para criar rich text, como negrito ou itálico.
Chamada de API personalizada

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

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

  • Código de Status (número): indica o sucesso ou a falha da 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, você poderá receber 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 aplicativo Workfront ao Workfront Fusion, consulte Conectar o Workfront ao 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 da API do Workfront 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 no 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 documentação do Workfront. Se sua Chamada de API personalizada retornar um Erro de solicitação HTTP 422, tente usar um cabeçalho "Content-Type":"text/plain".

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.

Observação:

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

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

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 4-row-2 layout-auto html-authored no-header
Conexão Para obter instruções sobre como conectar seu aplicativo Workfront ao Workfront Fusion, consulte Conectar o Workfront ao Workfront Fusion neste artigo.
Forçar exclusão Ative essa opção para garantir que o registro seja excluído, mesmo que a interface do usuário do Workfront solicite a confirmação da exclusão.
Exclusão assíncrona Ative essa opção para permitir que o módulo seja excluído de forma assíncrona.
ID

Insira o identificador exclusivo do Workfront do registro que você deseja que o módulo exclua.

Para obter a ID, abra o objeto do Workfront em seu 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 registro Workfront que você deseja que o módulo exclua.

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

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 aplicativo Workfront ao Workfront Fusion, consulte Conectar o Workfront ao Workfront Fusion neste artigo.
ID de Documento

Mapeie ou insira manualmente a ID exclusiva do Workfront do documento do qual você deseja que o módulo seja baixado.

Para obter a ID, abra o objeto do Workfront em seu 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 tipos de objetos do Workfront para os quais você pode usar este módulo em tipos de objetos do Workfront disponíveis para cada módulo do Workfront.

Ações diversas

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

note note
NOTE
A partir de julho de 2024, a ação convertToProject inclui o campo copyCategories. Quando definido como TRUE, todos os formulários personalizados serão incluídos no projeto para o qual o problema é convertido.

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 aplicativo Workfront ao Workfront Fusion, consulte Conectar o Workfront ao Workfront Fusion neste artigo.
Tipo de Registro Selecione o tipo de registro do Workfront 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 Projeto para o Tipo de Registro e Anexar Modelo para a Ação) exigem informações adicionais (como uma ID de Objeto e uma ID de Modelo).

Para opções disponíveis para algumas ações, consulte Opções de ações diversas neste artigo.

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

Observação: o site de documentação do desenvolvedor inclui informações somente 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 na página da documentação do desenvolvedor do Workfront. 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.

Observação:

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

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

ID

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

Para obter a ID, abra o objeto do Workfront em seu 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 tipos de objetos do Workfront para os quais você pode usar este módulo em tipos de objetos do Workfront disponíveis para cada módulo do Workfront.

Opções de ação diversas

Tarefa
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored
Ação Opções
Copiar
  • clearApprovers

  • clearAssignments

  • clearConstraints

  • clearCustomData

  • clearDocuments

  • clearExpenses

  • clearFinancials

    Limpa dados financeiros

  • clearPermissions

  • clearPredecessors

  • clearProgress

  • clearTimedNotifications

    Limpa as notificações de lembrete

Mover
  • clearApprovers

  • clearAssignments

  • clearDocuments

  • clearConstraints

  • clearExpenses

  • clearFinancials

    Limpa dados financeiros

  • clearPermissions

  • clearPredecessors

  • clearProgress

  • clearTimedNotifications

    Limpa as notificações de lembrete

Problema
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored
Ação Opções
Copiar
  • clearApprovers
  • clearAssignments
  • clearCustomData
  • clearDocuments
  • clearPermissions
  • clearProgress
Converter em tarefa
  • preserveIssue

    Conservar o problema original e vincular a sua resolução a esta tarefa

  • preservePrimaryContact

    Permitir que o contato primário do problema acesse esta tarefa

  • preserveCompletionDate

    Manter a data de conclusão planejada do problema

Converter em projeto
  • preserveIssue

    Conservar o problema original e vincular a sua resolução a esta tarefa

  • preservePrimaryContact

    Permitir que o contato primário do problema acesse esta tarefa

Projeto
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored
Ação Opções
Copiar
  • clearApprovers

  • clearAssignments

  • clearCustomData

  • clearDocuments

  • clearExpenses

  • clearFinancials

    Limpa dados financeiros

  • clearPermissions

  • clearPredecessors

  • clearProgress

  • clearTimedNotifications

    Limpa as notificações de lembrete

Anexar modelo / Salvar como modelo
  • clearApprovers

  • clearAssignments

  • clearBillingRates

  • clearConstraints

  • clearDeliverables

    Limpa metas

  • clearDocuments

  • clearExpenses

  • clearFinancials

    Limpa dados financeiros

  • clearHourTypes

  • clearIssueSetup

    Limpa as propriedades da fila e a configuração de problemas

  • clearPredecessors

  • clearRisks

  • clearSharingOptions

  • clearTimedNotifications

    Limpa as notificações de lembrete

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 de saída especificados.

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 aplicativo Workfront ao Workfront Fusion, consulte Conectar o Workfront ao Workfront Fusion neste artigo.
Tipo de Registro Escolha o tipo de objeto do Workfront 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.
Formulário Personalizado de Saída Selecione os formulários personalizados que deseja incluir no pacote de saída para este módulo e selecione os campos específicos desses formulários personalizados que deseja incluir na saída.
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 identificador exclusivo do Workfront do registro que você deseja que o módulo leia.

Para obter a ID, abra o objeto do Workfront em seu 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 tipos de objetos do Workfront para os quais você pode usar este módulo em tipos de objetos do Workfront disponíveis para cada módulo do Workfront.

Ler um Registro (Herdado)
note important
IMPORTANT
Esse módulo foi substituído pelo módulo Ler um registro. Recomendamos o uso desse módulo em novos cenários.
​>Os cenários existentes que usam esse módulo continuarão a funcionar conforme esperado. Este módulo será removido do seletor de módulos em maio de 2025.

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 de saída especificados.

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 aplicativo Workfront ao Workfront Fusion, consulte Conectar o Workfront ao Workfront Fusion neste artigo.
Tipo de Registro Escolha o tipo de objeto do Workfront 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 identificador exclusivo do Workfront do registro que você deseja que o módulo leia.

Para obter a ID, abra o objeto do Workfront em seu 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 tipos de objetos do Workfront para os quais você pode usar este módulo em tipos de objetos do Workfront disponíveis para cada módulo do Workfront.

Atualizar Versão da Carga dos Eventos

A Workfront lançou recentemente uma nova versão de seu serviço de assinatura de eventos. A nova versão não é uma alteração na API do Workfront, mas uma alteração na funcionalidade de assinatura do evento. Este módulo de ação atualiza a versão de carga útil do evento usada para este cenário.

Para obter mais informações sobre a nova versão de assinatura de eventos, consulte Versão de assinatura de eventos na documentação da Workfront

Para obter recursos sobre como preservar seus cenários do Workfront Fusion durante a atualização da assinatura do evento, incluindo uma gravação de webinário, consulte Preservando seus cenários do Fusion Durante a Atualização da V2 de Assinaturas do Evento.

table 0-row-2 1-row-2 layout-auto html-authored no-header
Conexão Para obter instruções sobre como conectar seu aplicativo Workfront ao Workfront Fusion, consulte Conectar o Workfront ao Workfront Fusion neste artigo.
Versão Selecione a versão da assinatura de evento que deseja usar para essa carga.
Atualizar um 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 4-row-2 layout-auto html-authored no-header
Conexão Para obter instruções sobre como conectar seu aplicativo Workfront ao Workfront Fusion, consulte Conectar o Workfront ao Workfront Fusion neste artigo.
ID

Insira o identificador exclusivo do Workfront do registro que você deseja que o módulo atualize.

Para obter a ID, abra o objeto do Workfront em seu 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 registro Workfront 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. Em seguida, você pode inserir ou mapear dados nesses campos.
Attach Custom Form

Selecione os formulários personalizados que deseja fornecer valores de campo para o novo registro. Após selecionar o formulário, insira os dados dos campos nele contidos.

Para fornecer valores de campo para um formulário que você está anexando neste módulo, inclua a ID de formulário personalizada na seção campos a mapear.

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

note note
NOTE
Ao inserir o texto para um campo personalizado ou um objeto Nota (Comentário ou resposta), você pode usar as marcas HTML no campo Texto da Nota para criar rich text, como negrito ou itálico.
Atualizar Registro (Herdado)
note important
IMPORTANT
Este módulo foi substituído pelo módulo Atualizar um registro. Recomendamos o uso desse módulo em novos cenários.
​>Os cenários existentes que usam esse módulo continuarão a funcionar conforme esperado. Este módulo será removido do seletor de módulos em maio de 2025.

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 aplicativo Workfront ao Workfront Fusion, consulte Conectar o Workfront ao Workfront Fusion neste artigo.
ID

Insira o identificador exclusivo do Workfront do registro que você deseja que o módulo atualize.

Para obter a ID, abra o objeto do Workfront em seu 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 registro Workfront 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. Em seguida, você pode inserir ou mapear dados nesses campos.

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

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 um objeto Nota (Comentário ou resposta), você pode usar as marcas HTML no campo Texto da Nota para criar rich text, como negrito ou itálico.
Carregar documento

Esse módulo de ação faz upload de um documento para um objeto do Workfront, como um projeto, tarefa ou problema. Esse módulo carrega o documento em partes, o que torna o processo de upload mais suave para o Workfront.

Esse módulo pode lidar com arquivos maiores do que o módulo herdado e faz parte de uma implantação em fases para organizações com um pacote Ultimate Workfront.

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 4-row-2 layout-auto html-authored no-header
Conexão Para obter instruções sobre como conectar seu aplicativo Workfront ao Workfront Fusion, consulte Conectar o Workfront ao Workfront Fusion neste artigo.
ID de Registro Relacionado Informe o Workfront ID exclusivo do registro para o qual você deseja fazer upload do documento.
Tipo de Registro Relacionado Selecione o tipo de registro Workfront no qual você deseja que o módulo faça upload do documento.
ID da Pasta Dependendo do tipo de registro relacionado, talvez seja necessário inserir ou mapear uma ID de pasta.
arquivo Source 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 tipos de objetos do Workfront para os quais você pode usar este módulo em tipos de objetos do Workfront disponíveis para cada módulo do Workfront.

Carregar Documento (Herdado)

Esse módulo de ação faz upload de um documento para um objeto do Workfront, como um projeto, tarefa ou problema. Ele carrega o documento inteiro de uma só vez.

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 4-row-2 layout-auto html-authored no-header
Conexão Para obter instruções sobre como conectar seu aplicativo Workfront ao Workfront Fusion, consulte Conectar o Workfront ao Workfront Fusion neste artigo.
ID de Registro Relacionado Informe o Workfront ID exclusivo do registro para o qual você deseja fazer upload do documento.
Tipo de Registro Relacionado Selecione o tipo de registro Workfront no qual você deseja que o módulo faça upload do documento.
ID da Pasta Dependendo do tipo de registro relacionado, talvez seja necessário inserir ou mapear uma ID de pasta.
arquivo Source 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 tipos de objetos do Workfront para os quais você pode usar este módulo em tipos de objetos do Workfront disponíveis para cada módulo do Workfront.

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 aplicativo Workfront ao Workfront Fusion, consulte Conectar o Workfront ao Workfront Fusion neste artigo.
Tipo de Registro

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

Consulte uma lista dos tipos de objetos do Workfront para os quais você pode usar este módulo em Tipos de objetos do Workfront disponíveis para cada módulo do Workfront 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 objeto do Workfront em seu 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

Esse 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 8-row-2 9-row-2 layout-auto html-authored no-header
Conexão Para obter instruções sobre como conectar seu aplicativo Workfront ao Workfront Fusion, consulte Conectar o Workfront ao Workfront Fusion neste artigo.
Tipo de Registro Selecione o tipo de registro Workfront que você deseja que o módulo procure.
Lista de formulários personalizados Selecione pelo menos um formulário personalizado. Os campos desses formulários personalizados estarão disponíveis para a consulta de pesquisa.
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 campos de critérios Selecione os campos que deseja usar com os critérios de pesquisa. Esses campos estarão disponíveis na lista suspensa Search criteria.
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 nos seus critérios de pesquisa. A inclusão de username em uma consulta de API para o Workfront registra o usuário no Workfront e a pesquisa não será bem-sucedida.

Observação: In e NotInfuncionam com matrizes. 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.
Pesquisar (Herdado)
note important
IMPORTANT
Esse módulo foi substituído pelo módulo Search records. Recomendamos o uso desse módulo em novos cenários.
​>Os cenários existentes que usam esse módulo continuarão a funcionar conforme esperado. Este módulo será removido do seletor de módulos em maio de 2025.

Esse 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 8-row-2 layout-auto html-authored no-header
Conexão Para obter instruções sobre como conectar seu aplicativo Workfront ao Workfront Fusion, consulte Conectar o Workfront ao Workfront Fusion neste artigo.
Tipo de Registro Selecione o tipo de registro Workfront 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 campos de critérios Selecione os campos que deseja usar com os critérios de pesquisa. Esses campos estarão disponíveis na lista suspensa Search criteria.
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 nos seus critérios de pesquisa. A inclusão de username em uma consulta de API para o Workfront registra o usuário no Workfront e a pesquisa não será bem-sucedida.

Observação: In e NotInfuncionam com matrizes. 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.

Tipos de objetos do Workfront disponíveis para cada módulo do Workfront

Tipos de objeto disponíveis para cada módulo de gatilho Workfront
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
Hour
Tipo de hora
Problema
Iteração
Função no trabalho
Entrada no Relatório
Marco
Caminho de Etapas
Observação
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
Atualização
Tipos de objetos disponíveis para cada módulo de ação do Workfront
note note
NOTE
O módulo Baixar Documento não está incluído nesta tabela porque os tipos de objeto do Workfront 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 37-row-8 38-row-8 39-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
Linha de base
Registro de Cobrança
Taxa de faturamento
Empresa
Documento
Pasta de documento
Versão do Documento
Taxa de câmbio
Despesa
Tipo de Despesa
Documento externo
Grupo
Hour
Tipo de hora
Problema
Iteração
Função no trabalho
Entrada no Relatório
Marco
Caminho de Etapas
Observação
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
Atualização
Tipos de objeto disponíveis para cada módulo de pesquisa do Workfront
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
Hour
Tipo de hora
Problema
Iteração
Função no trabalho
Entrada no Relatório
Marco
Caminho de Etapas
Observação
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 Eventos módulos

NOTE
  • É altamente recomendável usar filtros de assinatura de evento em seus módulos Assistir Eventos.

  • A Workfront lançou recentemente uma nova versão de seu serviço de assinatura de eventos. A nova versão não é uma alteração na API do Workfront, mas uma alteração na funcionalidade de assinatura do evento. Este módulo de ação atualiza a versão de carga útil do evento usada para este cenário.

    Para obter mais informações sobre a nova versão de assinatura de eventos, consulte Versão de assinatura de eventos na documentação da Workfront

    Para obter recursos sobre como preservar seus cenários do Workfront Fusion durante a atualização da assinatura do evento, incluindo uma gravação de webinário, consulte [Preservando seus cenários do Fusion Durante a Atualização de Assinaturas de Eventos V2(https://experienceleaguecommunities.adobe.com/t5/workfront-discussions/event-follow-up-preserving-your-fusion-scenarios-during-the/td-p/754182?profile.language=pt)].

O módulo Assistir Eventos do Workfront aciona cenários com base em um webhook que cria uma assinatura de evento na API do Workfront. A assinatura do evento é um conjunto de dados que determina quais eventos são enviados para o webhook. Por exemplo, se você configurar um módulo Eventos de observação que esteja observando problemas, a assinatura do evento enviará 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 API do Workfront para enviar somente problemas que estejam em um projeto específico para o webhook, garantindo que o módulo Eventos de observação acionará apenas 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 cenário do Workfront Fusion. 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 campo Origem do Registro.
IMPORTANT
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.
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.
Filtro de eventos
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 módulo Assistir Eventos.
Sem filtro de evento
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 eventos do Workfront, 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.

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