Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: DI-2320

Avança registro

Avança um registro em uma fonte

Esta função avança o cursor para o próximo registro da Fonte de dados.

Parâmetros de Entrada

NomeTipoDoc
Parâmetro 1Fonte de dadosFonte de dados a ser percorrida

Compatibilidade

Image Removed Servidor

Image Removed Cliente

Exemplo 1

A função abaixo avança um registro por vez na fonte de dados User, exibindo o conteúdo do campo login através da função Exibir Notificação. 

Image Removed

Utilização da função


Image Added

Figura 1 - Bloco Avança registro

Compatibilidade

  • Bloco cliente: cronapi.screen.nextRecord()
  • Bloco servidor: cronapi.screen.nextRecord() - executado a partir da chamada do bloco cliente.

Retorno

A função não possui retorno.

Parâmetros

Fonte de dados

Componente Fonte de dados que será vinculado ao bloco. A utilização da função Avança registro

A utilização da função Avança registro 

depende da forma correta de vinculação do bloco de programação ao formulário contendo

a fonte dados a ser utilizada.

Para mais informações sobre como fazer tal vinculação acesse o link abaixo.

Informações
titleMais sobre

Vinculando bloco de programação ao formulário

 

Sobre o bloco

Para que se possa utilizar funções que dependam de fonte de dados, é necessário criá-las antecipadamente. Essa criação se dá através do controle Fonte de dados. 

Image Removed

 Controle Fonte de dados

 

Dentre suas propriedades está Nome, responsável por identificar unicamente a fonte de dados criada, deixando-a disponível para uso no seletor dos blocos que utilizam fontes da dados.

Image Removed

 Fontes de dados criadas e com suas propriedades

os componentes com os quais se deseja interagir. Acesse o tópico "Propriedades do Blockly", da documentação Bloco de programação, para mais detalhes.

  • Posição: 1
  • Inglês: Datasource
  • Tipo: Fonte de dados / Datasource
  • Exemplo: Fonte de dados Aluno

Exemplo

A função abaixo imprime o nome do aluno no registro atual da Fonte de dados, avança o cursor para o próximo registro e, por fim, imprime o nome do aluno do registro seguinte.


Image Added

Figura 2 - Função que exibe os registros da grade


O resultado da função pode ser conferido abaixo. Inicialmente, o primeiro registro foi impresso no console do navegador. Posteriormente, o bloco Avança registro foi acionado, fazendo com que a fonte de dados apontasse para o segundo registro, que foi impresso em seguida.


Image Added

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

Nesta página

Índice

de Nome definidas para: User, Role e AllRole