Módulos do Adobe Workfront Planning

Com os módulos Adobe Workfront Planning, é possível acionar um cenário quando os eventos ocorrem no Workfront Planning. Você também pode criar, ler, atualizar e excluir registros ou executar uma chamada de API personalizada para sua conta do Adobe Workfront Planning.

Requisitos de acesso

Expanda para visualizar os requisitos de acesso da funcionalidade neste artigo.
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Pacote do Adobe Workfront

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

Workfront Ultimate

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

Licenças do Adobe Workfront

Padrão

Trabalho ou maior

Produto Se sua organização tiver um pacote Workfront Select ou Prime, ele não inclui o Workfront Automation and Integration. É necessário comprar o Adobe Workfront Fusion.

Para obter mais detalhes sobre as informações contidas nesta tabela, consulte Requisitos de acesso na documentação.

Pré-requisitos

Para acessar o Workfront Planning, é necessário ter o seguinte:

  • Um novo pacote e licença do Workfront. O Workfront Planning não está disponível para pacotes ou licenças herdadas do Workfront.
  • Um pacote do Workfront Planning.
  • A instância da Workfront de sua organização deve ser integrada à Adobe Unified Experience.

Informações da API do Adobe Workfront Planning

O conector do Adobe Workfront Planning usa o seguinte:

URL básica
code language-none
https://{{connection.host}}/maestro/api/{{common.maestroApiVersion}}/
Tag da API
v1.13.7

Conectar o Workfront Planning ao Workfront Fusion

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

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

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

  1. Em qualquer módulo do Adobe Workfront Planning, 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 a conexão 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 Planning, 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 do Workfront, crie um aplicativo OAuth2 nesse ambiente e use a ID do cliente e o segredo do cliente gerados por esse aplicativo em sua conexão.

Conectar-se ao Workfront Planning usando uma conexão Servidor a Servidor

  1. Em qualquer módulo do Adobe Workfront Planning, 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 Planning, 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 do Workfront, crie um aplicativo OAuth2 nesse ambiente e use a ID do cliente e o segredo do cliente gerados por esse aplicativo em sua conexão.

Adobe Workfront Planning módulos da versão 2 e seus campos

IMPORTANT
Os módulos desta seção pertencem ao conector do Workfront Planning V2.Para módulos no conector do Workfront Planning V1, consulte Adobe Workfront Planning Módulos da Versão 1 e seus campos.

Ao configurar módulos do Workfront Planning, 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.

Espaços De Trabalho (V2)

Criar um espaço de trabalho (V2)

Este módulo de ação cria um novo espaço de trabalho no Planning.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Workspace name
Insira ou mapeie um nome para o novo espaço de trabalho.
Descrição
Insira ou mapeie uma descrição para o novo espaço de trabalho/td>
Cor
Selecione a cor que deseja usar para representar o novo tipo de registro
Ícone
Mapeie o ícone que você deseja usar para este tipo de registro.
Proprietário
Insira ou mapeie a ID de usuário do Adobe IMS do usuário que você deseja que seja o proprietário do espaço de trabalho.

Excluir um espaço de trabalho (V2)

Este módulo de ação exclui um único espaço de trabalho, especificado pela ID.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Workspace ID
Insira ou mapeie a ID do espaço de trabalho que deseja excluir.

Obter todos os espaços de trabalho (V2)

Este módulo recupera uma lista de todos os espaços de trabalho.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Número máximo de workspaces retornados
Insira ou mapeie o número máximo de espaços de trabalho que o módulo retornará durante um ciclo de execução.

Obter um espaço de trabalho (V2)

Este módulo recupera um espaço de trabalho pela respectiva ID.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Workspace ID
Insira ou mapeie a ID do espaço de trabalho que você deseja recuperar.

Atualizar um espaço de trabalho (V2)

