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, vamos usar uma entidade chamada Cliente , contendo 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. Nesse exemplo, aplicamos um filtro à entidade Cliente , para que a pesquisa retorne apenas clientes do estado de Washington.

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

Observação:

Se você quiser recuperar um único registro, em vez disso 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 na parte superior da tela.
   2. Selecione Entidade.
   3. Selecione um tenant.
   4. Selecione a entidade que você deseja adicionar ao seu aplicativo e depois Adicionar.
4. Associe a entidade ao controle 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 Washington, 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 de 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 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 na parte superior da tela.
   2. Selecione Entidade.
   3. Selecione um tenant.
   4. Selecione a entidade que você deseja adicionar ao seu aplicativo e depois 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 Classificação crescente é definido como verdadeiro por padrão. Selecione o campo e insira False 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 Uso de Buscar para recuperar registros de entidade em controles Editar grade e Uso de entidades com controles Editar grade para obter mais detalhes e exemplos práticos relacionados ao controle Editar grade .