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 em tempo de execução.
• Após o carregamento dos dados, os dados das entidades são atualizados somente quando uma regra é executada. Quaisquer atualizações feitas no Data Service através de processos ou por outros meios não serão automaticamente coletadas. Certifique-se de atualizar os dados explicitamente nesses cenários.
• O operador in só é compatível com tipos de dados primitivos, como string, number, boolean e 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.

Observação:

Dependendo das necessidades do seu projeto, você pode optar por excluir certas condições ao usar a função Filtro . Para excluir uma condição, você pode escrever uma expressão que resolva o campo de filtro (primeiro parâmetro da matriz de condição) para um null. Por exemplo, você pode usar o seguinte:

Filter(Customer, [If(IsBlank(Dropdown.Value), null, City), "=", Dropdown.Value])

Neste caso, o filtro por Cidade só é aplicado quando o Dropdown contém um valor diferente de em branco.

Utilize a função Filtrar para recuperar vários registros de entidade aplicáveis à condição determinada. Para selecionar um único registro, use a função Pesquisar.

1. Abra seu aplicativo existente ou inicie um novo.
2. Criar uma tabela.

3. Adicione uma entidade ao seu aplicativo clicando no botão Adicionar qualquer ícone na parte superior da tela e selecionando Entity.

   
   

   

   
   
4. Associe a entidade recém-adicionada à tabela, adicionando-a no campo Origem dos dados da tabela.
5. Filtre as informações da tabela por estado usando a função Filtrar. Neste exemplo, para filtrar o cliente pelo estado da Califórnia, adicione a seguinte expressão na propriedade Origem de dados da tabela: = Filter(Customer, [State, "=", "CA"]).
   
   

   

   
   

Classificar clientes

Use a função Classificar para classificar clientes pelo nome.

1. Abra seu aplicativo existente ou inicie um novo.
2. Criar uma tabela.

3. Adicione uma entidade ao seu aplicativo clicando no botão Adicionar qualquer ícone na parte superior da tela e selecionando Entity.

   
   

   

   
   

4. Associe a entidade recém-adicionada à tabela, adicionando-a no campo Origem dos dados da tabela.

   
   

   

   
   
5. Classifique as informações a partir da tabela por nome em ordem decrescente usando a função Classificar. Neste exemplo, adicione a seguinte expressão na propriedade Origem de dados da tabela: = Sort(Customer, Name, "Desc").
   
   

   

   
   

Editar uma tabela

Neste exemplo, vamos criar uma tabela de dados com três botões:

• Criar Novo
• Editar selecionados
• Excluir selecionados

Os botões Criar novo e Editar selecionados levarão à mesma página.

1. Abra seu aplicativo existente ou inicie um novo.
2. Criar uma tabela.

3. Crie dois botões na parte superior da tabela: Editar Selecionados e Criar. Crie um terceiro botão, na parte inferior da tabela, chamado Excluir Selecionados.

   
   

   

   
   

4. Adicione uma entidade a seu aplicativo clicando no ícone Adicionar qualquer na parte superior da tela e selecionando Entidade.

   
   

   

   
   

5. Associe a entidade recém-adicionada à tabela, adicionando-a no campo Origem dos dados da tabela.

   
   

   

   
   

6. Crie uma página chamada Editar/Criar cliente e adicione os seguintes controles:

   6.1 Adicione os campos de texto correspondentes para cada um dos campos de entidade e os Associe.

   6.2 Adicione um botão abaixo dos campos de texto e o chame de Salvar.

   
   6.3 Configure uma variável chamada selectedCustomerId, usando uma regra Definir valor, no evento de alteração de valor da tabela. Associe a variável à Table.SelectedValue.Id para usá-la em outra página.
   
   6.4 Adicione uma regra If-Then-Else ao botão Save e configure-a: Adicione a seguinte expressão no campo If : =selectedCustomerId = ="", conforme a figura abaixo.
   

• Adicione uma regra Criar/atualizar registro da entidade, no campo Then e configure-a conforme mostrado na figura abaixo:

  

• Adicione a regra Criar/atualizar registro da entidade, no campo Else, adicionando a seguinte expressão no campo Qual registro de entidade deve ser criado/atualizado?: =Lookup(Customer, [Id, "=", selectedCustomerId]), no qual Id é a ID da entidade. Configure a regra conforme figura abaixo.

  

7. Adicione um regra Excluir registro da entidade ao botão Excluir selecionado na etapa 3 e adicione a seguinte expressão no campo Qual registro de entidade deve ser excluído?:* Lookup(Customer, [Id, "=', Table.Id]).

8. Configure os botões Editar selecionado e Criar novo do passo 3 para levar à página Editar/Criar cliente.