Zum Inhalt springen
Geprüft

Set Data

Ein gespeicherter Schreibzugriff, anlegen, aktualisieren oder löschen, jeweils ein Datensatz, mit Ereignissen zum Validieren und Reagieren.

Ein Set-Data-Programm ist ein gespeicherter Schreibzugriff. Eine neue Zeile anlegen, eine vorhandene aktualisieren oder sie löschen: Jede Änderung in einer Xuda-App ist ein Set-Data-Programm, bestehend aus einer Ziel-Datenquelle, einem Operationsmodus, Parametern, die auf die Felder der Tabelle abgebildet werden, und Lebenszyklus-Ereignissen für Validierung oder Nebeneffekte.

Eigenschaften

progDataSource

Dieselbe Form wie bei Datenquelle. Bei C werden die Filterfelder nicht genutzt, das Schreiben legt immer eine neue Zeile an. Bei U und D finden dataSourceFilterModelType plus dataSourceIndexId (oder eine Abfrage) den Zieldatensatz.

progFields

Jeder Eintrag bindet einen Parameter an eine Spalte der Ziel-Tabelle (data.type: "table") oder deklariert einen Parameter nur für Aufrufer (virtual). Wenn ein Workflow das Programm aufruft, füllen passende Parameter diese Felder, bevor das Schreiben läuft.

progEvents

Ein Set-Data-Programm aufrufen

Die Aktion set_data führt es aus; name.outputField kann den geschriebenen Datensatz beim Aufrufer empfangen:

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

Praxisbeispiel

Den Modus wählen

crudMode: "C" zum Einfügen, "U" zum Aktualisieren einer gefundenen Zeile, "D" zum Löschen einer Zeile.

Die Felder binden, die du schreibst

Gib jedem progFields-Eintrag data.type: "table" mit einem field_id, der zur Spalte der Ziel-Tabelle passt.

Die Zeile für U oder D finden

Setze dataSourceFilterModelType auf index (mit dataSourceIndexId) oder query, genau wie bei einem Get-Data-Programm.

Lege unter Programme einen Set-Data-Knoten an, wähle den CRUD-Modus auf seinem Tab Eigenschaften und binde dann Felder im Raster Felder auf dieselbe Weise wie bei 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" } }
  ]
}