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, 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:

Depending on your project's needs, you can choose to exclude certain conditions when using the Filter function. To exclude a condition, you can write an expression that resolves the filter field (first parameter of the condition array) to a null. For example, you can use the following:

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

In this case, the filter on City is only applied when the Dropdown contains a value other than blank.

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 a seu aplicativo clicando no botão Adicionar qualquer ícone da parte superior da tela e selecionando Entidade.

   

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. Neste exemplo, para filtrar os clientes pelo estado da Califórnia, adicione a seguinte expressão na propriedade Fonte de dados property da tabela: = Filter(Customer, [State, "=", "CA"]).

Classificar clientes

1. Abra seu aplicativo existente ou inicie um novo.

2. Criar uma tabela.

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

   

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

   

5. Classifique as informações da tabela por nome e em ordem descendente. Neste exemplo, adicione a seguinte expressão na propriedade Fonte de dados property 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 botão Adicionar qualquer ícone da 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 Salvar e configure-a:

• Adicione a seguinte expressão no campo If: =selectedCustomerId = ="", como na 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. Add a Delete Entity Record rule to the Delete Selected button from step 3 and add the following expression in the Which entity record should be deleted? field: Lookup(Customer, [Id, "=', Table.Id]).

8. Configure tanto a regra Editar selecionado e Criar do passo 3 para levar à página Editar/Criar cliente.