Armazena o valor em uma requisição. Os valores inseridos estão vinculados a uma requisição do tipo REST em uma aplicação web. Eles são válidos apenas durante o ciclo de vida da requisição realizada. Quando a resposta é enviada ou quando a requisição é concluída, esses valores perdem sua validade e são descartados.

Este bloco utiliza o HttpServletRequest do Java, consulte a documentação oficial para mais informações. Para obter o valor da variável criada, utilize o bloco Obter valor na requisição.

Figura 1 - Bloco Inserir ou alterar valor na requisição

Compatibilidade

Bloco servidor: cronapi.util.Operations.setInRequest()

Retorno

Bloco sem retorno.

Parâmetros

Nome do campo

Nome do campo a ser criado na requisição.

• Posição: 1
• Inglês: Field name
• Tipo: Texto / String
• Exemplo: "nome"

Valor do campo

Valor a ser definido no campo da requisição.

• Posição: 2
• Inglês: Field value
• Tipo: Texto / String
• Exemplo: "Ana"

Exemplo 1

A imagem abaixo mostra um exemplo de uso do bloco Inserir ou alterar valor na requisição. Na primeira função, estamos inserindo em uma variável da requisição o campo "nome" e, em seguida, é chamada a função "ObterValorNaRequisicao". Nesta segunda função, obtemos o valor do campo "nome" utilizando o bloco Obter valor na requisição, que será impresso no console do depurador.

Figura 2 - Exemplo de uso do bloco Inserir ou alterar valor na requisição

A imagem a seguir mostra o resultado de execução da função da Figura 2, em que o valor do campo "nome" é impresso no console do depurador.

Figura 2.1 - Resultado de execução da função da Figura 2

Exemplo 2

Na função da Figura 3, temos outro exemplo de uso deste bloco. Nela, obtemos a hora atual e verificamos se o minuto é ímpar. Em caso afirmativo, o bloco Inserir ou alterar valor na requisição armazena a hora atual. Caso contrário, o bloco Obter valor na requisição obtém o valor armazenado. Configure a função de bloco de programação como a imagem abaixo:

Figura 3 – Função que será executada por uma requisição REST

1. Defina uma variável com o nome "horaAtual" e, nela, insira o bloco Obter data e hora atual.
2. Defina uma variável com o nome "minuto" e, nela, insira o bloco Obter minuto da data com a variável "horaAtual".
3. Utilizamos os blocos imprime e criar texto com para imprimir a variável "horaAtual".
4. Insira o bloco se faça e, nele, o bloco é par, configurado com a opção ímpar, com a variável "minuto".
5. No parâmetro faça do bloco condicional, adicione os blocos imprime e criar texto com para imprimir a variável "minuto" e, na sequência, o bloco Inserir ou alterar valor na requisição. No parâmetro Nome do campo do bloco, inserimos o texto "horaComMinutoImpar" e, no Valor do campo, a variável "horaAtual".
6. No parâmetro senão, insira os blocos imprime e criar texto com para imprimir o valor da requisição, utilizando o bloco Obter valor na requisição.

A função acima foi executada várias vezes por meio de requisições REST. O resultado dessas execuções pode ser visualizado na imagem a seguir. Em destaque, na imagem, vemos o resultado de impressão do bloco Obter valor na requisição.

Observe que todos os valores da requisição estão sem resultado, isso acontece porque foram feitas várias requisições à função e, em nenhuma delas, devido à condição utilizada, os blocos Inserir ou alterar valor na requisição e Obter valor na requisição foram executados ao mesmo tempo, diferente do Exemplo 1. Esse exemplo deixa claro que as variáveis associadas a uma requisição só podem ser utilizadas apenas durante a execução dessa requisição, sendo descartadas ao seu término.

Figura 3.1 - Resultado das execuções da função da Figura 3

Exemplo 3

Para visualizar outro exemplo de uso do bloco Inserir ou alterar valor na requisição, consulte o tópico Paginação do tutorial Tratar recurso REST de terceiros no Cronapp. No tutorial apresentado, são detalhados os passos de configuração dos blocos de programação, fonte de dados e grade para tratar a paginação através do endereço de requisição de uma API.

Para trabalhar com a paginação, a fonte de dados necessita saber a quantidade total de elementos da API. Dessa forma, foi criada uma função utilizando o bloco Inserir ou alterar valor na requisição para guardar essa informação apenas no período de requisição à API. Além disso, para retornar o valor da variável de requisição na fonte de dados, foi criada outra função utilizando o bloco Obter valor na requisição. Consulte o tutorial para mais informações.