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
| 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 do s##
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:
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
-
Em qualquer módulo do Adobe Workfront Planning, clique em Adicionar ao lado do campo Conexão.
-
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/oauth2Host prefix Na maioria dos casos, esse valor deve ser origin. -
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.
- 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
-
Em qualquer módulo do Adobe Workfront Planning, clique em Adicionar ao lado do campo Conexão.
-
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, insiraexample.Instance lane Insira o tipo de ambiente ao qual esta conexão será feita.
Exemplo: se a URL for
https://example.my.workfront.com, insiramy.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. -
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.
- 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.
Módulos do Adobe Workfront Planning 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.
Acionadores
Assistir a 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.
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.
Fazer uma chamada de API personalizada
Este módulo faz uma chamada de API personalizada para a API Adobe Workfront Planning.
Pesquisas
Pesquisar registros
Este módulo de ação recupera uma lista de registros com base nos critérios que você especificar.
Sem categoria
Criar um registro
Essa ação cria um único registro no Workfront Planning.
Excluir um registro
Este módulo de ação exclui o registro especificado no Workfront Planning.
Obter um registro
Este módulo de ação recupera um único registro de Adobe Workfront Planning, especificado por sua ID.
Obter registros por tipo de registro
Este módulo de ação recupera todos os registros do tipo especificado.
Obter tipos de registro
Este módulo de ação recupera uma lista de tipos de registros em uma conta Adobe Workfront Planning.
Atualizar registro
Essa ação atualiza um único registro no Workfront Planning.
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.