Naar de inhoud springen
Geverifieerd

Gegevens instellen

Een opgeslagen schrijfactie, aanmaken, bijwerken of verwijderen, één record tegelijk, met gebeurtenissen om eromheen te valideren en te reageren.

Een programma Gegevens instellen is een opgeslagen schrijfactie. Een nieuwe rij aanmaken, een bestaande bijwerken of verwijderen: elke mutatie in een Xuda-app is een programma Gegevens instellen: een doeldatasource, een bewerkingsmodus, parameters gekoppeld aan de velden van de tabel en levenscyclusgebeurtenissen voor validatie of neveneffecten.

Eigenschappen

progDataSource

Dezelfde vorm als Datasource. Bij C worden de filtervelden niet gebruikt, de schrijfactie maakt altijd een nieuwe rij aan. Bij U en D bepalen dataSourceFilterModelType plus dataSourceIndexId (of een query) het doelrecord.

progFields

Elke vermelding koppelt een parameter aan een kolom van de doeltabel (data.type: "table") of declareert een parameter die alleen voor de aanroeper is (virtual). Als een workflow het programma aanroept, vullen de overeenkomende parameters deze velden voordat de schrijfactie draait.

progEvents

Een programma Gegevens instellen aanroepen

De actie set_data voert het uit; name.outputField kan het geschreven record bij de aanroeper ontvangen:

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

Uitgewerkt voorbeeld

Kies de modus

crudMode: "C" om in te voegen, "U" om een gevonden rij bij te werken, "D" om er een te verwijderen.

Bind de velden die je schrijft

Geef elke progFields-vermelding data.type: "table" met een field_id die overeenkomt met de kolom van de doeltabel.

Zoek de rij voor U of D

Stel dataSourceFilterModelType in op index (met dataSourceIndexId) of query, precies zoals een programma Gegevens ophalen dat zou doen.

Maak een knooppunt Gegevens instellen onder Programma's, kies de CRUD-modus op het tabblad Eigenschappen, en bind daarna velden in het raster Velden op dezelfde manier als bij Gegevens ophalen.

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