# 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](https://docs.jsonata.org/overview.html), permite que você realize operações de menor complexidade com parâmetros de um fluxo no **Skyone Studio**. 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**". {% hint style="success" %} 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](/skyone-studio/modulos.md). {% endhint %} {% hint style="info" %} 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](/skyone-studio/integracoes/fluxos/modulos-ferramentais/modulo-transformacao-de-dados.md). Por fim, o módulo[ Return](/skyone-studio/integracoes/fluxos/modulos-ferramentais/modulo-retorno.md) é ideal para manipulações mais complexas de dados, e que necessitem de uma resposta para uma requisição HTTP. {% endhint %} ### **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:


{
  "param1" : "minha string"
}
{
  "param1" : 10,
  "param2" : 5
}
{
  "param1" : 10,
  "param2" : 5
}
{
  "param1" : "Integra",
  "param2" : ".",
  "param3" : "Sky"
}
[
  "arg1",
  "arg2",
  "arg3"
]
{
  "param1" : "123.45"
}
{
  "param1" : [1, 2, 3],
  "param2" : 0
}

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](#exemplos-de-operacoes) 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. 3. 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.

4. Crie uma **Expressão** em JSONata para realizar a operação desejada, utilizando nossa [tabela](#exemplos-de-operacoes) de modelo. Por exemplo: `param1 + param2`. 5. Os campos **Resultado** e **Tipo** exibirão as informações correspondentes. 6. 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"**.

{% hint style="info" %} Não é possível reverter a exclusão. Caso precise novamente da mesma SMOP, será necessário refazê-la. {% endhint %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.skyone.cloud/skyone-studio/integracoes/operacoes-de-dados/smop-pequenas-operacoes.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.