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:

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:

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.

Abra seu aplicativo existente ou inicie um novo.
Criar uma tabela.
Adicione uma entidade ao aplicativo, clicando em , ao lado do nome do aplicativo e selecionando Entidade.
Associe a entidade recém-adicionada à tabela, adicionando-a no campo Origem dos dados da tabela.
Filtre as informações da tabela por estado. 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

Abra seu aplicativo existente ou inicie um novo.
Criar uma tabela.
Adicione uma entidade ao aplicativo, clicando em , ao lado do nome do aplicativo e selecionando Entidade.
Associe a entidade recém-adicionada à tabela, adicionando-a no campo Origem dos dados da tabela.
Classifique as informações da tabela por nome e em ordem descendente. 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.

Abra seu aplicativo existente ou inicie um novo.
Criar uma tabela.
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.
Adicione uma entidade ao aplicativo, clicando em , ao lado do nome do aplicativo e selecionando Entidade.
Associe a entidade recém-adicionada à tabela, adicionando-a no campo Origem dos dados da tabela.
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. Adicione a regra Excluir registro da entidade ao botão Excluir selecionado, da etapa 3. Depois, adicione a seguinte expressão no campo Qual registro de entidade deve ser excluído? campo: Lookup(Customer, [Id, "=', Table.Id]).