Como usar o Apps com o Data Service

Informações em segundo plano

Para obter mais informações sobre as funções e regras relacionadas às Entidades, consulte os seguintes guias:

• Função: filtro
• Função: classificar
• Função: pesquisar
• Função: nova
• Regra: criar/atualizar registro da entidade
• Regra: excluir registro da entidade

Observaçã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. Add an entity to your app by clicking on the next to the app's name and selecting 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. 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. Add an entity to your app by clicking on the next to the app's name and selecting Entity.

   

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. Add an entity to your app by clicking on the next to the app's name and selecting Entity.

   

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.