דילוג לתוכן
אומת

אצווה

תוכנית אחת שניתנת לקריאה ומתזמרת כמה צעדים, הליך מרובה חלקים עם מזהה אחד לקרוא לו.

תוכנית אצווה מתזמרת כמה צעדים כפעולה אחת שניתנת לקריאה. בכל מקום שבו הליך היה מועתק אחרת בין רכיבים, שמירה בכמה שלבים, לולאה על רשומות, רצף קריאות API, אצווה נותנת לו שם אחד ומזהה אחד. מצד הקורא היא נראית בדיוק כמו תוכנית קבלת נתונים או שמירת נתונים: קוראים לה עם הפעולה batch, מעבירים פרמטרים, ומקבלים תוצאה בחזרה.

מאפיינים

progFields

פרמטרים של אצווה עוקבים אחרי הצורה המשותפת (data.field_id, data.type: "virtual", props.fieldType), ומוזכרים בתוך תהליך העבודה של האצווה כ-@field_id.

progEvents וגוף תהליך העבודה

בניגוד לטבלה או להתראה, הלוגיקה בפועל של אצווה אינה מערך ברמה העליונה, היא נמצאת בתוך progEvents, כמעט תמיד באירוע on_load, שמערך ה-workflow שלו הוא הגוף של האצווה:

צעד בתוך תהליך העבודה הזה יכול להיות כל פעולה בקטלוג של תהליך עבודה: get_data, set_data, call_native_javascript, call_project_api, call_external_api, delay, update, raise_event, קריאה מקוננת ל-batch, ועוד. כל צעד יכול לשאת props.condition כדי לתנות אותו, או props.async: true כדי להפעיל אותו בלי להמתין.

קריאה לאצווה

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

דוגמת עבודה

להצהיר על הפרמטרים

progParams לכל מה שהאצווה צריכה מהקורא שלה, משוקף אל progFields.

לבנות את הגוף על on_load

מוסיפים צעדים לתהליך העבודה של האירוע on_load: get_data לקריאה, חישוב, set_data לכתיבה בחזרה.

לקרוא לה כמו לכל תוכנית אחרת

הפעולה batch, עם name.prog שמוגדר למזהה של האצווה הזאת, והתוצאות נגישות דרך השדות של הקורא עצמו.

יוצרים צומת אצווה תחת תוכניות, מצהירים על פרמטרים בלשונית מאפיינים שלו, ואז בונים את רצף הצעדים בעורך אירועים ← on_load ← תהליך עבודה, אותו עורך תהליכי עבודה שכל תוכנית אחרת משתמשת בו.

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>

אצווה שקשורה ישירות למקור נתונים מריצה את הצעדים before_record / after_record שלה פעם אחת לכל שורה תואמת, הצורה האיטרטיבית של היחידה.

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