Mapear informações de um módulo para outro em Adobe Workfront Fusion
O mapeamento é o processo de atribuir as saídas de um módulo, estruturadas em itens, aos campos de entrada de outro módulo.
O painel de mapeamento é exibido ao clicar em um campo no qual você deseja inserir um valor emitido de um módulo anterior em um cenário. Em um módulo, em qualquer campo disponível para mapeamento, é possível criar uma fórmula usando qualquer combinação de funções e itens mapeados do painel de mapeamento com texto estático digitado. Esses elementos podem ser aninhados um dentro do outro.
Requisitos de acesso
Você deve ter o seguinte acesso para usar a funcionalidade 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.
Pacotes e itens
A operação de um módulo produz zero, um ou mais pacotes como sua saída. Um pacote consiste em um ou mais itens.
Para explorar a saída de um módulo:
-
Clique em Executar uma vez para executar o módulo.
-
Clique no balão acima do módulo.
Um registro contendo todas as fases do módulo é exibido. Você pode encontrar o(s) pacote(s) emitido(s) pela fase de operação de um módulo no cabeçalho Saída. Cada pacote contém seus itens e os valores de cada item.
Date, Email ID (UID), size e assim por diante.
Mapear um item
Depois de criar uma sequência de módulos vinculando dois ou mais deles, cada módulo pode processar valores de itens gerados pelos módulos que o precedem.
Para atribuir os itens aos campos de entrada de um módulo:
-
Clique no módulo que deve processar a saída dos módulos anteriores.
-
No painel Configurações do módulo que é exibido, clique em um campo onde você deseja usar o valor de um item emitido de um ou mais módulos anteriores.
O painel de mapeamento é aberto.
-
Clique em um item no painel de mapeamento para inseri-lo no campo.
-
(Opcional) Para pesquisar um campo específico no painel de mapeamento, clique na barra de pesquisa do painel de mapeamento e digite o termo que deseja pesquisar. Clique no campo quando ele aparecer na lista.
Os resultados da pesquisa contêm o termo de pesquisa e não diferenciam maiúsculas de minúsculas.
Para obter mais informações, consulte Definir as configurações de um módulo em Adobe Workfront Fusion.
Fórmulas
Você pode mapear vários itens em um campo, combiná-los com literais (valores fixos) e empregar Operadores e Funções para criar fórmulas complexas:
Você pode encontrar as funções e os operadores no painel de mapeamento em uma de suas guias.
A primeira guia
As outras guias contêm os seguintes tipos de funções:
-
Funções gerais
-
Funções matemáticas
-
Funções de texto e binárias
-
Data e hora
-
Funções para trabalhar com matrizes
Para obter mais informações sobre como mapear itens usando funções, consulte Mapear itens usando funções em Adobe Workfront Fusion.
Coleções
Alguns itens podem conter vários valores de vários tipos. Estes são itens do tipo coleção.
Você pode identificar um item do tipo coleção pelo retângulo preto pequeno exibido à direita do rótulo do item e sua lista de subitens expandida automaticamente:
Para obter mais informações sobre coleções, consulte Tipos de dados de item no Adobe Workfront Fusion
Matrizes
Alguns itens podem conter vários elementos do mesmo tipo. Esses itens são do tipo matriz.
Você pode identificar um item do tipo matriz pelos colchetes no final do rótulo do item. Clique no pequeno retângulo preto à direita do rótulo do item para revelar os itens do elemento:
Para obter mais informações sobre matrizes, consulte Tipos de dados do item em Adobe Workfront Fusion
Mapear o primeiro elemento de uma matriz
Se você mapear o item Recipient name de uma matriz, ele será exibido no campo da seguinte maneira:
O número entre colchetes é um índice que determina qual elemento da matriz será usado. É definido como 1 por padrão.
Mapear o elemento n-ésimo de uma matriz
Se quiser acessar outro elemento, clique nos colchetes e edite o valor do índice:
Mapear um elemento de matriz com uma determinada chave
Algumas matrizes contêm várias coleções com itens de chave e valor. Normalmente, são vários metadados, atributos e assim por diante.
O exemplo a seguir mostra a saída do aplicativo Jira.
Neste exemplo, obtemos um nome de arquivo de uma matriz de anexos para o anexo específico com uma ID 10108.
A saída de Jira tem esta aparência:
O requisito típico é pesquisar um elemento por seu valor de chave determinado e obter o valor correspondente do item de valor. Isso pode ser feito com uma fórmula que emprega uma combinação das funções map() e get().
Veja a seguir um detalhamento da fórmula:
-
O primeiro parâmetro da função
map()é o item de matriz inteiro. -
O segundo parâmetro é o nome bruto do item de valor. Para obter o nome bruto, passe o mouse sobre o item no painel mapeamento:
note note NOTE Todos os parâmetros diferenciam maiúsculas de minúsculas. Mesmo que, neste exemplo específico, o rótulo do item difira de seu nome bruto apenas em maiúsculas, é necessário usar o nome bruto, que é um valor em minúsculas em contraste com o Valor do rótulo. -
O terceiro parâmetro é o nome bruto do item-chave:
-
O 4º parâmetro é o valor de chave fornecido.
Como a função map() retorna uma matriz (já que poderia haver mais elementos com o valor de chave fornecido), é necessário aplicar a função get() para obter seu primeiro elemento:
-
O primeiro parâmetro da função
get()é o resultado da funçãomap(). -
O 2º parâmetro é o índice do elemento - um.
Para obter mais informações sobre a função map(), consulte Funções de matriz em Adobe Workfront Fusion.
Para obter mais informações sobre a função get(), consulte Funções gerais em Adobe Workfront Fusion.
Conversão de elementos em uma série de pacotes
Matrizes podem ser convertidas em uma série de conjuntos usando o módulo Iterador. Para obter mais informações, consulte o módulo Iterador no Adobe Workfront Fusion.
Solução de problemas
Itens ausentes no painel de mapeamento
Para cada módulo, o painel de mapeamento exibe todos os itens de saída listados pelo autor do módulo. Em alguns casos, essa lista pode estar incompleta por vários motivos e alguns itens podem estar ausentes. O Workfront Fusion pode descobrir automaticamente os itens de saída ausentes quando você executa o módulo no editor de cenários. O procedimento exato difere ligeiramente dependendo do tipo do módulo:
Acionador instantâneo
-
Clique com o botão direito do mouse no módulo e clique em Executar este módulo somente no menu exibido.
Se não houver webhooks em fila, o módulo aguardará um novo webhook ser processado.
-
Gerar um webhook.
Por exemplo, o módulo de webhook Slack>Ouvir novos eventos (que observa novas mensagens de canal em um canal) envia uma mensagem para o canal.
-
Quando o módulo terminar de ser executado, clique no balão acima do módulo para explorar sua saída completa.
O painel de mapeamento conterá todos os itens que foram descobertos na saída do módulo.
Acionador de sondagem
-
Clique com o botão direito do mouse no módulo e clique em Executar este módulo somente no menu exibido.
-
Se não houver saída, clique em Escolher onde começar e ajuste as configurações.
-
Se não houver um evento a ser processado, crie um e retorne à etapa 2.
Por exemplo, o módulo de webhook Gmail >Assistir emails envia um email para a pasta que o módulo está assistindo.
-
Quando o módulo terminar de ser executado, clique no balão acima do módulo para explorar sua saída completa.
O painel de mapeamento agora contém todos os itens que foram descobertos na saída do módulo.
Outros módulos
Você pode optar por executar:
-
O cenário inteiro (ou apenas a parte que contém o módulo)
Se o cenário iniciar com um gatilho, consulte a seção Gatilho instantâneo ou Gatilho de sondagem acima.
-
Apenas o módulo único
Se você optar por executar apenas o único módulo:
-
Clique com o botão direito do mouse no módulo e clique em Executar este módulo somente no menu exibido.
-
Forneça valores de exemplo para os itens de entrada, em seguida, clique em OK.
-
Quando o módulo terminar de ser executado, clique no balão acima do módulo para explorar sua saída completa.
O painel de mapeamento agora contém todos os itens que foram descobertos na saída do módulo.