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:
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
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.