Este módulo de ação atualiza um novo espaço de trabalho no Planning.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Espaço de trabalho
Selecione o espaço de trabalho que deseja atualizar.
Workspace name
Insira ou mapeie um nome para o novo espaço de trabalho.
Descrição
Insira ou mapeie uma descrição para o novo espaço de trabalho/td>
Cor
Selecione a cor que deseja usar para representar o novo tipo de registro
Ícone
Mapeie o ícone que você deseja usar para este tipo de registro.
Proprietário
Insira ou mapeie a ID de usuário do Adobe IMS do usuário que você deseja que seja o proprietário do espaço de trabalho.
Seções de tipo de registro
Para cada seção de tipo de registro que você deseja adicionar a este espaço de trabalho, clique em Adicionar item e insira o nome da seção, as IDs de tipo de registro e se deseja substituir as IDs de tipo de registro existentes.
Seções do tipo de registro > Substituir
Selecione se as seções existentes devem ser substituídas pelas do módulo. Se não, as seções do módulo serão adicionadas à lista de seções existente.

Tipos de registro (V2)

Criar um tipo de registro (V2)

Este módulo de ação cria um novo tipo de registro no espaço de trabalho selecionado.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Espaço de trabalho
Selecione o espaço de trabalho onde deseja criar um tipo de registro.
Nome de exibição
Insira ou mapeie um nome para o novo tipo de registro.
Descrição
Insira ou mapeie uma descrição para o novo tipo de registro.
Ícone
Mapeie o ícone que você deseja usar para este tipo de registro.
Cor
Selecione a cor que deseja usar para representar o novo tipo de registro
Tipo de registro do Source
Se você estiver usando outro tipo de registro para copiar como ponto de partida, selecione esse tipo de registro.

Excluir um tipo de registro (V2)

Esse módulo de ação exclui um único tipo de registro, especificado pela ID.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
ID de tipo de registro
Informe ou mapeie a ID do tipo de registro que deseja deletar.

Obter tipos de registro global (V2)

Este módulo recupera uma lista de tipos de registros em uma conta do Adobe Workfront Planning.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Espaço de trabalho
Selecione um espaço de trabalho. O módulo retornará os tipos de registro global que estão disponíveis para adicionar a este espaço de trabalho.
Número máximo de tipos de registros retornados
Insira ou mapeie o número máximo de tipos de registros que o módulo retornará durante um ciclo de execução.

Obter um tipo de registro (V2)

Este módulo recupera um tipo de registro por sua ID.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
ID de tipo de registro
Insira ou mapeie a ID do tipo de registro que você deseja recuperar.

Obter tipos de registro (V2)

Este módulo recupera uma lista de tipos de registros disponíveis em um determinado espaço de trabalho.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Espaço de trabalho
Selecione o espaço de trabalho para o qual deseja recuperar tipos de registro.
Número máximo de tipos de registros retornados
Insira ou mapeie o número máximo de tipos de registros que o módulo retornará durante um ciclo de execução.

Atualizar um tipo de registro (V2)

Este módulo atualiza um tipo de registro.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Espaço de trabalho
Selecione o espaço de trabalho no qual deseja atualizar um tipo de registro.
Record type
Selecione o espaço de trabalho no qual deseja atualizar um tipo de registro.
Nome de exibição
Insira ou mapeie um nome para o tipo de registro.
Descrição
Insira ou mapeie uma descrição para o tipo de registro.
ID do campo primário
Insira ou mapeie a ID do campo usado como o título do tipo de registro.
Ícone
Mapeie o ícone que você deseja usar para este tipo de registro.
Cor
Selecione a cor que deseja usar para representar o novo tipo de registro
Vinculável a Workspace IDs
Para cada espaço de trabalho ao qual você deseja que esse tipo de registro possa se vincular, clique em Adicionar item e insira a ID do espaço de trabalho.
Vinculável a Workspace IDs > Substituir
Selecione se os espaços de trabalho existentes devem ser substituídos pelos do módulo. Se não, os espaços de trabalho do módulo serão adicionados à lista existente de espaços de trabalho.
Autorizado a criar tipo de registro dinâmico
Para cada assunto autorizado a criar tipos de registro dinâmicos com base neste tipo de registro, clique em Adicionar item e insira o tipo e a ID do assunto.
Autorizado a criar tipo de registro dinâmico > Substituir
Selecione se os assuntos existentes devem ser substituídos pelos assuntos do módulo. Se não, os assuntos do módulo serão adicionados à lista de assuntos existente.

Registros (V2)

Criar um registro (V2)

