Saltar al contenido
Verificada

Fuente de datos

La forma de vinculación compartida que le dice a un programa o a un componente de dónde vienen sus datos y cómo filtrarlos.

Una fuente de datos es progDataSource, el objeto que dice de dónde vienen los datos de un programa o de un componente: una tabla, un array en línea, JSON o CSV sin procesar, o una URL, además de cómo filtrarlos, ordenarlos y si mantenerlos en vivo. No es algo que crees por sí solo en el Studio actual, es una sección que lleva cada Get Data, Set Data y componente que maneja datos, y los tres leen y escriben esa sección con exactamente la misma forma y el mismo resolutor del entorno de ejecución.

progDataSource

runAt en una fuente de datos

Una fuente de datos se resuelve como "" (heredar de su programa padre), client (en el navegador) o server (mediante el servicio datasource_create del entorno de ejecución, que mantiene las consultas con privilegios fuera del cliente). El entorno de ejecución sustituye el valor almacenado por client de forma incondicional en dos casos: dentro de un programa Globales, y cuando la sesión se ejecuta en app_computing_mode: "main".

Dos formas, el mismo objeto

Un único registro por clave (un formulario):

json
{
  "dataSourceType": "table", "dataSourceFilterModelType": "index",
  "dataSourceTableId": "392_tbl_…", "dataSourceIndexId": "<index-uuid>",
  "dataSourceIndexesObj": { "<index-uuid>": { "ORD_Id": { "from": "@order_id_in", "to": "@order_id_in", "key": "ORD_Id" } } }
}

Lista filtrada (una cuadrícula):

json
{
  "dataSourceType": "table", "dataSourceFilterModelType": "query",
  "dataSourceTableId": "392_tbl_…",
  "filterModelMongoFx": "({ ORD_Status: { $eq: @status_v } })",
  "dataSourceRealtime": true
}

Ejemplo práctico

Elige el modo

Para buscar un registro por su clave: modo index más dataSourceIndexId. Para filtrar una lista por una condición: modo query más filterModelMongoFx.

Apúntala a una tabla

dataSourceTableId es el _id de la Tabla de destino, nunca su nombre.

Activa el tiempo real donde importa

dataSourceRealtime: true mantiene sincronizada una cuadrícula vinculada cuando cambian las filas por debajo, solo en el controlador de base de datos nativo.

xml
<datasource lang="json5">
{
  type: "table",
  table: "student_profiles_table",
  filter: {
    mode: "query",
    queryField: "@campus_query_v"
  },
  output: "student_entries_v",
  direction: "asc",
  realtime: true,
  limit: 25
}
</datasource>

El bloque <datasource> de .xu es la misma información que progDataSource, en la forma abreviada que xuda-cli compila hasta la forma JSON de Studio.

json
"progDataSource": {
  "dataSourceType": "table",
  "dataSourceTableId": "5b1_tbl_a953848a71c5",
  "dataSourceFilterModelType": "index",
  "dataSourceIndexId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
  "dataSourceSort": "STU_Full_Name",
  "dataSourceRealtime": true
}