Uso do Contexto de dados

Informações em segundo plano

Para obter mais informações relacionadas às entidades, consulte os seguintes manuais:

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

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

Como configurar o contexto de dados

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

3. Adicione uma entidade ao aplicativo, clicando em , ao lado do nome do aplicativo e selecionando Entidade.

   
   

   

   
   
4. Associe a entidade recém-adicionada à tabela, adicionando-a no campo Origem dos dados da tabela.
5. Adicione a seguinte expressão no campo Contexto de dados da página principal: =Lookup(Customer, [Name, "=", "Demo"]).
   
   

   

   
   
6. Adicione um novo controle de caixa de texto.

7. Adicione o contexto de dados do Nome, no campo Texto padrão do controle de caixa de texto. Visualizar o aplicativo e a caixa de texto deverá exibir o texto configurado com o contexto de dados.

   
   

   

   
   

Como usar o contexto de dados nas regras

Regra Criar/Atualizar a registro de entidade

O contexto de dados somente pode ser usado para atualizar uma entidade existente com a regra Criar/Atualizar registro de entidade.

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

3. Adicione uma entidade ao aplicativo, clicando em , ao lado do nome do aplicativo e selecionando Entidade.

   
   

   

   
   
4. Associe a entidade recém-adicionada à tabela, adicionando-a no campo Origem dos dados da tabela.
5. Adicione a seguinte expressão no campo Contexto de dados da página principal: =Lookup(Customer, [Name, "=", "Demo"]).
   
   

   

   
   
6. Adicione um novo controle de botão.

7. Configure uma regra Criar/Atualizar registro de entidade em relação ao botão. Adicione o contexto de dados da página principal do cliente no campo Qual registro de entidade deve ser criado/atualizado? . A regra deve ser preenchida com o contexto de dados configurado.

   
   

   

   
   

Excluir a regra Registro de entidade

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

3. Adicione uma entidade ao aplicativo, clicando em , ao lado do nome do aplicativo e selecionando Entidade.

   
   

   

   
   
4. Associe a entidade recém-adicionada à tabela, adicionando-a no campo Origem dos dados da tabela.
5. Adicione a seguinte expressão no campo Contexto de dados da página principal: =Lookup(Customer, [Name, "=", "Demo"]).
   
   

   

   
   
6. Adicione um novo controle de botão.

7. Configure uma regra Excluir registro de entidade em relação ao botão. Adicione o contexto de dados da página principal do cliente no campo Qual registro de entidade deve ser excluído? . A regra deve excluir o contexto de dados configurado.

   
   

   

   
   

Como usar a função Novo

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

3. Adicione uma entidade ao aplicativo, clicando em , ao lado do nome do aplicativo e selecionando Entidade.

   
   

   

   
   
4. Associe a entidade recém-adicionada à tabela, adicionando-a no campo Origem dos dados da tabela.
5. Adicione a seguinte expressão no campo Contexto de dados da página principal: =New(Customer).
   
   

   

   
   

6. Adicione dois controles de caixa de texto:

   • Adicione Data Context.Name na propriedade Associação de Valor do primeiro controle de caixa de texto.
   • Adicione Data Context.City na Value Binding property do segundo controle de caixa de texto.
     
     

     

     
     
7. Adicione um novo controle de botão.

8. Configure uma regra Criar/Atualizar registro de entidade em relação ao botão. Adicione o contexto de dados do Cliente, no campo Qual registro de entidade deve ser criado/atualizado? . Ao fazer isso, os dados serão automaticamente associados aos campos.

   
   

   

   
   

9. Remova os dados não utilizados dos campos. Certifique-se de manter os dados configurados na etapa 6, nos campos de Valores a definir.

   
   

   

   
   

Resultados do procedimento

No tempo de execução, ao adicionar o nome e a cidade do novo cliente nos dois campos de texto e clicar no botão, uma nova entrada será adicionada à tabela.

Referenciando entidades de diferentes páginas

Para consultar diretamente um valor de campo de entidade selecionado de uma tabela em uma página diferente, você precisa usar pelo menos uma variável.

Em vez de criar variáveis para cada campo, você pode usar uma para a ID de entidade. Na segunda página, você pode fazer o seguinte:

1. Adicione um controle de contêiner.
2. Configure a propriedade Contexto de dados do contêiner da seguinte forma: Lookup (Entity, [id, "=", myVariableID]).
3. Adicione os controles necessários dentro do contêiner e vincule-os aos campos disponíveis para a entidade disponível no Contexto de dados.

Você pode usar a função Pesquisar neste caso, porque você pode tratá-la como um objeto de entidade. Isso significa que você pode atualizar aquela entidade usando a regra Criar/Atualizar Registro de entidade no contexto de dados do contêiner.