Essa ação cria um único registro no Workfront Planning.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Espaço de trabalho
Selecione o espaço de trabalho no qual deseja criar um registro.
Record type
Selecione o tipo de registro que deseja criar.
Outros campos
Insira os valores que você deseja que o novo registro tenha. Esses campos são baseados no tipo de registro selecionado e são exclusivos de sua organização do Workfront Planning.

Excluir um registro (V2)

Esse módulo de ação exclui um único registro, especificado pela ID.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
ID de Registro
Insira ou mapeie a ID do registro que deseja excluir.

Obter um registro (V2)

Este módulo de ação recupera um registro, especificado por sua ID.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Workspace ID
Insira ou mapeie a ID do registro que você deseja recuperar.

Obter registros por tipo de registro (V2)

Este módulo recupera uma lista de todos os registros do tipo de registro fornecido.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Espaço de trabalho
Selecione o espaço de trabalho que contém os registros que você deseja recuperar.
Record type
Selecione o tipo de registro que deseja retornar.
Número máximo de registros retornados
Insira ou mapeie o número máximo de registros que o módulo retornará durante um ciclo de execução.

Mover registros (V2)

Este módulo reorganiza um ou mais registros em um tipo de registro especificando onde colocá-los.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Espaço de trabalho
Selecione o espaço de trabalho que contém os registros que você deseja mover.
Record type
Selecione o tipo de registro que deseja mover.
Espaço de trabalho
Selecione o espaço de trabalho que contém os registros que você deseja mover.
Espaço de trabalho
Selecione o espaço de trabalho que contém os registros que você deseja mover.

Pesquisar registros (V2)

Retornar registros com base nos critérios especificados

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Espaço de trabalho
Selecione o espaço de trabalho que contém os registros que você deseja recuperar.
Record type
Selecione o tipo de registro que contém os registros que você deseja recuperar.
Outros campos
Para cada campo que deseja filtrar, insira o operador e o valor desse campo. Esses campos são baseados no tipo de registro selecionado e são exclusivos de sua organização do Workfront Planning.

Atualizar um registro (V2)

Este módulo atualiza o registro especificado.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Espaço de trabalho
Selecione o espaço de trabalho que contém o registro que você deseja atualizar.
ID de tipo de registro
Selecione o tipo de registro que deseja atualizar.
ID de Registro
Insira ou mapeie a ID do registro que você deseja atualizar.
Outros campos
Insira valores para outros campos. Os campos disponíveis dependem do registro selecionado.

Campos (V2)

Criar um campo (V2)

Esse módulo de ação cria um novo campo no tipo de registro especificado.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Espaço de trabalho
Selecione o espaço de trabalho onde deseja criar um campo.
Record type
Selecione o tipo de registro para o qual deseja criar um campo.
Nome de exibição
Insira ou mapeie um nome para o novo campo.
Descrição
Insira ou mapeie uma descrição para o novo campo.
Tipo de campo
Selecione o tipo de dados do campo.
Outros campos
Outros campos específicos para o tipo de campo selecionado podem estar disponíveis. Preencha os valores para esses campos.

Excluir um campo (V2)

Esse módulo de ação exclui um único campo, especificado pela ID.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
ID de Campo
Insira ou mapeie o ID do campo que você deseja excluir.

Obter um campo (V2)

Este módulo recupera um campo por sua ID.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
ID de Campo
Insira ou mapeie a ID do campo que você deseja recuperar.

Obter campos por tipo de registro (V2)

Este módulo recupera uma lista de campos para um tipo de registro específico.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Espaço de trabalho
Selecione o espaço de trabalho que contém os campos que deseja retornar.
Record type
Selecione o tipo de registro para o qual você deseja retornar campos.
Número máximo de campos retornados
Insira ou mapeie o número máximo de campos que o módulo retornará durante um ciclo de execução.

Atualizar um campo (V2)

Este módulo atualiza parcialmente um campo por sua ID.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Tipo de recurso
Selecione o tipo de recurso que contém o campo que você deseja atualizar.
ID de Campo
Selecione o campo que deseja atualizar.
Nome para exibição
Insira ou mapeie um nome para o campo.
Description
Insira ou mapeie uma descrição para o campo.
Outros parâmetros
Insira valores para outros parâmetros de campo. Os parâmetros disponíveis dependem do campo selecionado.

Visualizações (V2)

Criar uma visualização (V2)

