Nesse artigo você encontrará as seguintes informações:
O que é mapeamento?
O que é um item?
Mapeando um item
Coleções e matrizes
Matrizes de mapeamento
Solução de problemas
O que é mapeamento?
Os módulos em um cenário são vinculados entre si pelo mapeamento de itens.
Ao mapear um item, você usa os dados recuperados de um módulo de origem nas configurações de outro módulo (destino).
Os valores dos itens mapeados são usados pelo módulo para executar a ação desejada.
Por exemplo, "Remetente: itens de endereço de e-mail" (o endereço de e-mail do remetente) e "Assunto" (um assunto de e-mail) recuperados pelo módulo "Monitorar e-mail" e então mapeados nas configurações do módulo "Enviar um e-mail".
O que é um item?
A operação de um módulo produz pacotes como sua saída. Um pacote consiste em itens.
Geralmente, um item é uma informação recuperada por um módulo. O item é exibido na saída do módulo como um rótulo e um valor.
Clique no balão acima do módulo para exibir a saída do módulo.
No exemplo de um item a seguir, o rótulo do item é "Assunto" e o valor do item é "Bem-vindo ao Toolzz Connect!".
Mapeando um item
Siga estas etapas para mapear um item de um módulo para outro.
Passo a passo:
1º passo: abra as configurações do módulo de destino (para onde você deseja mapear os itens).
2º passo: clique no campo onde deseja mapear um item de um módulo anterior.
Isso abrirá um painel de mapeamento oferecendo todos os itens dos módulos anteriores no cenário que estão disponíveis para mapeamento. Além disso, os valores de amostra são geralmente exibidos ao lado do rótulo do item.
3º passo: para usar um item mapeados em um campo, clique no item ou arraste e solte o item no campo de entrada do módulo.
❗ Observação
Você pode pesquisar itens usando o campo de pesquisa na parte superior do painel de mapeamento. A pesquisa é realizada em rótulos de itens e valores de itens.
4º passo: quando terminar, clique em "OK" nas configurações do módulo.
Você pode repetir a ação (mapear da saída do módulo para os campos de entrada de outro módulo) em outros módulos consecutivos adicionados ao seu cenário. O número de módulos vinculados no cenário não é limitado.
Coleções e matrizes
Os itens de saída do módulo que contêm mais itens são chamados de coleções, quando possuem itens de tipos diferentes, ou arrays/matrizes, quando possuem itens do mesmo tipo.
As coleções são expandidas no painel de mapeamento para permitir que o usuário mapeie facilmente os itens contidos nela. Uma coleção em si, geralmente, não está sendo mapeada.
Exemplo de coleção na saída do módulo:
Exemplo de coleção no painel de mapeamento do módulo:
Exemplo de array (contendo coleções do mesmo tipo) na saída do módulo:
Exemplo de array (contendo coleções do mesmo tipo) no painel de mapeamento do módulo:
Matrizes de mapeamento
Uma matriz é um tipo especial de item. Uma matriz simples contém um ou mais valores de texto. Uma matriz complexa contém uma ou mais coleções do mesmo tipo.
Um exemplo de uma matriz complexa é o anexo de e-mail. O módulo "Monitorar e-mails" retorna uma matriz de anexos para cada e-mail. Cada anexo representa uma coleção que pode conter um nome, conteúdo, tamanho, etc.
Mapeando o primeiro elemento de um array (matriz)
Se você mapear o item do array "Recipiente name", ele aparecerá no campo assim:
O número entre os colchetes é um índice que determina qual elemento da matriz será usado. Se deixá-lo vazio, é padronizado para o primeiro elemento.
Mapeando a ordenação elemento de um array (matriz)
Se desejar acessar outro elemento, insira ou mapeie um valor entre colchetes. No exemplo abaixo, digite 2 para selecionar o segundo elemento.
Mapeando o elemento de uma matriz com uma determinada chave
Algumas matrizes contêm várias coleções com itens de key/chave e value/valor. Estes são, tipicamente, vários metadados, atributos, etc.
O exemplo a seguir mostra a saída do módulo WooCommerce > "Obter um produto" que contém o item "Meta data", que é uma matriz de coleções. Cada coleção contém o item-chave "Meta data ID" e o item de valor "Value".
O requisito típico é pesquisar um elemento por seu valor de chave fornecido e obter o valor correspondente do item de valor. Isso pode ser obtido com uma fórmula que emprega uma combinação das funções "map( )" e "get( )".
O exemplo a seguir mostra como obter o valor do item do elemento com o valor do item chave "Meta da ID" igual a "36675". O resultado da fórmula será "não".
A repartição detalhada da fórmula segue:
O primeiro parâmetro da função "map( )" é todo o item da matriz.
O segundo parâmetro é o nome bruto do item de valor. Para obter o nome bruto, passe o cursor do mouse sobre o item no painel de mapeamento:
📢 Importante
Todos os parâmetros diferenciam maiúsculas de minúsculas. Embora neste exemplo particular o rótulo do item seja diferente de seu nome bruto apenas em letras maiúsculas, é necessário usar o nome bruto, que é todo minúsculo "value" diferente do rótulo "Value".
O terceiro parâmetro é o nome bruto do item "key".
O quarto parâmetro é o valor da "key" fornecido.
Como a função "map( )" retorna uma matriz (pois pode haver mais elementos com o valor de chave fornecido), é necessário aplicar a função "get( )" para obter seu primeiro elemento:
O 1º parâmetro da função "get( )" é o resultado da função "map( )".
O segundo parâmetro é o índice do elemento - um.
Convertendo elementos em uma série de pacotes
Matrizes podem ser convertidos em uma série de pacotes usando o módulo Iterador.
📢 Importante
As saídas dos módulos agrupados entre um IteraDor e AgregaDor não são acessíveis além do módulo Agregador.
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. No entanto, o Toolzz Connect pode descobrir, automaticamente, os itens de saída ausentes.
Tudo o que você precisa fazer é executar o módulo no editor de cenários. O procedimento exato difere ligeiramente dependendo do tipo do módulo:
Gatilho instantâneo
Passo a passo:
1º passo: clique com o botão direito do mouse no módulo.
2ª passo: escolha a opção "Run this module only" para executar apenas este módulo.
3º passo: se não houver webhooks na fila, o módulo aguardará o processamento de um novo webhook.
4º passo: gere um webhook (por exemplo, se o módulo for Slack > Ouvir novos eventos, que está observando novas mensagens de canal em um canal, envie uma mensagem para o canal).
5º passo: o módulo deve terminar a execução.
6º passo: clique na "bolha" acima do módulo para explorar sua saída completa.
7º passo: o painel de mapeamento agora conterá todos os itens que foram descobertos na saída do módulo.
Gatilho de votação
Passo a passo:
1º passo: clique com o botão direito do mouse no módulo.
2ª passo: escolha a opção "Run this module only" para executar apenas este módulo.
3º passo: se não houver saída, clique na opção "Choose where to srtar" para escolhe por onde começar e ajuste as configurações. Se não houver nenhum evento a ser processado, crie um (por exemplo, se o módulo for Gmail > Monitorar e-mails e envie um e-mail para a pasta que o módulo está monitorando) e volte para a etapa 2.
4º passo: o módulo deve terminar a execução.
5º passo: clique na "bolha" acima do módulo para explorar sua saída completa.
6º passo: o painel de mapeamento agora conterá todos os itens que foram descobertos na saída do módulo.
Outros módulos
Você pode optar por executar:
Todo o cenário (ou apenas a parte que contém o módulo). Se o seu cenário começar com um gatilho.
Apenas o único módulo.
Se você optar por executar apenas o módulo único, então:
Passo a passo:
1º passo: clique com o botão direito do mouse no módulo.
2ª passo: escolha a opção "Run this module only" para executar apenas este módulo.
3º passo: forneça valores de amostra para os itens de entrada e clique no botão "OK".
4º passo: o módulo deve terminar a execução.
5º passo: clique na "bolha" acima do módulo para explorar sua saída completa.
6º passo: o painel de mapeamento agora conterá todos os itens que foram descobertos na saída do módulo.
Pronto! Agora você já sabe tudo sobre mapeamento no Toolzz Connect.