Adobe Workfront módulos

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

O conector Workfront não conta com o número de aplicativos ativos disponíveis para a 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.

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

Se você precisar de instruções sobre como criar um cenário, consulte Criar um cenário Adobe Workfront Fusion. Para obter informações sobre módulos, consulte Módulos em 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: nenhum requisito de licença Workfront Fusion.

Ou

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

Produto

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

Ou

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

Para saber que plano, tipo de licença ou acesso você tem, contate o administrador do Workfront.

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

Conectar Workfront a Workfront Fusion

O conector Workfront usa OAuth 2.0 para se conectar a 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 sua ID de 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 sua ID de 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.
    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.

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 em Adobe Workfront

  • As conexões OAuth 2.0 para a API Workfront não dependem mais das chaves de API.

Workfront módulos e seus campos

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

  2. Configure o webhook na caixa 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 aplicativo Workfront ao Workfront Fusion, consulte Conectar 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 Workfront existentes. Para configurar filtros diferentes para assinaturas de evento 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 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 Atribuição não inclui essa opção.

    Origem do Registro

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

    Observação: se você escolher Registros novos e atualizados, a criação do webhook criará 2 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 Workfront artigo de ajuda API de assinatura de evento.

Veja uma lista dos Workfront tipos de objetos para os quais você pode usar este módulo em Workfront tipos de objetos 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 aplicativo Workfront ao Workfront Fusion, consulte Conectar 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 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 objetos para os quais você pode usar este módulo em Workfront tipos de objetos 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 aplicativo Workfront ao Workfront Fusion, consulte Conectar Workfront ao Workfront Fusion neste artigo.
Filtro Escolha se deseja que o cenário assista a Novos Registros Somente, Registros Atualizados Somente ou Registros Novos e Atualizados.
Tipo de Registro

(É exibido depois que você escolhe um Filtro.) 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 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 objetos para os quais você pode usar este módulo em Workfront tipos de objetos 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 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 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 (anexar formulários personalizados)

Este módulo de ação cria um objeto, como um projeto, tarefa ou problema no Workfront, e permite que você adicione 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ê poderia usar este módulo, por exemplo, para criar uma tarefa em Workfront quando um cliente adiciona uma nova linha em uma lista Google Sheets 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 aplicativo Workfront ao Workfront Fusion, consulte Conectar Workfront ao Workfront Fusion neste artigo.
Tipo de Registro

Selecione o tipo de registro Workfront 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 campo Anexar Formulário Personalizado.

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

    Para obter mais informações sobre rich text em atualizações, consulte Adicionar uma atualização a um item de trabalho em 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ê poderia usar este 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 aplicativo Workfront ao Workfront Fusion, consulte Conectar Workfront ao Workfront Fusion neste artigo.
Tipo de Registro

Selecione o tipo de registro Workfront 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 objetos para os quais você pode usar este módulo em Workfront tipos de objetos 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 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.

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

Chamada de API personalizada

Este módulo de ação permite fazer uma chamada autenticada personalizada para a API 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 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 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 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 documentação 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.

Nota:

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

Veja uma lista dos Workfront tipos de objetos para os quais você pode usar este módulo em Workfront tipos de objetos 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 aplicativo Workfront ao Workfront Fusion, consulte Conectar Workfront ao Workfront Fusion neste artigo.
Forçar exclusão Habilite esta opção para garantir que o registro seja excluído, mesmo que a interface do usuário do Workfront solicite confirmação da exclusão.
ID

Insira a ID Workfront exclusiva do registro que você deseja que o módulo exclua.

Para obter a ID, abra o objeto Workfront no navegador e copie o texto no final da 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 Workfront tipos de objetos para os quais você pode usar este módulo em Workfront tipos de objetos 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 aplicativo Workfront ao Workfront Fusion, consulte Conectar Workfront ao Workfront Fusion neste artigo.
ID de Documento

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

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

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

Ações diversas

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 aplicativo Workfront ao Workfront Fusion, consulte Conectar Workfront ao Workfront Fusion neste artigo.
Tipo de Registro Selecione o tipo de registro 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 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 de documentação do desenvolvedor 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.

Nota:

Ao criar uma prova por meio do módulo Workfront Misc Action, a prática recomendada é criar uma prova sem nenhuma opção avançada e, em seguida, atualizar a prova usando a API 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 ID exclusiva Workfront do registro com a qual você deseja que o módulo interaja.

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

Veja uma lista dos Workfront tipos de objetos para os quais você pode usar este módulo em Workfront tipos de objetos 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 aplicativo Workfront ao Workfront Fusion, consulte Conectar Workfront ao Workfront Fusion neste artigo.
Tipo de Registro Escolha o tipo de objeto 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 a ID Workfront exclusiva do registro que você deseja que o módulo leia.

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

Veja uma lista dos Workfront tipos de objetos para os quais você pode usar este módulo em Workfront tipos de objetos 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 aplicativo Workfront ao Workfront Fusion, consulte Conectar Workfront ao Workfront Fusion neste artigo.
ID

Insira a ID Workfront exclusiva do registro que você deseja que o módulo atualize.

Para obter a ID, abra o objeto Workfront no navegador e copie o texto no final da 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.

Veja uma lista dos Workfront tipos de objetos para os quais você pode usar este módulo em Workfront tipos de objetos 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 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.

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

Carregar documento

Este módulo de ação carrega um documento para um objeto 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 aplicativo Workfront ao Workfront Fusion, consulte Conectar Workfront ao Workfront Fusion neste artigo.
ID de Registro Relacionado Insira a ID Workfront exclusiva do registro para o qual você deseja carregar o documento.
Tipo de Registro Relacionado Selecione o tipo de registro Workfront no qual você deseja que o módulo carregue o documento.
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 Workfront tipos de objetos para os quais você pode usar este módulo em Workfront tipos de objetos 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 aplicativo Workfront ao Workfront Fusion, consulte Conectar 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 Workfront tipos de objetos para os quais você pode usar este módulo em Workfront tipos de objetos 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 objeto Workfront no navegador e copie o texto no final da 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 em 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 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 Workfront faz com que o usuário entre 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)

Este módulo de pesquisa procura registros em um objeto em 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 aplicativo Workfront ao Workfront Fusion, consulte Conectar 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 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 Workfront faz com que o usuário entre 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.

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

Workfront tipos de objetos disponíveis para cada módulo 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 ✓ µ ✓ µ
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 módulo de ação Workfront
note note
NOTE
O módulo Baixar Documento não está incluído nesta tabela porque os tipos de objeto 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 ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ ✓ µ
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 nos módulos Workfront > Eventos de observação

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

O módulo Workfront Assistir Eventos aciona cenários com base em um webhook que cria uma assinatura de evento na API 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 Workfront para enviar ao webhook somente problemas que estão em um projeto específico, garantindo que o módulo Assistir Eventos acionará problemas somente 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 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 Workfront existentes. Para configurar filtros diferentes para assinaturas de evento 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.
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.
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, consulte Perguntas frequentes - Assinaturas de Eventos.

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

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

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