Instruções para trabalhar com a ferramenta “Unir Linhas”
A ferramenta Unir linhas (String Concatenation) permite combinar uma “seção de string” (uma matriz de objetos) de uma etapa com uma “seção de string” de outra etapa em uma matriz.
Nas instruções para colar strings, definimos o que são “strings” no conceito da Albato. Agora existe uma ferramenta que amplia as possibilidades de trabalhar com “strings” caso você as tenha em duas etapas, e precise dar a união na terceira etapa.
Exemplo de uso da ferramenta Unir Linhas
Vamos analisar o uso da ferramenta usando o exemplo do “AliExpress – MeuWarehouse”.
No sistema CRM “MyWarehouse”, ao criar um novo documento “Pedido do comprador”, ao adicionar itens de mercadoria a este pedido, é necessário indicar o UUID interno deste item. Ao receber um pedido do AliExpress, recebemos apenas a ID interna do produto do próprio AliExpress e seu código SKU. Você pode tornar o código SKU igual ao UUID do produto no MyWarehouse, mas isso é muito inconveniente e ilógico.
Como regra, as comparações são feitas pelo número do item ou por um código externo. Criamos uma ação para MoiStore que permite criar ou localizar um item no MoiStore por SKU ou código. Quando você recebe um pedido do AliExpress, “MyWarehouse” começa a pesquisar produtos com SKU / código / código externo igual a SKU. Como resposta, somos devolvidos às “linhas” de produtos encontrados com seus UUIDs internos, que podemos transferir para o pedido.
Há um problema aqui: temos “linhas” de nosso gatilho do AliExpress e “linhas” de nossa ação, que encontraram os produtos de que precisamos em “MyStorage”. Agora precisamos combinar de alguma forma essas duas matrizes de dados entre si antes de criar um pedido, já que queremos transferir a quantidade de mercadorias do AliExpress e enviar a identificação das mercadorias que a MoySklad nos deu em resposta.
Para tal combinação e posterior transferência correta de dados, foi criada a ferramenta “Combinar Linhas”. Ele permite que você pegue dois arrays do gatilho AliExpress e da ação “MySklad” e os combine em um array, combinando objetos dentro do array por algum valor, por exemplo, novamente por SKU e SKU.
Assim, você pode criar um pedido com os dados dos produtos do AliExpress e o UUID obtido na pesquisa de produtos no MyWarehouse.
Personalize a ferramenta Unir Linhas
Agora vamos olhar diretamente para o próprio instrumento e suas configurações. Não consideraremos a criação do pacote em si dentro da estrutura desta instrução.
Adicione uma ferramenta após as etapas onde você tem as “linhas” que você precisa combinar, clique em “+” e selecione “Ferramenta”:
Selecione a ferramenta Unir Linhas:
Escolha sua primeira etapa, de onde você obterá as “linhas”. Neste caso, este é um gatilho do AliExpress:
Escolha a segunda etapa, de onde você obterá as “linhas”. No exemplo, esta é a ação do sistema “MoySklad”:
Vá para as configurações da ferramenta:
Escolha o que o instrumento precisa fazer na ausência de um par, ou seja, no caso em que não foi possível combinar duas “linhas” de duas etapas. Por exemplo, se a “Etapa 2” não encontrou o produto desejado, você pode pular este objeto, preencher suas lacunas ou lançar um erro (neste caso, o link para).
Selecione também um cenário se vários pares de objetos forem encontrados. Por exemplo, você pesquisou produtos por nome na MoyStore e conseguiu encontrar dois desses produtos. Aqui você pode pular o objeto, usar o primeiro encontrado, duplicar (se um produto veio do AliExpress e dois produtos foram encontrados em “MyStorage”, a ferramenta retornará dois itens separados de mercadoria) ou gerará um erro:
Clique em “Adicionar condição” e selecione por quais parâmetros da primeira e segunda seções da string você deseja combinar os objetos:
Digamos que você queira comparar os produtos do AliExpress com os produtos encontrados no MyWarehouse pelo SKU do AliExpress e pelo SKU (já que você os pesquisou anteriormente). Para fazer isso, configure a ferramenta da seguinte maneira:
Você também pode combinar e adicionar várias condições pelas quais você precisa encontrar um par.
Após configurar a ferramenta, clique em “Salvar”.
Agora, se você abrir as configurações das próximas etapas, nos campos da “seção String” você pode escolher entre os resultados da ferramenta. Você pode selecionar campos da primeira etapa e da segunda:
Isso permitirá que você faça mais uso de “strings” (matriz de objetos) na Albato.
A ferramenta Juntar Linhas também pode ser usada com outros sistemas que enviam linhas. A configuração da própria etapa é realizada de forma idêntica.
