Função Concat

A função Concat junta (concatena) múltiplos valores em uma única sequência de caracteres (string):

concat (field 1, field 2,...)

Essa função é amplamente utilizada para criar textos combinando variáveis literais ou valores provenientes de outras operações.

No Sensedia Integrations, a função Concat está disponível para:

Exemplo 1

Considere uma integração com um step que gera um relatório de vendas. O objetivo é criar uma mensagem com o total de unidades vendidas em 2023. Por exemplo:

  • In 2023, total sales of 5000 units. (Em 2023, vendas totais de 5.000 unidades).

Para criar a mensagem, utilizaremos:

  • O payload de um conector disponível em Properties: $.Sales.Response.Payload.totalSales.

  • Strings: representadas entre aspas duplas:

    • "In", "total sales of", "units"

    • " " (espaço em branco)

    • "," (inclusão de vírgula como texto).

  • Separadores: a vírgula separa os elementos ou campos a serem concatenados.

  • Números: 2023 (não são colocados entre aspas).

Assim, temos a função Concat:

concat("In"," ", 2023,",","total sales of"," ",$.Sales.Response.Payload.totalSales," ", "units.")

Exemplo 2

Considere uma integração que contém um conector de banco de dados SQL:

Para montar instruções de um banco de dados SQL, você deverá utilizar a sintaxe SQL.

A instrução SQL abaixo seleciona todas as colunas de uma tabela apenas para o registro em que o valor do campo id corresponde ao valor do campo id fornecido no payload especificado.

concat("SELECT * FROM clients WHERE id = ", $.clientRegistration.Response.Payload.id)

Veja o passo a passo da instrução:

  • "SELECT * FROM clients WHERE id = ": instrui o banco de dados a:

    • Selecionar (SELECT)

    • todas as colunas (*)

    • da (FROM)

    • tabela clients

    • e filtrar a busca (WHERE)

    • para retornar apenas o registro onde a coluna id corresponde a um valor específico que é indicado após o sinal de igual (id =).

    • $.clientRegistration.Response.Payload.id: valor que será filtrado pela instrução, extraído do campo id no payload de resposta do conector clientRegistration.

Agora, o valor do campo id passará a ser um valor fixo igual a 155.

concat("SELECT * FROM clients WHERE id = ", 155)

Isso significa que a instrução retornará todas as colunas da tabela clients para o registro cujo id é 155.

Thanks for your feedback!
EDIT

Share your suggestions with us!
Click here and then [+ Submit idea]