Retorna para o primeiro registro de uma fonte de dados.
Figura 1 - Bloco Ir para Primeiro Registro
Compatibilidade
Bloco cliente: cronapi.screen.firstRecord()
Bloco servidor: cronapi.screen.firstRecord() - executado a partir da chamada do bloco cliente.
Retorno
O bloco não possui retorno.
Parâmetros
Fonte de dados
Componente Fonte de dados que será vinculado ao bloco. A utilização da função Fonte de Dados depende da forma correta de vinculação do bloco de programação ao formulário contendo 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 utiliza umlaçode repetição para percorrer todos os registros dafonte de dadosAluno, com base no númerototal de registros. Em seguida, verificasehá um próximo registro na fonte usando o bloco Existe Próximo Registro?. A verificação começa a partir do primeiro elemento. Caso a condição seja verdadeira,obtemos o nome do alunoe oimprimimosno console do navegador. Após isso,avançamospara o próximo registro da fonte. A função continua executando até que o bloco "Existe Próximo Registro"retornefalse, indicando que o registro atual é o último da lista. Nesse caso, o blocoIr para Primeiro Registro é acionado, fazendo com que o primeiro registro da fonte de dados seja exibido novamente, finalizando a execução.
Figura 2 - Função que imprime o nome dos alunos no console do navegador
Adicionamos a função no eventoAo Clicarem umbotãopresente naviewAluno, o resultado da execução da função pode ser conferido abaixo. Observe que o quarto registro não foi retornado pois a verificação feita no bloco condicional deu false, então a função acionou o bloco Ir para Primeiro Registro, fazendo com que o primeiro registro fosse exibido novamente.
Figura 2.1 - Resultado da execução da função da figura 2