Como usar as funções Fetch

A seguir encontram-se dois exemplos de como aplicar as funções Fetch e FetchOne na prática.

Uso de Buscar para recuperar registros de entidade nos controles Editar grade

Use a função Buscar para recuperar todos os registros de entidade de uma entidade do Data Service, em conjunto com um controle tabular como Editar grade.

1. Adicionar uma entidade ao aplicativo:
   1. Selecione Adicionar qualquer.
   2. Selecione Entidade.
   3. Selecione um tenant.
   4. Selecione a entidade que você deseja adicionar ao seu aplicativo e depois Adicionar.
2. Adicione um controle Editar grade ao seu aplicativo:
   1. Selecione Adicionar controle.
   2. Selecione Exibir.
   3. Selecione Editar grade e arraste-o para uma área em seu aplicativo.
3. Associe o controle Editar grade à sua entidade:
   1. No painel Propriedades , na guia Geral , selecione o botão Recursos adicionais adjacente à Origem de dados.
   2. Selecione construtor de Consultas.
   3. Selecione a entidade que você deseja usar e, em seguida, Salve. O sistema prepara automaticamente uma expressão VB Fetch .
4. Visualize ou execute seu aplicativo.

Ao visualizar seu aplicativo, o controle Editar grade é preenchido com todos os registros da sua entidade.

Uso da função VB FetchOne para recuperar um registro de entidade e exibi-lo em um controle de Rótulo

Use a função FetchOne para recuperar um único registro de uma entidade do Data Service e use-o em controles de exibição, como o controle Rótulo , em seus aplicativos.

1. Adicionar uma entidade ao aplicativo:
   1. Selecione Adicionar qualquer.
   2. Selecione Entidade.
   3. Selecione um tenant.
   4. Selecione a entidade que você deseja adicionar ao seu aplicativo e depois Adicionar.
2. Adicione um rótulo ao seu aplicativo:
   1. Selecione Adicionar controle.
   2. Selecione Exibir.
   3. Selecione Rótulo e arraste-o para uma área em seu aplicativo.
3. Adicione uma variável ao seu aplicativo:
   1. Selecione Adicionar qualquer.
   2. Selecione Variável.
   3. Dê um nome à sua variável.
   4. Em Tipo, selecione sua entidade e, em seguida, Salve.
4. Adicione uma regra à página principal do seu aplicativo:
   1. Selecione a página principal do seu aplicativo.
   2. No painel Propriedades , selecione Eventos.
   3. Em Carregado, selecione Criar regra.
5. Associe a regra à sua variável:
   1. Selecione Definir valor.
   2. Em Item a definir, selecione a variável que você adicionou na etapa 3.
   3. Selecione Valor e, em seguida, construtor de Consultas.
   4. Selecione sua entidade e, em seguida, Salve. O sistema prepara automaticamente uma expressão VB Fetch .
   5. Em Valor, selecione a expressão e substitua Fetch por FetchOne.
6. Associe o Rótulo à variável:
   1. Selecione o Rótulo que você adicionou na etapa 2.
   2. No painel Propriedades , selecione o botão Abrir recursos adjacente ao campo Texto .
   3. Selecione Editor de expressão.
   4. No editor de Expressão, adicione o nome da sua entidade seguido do nome de um campo na sua entidade. Separe os dois com um ponto:
      Entity.Field
7. Visualize ou execute seu aplicativo.

Ao executar o aplicativo, o Rótulo será preenchido automaticamente com um único registro do campo de entidade que você especificou.