İçeriğe geç
Doğrulandı

Batch

Birkaç adımı düzenleyen, çağrılabilir tek bir program: çağırmak için tek bir kimliği olan çok parçalı bir yordam.

Batch programı, birkaç adımı çağrılabilir tek bir işlem olarak düzenler. Bir yordamın Bileşenler arasında kopyalanıp yapıştırılacağı her yerde (çok adımlı bir kayıt, kayıtlar üzerinde bir döngü, bir API çağrıları dizisi) Batch ona tek bir ad ve tek bir kimlik verir. Çağıran tarafından bakıldığında tıpkı bir Veri Al veya Veri Ayarla programı gibi görünür: batch eylemiyle çağırın, parametreleri geçirin, sonucu geri alın.

Özellikler

progFields

Batch parametreleri ortak biçimi izler (data.field_id, data.type: "virtual", props.fieldType) ve Batch'in iş akışı içinde @field_id olarak başvurulur.

progEvents ve iş akışı gövdesi

Bir Tablo'dan veya bir Uyarı'dan farklı olarak, Batch'in asıl mantığı üst düzey bir dizi değildir, progEvents içinde yer alır; çoğunlukla on_load olayında ve o olayın workflow dizisi Batch'in gövdesidir:

Bu iş akışındaki bir adım, İş akışı kataloğundaki herhangi bir eylem olabilir: get_data, set_data, call_native_javascript, call_project_api, call_external_api, delay, update, raise_event, iç içe bir batch çağrısı ve daha fazlası. Her adım, onu koşula bağlamak için props.condition, beklemeden başlatmak için props.async: true taşıyabilir.

Batch çağırma

json
{
  "id": "1", "data": {
    "action": "batch",
    "name": { "prog": "5b1_bth_…", "properties": {}, "parameters": { "class_id": { "fx": "@glb_class_id" } } },
    "enabled": true
  }, "props": {}
}

Çalışan örnek

Parametreleri bildirin

Batch'in çağıranından ihtiyaç duyduğu her şey için progParams, progFields üzerine yansıtılır.

Gövdeyi on_load üzerinde oluşturun

on_load olayının iş akışına adımlar ekleyin: okumak için bir get_data, bir hesaplama, geri yazmak için bir set_data.

Başka herhangi bir program gibi çağırın

batch eylemi, name.prog bu Batch'in kimliğine ayarlanır, sonuçlara çağıranın kendi alanları üzerinden ulaşılır.

Programs altında bir Batch düğümü oluşturun, parametreleri Properties sekmesinde bildirin, ardından adım dizisini Events → on_load → Workflow düzenleyicisinde oluşturun; bu, diğer tüm programların kullandığı iş akışı düzenleyicisinin aynısıdır.

xml
<meta lang="json5">
{
  id: "rebuild_class_roster",
  menuTitle: "Batch Print Student Packets"
}
</meta>

<params lang="json5">
{
  in: { campus_in: "string" }
}
</params>

<datasource lang="json5">
{
  type: "table",
  table: "student_profiles_table",
  filter: {
    mode: "index",
    activeIndex: "campus_idx",
    indexes: { campus_idx: { campus: { from: "@campus_in", to: "@campus_in" } } }
  },
  limit: 50
}
</datasource>

<events lang="json5">
{
  before_record: [
    { action: "delay", name: { value: "1" } }
  ],
  after_record: [
    { action: "debug", name: { value: "Prepared one student packet for printing" } }
  ]
}
</events>

Doğrudan bir veri kaynağına bağlı Batch, before_record / after_record adımlarını eşleşen her satır için bir kez çalıştırır; bu, birimin yinelemeli biçimidir.

json
{
  "properties": { "menuType": "batch", "menuName": "Rebuild Class Grades", "runAt": "server", "progParams": [] },
  "progFields": [
    { "id": "b2c3d4e5-…", "data": { "field_id": "class_id", "type": "virtual" }, "props": { "fieldType": "string" } }
  ],
  "progEvents": [
    {
      "id": "d4e5f6a7-…", "data": { "type": "on_load", "parameters": [], "condition": "" },
      "workflow": [
        { "id": "step-1", "data": { "action": "get_data", "name": { "prog": "97a_gtd_…", "parameters": { "class_id": { "fx": "@class_id" } } }, "enabled": true }, "props": {} },
        { "id": "step-2", "data": { "action": "set_data", "name": { "prog": "97a_std_…", "parameters": { "class_id": { "fx": "@class_id" } }, "outputField": "GLB_Grades" }, "enabled": true }, "props": {} }
      ]
    }
  ]
}