Consultas
Las consultas definen lo que una app puede leer y cambiar. Están en la pestaña Consultas del App-Builder y se ejecutan en el servidor: el navegador solo envía el nombre de la consulta y los valores de sus parámetros – tabla, filtro, campos y valores nunca le llegan ni se pueden alterar.
Tipos
| Tipo | Para | Campos |
|---|---|---|
| Listar registros | listas para tablas, listas, gráficos, selecciones | tabla, campos (ninguno = todos), filtro, orden, máximo por página |
| Un registro | detalles, p. ej. en un diálogo | tabla, registro (clave primaria), campos |
| Crear registro | guardar un formulario | tabla, valores (columna → valor) |
| Cambiar registro | fijar un estado, editar | tabla, registro, valores |
| Eliminar registro | – | tabla, registro |
| Subir un archivo | adjuntos de un registro, p. ej. fotos o justificantes | tabla, registro, columna de adjuntos; el archivo viene de un campo Archivo |
| Ejecutar workflow | lógica en el servidor | workflow (consulta Workflows y fuentes REST) |
| Endpoint personalizado | endpoints de scripts existentes | método, ruta |
| Fuente REST | API externa | fuente, método, ruta, cuerpo |
Parámetros y marcadores
Una consulta solo acepta parámetros declarados (nombre, tipo texto/número/sí-no/fecha/cualquiera, obligatorio). En filtro, valores, registro, ruta y cuerpo los marcadores los insertan:
{{params.<nombre>}}– un parámetro. Solo, conserva su tipo.{{user.id}},{{user.email}},{{user.role}}– la cuenta con sesión (vacío en apps públicas).{{now}}(momento) y{{today}}(fecha).
Los marcadores se insertan en la estructura guardada, nunca en un texto de consulta – un valor solo puede convertirse en un valor. En las rutas de las fuentes REST se codifican para la URL. Valor de filtro vacío = sin condición: si el marcador de una condición está vacío, la condición desaparece – un campo de búsqueda vacío muestra todo. Desde los marcadores crea los parámetros a partir de los marcadores usados.
Los elementos de datos indican los valores de los parámetros en sus propiedades, las acciones en el paso Ejecutar consulta (con Formulario, los valores de un formulario pasan a ser parámetros del mismo nombre). Al final de la pestaña, cada consulta se puede probar con valores de ejemplo (las consultas de escritura cambian datos de verdad).
Permisos
- Apps con inicio de sesión: cada consulta llega exactamente a su tabla con su nivel (lectura o escritura) – y nunca más de lo que la cuenta ya puede: para los viewers se aplican además sus permisos de tabla.
- Los usuarios de apps no tienen permisos de tabla; solo valen las consultas de sus apps.
- Las apps públicas se ejecutan con una identidad de app sin nombre: exactamente las consultas de la app, iguales para todos los visitantes – también con sesión.
- Los campos calculados forman parte de la tabla: lookups, rollups, fórmulas, vínculos, registros hijos y los valores mostrados de las claves foráneas llegan con la tabla de la consulta (o las tablas de un workflow), aunque tomen datos de otras tablas – en
fieldsywherese usan con su nombre de API. Los usuarios de apps y las apps públicas los ven tal como está construida la tabla; para los viewers, los campos de tablas que no pueden leer siguen ocultos. - Hooks, webhooks y campos calculados funcionan como con la API REST. La ejecución permite 600 llamadas por minuto e IP.