SMOP (Pequenas Operações)

Conceito

Muitas vezes, precisamos modificar um parâmetro antes que ele seja referenciado em um fluxo. Isso acontece, por exemplo, quando estamos buscando uma substring dentro de uma string ou precisamos adicionar um valor a um parâmetro numérico. Para isso, há a funcionalidade SMOPs (Small Operations), que permite que você crie pequenas operações diretamente no campo em que os parâmetros são referenciados. Isso significa que cada operação é executada e o seu resultado é passado como um parâmetro para o módulo.

SMOP é uma funcionalidade de transformação de dados que, utilizando-se de JSONata, permite que você realize operações de menor complexidade com parâmetros de um fluxo na plataforma.

Algumas operações sobre parâmetros de um fluxo que podemos realizar utilizando-se da funcionalidade SMOP:

• Somar dois números, tais como um offset e um rowCount, na leitura de um banco de dados;

• Concatenar duas strings ou extrair um padrão de uma delas;

• Modificar o tipo de dado de um parâmetro como, por exemplo, de string para number.

Com a SMOP, sempre que um parâmetro é referenciado, é possível realizar pequenas operações, utilizando-se dos dados obtidos no fluxo.

As operações ideais para esta funcionalidade são de baixa complexidade, para que você possa transformar os dados usando apenas uma linha de código. A sintaxe é JSONata, a mesma utilizada no módulo "Transformação de Dados".

A funcionalidade SMOP está disponível para módulos com autenticação REST, Banco de Dados e E-mail, e está presente em quase todos os módulos ferramentais.

A SMOP é ideal para manipulações de dados de menor complexidade, sem a necessidade de uma resposta externa. Para manipulações mais complexas de dados, igualmente sem resposta externa, recomendamos o módulo Data Transformation. Por fim, o módulo Return é ideal para manipulações mais complexas de dados, e que necessitem de uma resposta para uma requisição HTTP.

Exemplos de Operações

Os exemplos abaixo descrevem pequenas operações (expressões) que podem ser realizadas, cujo código JSONata é limitado a uma linha e retorna apenas um elemento de saída, mesmo que esse elemento seja um array:

Ex.	Parâmetros originais	Expressão SMOP (JSONata)	Novo parâmetro	Tipo de Dados
1	{ "param1" : "minha string" }	$length(param1)	12	number
2	{ "param1" : 10, "param2" : 5 }	param1 + param2	15	number
3	{ "param1" : 10, "param2" : 5 }	param1 + param2	15	number
4	{ "param1" : "Integra", "param2" : ".", "param3" : "Sky" }	param1 > param2	VERDADEIRO	Boolean
5	{ "param1" : "arg1 arg2 arg3" }	$split(param1, " ")	[ "arg1", "arg2", "arg3" ]	Array
6	{ "param1" : "123.45" }	$number(param1)	123.45	Number
7	{ "param1" : [1, 2, 3], "param2" : 0 }	param1[param2]	1	number

Criação de SMOPs

O acesso à configuração das SMOPs é feito durante a configuração da operação de um módulo compatível, na etapa da edição de um fluxo.

Para criar uma SMOP, siga os passos abaixo:

1. Clique em "Editar" do módulo desejado e compatível. Em seguida, clique no sinal de "+" localizado no bloco de configurações de parâmetros.

2. A janela de criação da SMOP será exibida, sendo que:

• param1 (opcional): O parâmetro original que você deseja manipular deverá ser arrastado para este campo, sendo possível utilizar um parâmetro do fluxo ou um parâmetro de passos anteriores do fluxo. É possível, também, criar SMOPs utilizando-se de operações JSONata que não requerem parâmetros.

• valor (opcional): Caso o param informado seja um parâmetro de fluxo, o campo valor será preenchido automaticamente, sendo também possível informar o valor manualmente ou mesmo não o informar, conforme a necessidade. O tipo de dado utilizado deve ser compatível com o param informado.

• adicionar parâmetro: adicione mais parâmetros

• Expressão (obrigatório): Aqui você deverá informar a operação desejada. Todas as expressões JSONata são válidas. Além de usar um parâmetro, como nos exemplos que informamos acima, é possível usar funções como $now(), que não requer parâmetros.
• Resultado (somente leitura): aqui será exibido automaticamente o resultado da Expressão criada.

• Tipo (somente leitura): aqui você verá automaticamente o tipo de dados do Resultado apresentado (string, number, Boolean, array ou object). Observe que o tipo informado deve estar de acordo com o tipo esperado pelo parâmetro do módulo.

1. Para adicionar um parâmetro à SMOP, selecionando-o entre os parâmetros disponíveis. Para fazer isso, arraste-o e solte-o no campo param1 da SMOP. Clique em "Adicionar parâmetro" se quiser adicionar outro parâmetro.

Você pode utilizar até 3 parâmetros originais dentro de uma SMOP.

Exemplo com 2 parâmetros

1. Crie uma Expressão em JSONata para realizar a operação desejada, utilizando nossa tabela de modelo. Por exemplo: param1 + param2.
2. Os campos Resultado e Tipo exibirão as informações correspondentes.

3. Clique em "Salvar" para concluir. O campo da operação passará a exibir a expressão “SMOP”, denotando que uma operação SMOP foi configurada.

Edição de uma SMOP

Para editar uma SMOP:

1. Clique no sinal de seta para baixo, ao lado do campo com a SMOP que deseja editar:

2. Faça as alterações necessárias e clique em "Salvar".

Exclusão de uma SMOP

Para excluir uma SMOP há dois caminhos:

1. Clicar no sinal "x" que fica do lado direito do SMOP.

2. Abrir o modal de edição e clicar em "Excluir".

Não é possível reverter a exclusão. Caso precise novamente da mesma SMOP, será necessário refazê-la.