Mudar formulário
um novo .| title | Obs.: |
|---|
Parâmetros de Entrada
| Nome | Tipo | Doc |
|---|---|---|
| Parâmetro 1 | string | Conteúdo a ser passado de um formulário para outro |
| Parâmetro n | string | Conteúdo a ser passado de um formulário para outro |
Servidor
Cliente
Exemplo 1
A função abaixo muda o formulário corrente para um novo formulário passando através do URL o parâmetro definido no corpo da função.
Utilização da função
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
Para mais informações sobre como fazer a vinculação acesse o link abaixo.
| Informações | ||
|---|---|---|
| ||
Sobre o bloco
O bloco Mudar formulário pode ser configurado clicando-se no botão de configuração.
Configuração da função
A tela de configuração chama-se Abrir Formulário. Nela é possível definir qual o formulário de destino e os parâmetros que serão passados.
(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
Nome do controle
Parâmetro a ser passado para o novo formulário
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
| Índice |
|---|