İçeriğe geç
Doğrulandı

JavaScript

Kaydedilirken derlenen gerçek JS kaynağı, bildirimsel bir programın ifade edemediği mantık için.

Bir JavaScript programı, gerçek kaynak kodunu scriptData.value içinde tutar; bildirimsel bir Veri Al, Veri Ayarla veya Batch'in ifade edemediği mantık için bir çıkış yoludur. Kaydedilirken derlenir (save_prog, Studio ile aynı derlemeyi çalıştırır ve data.compile döndürür: { ok: true, dependencies } veya { ok: false, error }) ve yalnızca bir DOM öğesiyle değil, alanlar, tablolar ve olaylar için gerçek bir API ile çalışır.

Özellikler

Çalıştırma sözleşmesi

Kaynak düz bir async gövdedir, export yok, sarmalayıcı yok, şu şekilde çalıştırılır:

js
async function (params, xu, SESSION_ID, SESSION_OBJ, jobNoP, $container, func, glb, APP_OBJ, evt) {
  /* your source */
}

params, çağıranın zaten değerlendirilmiş parametreleridir. xu çalışma zamanı API'sidir: alanlar, veritabanı satırları, olaylar, HTTP. Sarmalayıcı async olduğundan await serbestçe çalışır. Burada tırnak işaretleri sorun değildir; bir xu-script öznitelik değerinde ise durum farklıdır.

Bir tabloyu okuma ve yazma

js
const raw = await xu.get_field_value(`rows_json_v`);
const rows = typeof raw === `string` ? JSON.parse(raw || `[]`) : raw || [];
for (const row of rows) {
  await xu.dbs_create(`392_tbl_…`, { CNT_Name: row.name || `` });
}
// dbs_read resolves to an ARRAY of { id, value } rows, the row id on .id, fields under .value.
const all = await xu.dbs_read(`392_tbl_…`, {}, [], null, 999);
await xu.set_field_value(`saved_rows_v`, all.map((r) => ({ row_id: r.id, name: r.value?.CNT_Name || `` })));

dbs_* yöntemleri tablonun adını değil _id değerini alır. dbs_read üzerindeki fields projeksiyonu isteğe bağlıdır: varsayılan değer olan [] tüm alanları döndürür, alan kimliklerinden oluşan bir liste ise yalnızca o alanları döndürür.

Veriyi içeri geçirme: parametreler değil, alanlar

call_native_javascript, {value, fx} parametre sarmalayıcılarını değerlendirmez; bu şekilde çağrılan bir betik çözümlenmiş değerleri değil, düz {value: "", fx: "@field"} nesnelerini alır. Güvenilir yöntem şudur: çağıran yükü önce bir alana koyar (bir update adımı veya bir xu-bind girdisi), betiği boş parameters: {} ile çağırır, betik xu.get_field_value ile okur ve xu.set_field_value ile geri bildirir. Başka bir betikten çağırmak farklıdır: xu.call_javascript(prog_id, {...}) parametreleri geçirildiği gibi ulaşır.

Bir JavaScript programını çağırma

Çalışan örnek

Parametreleri bildirin

progFields girdileri, çağrı sırasına göre sarmalayıcı fonksiyonun argüman adları olur.

Gövdeyi yazın

Düz bir async fonksiyon gövdesi; call_evaluate_javascript okuyacaksa bir değer return edin.

Çağırın ve compile.ok değerini okuyun

save_prog sonrasında data.compile.ok değerini kontrol edin; başarısız bir derleme de belgeyi kaydeder ve ona bir build_error ekler.

Programs altında bir JavaScript düğümü oluşturun, kaynağı kod düzenleyicisine yazın, parametreleri Fields tablosuna ekleyin. Kaydetmek otomatik olarak yeniden derler, hatalar düzenleyicide görünür.

xml
<meta lang="json5">
{
  id: "normalize_student_name",
  menuTitle: "Normalize Student Name"
}
</meta>

<params lang="json5">
{
  in: { raw_name_in: "string" },
  out: { normalized_name_out: "string" }
}
</params>

<code>
return (@raw_name_in || "")
  .trim()
  .split(/\s+/)
  .filter(Boolean)
  .map(part => part.charAt(0).toUpperCase() + part.slice(1).toLowerCase())
  .join(" ");
</code>
json
{
  "properties": { "menuType": "javascript", "menuName": "Slugify Name", "fileExtension": "js" },
  "scriptData": { "value": "return name.toLowerCase().replace(/[^a-z0-9]+/g, '-');", "dependencies": [] },
  "progFields": [
    { "id": "b2c3d4e5-…", "data": { "field_id": "name", "type": "virtual" }, "props": { "fieldType": "string" } }
  ]
}