Esse módulo de ação cria uma nova exibição para o tipo de registro selecionado.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Espaço de trabalho
Selecione o espaço de trabalho no qual deseja criar uma view.
Record type
Selecione o tipo de registro para o qual deseja criar uma exibição.
Exibir nome
Insira ou mapeie um nome para a nova exibição.
Tipo de visualização
Selecione se a nova exibição é uma exibição de tabela, linha do tempo ou calendário.
Campo de data inicial
Se a exibição for uma exibição de linha do tempo ou calendário, selecione o campo que a exibição usará para colocar o registro na linha do tempo.
Campo de data final.
Se a exibição for uma exibição de linha do tempo ou calendário, selecione o campo que a exibição usará para determinar a data final na linha do tempo.

Excluir um modo de exibição (V2)

Esse módulo de ação exclui uma única visualização, especificada pela ID.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Exibir ID
Informe ou mapeie a ID da view que deseja deletar.

Obter uma visualização (V2)

Este módulo recupera uma visualização por sua ID.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Exibir ID
Informe ou mapeie a ID da view que deseja recuperar.

Obter visualizações por tipo de registro (V2)

Esse módulo recupera uma lista de exibições para o tipo de registro específico.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Espaço de trabalho
Selecione o espaço de trabalho que contém as views que você deseja recuperar.
Record type
Selecione o tipo de registro que contém as exibições que você deseja recuperar.
Número máximo de exibições retornadas
Insira ou mapeie o número máximo de exibições que o módulo retornará durante um ciclo de execução.

Atualizar uma visualização (V2)

Este módulo de ação atualiza a exibição especificada.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Espaço de trabalho
Selecione o espaço de trabalho no qual deseja atualizar uma view.
Record type
Selecione o tipo de registro para o qual você deseja atualizar uma exibição.
ID da Visualização
Selecione a view que deseja atualizar.
Exibir nome
Insira ou mapeie um nome para a nova exibição.

Permissões (V2)

Ignorar solicitações de acesso (V2)

Este módulo de ação ignora uma ou mais solicitações de acesso, especificadas pela ID.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Tipo de recurso
Insira ou mapeie a ID da Workspace que deseja excluir.
ID de Recurso
Insira ou mapeie a ID do recurso para o qual você deseja descartar solicitações de acesso.
IDs de Solicitação
Para cada solicitação de acesso que você deseja ignorar, clique em Adicionar item e insira a ID da solicitação.

Obter todos os membros e suas funções para um recurso (V2)

Este módulo lista todos os usuários, grupos e equipes que têm uma relação de compartilhamento explícita no recurso. As credenciais usadas na conexão para este módulo devem ter a permissão Gerenciar no recurso.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Tipo de recurso
Selecione o tipo de recurso para o qual deseja recuperar informações.
ID de Recurso
Insira ou mapeie a ID do recurso para o qual deseja recuperar informações.

Obter as permissões efetivas do usuário atual em um recurso (V2)

Este módulo retorna a visualização, edição, exclusão e adição de permissões do usuário atual para um determinado recurso.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Tipo de recurso
Selecione o tipo de recurso para o qual deseja recuperar permissões.
ID de Recurso
Insira ou mapeie a ID do recurso para o qual deseja recuperar permissões.

Listar solicitações de acesso pendentes para um recurso (V2)

Este módulo retorna todas as solicitações de acesso pendentes para o recurso fornecido.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Tipo de recurso
Selecione o tipo de recurso para o qual deseja recuperar informações.
ID de Recurso
Insira ou mapeie a ID do recurso para o qual deseja recuperar informações.

Solicitar acesso a um recurso (V2)

Este módulo cria ou atualiza uma solicitação de acesso para o usuário atual no recurso fornecido.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Tipo de recurso
Selecione o tipo de recurso para o qual deseja criar ou atualizar uma solicitação de acesso.
ID de Recurso
Insira ou mapeie a ID do recurso para o qual você deseja criar ou atualizar uma solicitação de acesso.
Mensagem
Insira ou mapeie o texto de uma mensagem que você deseja incluir na solicitação de acesso.

Outro (V2)

Obter ID de autenticação da Workfront ID (V2)

Esse módulo pega uma ID de usuário do Workfront e retorna a ID de autorização correspondente que o Planning usa.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
ID de Usuário do Workfront
Insira ou mapeie a Workfront ID do usuário para o qual você deseja recuperar uma ID de autorização.

