Saltar al contenido
Verificada

Set Data

Una escritura guardada, crear, actualizar o eliminar, un registro cada vez, con eventos para validar y reaccionar a su alrededor.

Un programa Set Data es una escritura guardada. Crear una fila nueva, actualizar una existente o eliminarla: toda mutación en una app de Xuda es un programa Set Data: una fuente de datos de destino, un modo de operación, parámetros asignados a los campos de la tabla y eventos del ciclo de vida para la validación o los efectos secundarios.

Propiedades

progDataSource

La misma forma que Fuente de datos. Para C los campos de filtro no se usan; la escritura siempre crea una fila nueva. Para U y D, dataSourceFilterModelType más dataSourceIndexId (o una consulta) localizan el registro de destino.

progFields

Cada entrada vincula un parámetro con una columna de la tabla de destino (data.type: "table") o declara un parámetro solo para quien llama (virtual). Cuando un flujo de trabajo llama al programa, los parámetros coincidentes rellenan estos campos antes de que se ejecute la escritura.

progEvents

Llamar a un programa Set Data

La acción set_data lo ejecuta; name.outputField puede recibir en quien llama el registro escrito:

json
{
  "id": "1", "data": {
    "action": "set_data",
    "name": { "prog": "97a_std_…", "properties": {}, "parameters": { "class_id": { "fx": "@glb_class_id" } }, "outputField": "GLB_Grades" },
    "enabled": true
  }, "props": {}
}

Ejemplo práctico

Elige el modo

crudMode: "C" para insertar, "U" para actualizar una fila localizada, "D" para eliminar una.

Vincula los campos que escribes

Dale a cada entrada de progFields data.type: "table" con un field_id que coincida con la columna de la tabla de destino.

Localiza la fila para U o D

Establece dataSourceFilterModelType en index (con dataSourceIndexId) o query, exactamente como lo haría un programa Get Data.

Crea un nodo Set Data en Programas, elige el modo CRUD en su pestaña Propiedades y luego vincula los campos en la cuadrícula de Campos igual que con Get Data.

xml
<meta lang="json5">
{
  id: "delete_student_profile",
  menuTitle: "Delete Student Profile",
  crudMode: "D"
}
</meta>

<params lang="json5">
{
  in: { student_id_in: "string" }
}
</params>

<datasource lang="json5">
{
  type: "table",
  table: "student_profiles_table",
  filter: {
    mode: "query",
    query: { student_id: "@student_id_in" }
  }
}
</datasource>
json
{
  "properties": { "menuType": "set_data", "menuName": "Create Student", "crudMode": "C", "allowCreate": false, "runAt": "" },
  "progDataSource": { "dataSourceType": "table", "dataSourceTableId": "5b1_tbl_a953848a71c5" },
  "progFields": [
    { "id": "b2c3d4e5-…", "data": { "field_id": "STU_Student_Id", "type": "table" }, "props": { "fieldType": "string" } },
    { "id": "c3d4e5f6-…", "data": { "field_id": "STU_Full_Name", "type": "table" }, "props": { "fieldType": "string" } }
  ]
}