- Created by Unknown User (557058:4b1b311a-8636-4ab4-87d8-6a41e4d941bf), last modified by Laila Maria Vieira Souza on 03/06/2024
Redireciona para o formulário informado no bloco. É possível passar parâmetros durante o processo de mudança de formulário.
Figura 1 - Bloco Mudar formulário
Compatibilidade
- Bloco cliente: cronapi.screen.changeView()
- Bloco servidor: cronapi.screen.changeView() - executado a partir da chamada do bloco cliente.
Características do bloco
Para configurar o bloco Mudar formulário, clique no ícone de engrenagem (seta da Figura 2). Após esta ação, a janela "Abrir Formulário" será exibida, clique no ícone de menu (1) para vincular o formulário que será utilizado para redirecionar o usuário. Essa janela exibirá somente formulários web para blocos de programação web, a mesma lógica se aplica para blocos de programação mobile, porém, para blocos de programação do tipo servidor, a janela "Abrir Formulário" exibirá tanto formulários web quanto mobile. Utilize o campo de pesquisa (2) para buscar pelo formulário desejado.
Figura 2 - Configuração do bloco Mudar formulário
Retorno
O bloco não possui retorno.
Parâmetros
Parâmetro "N"
Os parâmetros da função são exibidos de acordo com a necessidade do usuário no campo "Parâmetros" da janela Abrir formulário. A utilização da função Mudar formulário depende da forma correta de vinculação do bloco de programação ao formulário (figura 2).
- Posição: 1 ou mais
- Tipo: Depende do tipo do dado do atributo.
Exemplo 1 - Mudando de formulário
Após ser acionada, a função abaixo alterna entre o formulário atual e o formulário escolhido pelo usuário na janela "Abrir Formulário" (figura 2).
Figura 3 - Função que alterna para uma view selecionada na janela Abrir formulário
A figura 3.1 exibe o formulário atual, "ChangeView1", antes da execução da função.
Figura 3.1 - View padrão antes do acionamento da função
Após vincular a função no evento Ao Clicar, acionamos o botão, fazendo com que a view alternasse para o formulário de destino, "ChangeView2".
Figura 3.2 - View exibida após a execução da função da figura 3
Exemplo 2 - Passagem de Parâmetro
É possível passar parâmetros da tela de uma view para o bloco de programação Mudar formulário. Clique com o botão direito do mouse na view desejada, no menu de contexto que será exibido selecione a opção "Parâmetros da tela", em seguida, acesse o menu indicado pelo destaque 1 da figura 4 na propriedade "Parâmetros de tela". No campo "Nova propriedade" (2), insira o nome do parâmetro que deseja passar para o bloco e clique no botão "+
" para adicioná-lo. Neste exemplo, criamos os parâmetros "param1" e "param2".
Figura 4 - Criando os parâmetros da tela
Ao vincular o formulário de referência ao bloco, ele exibirá os dois parâmetros criados anteriormente na view, dessa forma, incluímos nos dois parâmetros os valores "valor1" e "valor2", respectivamente.
Figura 4.1 - Função Mudar formulário com parâmetros
Ao acionar a função, é possível notar a mudança no endereço, agora ele exibe o nome da página, os parâmetros passados pela view e os valores informados no bloco.
Figura 4.2 - View apresentando os parâmetros passados na tela
Exemplo 3 - Passando parâmetros
O processo inverso também é permitido, é possível passar parâmetros criados no bloco pra uma view específica. Clique no ícone de engrenagem da função e no campo "Parâmetro", insira o nome do parâmetro que deseja enviar para a view e clique no botão "+
" para adicioná-lo.
Figura 5 - Criando os parâmetros no bloco
Após isso, passamos o valor que desejamos enviar para a view, neste caso "valorMeuParam".
Figura 5.1 - Definindo o valor do parâmetro
Para que o conteúdo passado como parâmetro da função possa ser resgatado no formulário, é necessário que o parâmetro definido no campo "Parâmetros de tela" (destaque 1 da figura 5.2) tenha o mesmo nome do parâmetro definido no bloco. A utilização do prefixo params
. é obrigatória.
Figura 5.2 - Passando o parâmetro para a view
Por fim, ao executar a função, é possível ver que o parâmetro passado pelo bloco foi recuperado na view.
Figura 5.3 - Resultado obtido após a execução da função da figura 5.1
Nesta página