Fazer uma chamada de API personalizada (V2)<table

Este módulo faz uma chamada personalizada para a API do Workfront Planning.

Connection
Para obter instruções sobre como conectar seu aplicativo Workfront ao Fusion, consulte Conectar o Workfront ao Workfront Fusion neste artigo.
URL
Insira um caminho relativo a https://<WORKFRONT_DOMAIN>/maestro/api/..
API Version
Selecione a versão da API do Workfront que você deseja que o módulo use.
Method
Selecione o método de solicitação HTTP necessário para configurar a chamada de API. Para obter mais informações, consulte Métodos de solicitação HTTP no Adobe Workfront Fusion.
Headers

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

Query String

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.

Body

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

Observação:

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

Eventos De Observação (V2)

Este módulo de acionamento inicia um cenário quando um registro, tipo de registro ou espaço de trabalho é criado, atualizado ou excluído no Workfront Planning.

IMPORTANT
Você pode editar esse módulo posteriormente, o que editará o webhook.
Considere o seguinte ao atualizar um webhook:
  • O webhook editado é tratado pelas assinaturas de evento do Workfront como uma nova assinatura. O histórico de assinaturas do evento não é preservado para a configuração de webhook anterior, pois essa é considerada uma assinatura de evento separada.
  • A alternância da assinatura de evento antiga para a nova pode não estar perfeitamente sincronizada. Portanto, é possível receber um evento duas vezes (se a nova assinatura começar a ser executada antes da antiga) ou perder um evento (se a assinatura antiga for interrompida antes da nova começar a ser executada).
Para obter mais informações sobre edição de webhooks, consulte Editar webhooks.
Webhook
Selecione o webhook que deseja usar ou clique em Adicionar para criar um novo.
Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Object type
Selecione se deseja observar registros, tipos de registro ou espaços de trabalho.
Objetos a serem observados
Selecione se deseja observar novos registros, registros atualizados, registros novos e atualizados ou registros excluídos.
Tipo de configuração

Selecione se deseja configuração simples ou avançada.

Para obter mais informações sobre configuração avançada, consulte Exemplo de lógica avançada no módulo Eventos observados neste artigo.

State

Selecione se deseja monitorar o estado antigo ou novo.

  • New state

    Acione um cenário quando o registro é alterado para um valor específico.

  • Old state

    Acione um cenário quando o registro é alterado de um valor específico.

Espaço de trabalho
Se estiver observando registros, selecione o Workspace que deseja observar para os registros.
Record type
Se estiver observando registros, selecione o tipo de registro que deseja observar.
Events filters

É possível definir filtros para monitorar apenas os registros que atendem aos critérios selecionados.

Para cada filtro, insira o campo que você deseja que o filtro avalie, bem como o operador e o valor que deseja que o filtro permita. Você pode usar mais de um filtro adicionando regras AND.

Observação: não é possível editar filtros em webhooks existentes do Workfront. Para configurar filtros diferentes para assinaturas de eventos do Workfront, remova o webhook atual e crie um novo.

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

Objetos a serem observados
Selecione se você deseja observar novos. registros atualizados, novos e atualizados ou excluídos.
Excluir atualizações feitas por esta conexão
Habilite esta opção para impedir que o cenário seja acionado quando uma alteração for feita pela conexão usada por este módulo. Isso impede que outra instância do cenário seja acionada se esse cenário executar uma ação de acionamento.

Para obter um exemplo de uso da lógica avançada neste módulo, consulte Exemplo de lógica avançada no módulo Eventos observados.

Módulos da versão 1 do Adobe Workfront Planning e seus campos

IMPORTANT
Os módulos desta seção pertencem ao conector do Workfront Planning V1.Para módulos no conector do Workfront Planning V2, consulte Adobe Workfront Planning Módulos da versão 2 e seus campos.

Ao configurar módulos do Workfront Planning, o Workfront Fusion exibe os campos listados abaixo. Junto com esses campos, podem ser exibidos campos adicionais do Workfront, dependendo de fatores como nível de acesso no aplicativo ou serviço. Um título em negrito em um módulo indica um campo obrigatório.

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

Botão de alternância Mapear

