Descripción general de los modelos

Los modelos organizan los datos y los almacenan en App Maker. Son como una tabla en una base de datos o una hoja en una hoja de cálculo. Las hojas de cálculo organizan datos por columnas y los almacenan en filas. Los modelos organizan datos por campos y los almacenan en colecciones llamadas registros.

Por ejemplo, imagina que trabajas para un startup nuevo, Weyland Corp y quieres compilar una app de recursos humanos que haga un seguimiento de los nombres de los empleados, los números de ID y las fechas de nacimiento. En App Maker, puedes realizar un modelo Employee con cuatro campos: Name, EmployeeID, Active y DateOfBirth. Puedes crear una página en tu app en la que un usuario pueda agregar al modelo un registro para cada empleado. En una hoja de cálculo, se almacenan los mismos datos en columnas y filas:

NameEmployeeIDActiveDateOfBirth
Carter Burke2179426Falso30/03/2150
Ellen Ripley1612122Verdadero7/01/2092
Dos registros para el modelo Employee

Tipos de modelos

App Maker es compatible con cinco tipos de modelos:

  • Google Cloud SQL: una tabla de MySQL tradicional que se puede compartir entre varias aplicaciones,

    • Predeterminada: un administrador de G Suite puede establecer una instancia de Cloud SQL compartida entre aplicaciones de App Maker en una organización. Una vez habilitada, se crea una base de datos nueva de forma automática cuando agregas un modelo de datos de Cloud SQL a una app. Elige esta opción si tu app necesita una base de datos que no requiera configuración y sea fácil de usar.

    • Personalizada: una vez que tu administrador configura una instancia de Cloud SQL predeterminada, también puedes establecer tu propia instancia de Cloud SQL. Elige esta opción en las siguientes circunstancias:

      • la aplicación se entrega a varios usuarios o almacena una gran cantidad de datos.
      • la base de datos se debe compartir con otras aplicaciones.
      • debes administrar la base de datos o retener el control de la instancia de Cloud SQL.
  • Calculado: un modelo "virtual" que usa secuencias de comandos para producir datos. Este modelo te permite manipular datos de modelos o de otras fuentes, pero debes poder escribir secuencias de comandos del lado del servidor avanzadas para configurarlo.

  • SQL calculado: una consulta que se ejecuta en una base de datos de Google Cloud SQL.

  • Calculado del lado del cliente: una secuencia de comandos de consulta del lado del cliente que se ejecuta para recuperar datos de manera asíncrona o que usa una devolución de llamada con el fin de mostrar resultados asíncronos.

  • Directorio: un modelo que obtiene información del directorio de la organización, por ejemplo, las direcciones de correo electrónico y los números de teléfono.

El editor de modelos

En el editor de modelos, defines la estructura y la configuración de los modelos. App Maker te dirige al editor después de crear el modelo. Para volver al editor de modelos, haz clic en el nombre del modelo en la barra de navegación izquierda. El editor tiene hasta cinco pestañas, según el tipo de modelo:

  • Campos: agrega campos nuevos a un modelo y edita la configuración del campo. Por ejemplo, podrías agregar un campo Email el modelo Employee y configurarlo según se requiere.

  • Fuentes de datos: define como un modelo recupera y almacena datos cuando se lo consulta, incluido el subconjunto de registros que muestra. Por ejemplo, puedes crear una fuente de datos para el modelo Employee que solo muestre empleados activos cuando sea necesario.

  • Eventos: crea secuencias de comandos del lado del servidor que se ejecuten cuando tu aplicación muestra, crea o borra registros. Por ejemplo, puedes escribir una secuencia de comandos para el modelo Employee que propague el campo HireDate de manera automática cuando un usuario crea un registro de empleado nuevo. No está disponible para modelos calculados del lado del cliente.

  • Relaciones: describe las relaciones entre registros dentro de un modelo o entre modelos. Por ejemplo, puedes crear una relación en el modelo Employee entre un administrador y sus subordinados directos. No está disponible para modelos calculados.

  • Seguridad: controla qué usuarios pueden crear, cargar, guardar o borrar registros en un modelo. Por ejemplo, puedes restringir el modelo Employee para que solo los empleados puedan ver los registros en el modelo.

Campo de visualización

Cuando creas un modelo, puedes seleccionar un campo de visualización predeterminado. App Maker usa el campo de visualización predeterminado cuando se refiere a un registro en el modelo. Los widgets suelen usar un campo de visualización en el que seleccionan registros como menús desplegables.

Por ejemplo, puedes seleccionar el campo Departamento en el modelo Departamentos que contiene registros de los nombres de departamentos y sus ubicaciones. Cuando configuras la fuente de datos de un widget de menú desplegable al modelo, las opciones del menú son valores del campo Departamento.

Si no especificas un campo de visualización, App Maker trata de encontrar un campo con el nombre “id” o “name” para mostrar. Si el modelo no tiene un campo con alguno de esos nombres, App Maker usa el primer campo de la string del modelo.

Para configurar un campo como el campo de visualización predeterminado, haz lo siguiente:

  1. Haz clic en el modelo.
  2. En la pestaña Campos, haz clic en el campo que quieras configurar como el campo de visualización.
  3. Haz clic en Configurar un campo de visualización.

Para cambiar el campo de visualización por otro, abre el campo y haz clic en Configurar el campo de visualización. Solo un campo se puede configurar como el campo de visualización.

Para configurar el campo de visualización de otra manera, vincula la propiedad names de un widget a un campo que quieras mostrar.