Saltar para o conteúdo
Verificado

Definir Dados

Uma escrita guardada, criar, atualizar ou eliminar, um registo de cada vez, com eventos para validar e reagir em torno dela.

Um programa Definir Dados é uma escrita guardada. Criar uma nova linha, atualizar uma existente ou eliminá-la, toda a alteração numa aplicação Xuda é um programa Definir Dados: uma fonte de dados de destino, um modo de operação, parâmetros mapeados para os campos da tabela e eventos de ciclo de vida para validação ou efeitos secundários.

Propriedades

progDataSource

A mesma forma que Fonte de dados. Para C, os campos de filtro não são usados, a escrita cria sempre uma nova linha. Para U e D, dataSourceFilterModelType mais dataSourceIndexId (ou uma consulta) localizam o registo de destino.

progFields

Cada entrada associa um parâmetro a uma coluna da tabela de destino (data.type: "table") ou declara um parâmetro só de quem chama (virtual). Quando um fluxo de trabalho chama o programa, os parâmetros correspondentes preenchem estes campos antes de a escrita correr.

progEvents

Chamar um programa Definir Dados

A ação set_data executa-o; name.outputField pode receber o registo escrito em quem chama:

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

Exemplo prático

Escolha o modo

crudMode: "C" para inserir, "U" para atualizar uma linha localizada, "D" para eliminar uma.

Associe os campos que escreve

Dê a cada entrada de progFields data.type: "table" com um field_id que corresponda à coluna da tabela de destino.

Localize a linha para U ou D

Defina dataSourceFilterModelType como index (com dataSourceIndexId) ou query, exatamente como faria um programa Obter Dados.

Crie um nó Definir Dados em Programas, escolha o modo CRUD no seu separador Propriedades e depois associe campos na grelha de Campos da mesma forma que no Obter Dados.

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