İçeriğe geç
Doğrulandı

Veri Al

Kayıtları bir veri kaynağı üzerinden okuyan ve onu çağıran kişiye geri veren, kaydedilmiş, çağrılabilir bir sorgu.

Bir Veri Al programı, kaydedilmiş bir okumadır. Tek bir kaydı arayan bir form, filtrelenmiş bir liste çeken bir ızgara veya bir şey hesaplamak için satır getiren bir betik olsun, okuma bir Veri Al programıdır: bir veri kaynağı, döndürülecek alanlar ve getirme etrafında tetiklenen yaşam döngüsü olayları.

Özellikler

studio_meta.parentId varsayılan olarak programs değerini alır (veya altındaki bir klasör).

progDataSource

Tam yapı Veri kaynağı sayfasındadır. Bir Veri Al programı neredeyse her zaman dataSourceType: "table" ayarlar, artı tek bir kayıt için dataSourceFilterModelType: "index" veya filtrelenmiş bir liste için "query".

progFields

progEvents

Veri Al, olağan yaşam döngüsünün üstüne kayıt başına olaylar ekler:

Bir Veri Al programını çağırma

Bir iş akışından get_data eylemi onu çalıştırır. Parametreler alan kimliğine göre eşleştirilir, her biri ya statik bir value ya da bir fx ifadesidir:

json
{
  "id": "1", "data": {
    "action": "get_data",
    "name": { "prog": "97a_gtd_…", "properties": {}, "parameters": { "class_id": { "fx": "@glb_class_id" } } },
    "enabled": true
  }, "props": {}
}

Çalışan örnek

Bir tabloya yöneltin

dataSourceTableId hedef tabloyu adlandırır. dataSourceFilterModelType index (tek kayıt) veya query (filtrelenmiş bir küme) seçer.

Neyin döneceğini bildirin

data.type: "table" olan progFields girdileri, eşleşen her satırda o sütunu döndürür. Bir virtual alan bunun yerine bir girdi parametresidir.

Bir iş akışından çağırın

name.prog bu programın kimliğine ayarlı get_data, name.parameters çağıranın değerlerini programın sanal alanlarına eşler.

Programlar altında bir Veri Al düğümü oluşturun, Veri kaynağı sekmesini (tablo, dizin veya sorgu, sıralama), ardından parametreler ve döndürülen sütunlar için Alanlar ızgarasını ayarlayın.

xml
<meta lang="json5">
{
  id: "load_student_classes",
  menuTitle: "Load Student Roster"
}
</meta>

<params lang="json5">
{
  in: { campus_in: "string" },
  out: { student_entries_v: "array" }
}
</params>

<datasource lang="json5">
{
  type: "table",
  table: "student_profiles_table",
  filter: { mode: "query", queryField: "@campus_query_v" },
  output: "student_entries_v",
  direction: "asc",
  realtime: true,
  limit: 25
}
</datasource>
json
{
  "properties": { "menuType": "get_data", "menuName": "Load Students By Class", "runAt": "" },
  "progDataSource": {
    "dataSourceType": "table",
    "dataSourceTableId": "5b1_tbl_a953848a71c5",
    "dataSourceFilterModelType": "index",
    "dataSourceIndexId": "a1b2c3d4-…",
    "dataSourceSort": "STU_Full_Name",
    "dataSourceRealtime": true
  },
  "progFields": [
    { "id": "b2c3d4e5-…", "data": { "field_id": "class_id", "type": "virtual" }, "props": { "fieldType": "string" } },
    { "id": "c3d4e5f6-…", "data": { "field_id": "STU_Full_Name", "type": "table" }, "props": { "fieldType": "string" } }
  ]
}