Módulos do Adobe Workfront

Qualquer pacote de fluxo de trabalho do Adobe Workfront e qualquer pacote do Adobe Workfront Automation and Integration

Workfront Ultimate

Os pacotes Workfront Prime e Select, com uma compra adicional do Workfront Fusion.

Padrão

Trabalho ou maior

O conector 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.

• Conectar-se ao Workfront usando a ID do cliente e o segredo do cliente
• Conectar-se ao Workfront usando uma conexão de servidor para servidor

Conectar-se ao Workfront usando a ID do cliente e o segredo do cliente

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 layout-auto html-authored no-header
   Connection type	Selecione Conexão de autenticação do Adobe Workfront.
   Connection name	Insira um nome para a nova conexão.
   Client ID	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 de cliente.
   Client Secret	Insira o segredo do cliente do Workfront. Isso pode ser encontrado na área Aplicativos OAuth2 da área Configuração no Workfront. Se não tiver um segredo do cliente para o aplicativo OAuth2 no Workfront, você poderá gerar outro. Para obter instruções, consulte a documentação do Workfront.
   Authentication URL	Isso pode permanecer como o valor padrão, ou você pode inserir o URL da sua instância do Workfront, seguido por /integrations/oauth2. Exemplo: https://mydomain.my.workfront.com/integrations/oauth2
   Host prefix	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.

Conectar-se ao Workfront usando uma conexão de servidor para servidor

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 7-row-2 layout-auto html-authored no-header
   Connection type	Selecione Conexão de servidor para servidor do Adobe Workfront.
   Connection name	Insira um nome para a nova conexão.
   Instance name	Insira o nome da instância, também conhecido como domínio. Exemplo: se a URL for https://example.my.workfront.com, insira example.
   Instance lane	Insira o tipo de ambiente ao qual esta conexão será feita. Exemplo: se a URL for https://example.my.workfront.com, insira my.
   Client ID	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 de cliente.
   Client Secret	Insira o segredo do cliente do Workfront. Isso pode ser encontrado na área Aplicativos OAuth2 da área Configuração no Workfront. Se não tiver um segredo do cliente para o aplicativo OAuth2 no Workfront, você poderá gerar outro. Para obter instruções, consulte a documentação do Workfront.
   Scopes	Insira todos os escopos aplicáveis para esta conexão.
   Host prefix	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.

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, podem ser exibidos campos adicionais do Workfront, dependendo de fatores como nível de acesso no aplicativo ou serviço. Um título em negrito em um módulo indica um campo obrigatório.

Se você vir o botão de mapa acima de um campo ou função, poderá usá-lo para definir variáveis e funções para esse campo. Para obter mais informações, consulte Mapear informações de um módulo para outro.

• Triggers
• Ações
• Pesquisas

Acionadores

Selecione o tipo de registro do Workfront que o módulo deve monitorar.

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

Selecione o tipo de registro do Workfront que o módulo deve monitorar.

Por exemplo, se desejar iniciar o cenário sempre que um novo projeto for criado, selecione Project

Insira a ID do objeto.

Observação: ao informar a ID de um objeto, é possível começar digitando o nome do objeto e, em seguida, selecioná-lo na lista. Em seguida, o módulo insere a ID adequada no campo.

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

Observação: ao informar a ID de um objeto, é possível começar digitando o nome do objeto e, em seguida, selecioná-lo na lista. Em seguida, o módulo insere a ID adequada no campo.

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

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

Selecione os campos que deseja disponibilizar para entrada de dados. Dessa forma, você pode 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 Attach Custom Form.

• Ao inserir a ID de um objeto, você pode começar a digitar o nome do objeto e, em seguida, selecioná-lo na lista. Em seguida, o módulo insere a ID adequada no campo.
• Ao inserir o texto para um campo personalizado ou um objeto Nota (Comentário ou resposta), você pode usar as tags HTML no campo Texto da nota para criar rich text, como texto em negrito ou itálico.

• Resolver usuários individuais

  code language-none
  É possível resolver usuários individuais na lista Usuários.

• Resolver usuários adicionados em um lote grande

  Para resolver os 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 da Adobe.

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"}

Nota: se você estiver recebendo erros e for difícil determinar a origem deles, considere modificar os 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".

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

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

Dica: é recomendável enviar informações por meio do corpo do JSON, em vez de como parâmetros de consulta.

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

Observação:

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

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

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

1. Exclua o registro de forma síncrona.
2. Adicione a manipulação de erros ao módulo Excluir registro para ignorar o erro causado pelo tempo-limite de 40 segundos.

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 no navegador e copie o texto no final do URL após "ID=". Por exemplo: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

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 Record Type e Attach Template para Action) requerem 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 para desenvolvedor inclui informações somente até a API versão 14, mas ainda contém informações valiosas para chamadas de API.

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

   • Projects

   • Tasks

   • Issues

   • Users

   • Documents

   Para todos os outros tipos de registro, selecione Other objects and endpoints e localize o tipo de registro nas páginas classificadas alfabeticamente.

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

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 do Workfront, 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 do Workfront (que este módulo usa), consulte Adicionar opções de prova avançadas ao criar uma prova por meio da API do Adobe Workfront

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

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

• clearApprovers

• clearAssignments

• clearConstraints

• clearCustomData

• clearDocuments

• clearExpenses

• clearFinancials

  Limpa dados financeiros

• clearPermissions

• clearPredecessors

• clearProgress

• clearTimedNotifications

  Limpa notificações de lembrete

• clearApprovers

• clearAssignments

• clearDocuments

• clearConstraints

• clearExpenses

• clearFinancials

  Limpa dados financeiros

• clearPermissions

• clearPredecessors

• clearProgress

• clearTimedNotifications

  Limpa notificações de lembrete

• clearApprovers
• clearAssignments
• clearCustomData
• clearDocuments
• clearPermissions
• clearProgress

• preserveIssue

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

• preservePrimaryContact

  Permitir o acesso do contato primário do problema a esta tarefa

• preserveCompletionDate

  Manter a data de conclusão planejada do problema

• preserveIssue

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

• preservePrimaryContact

  Permitir o acesso do contato primário do problema a esta tarefa

• clearApprovers

• clearAssignments

• clearCustomData

• clearDocuments

• clearExpenses

• clearFinancials

  Limpa dados financeiros

• clearPermissions

• clearPredecessors

• clearProgress

• clearTimedNotifications

  Limpa notificações de lembrete

• clearApprovers

• clearAssignments

• clearBillingRates

• clearConstraints

• clearDeliverables

  Limpa metas

• clearDocuments

• clearExpenses

• clearFinancials

  Limpa dados financeiros

• clearHourTypes

• clearIssueSetup

  Limpa propriedades da fila e configuração de problemas

• clearPredecessors

• clearRisks

• clearSharingOptions

• clearTimedNotifications

  Limpa notificações de lembrete

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

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

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

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

Selecione os formulários personalizados para os quais você deseja fornecer valores de campo no novo registro. Após selecionar o formulário, insira os dados dos campos nesse formulário.

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

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

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

Insira ou mapeie a ID do registro principal cujos registros associados você deseja ler.

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

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

Observação: não use username em seus critérios de pesquisa. 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 NotIntrabalham com matrizes. As entradas devem estar em formato de matriz.

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

Observação: não use username em seus critérios de pesquisa. 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 NotIntrabalham com matrizes. As entradas devem estar em formato de matriz.