Acionadores

Monitorar eventos

Este módulo de acionamento inicia um cenário quando um registro, tipo de registro ou espaço de trabalho é criado, atualizado ou excluído no Workfront Planning.

IMPORTANT
Você pode editar esse módulo posteriormente, o que editará o webhook.
Considere o seguinte ao atualizar um webhook:
  • O webhook editado é tratado pelas assinaturas de evento do Workfront como uma nova assinatura. O histórico de assinaturas do evento não é preservado para a configuração de webhook anterior, pois essa é considerada uma assinatura de evento separada.
  • A alternância da assinatura de evento antiga para a nova pode não estar perfeitamente sincronizada. Portanto, é possível receber um evento duas vezes (se a nova assinatura começar a ser executada antes da antiga) ou perder um evento (se a assinatura antiga for interrompida antes da nova começar a ser executada).
Para obter mais informações sobre edição de webhooks, consulte Editar webhooks.
Webhook
Selecione o webhook que deseja usar ou clique em Adicionar para criar um novo.
Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Object type
Selecione se deseja observar registros, tipos de registro ou espaços de trabalho.
State

Selecione se deseja monitorar o estado antigo ou novo.

  • New state

    Acione um cenário quando o registro é alterado para um valor específico.

  • Old state

    Acione um cenário quando o registro é alterado de um valor específico.

Espaço de trabalho
Se estiver observando registros, selecione o Workspace que deseja observar para os registros.
Record type
Se estiver observando registros, selecione o tipo de registro que deseja observar.
Events filters

É possível definir filtros para monitorar apenas os registros que atendem aos critérios selecionados.

Para cada filtro, insira o campo que você deseja que o filtro avalie, bem como o operador e o valor que deseja que o filtro permita. Você pode usar mais de um filtro adicionando regras AND.

Observação: não é possível editar filtros em webhooks existentes do Workfront. Para configurar filtros diferentes para assinaturas de eventos do Workfront, remova o webhook atual e crie um novo.

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

Objetos a serem observados
Selecione se você deseja observar novos. registros atualizados, novos e atualizados ou excluídos.
Excluir atualizações feitas por esta conexão
Habilite esta opção para impedir que o cenário seja acionado quando uma alteração for feita pela conexão usada por este módulo. Isso impede que outra instância do cenário seja acionada se esse cenário executar uma ação de acionamento.

Para obter um exemplo de uso da lógica avançada neste módulo, consulte Exemplo de lógica avançada no módulo Eventos observados.

Ações

Excluir um tipo de registro

Este módulo de ação exclui um único tipo de registro no Workfront Planning por sua ID.

WARNING
A exclusão de um tipo de registro no Workfront Planning também exclui todos os registros na tabela de tipo de registro.
Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
ID de tipo de registro
Informe ou mapeie a ID do tipo de registro que deseja deletar.

Fazer uma chamada de API personalizada

Este módulo faz uma chamada de API personalizada para a API Adobe Workfront Planning.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
URL
Insira um caminho relativo a https://(YOUR_WORKFRONT_DOMAIN)/maestro/api/
Method
Selecione o método de solicitação HTTP necessário para configurar a chamada de API. Para obter mais informações, consulte Métodos de solicitação HTTP.
Headers

Adicione os cabeçalhos da solicitação no formulário de um objeto JSON padrão.

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

O Workfront Fusion adiciona cabeçalhos de autorização automaticamente.

Query String
Para cada par de chave/valor que você deseja adicionar à sequência de consulta, clique em Adicionar item e insira a chave e o valor.
Body

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

Observação:

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

Pesquisas

Pesquisar registros

Este módulo de ação recupera uma lista de registros com base nos critérios que você especificar.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Espaço de trabalho
Insira ou mapeie a Workspace que contém os registros que você deseja pesquisar.
Record type
Selecione o tipo de registro que deseja pesquisar.
Campos de Registro
Para cada campo que deseja usar na pesquisa, localize esse campo, selecione o operador e insira ou mapeie o valor que deseja pesquisar. Os campos estão disponíveis com base no tipo de registro selecionado.
Condição para filtros

Selecione a condição para seus filtros:

  • E

    O módulo retorna registros que correspondem a todos dos valores de campo selecionados.

  • OR

    O módulo retorna registros que correspondem a qualquer dos valores de campo selecionados.

