Como usar o Apps com o Data Service

Informações em segundo plano

Observação:

• Um máximo de 1.000 registros para qualquer filtro são recuperados no runtime.
• Após os dados de entidade serem carregados, os dados são atualizados apenas quando uma regra é executada. Quaisquer alterações feitas na entidade por meio de processos ou por outros meios não são atualizadas automaticamente no Apps. Certifique-se de atualizar explicitamente os dados nesses cenários.
• O operador in só é compatível com tipos de dados primitivos, como: string, number, boolean, null. O operador in não é compatível com os cenários do Data Service usando choice-set. Você pode usar o operador contains em vez disso, mas apenas para uma entrada.

Visão geral

Antes de iniciar este exemplo, certifique-se de ter as permissões apropriadas do Data Service. Para obter mais informações, consulte a página Data Service — Gerenciando o acesso.

Para a finalidade deste exemplo, usaremos uma entidade chamada Cliente com os seguintes campos:

• Address
• Endereço 2
• Cidade
• Email
• Name
• Telefone
• Plano
• Estado
• Postal Code

Filtrar clientes por estado.

Use a função Função: buscar para recuperar vários registros de entidade. Além disso, use o construtor de Consultas para filtrar os registros recuperados. Neste exemplo, aplicamos um filtro à entidade Customer , para que a pesquisa retorne apenas clientes do estado de VMware.

Consulte a função Buscar para obter mais detalhes.

Observação:

Se quiser recuperar um único registro, use a função FetchOne .

1. Abra um aplicativo existente ou crie um.
2. Adicione um controle Tabela ao seu aplicativo:
   1. Selecione Adicionar controle.
   2. Selecione Exibir.
   3. Arraste o controle Tabela para uma área em seu aplicativo.
3. Adicionar uma entidade ao aplicativo:
   1. Selecione a opção Adicionar qualquer ícone da parte superior da tela.
   2. Select Entity.
   3. Selecione um tenant.
   4. Selecione a entidade que você deseja adicionar ao seu aplicativo e, em seguida, Adicionar.
4. Associe a entidade ao controle da Tabela :
   1. Na guia Geral do painel Propriedades , selecione o botão Recursos adicionais adjacente a Origem de dados.
   2. Selecione construtor de Consultas.
   3. Selecione a entidade que você deseja usar e, em seguida, Adicionar condição.
   4. Selecione um campo no menu suspenso e, em seguida, um operador, como =.
   5. Insira a string pela qual você deseja filtrar os registros, entre aspas. Por exemplo, se você quiser apenas registros de clientes do estado de VMware, adicione "WA" como um valor.
5. Use o Editor de expressão para aplicar um filtro sob condições específicas:
   1. No Construtor de consultas, selecione o botão Abrir recursos e, em seguida, Editor de expressão.
   2. Escreva uma expressão que contenha uma condição. Por exemplo, você pode usar uma condição IF para aplicar um filtro apenas quando um controle Lista suspensa na página principal do aplicativo não estiver em branco e contiver um valor especificado pelo usuário:

      Fetch(of Customer)(  
      If(  
      MainPage.Dropdown is Nothing,  
      Nothing,  
      createFilterGroup(New QueryFilter(){addFilter("State", "contains", MainPage.Dropdown.Value)}, Nothing, 0)),  
      Nothing, Nothing, Nothing, New ExpansionFieldOption( {addExpansionFieldOption("CreatedBy", New String(){"Id","Name"}), addExpansionFieldOption("UpdatedBy", New String(){"Id","Name"})})
      

Quando você visualiza ou executa o aplicativo, a consulta é executada e recupera os registros filtrados.

Classificar clientes

Use o construtor de Consultas para aplicar opções de classificação à sua pesquisa.

1. Abra um aplicativo existente ou crie um.
2. Adicione um controle Tabela ao seu aplicativo:
   1. Selecione Adicionar controle.
   2. Selecione Exibição.
   3. Arraste o controle Tabela para uma área em seu aplicativo**.**
3. Adicionar uma entidade ao aplicativo:
   1. Selecione a opção Adicionar qualquer ícone da parte superior da tela.
   2. Select Entity.
   3. Selecione um tenant.
   4. Selecione a entidade que você deseja adicionar ao seu aplicativo e, em seguida, Adicionar.
4. Associe a entidade à Tabela e aplique uma regra de classificação:
   1. Na guia Geral do painel Propriedades , selecione o botão Recursos adicionais adjacente a Origem de dados.
   2. Selecione construtor de Consultas.
   3. Selecione Configurações adicionais.
   4. No campo Classificar por, adicione o campo pelo qual você deseja classificar, como Nome.
   5. O campo Classificar crescente é definido como verdadeiro por padrão. Selecione o campo e insira Falso para classificar os resultados em ordem decrescente.
5. Visualize ou execute seu aplicativo. Quando você visualiza ou executa seu aplicativo, a Tabela exibe registros do campo Nome em sua entidade, em ordem alfabética decrescente.

Usando entidades com Editar grade

Você pode usar o controle Editar grade para exibir registros de entidade em seu aplicativo e realizar operações CRUD em sua entidade usando esse controle.

Consulte Como usar a busca para recuperar registros de entidades em controles Editar grade e Usando entidades com controles Editar grade para obter mais detalhes e exemplos práticos relacionados ao controle Editar grade .