Vai al contenuto
Verificata

Imposta dati

Una scrittura salvata, creazione, aggiornamento o eliminazione, un record alla volta, con eventi per validare e reagire attorno ad essa.

Un programma Imposta dati è una scrittura salvata. Creare una nuova riga, aggiornarne una esistente o eliminarla: ogni modifica in un'app Xuda è un programma Imposta dati, con un'origine dati di destinazione, una modalità di operazione, parametri associati ai campi della tabella ed eventi del ciclo di vita per la validazione o gli effetti collaterali.

Proprietà

progDataSource

Stessa forma di Origine dati. Per C i campi del filtro non vengono usati, la scrittura crea sempre una nuova riga. Per U e D, dataSourceFilterModelType più dataSourceIndexId (o una query) individuano il record di destinazione.

progFields

Ogni voce associa un parametro a una colonna della tabella di destinazione (data.type: "table") oppure dichiara un parametro solo per il chiamante (virtual). Quando un workflow chiama il programma, i parametri corrispondenti popolano questi campi prima che la scrittura venga eseguita.

progEvents

Chiamare un programma Imposta dati

L'azione set_data lo esegue; name.outputField può ricevere il record scritto sul chiamante:

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": {}
}

Esempio pratico

Scegli la modalità

crudMode: "C" per inserire, "U" per aggiornare una riga individuata, "D" per eliminarne una.

Associa i campi che scrivi

Dai a ogni voce di progFields data.type: "table" con un field_id che corrisponde alla colonna della tabella di destinazione.

Individua la riga per U o D

Imposta dataSourceFilterModelType su index (con dataSourceIndexId) o query, esattamente come farebbe un programma Leggi dati.

Crea un nodo Imposta dati sotto Programmi, scegli la modalità CRUD nella sua scheda Proprietà, poi associa i campi nella griglia Campi nello stesso modo di Leggi dati.

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" } }
  ]
}