Limit
Insira ou mapeie o número máximo de registros que deseja que o módulo retorne durante cada ciclo de execução de cenário.

Sem categoria

Criar um registro

Essa ação cria um único registro no Workfront Planning.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
ID de tipo de registro
Insira ou mapeie o tipo de registro que deseja criar. Os tipos de registro disponíveis baseiam-se na sua conta do Workfront Planning.
Outros campos
Insira os valores que você deseja que o novo registro tenha. Esses campos se baseiam no tipo de registro selecionado.

Excluir um registro

Este módulo de ação exclui o registro especificado no Workfront Planning.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
ID de Registro
Informe ou mapeie a ID do registro que deseja deletar.

Obter um registro

Este módulo de ação recupera um único registro de Adobe Workfront Planning, especificado por sua ID.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
ID de Registro
Insira ou mapeie a ID do registro que deseja recuperar.

Obter registros por tipo de registro

Este módulo de ação recupera todos os registros do tipo especificado.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Espaço de trabalho
Selecione ou mapeie o espaço de trabalho que contém os registros que deseja recuperar.
Record type
Selecione o tipo de registro que deseja recuperar.

Obter tipos de registro

Este módulo de ação recupera uma lista de tipos de registros em uma conta Adobe Workfront Planning.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
Espaço de trabalho
Selecione ou mapeie o espaço de trabalho que contém os tipos de registro que deseja recuperar.

Atualizar registro

Essa ação atualiza um único registro no Workfront Planning.

Connection
Para obter instruções sobre como criar uma conexão com o Adobe Workfront Planning, consulte Criar uma conexão com o Adobe Workfront Planning neste artigo.
ID de Registro
Insira ou mapeie o tipo de registro que deseja atualizar. Os tipos de registro disponíveis baseiam-se na sua conta do Workfront Planning.
Outros campos
Informe os novos valores que deseja que o registro tenha. Esses campos se baseiam no tipo de registro selecionado.

Usar JSONata para o detalhamento record-types legível

A expressão JSONata a seguir cria uma saída legível da consulta do Planning que fornece o detalhamento dos tipos de registro. Isso torna o nome do tipo de registro, os nomes dos campos e os nomes das opções de campo (quando aplicável) legíveis por um nome e mantém o restante da estrutura intacta.

(
    $s0 := ({"data":$ ~> | fields | {"options":(options){name:$}} |});
    $s1 := ({"data":$s0.data ~> | **.fields | {"options_name":(options.*){displayName:$}} | });
    $s2 := $s1 ~> | data | {"fields":(fields){displayName:$}} |;
    $s2.data{displayName:$}
)

Para obter informações sobre o uso de módulos JSONata, consulte módulos JSONata.

Exemplo de lógica avançada no módulo Eventos observados

Este é um exemplo do formato usado pela lógica avançada ao usar o módulo Workfront Planning > Eventos de observação.

[
  {
    "fieldName": "recordTypeId",
    "fieldValue": "Rt68c886502d4b5554ee80896b",
    "comparison": "eq",
    "state": "newState"
  },
  {
    "fieldName": "data",
    "fieldValue": {
      "F68c886502d4b5554ee808975": "planning"
    },
    "comparison": "eq",
    "state": "newState"
  },
  {
    "fieldName": "data",
    "fieldValue": {
      "F68c886502d4b5554ee808975": "active"
    },
    "comparison": "eq",
    "state": "newState"
  }
]

Considere o seguinte ao usar a lógica avançada no módulo Evento de observação:

  • A primeira entrada "fieldvalue": é a ID de Tipo de Registro de Planejamento extraída da URL. Neste exemplo, a ID do Tipo de Registro de Planejamento é Rt68c886502d4b5554ee80896b.
  • Os dados de planejamento são retornados dentro de uma matriz chamada data , que aparece neste exemplo como "fieldName": "data".
  • FieldNames do Planning são retornados como IDs que começam com F.
  • Como este exemplo está avaliando em relação a um conector de filtro OR, ele tem duas entradas para o mesmo campo (F68c886502d4b5554eec808975). As duas opções suspensas que o módulo está filtrando são "planning" e "active".
recommendation-more-help
workfront-fusion-help-workfront-fusion