Obter parâmetro da query string

O bloco obtém Obtém o valor do parâmetro query string da requisição REST atual.

Parâmetro

Retorno

Image Added

Figura 1 - Bloco Obter parâmetro da query string

Compatibilidade

• Bloco servidor: cronapi.screen.Operations.getParam()

Retorno

Retorna uma string contendo Retorna um texto com o valor do parâmetro selecionado da URL.

Compatibilidade

Image Removed Cliente

Exemplo

A função da figura 1 obtém o valor de 2 parâmetros ("user" e "system") da URL, alimenta as variáveis "param_user" e "param_system" e em seguida notifica o usuário. 

Figura 1 - Executando o bloco cliente Obter parâmetro da query string

O botão "Executa ObtemParametroQueryString" (Figura 2) chama o bloco de programação da Figura 1 que exibe em forma de notificação os parâmetros da URL.

Figura 2 - Notificação dos parâmetros da query string

requisição REST atual.

Parâmetros

Campo

Nome do parâmetro da query string.

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

Exemplo

Neste exemplo, iremos alimentar uma Fonte de dados usando a função apresentada na Figura 2.1, que, por sua vez, atualizará o componente visual da grade na tela.

Image Added

Figura 2 - Configuração da Fonte de dados alimentada pelo bloco de programação

Quando solicitamos a ordenação da grade a partir de uma coluna, uma nova requisição é enviada à Fonte de Dados. Esta requisição inclui o parâmetro de query string "$orderby", que pode ser obtido através do bloco Obter parâmetro da query string para realizar algum tratamento. Na imagem abaixo, iremos imprimir o valor do parâmetro "$orderby" no console do depurador após a ordenação da coluna "name" da grade (destaque 1 da Figura 2.2).

Image Added

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

Na imagem a seguir, podemos visualizar a requisição de ordenação feita para a Fonte de dados e o parâmetro da requisição $orderby em (destaque 2 da Figura 2.2).

Image Added

Figura 2.2 - Requisição de ordenação para a Fonte de dados