Uso de Apps con Data Service

Información en segundo plano

Nota:

• Se recupera un máximo de 1000 registros para cualquier filtro en tiempo de ejecución.
• Una vez cargados los datos de la entidad, los datos se actualizan solo cuando se ejecuta una regla. Cualquier cambio realizado en la entidad a través de procesos u otros medios no se actualiza automáticamente en Apps. Asegúrate de actualizar explícitamente los datos en estos escenarios.
• El operador in solo admite tipos de datos primitivos, como: string, number, boolean, null.

El operador in no se admite en los escenarios de Data Service mediante el uso de choice-set. En su lugar puedes usar el operador contains pero solo para una entrada.

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, utilizaremos una entidad llamada Cliente con los siguientes campos:

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

Filtrar cliente por estado

Use the Function: Fetch function to retrieve multiple entity records. Additionally, use the Query builder to filter the retrieved records. In this example, we apply a filter to the Customer entity, so the search only returns customers from the state of Washington.

Refer to The Fetch function for more details.

Nota:

If you want to retrieve a single record, use the FetchOne function instead.

1. Abre una aplicación existente o crea una nueva.
2. Añade un control Tabla a tu aplicación:
   1. Selecciona Añadir control.
   2. Selecciona Pantalla.
   3. Arrastra el control Tabla a un área de tu aplicación.
3. Añade una entidad a tu aplicación:
   1. Selecciona la opción Añadir cualquiera en la parte superior del lienzo.
   2. Selecciona Entidad.
   3. Selecciona un tenant.
   4. Selecciona la entidad que quieres añadir a tu aplicación y, a continuación, Añadir.
4. Vincula la entidad al control Tabla :
   1. En la pestaña General del panel Propiedades , selecciona el botón Recursos adicionales junto a Origen de datos.
   2. Selecciona Generador de consultas.
   3. Selecciona la entidad que quieres utilizar y, a continuación, Añadir condición.
   4. Selecciona un campo del menú desplegable y, a continuación, un operador, como =.
   5. Introduce la cadena por la que quieres filtrar los registros, entre comillas.
      Por ejemplo, si solo quieres registros de clientes del estado de Washington, añade "WA" como valor.
5. Utiliza el editor de expresiones para aplicar un filtro en condiciones específicas:
   1. En el Generador de consultas, selecciona el botón Abrir recursos y luego Editor de expresiones.
   2. Escribe una expresión que contenga una condición. Por ejemplo, puedes utilizar una condición SI para aplicar un filtro solo cuando un control desplegable en la página principal de la aplicación no esté en blanco y contenga un valor especificado por el usuario:

      Fetch(of Customer)(  
      If(  
      MainPage.Dropdown is Nothing,  
      Nothing,  
      createFilterGroup(New QueryFilter(){addFilter("State", "contains", MainPage.Dropdown.Value)}, Nothing, 0)),  
      Nothing, Nothing, Nothing, New ExpansionFieldOption( {addExpansionFieldOption("CreatedBy", New String(){"Id","Name"}), addExpansionFieldOption("UpdatedBy", New String(){"Id","Name"})})

Al previsualizar o ejecutar la aplicación, la consulta se ejecuta y recupera los registros filtrados.

Ordenar clientes

Utiliza el Creador de consultas para aplicar opciones de ordenación a tu búsqueda.

1. Abre una aplicación existente o crea una nueva.
2. Añade un control Tabla a tu aplicación:
   1. Selecciona Añadir control.
   2. Selecciona Pantalla.
   3. Arrastra el control Tabla a un área de tu aplicación.
3. Añade una entidad a tu aplicación:
   1. Selecciona la opción Añadir cualquiera en la parte superior del lienzo.
   2. Selecciona Entidad.
   3. Selecciona un tenant.
   4. Selecciona la entidad que quieres añadir a tu aplicación y, a continuación, Añadir.
4. Vincula la entidad a la tabla y aplica una regla de clasificación:
   1. En la pestaña General del panel Propiedades , selecciona el botón Recursos adicionales junto a Origen de datos.
   2. Selecciona Generador de consultas.
   3. Selecciona Configuración adicional.
   4. En el campo Ordenar por, añade el campo por el que quieres ordenar, como Nombre.
   5. El campo Ordenar de forma ascendente está establecido en verdadero de forma predeterminada. Selecciona el campo y escribe Falso para ordenar los resultados en orden descendente.
5. Previsualiza o ejecuta tu aplicación.

   Al previsualizar o ejecutar tu aplicación, la tabla muestra los registros del campo Nombre en tu entidad, en orden alfabético descendente.

Usar entidades con Editar cuadrícula

Puedes utilizar el control Editar cuadrícula para mostrar registros de entidades en tu aplicación y realizar operaciones CRUD en tu entidad utilizando este control.

Refer to Using Fetch to retrieve entity records in Edit Grid controls and Using entities with Edit Grid controls for more details and practical examples related to the Edit Grid control.