Utilizar el contexto de datos

Información en segundo plano

Para obtener más información relacionada con las entidades, consulta las siguientes guías:

• Acerca del contexto de datos
• Función: filtro
• Función: ordenar
• Función: nueva
• Función: buscar
• Regla: crear/actualizar registro de entidad
• Norma: elimina el registro de entidad

Información general

Antes de iniciar este ejemplo, asegúrate de que tienes los permisos adecuados de Data Service. Para obtener más información, consulta la página Data Service: gestión de acceso.

Para este ejemplo, usaremos una entidad llamada Cliente con los siguientes campos:

• Address
• Dirección 2
• Ciudad
• Correo electrónico
• Nombre
• Teléfono
• Plan
• Estado
• Código postal

Configurar el contexto de datos

1. Abre tu aplicación ya existente o inicia una nueva.
2. Crea una nueva tabla.

3. Agregue una entidad a su aplicación haciendo clic en el botón Añadir cualquiera en la parte superior del lienzo y seleccionando Entidad.

   
   

   

   
   
4. Vincula la entidad recién añadida a la tabla añadiéndola en el campo Origen de datos de la tabla.
5. Añade la siguiente expresión en el campo Contexto de datos de la página principal: =Lookup(Customer, [Name, "=", "Demo"]).
   
   

   

   
   
6. Añade un nuevo control de cuadro de texto.

7. Añade el contexto de datos Nombre en el campo Texto predeterminado del control del cuadro de texto. Al previsualizar la aplicación y el cuadro de texto, se debería mostrar el texto configurado mediante el contexto de datos.

   
   

   

   
   

Utiliza el contexto de datos en las reglas

Crea/actualiza la regla de registro de entidad

El contexto de datos solo puede utilizarse para actualizar una entidad existente con la regla Crear/Actualizar registro de entidad.

1. Abre tu aplicación ya existente o inicia una nueva.
2. Crea una nueva tabla.

3. Agregue una entidad a su aplicación haciendo clic en el botón Añadir cualquiera en la parte superior del lienzo y seleccionando Entidad.

   
   

   

   
   
4. Vincula la entidad recién añadida a la tabla añadiéndola en el campo Origen de datos de la tabla.
5. Añade la siguiente expresión en el campo Contexto de datos de la página principal: =Lookup(Customer, [Name, "=", "Demo"]).
   
   

   

   
   
6. Añade un nuevo control de botones.

7. Configura una regla Crear/Actualizar registro de entidad para el botón. Añade el contexto de datos Página principal del cliente en el campo Qué registro de entidad debe crearse/actualizarse? La regla debe rellenarse con el contexto de datos configurado.

   
   

   

   
   

Elimina la regla de registro de entidad

1. Abre tu aplicación ya existente o inicia una nueva.
2. Crea una nueva tabla.

3. Agregue una entidad a su aplicación haciendo clic en el botón Añadir cualquiera en la parte superior del lienzo y seleccionando Entidad.

   
   

   

   
   
4. Vincula la entidad recién añadida a la tabla añadiéndola en el campo Origen de datos de la tabla.
5. Añade la siguiente expresión en el campo Contexto de datos de la página principal: =Lookup(Customer, [Name, "=", "Demo"]).
   
   

   

   
   
6. Añade un nuevo control de botones.

7. Configura la regla Eliminar registro de entidad para el botón. Añade el contexto de datos Página principal del cliente en el campo ¿Qué registro de la entidad debe ser eliminado? La regla debe eliminar el contexto de datos configurado.

   
   

   

   
   

Utilizar la función Nuevo

1. Abre tu aplicación ya existente o inicia una nueva.
2. Crea una nueva tabla.

3. Agregue una entidad a su aplicación haciendo clic en el botón Añadir cualquiera en la parte superior del lienzo y seleccionando Entidad.

   
   

   

   
   
4. Vincula la entidad recién añadida a la tabla añadiéndola en el campo Origen de datos de la tabla.
5. Añade la siguiente expresión en el campo Contexto de datos de la página principal: =New(Customer).
   
   

   

   
   

6. Añade dos controles de cuadro de texto:

   • Añade Data Context.Name en la propiedad Vinculación de valor del primer control del cuadro de texto.
   • Añade Data Context.City en la propiedad Vinculación de valor del segundo control del cuadro de texto.
7. Añade un nuevo control de botones.
8. Configura una regla Crear/Actualizar registro de entidad para el botón. Añade el contexto de datos Cliente en el campo ¿Qué registro de entidad debe crearse/actualizarse? Al hacer esto, los datos se vinculan automáticamente a los campos.

9. Elimina los datos no utilizados de los campos. Asegúrate de mantener los datos configurados en el paso 6 en los campos Valores a establecer.

   
   

   

   
   

Resultados del procedimiento

En tiempo de ejecución, cuando se añade el nombre y la ciudad del nuevo cliente en los dos campos de texto y se pulsa el botón, se añade una nueva entrada a la tabla.

Referencias a entidades de diferentes páginas

Para referirse directamente al valor de campo de una entidad seleccionada de una tabla de una página diferente, hay que usar al menos una variable.

En lugar de crear variables para cada campo, puedes usar una para la ID de entidad. En la segunda página puedes hacer lo siguiente:

1. Añade un control de contenedor.
2. Configura la propiedad Contexto de datos del contenedor de la forma siguiente: Lookup (Entity, [id, "=", myVariableID]).
3. Añade los controles necesarios dentro del contenedor y vincúlalos a los campos disponibles para la entidad disponible en Contexto de datos.

En este caso puedes usar la función Búsqueda porque se puede tratar como una entidad Object. Esto significa que puedes actualizar dicha entidad usando la regla Crear/actualizar registro de entidad en el contexto de datos del contenedor.