Manipulação de Objetos

Há duas manipulações de objetos que podem ser utilizadas no Flow Studio e são de especial importância para a criação de um fluxo:

Entrada de múltiplas variáveis para transformação JSONata

Com o Flow Studio você pode manipular dados em código JSONata, oriundos de diversos módulos anteriores ou de diferentes variáveis do fluxo. Para realizar essa operação, é necessário utilizar o módulo "Transformação de Dados", que é um módulo ferramental da plataforma.

Para começar, na janela de edição e configuração do módulo no seu fluxo, siga estas etapas:

1. Vá para a aba "Dados de Origem";

2. Arraste as variáveis do seu fluxo para a coluna “Valor";

3. Escolha o "Tipo de variável" (texto, número, etc);

4. Dê um nome à "Chave".

Você também pode configurar as variáveis desejadas usando um objeto JSON na aba “JSON de Origem".

Ao utilizar o "Dados de Origem", note que a visualização pode ser realizada ao clicar na seta localizada no lado direito da variável.

Ao prosseguir clicando em "Avançar" da tela da configuração do módulo "Transformação de Dados", essas variáveis deverão ser acessadas, na construção do código JSONata, da forma exemplificada abaixo:

JSON do exemplo:

{
  "data": {
    "date": "19 de dezembro",
    "offset": "0",
    "password": "pass123",
    "row_count": "5",
    "username": "integra.user"
  }
}

Após escrever o JSONata é preciso clicar em "Executar". Para finalizar a configuração, clique em "Salvar".

Manipulação das variáveis

É possível manipular as variáveis clicando diretamente nos parâmetros dos componentes. Isso facilita o acesso e manipulação de subobjetos ou objetos dentro dos parâmetros de resultado dos componentes anteriores, tornando o processo mais intuitivo e direto.

Para realizar a manipulação das variáveis, siga as seguintes etapas:

1. Clique na seta localizada à direita da variável na coluna "Valor".

2. No campo Caminho (Path), observe que há uma base JSON associada a ele a qual pode ser alterada utilizando colchetes [ ]. Manipule de acordo com a necessidade.

Acesso a dados internos de um objeto

Muitas vezes desejamos referenciar apenas uma propriedade dentro de um objeto. Para fazer isso, devemos especificá-la dentro no fluxo, mesmo que essa variável interna não esteja explícita, de forma possamos utilizar somente aquilo de que necessitamos.

No exemplo abaixo, o módulo Transformação de Dados, que precede o módulo que estamos configurando em nosso fluxo, gera um objeto chamado data, cujo conteúdo é o seguinte:

{
   "result": {
      "date":"19 de Dezembro",
      "username":"integra.user",
      "password":"pass123",
      "offset":"0",
      "row_count":"5"
   }
}

Poderemos referenciar as variáveis internas deste objeto em outro passo do fluxo. Utilizando date como exemplo, será necessário informar o caminho da variável. Você pode realizar a mesma operação utilizando-se de uma SMOP, o que permite não só referenciar, como realizar operações com parâmetros internos de um objeto.

No próximo exemplo abaixo, utilizamos o parâmetro data (date) do módulo "Transformação de Dados" no param1 de uma SMOP e, para criar a expressão, referenciamos o parâmetro offset, um parâmetro de fluxo cujo valor atual é “0”: