İçeriğe geç
Doğrulandı

Studio LLM kılavuzu

Prog belge modeli, xu-* öznitelik başvurusu ve bir yapay zekâ ajanına ilk araç çağrısından önce öğretilen iş akışı kuralları.

Her Studio projesi, içindeki her tablo, ekran, betik ve rota, prog adı verilen tek bir CouchDB JSON belgesidir (docType: "studio"). Bu sayfa, bir yapay zekâ ajanının bir tane oluştururken aldığı aynı başvurudur; dokümantasyon olarak yeniden yazılmıştır: o belgenin şekli, arayüzünü yönlendiren öznitelikler, bir iş akışının yapabileceği eylemler ve gerçek derlemelerde ortaya çıkan hatalar.

Bir yapay zekâ ajanı bu kılavuzu nasıl alır

Bir MCP istemcisini Xuda'ya bağlayın; ilk yanıt, yani initialize çağrısı, bu kılavuzu oturumun instructions alanı olarak taşır. Platformun kendi canlı kurallarından yeniden birleştirilir; bu yüzden dağıtılmış denetleyicinin artık uygulamadığı bir şeyi asla anlatamaz. Bkz. Bir yapay zekâ istemcisini MCP ile bağlama.

Bir oturumun içinden iki yöntem aynı malzemeye doğrudan, MCP ya da düz REST üzerinden ulaşır ve normal bir API anahtarının ötesinde hiçbir şey gerektirmez:

Öngörülen sıra: oluşturduğunuz şeyle eşleşen konuyu okuyun, eşleşen bir örnek getirin, progu fabrika aracılığıyla oluşturun (create_prog), içerik bölümlerinin içinde derleyin, doğrulayın (validate_prog) ve bildirdiği her şeyi düzeltin, kaydedin (save_prog), sonra doğrulamak için yeniden getirin. -409 döndüren bir kayıt, belgenin okunduğundan beri değiştiği anlamına gelir: yeniden getirin, yeniden uygulayın, yeniden deneyin.

Prog belge modeli

Zarf

Bu alanlar sunucu ve fabrika koduna aittir; yazılan bir derleme yalnızca altındaki içerik bölümlerini düzenler.

json
{
  "_id": "392_cmp_f15654997737",
  "_rev": "3-...",
  "docType": "studio",
  "stat": 3,
  "app_id": "prj...",
  "properties": { "menuType": "component", "menuName": "Orders", "menuTitle": "Orders" },
  "studio_meta": { "created": 1750000000000, "createdByUid": "...", "savedByUid": "...", "parentId": "programs" }
}
  • _id, <app_id son 3 karakter>_<3 harfli tür kısaltması>_<12 onaltılık> biçimini izler; örneğin bir bileşen için 392_cmp_..., bir tablo için 392_tbl_..., bir javascript progu için 392_jvs_..., get_data / set_data için 392_gtd_... / 392_std_..., bir klasör için 392_fld_.... Kimlikleri fabrika üretir, bir derleme asla kimlik uydurmaz.
  • stat, etkin için 3, yumuşak silinmiş için 4'tür (bir progu silmenin ayarladığı değer). Studio'nun ağacı yalnızca stat: 3 olanları gösterir.
  • properties.menuType, globals, table, get_data, set_data, batch, alert, javascript, folder, route, api, component, ai_agent değerlerinden biridir.
  • studio_meta.parentId düğümü Studio ağacında konumlandırır: ya başka bir progun kimliği (genellikle bir klasör) ya da tür köklerinden biri: programs (mantık ve bileşenler), database (tablolar), routes, globals, ai_agents. Tanınmayan bir parentId, düğümü ağaçta görünmez bırakır ve bir denetleyici hatasıdır.

menuType'a göre içerik bölümleri

Globals belgesi

Her projenin tam olarak bir global_<app_id> belgesi vardır (menuType: "globals"). progFields alanları, diğer her progdan @field_id olarak okunabilir. Her projede iki sistem globali gelir: oturum açmış kullanıcı için @SYS_GLOBAL_OBJ_LOGIN_USER_INFO ve xu-ref ile kaydedilen öğeler için @SYS_GLOBAL_OBJ_REFS. Ne globals belgesi ne de ağaç kökü silinebilir.

Yapısal zorunluluklar

  • properties, properties.menuType, properties.menuName, studio_meta ve studio_meta.parentId her belgede zorunludur.
  • Bir progFields girdisi benzersiz bir id, data.field_id, virtual, table, expression veya datasource değerlerinden biri olan bir data.type ve string, number, boolean, array veya object değerlerinden biri olan bir props.fieldType gerektirir.
  • Ayrılmış çalışma zamanı değişken adları, _NULL, _THIS, _FOR_KEY, _FOR_VAL, _ROWNO, _ROWID, _ROWDOC, _KEY, _VAL, asla alan kimliği olarak yeniden tanımlanmaz.
  • Yinelenen kimlikler, bilinmeyen menuType değerleri ve hatalı biçimli bölümlerin hepsi, validate_prog'un doğrudan bildirdiği kesin hatalardır.

İfadeler ve xu-* öznitelikleri

İfade sözdizimi

İfadeler progun kendi veri kümesine karşı çalışır. Yerel, tabloya bağlı, global ya da bir parametre olan her alana @ ile başvurulur: @search_v, @ORD_Total, @SYS_GLOBAL_OBJ_LOGIN_USER_INFO, etrafında düz JavaScript, @count_v > 0 ? 'has rows' : 'empty'. Bir nesne değişmezinin etrafında parantez gerekir, ({ ORD_Status: @status_v }). Bir xu-for döngüsünün içinde geçerli öğe @_FOR_VAL, anahtarı veya dizini @_FOR_KEY'dir (xu-for-key / xu-for-val ile yeniden adlandırılabilir). xu-render ve diğer koşullar doğru ya da yanlış değeri doğrudan döndürür; asla bir "Y" / "N" dizesi ya da ek bir karşılaştırma değil.

xu-bind tek istisnadır

Başka her yerde bir alana @ ile başvurulur. xu-bind bunun yerine yalın alan kimliğini alır: xu-bind="search_v", asla xu-bind="@search_v" değil.

xu öznitelikleri

Önek aileleri

Sonek alan öznitelik aileleri. xu-on değerleri her zaman işleyici nesnelerinden oluşan dizilerdir; xu-exp değerleri her zaman ifade dizeleridir.

json
"xu-on:click": [{
  "handler": "custom",
  "props": {},
  "workflow": [
    { "id": "1", "data": { "action": "update", "name": { "value": "@saving_v: true" }, "enabled": true }, "props": {} },
    { "id": "2", "data": { "action": "set_data", "name": { "prog": "392_std_...", "properties": {}, "parameters": {} }, "enabled": true }, "props": { "condition": "@form_valid_v" } }
  ]
}]

Bir xu-on:* özniteliğinin değeri her zaman işleyici nesnelerinden oluşan bir dizidir ve her workflow, eylem adımlarından oluşan bir dizidir (tam eylem başvurusu aşağıda, Mantık programları ve iş akışları altındadır). Bir adımın props.condition değeri onu sınırlar; props.async: true onu beklemeden tetikler.

Kritik anlambilim

  • xu-exp:class, statik class özniteliğine eklemek yerine onu değiştirir. İkisini de taşıyan bir öğede statik olan yok sayılır; bu yüzden yerleşim sınıfları da ifadenin içine aittir: xu-exp:class="'card p-4 ' + (@active_v ? 'ring' : '')".
  • xu-script, yalın bir function (el) { ... } ifadesi alır; düğüm görünür olduğunda eval edilir ve DOM öğesiyle çağrılır. Yeniden çalışmalara karşı koruma ekleyin (if (el.__bound) return; el.__bound = true;) ve her sorguyu document ile değil el ile sınırlayın.
  • xu-style otomatik olarak kapsamlıdır: her seçici düğümün [xu-ui-id] değeriyle öneklenir; bu yüzden düz öğe ve sınıf seçicileri yerel kalır ve asla sızmaz.
  • Ne xu-script ne de xu-style değerleri bir tırnak karakteri (' veya ") içerebilir; tasarımcı tuvali öznitelikleri kaçışsız serileştirir ve tek bir tırnak bileşeni bozar. Aşağıdaki JavaScript programları bölümü tırnaksız teknikleri kapsar.
  • Statik metin bir öğenin content özelliğine aittir. xu-exp:xu-content yalnızca dinamik metin içindir.

Etiketler

Düz HTML dışındaki yazım etiketleri: xu-template, xu-single-view, xu-multi-view, xu-panel, xu-teleport, xu-slot.

  • xu-single-view tek bir kaydı kapsar (bir form kökü, iç içe de kullanılabilir).
  • xu-multi-view alt öğelerini bağlı verinin her satırı için bir kez tekrarlar.
  • xu-panel başka bir progu gömer (program özniteliği artı xu-exp:<param> girdileri). Param ifadelerinin yanında yalnızca standart HTML öznitelikleri (class, id, style, title, hidden, slot, name, role, tabindex) ona aittir.
  • xu-teleport alt öğelerini başka bir DOM hedefinde oluşturur (to veya xu-exp:to).
  • Büyük harfle başlayan bir etiket adı (Button, Card) bir HTML öğesi değil, derlenmiş bir bileşendir; aşağıdaki Gömme bölümüne bakın.

Bileşenler

Bir bileşen (menuType: "component") bir arayüz birimidir: yerel duruma (progFields) bağlı bir öğe ağacı (progUi), isteğe bağlı veri (progDataSource), yaşam döngüsü mantığı (progEvents) ve bir girdi/çıktı arayüzü (properties.progParams).

Özellikler

json
{
  "menuType": "component", "menuName": "OrderList",
  "renderType": "form",
  "uiFramework": "@xuda.io/xuda-framework-plugin-tailwind",
  "rwMode": "R",
  "progParams": [{ "id": 1, "data": { "dir": "in", "parameter": "order_id_in", "type": "string" }, "props": {} }]
}
  • renderType, tek bir kayıt için form (kök öğe xu-single-view) ya da her veri satırı için bir kez tekrarlanan grid / list (kök öğe xu-multi-view) değeridir.
  • rwMode, okuma için R veya güncelleme için U değeridir; allowCreate, hiçbiri eşleşmediğinde yeni bir satırın eklenip eklenemeyeceğini söyler.
  • progParams adlandırma kuralı: parametreler _in / _out ile biter, bileşene yerel sanal alanlar _v ile biter.
  • uiFramework, projenin mevcut bileşenlerinin zaten kullandığını yansıtır. Bunu atlayan mevcut bir proje atlamaya devam etmelidir; projenin sürücüsünün gerçekte sunmadığı bir çatı eklentisi ayarlamak, canlı önizlemeyi boş bir ekranda durdurur.

Öğe ağacı (progUi)

json
{
  "id": "root", "type": "element", "tagName": "xu-single-view", "attributes": {},
  "children": [
    { "id": "ui-...", "type": "element", "tagName": "div",
      "attributes": { "class": "card", "xu-style": ".card { padding: 16px; border-radius: 12px; }" },
      "children": [
        { "id": "ui-...", "type": "element", "tagName": "h2", "content": "Orders", "attributes": {}, "children": [] },
        { "id": "ui-...", "type": "element", "tagName": "input", "children": [],
          "attributes": { "type": "text", "placeholder": "Search", "xu-bind": "search_v" } }
      ] }
  ]
}

Fabrikanın root düğümü kalır; bir derleme onun children alanının içinde çalışır. Her düğümün benzersiz bir kimliği (yeni düğümler ui-<uuid> kullanır), type: "element" değeri ve bir tagName değeri olmalı; comment ya da text düğüm türleri yoktur, statik metin bunun yerine content içinde yaşar. Her düğümün, boş olsa bile, attributes: {} ve children: [] alanlarına ihtiyacı vardır; tasarımcı tuvali serileştiricisi her düğümde ikisine de başvurur ve bir eksiklik bileşenin kendi önizlemesini bozar.

Gömme: xu-panel veya derlenmiş bir bileşen

İkisi de şeffaf şekilde bağlanır, sarmalayıcı öğe yoktur ve ikisi de tek bir sinyalle belirlenir: tagName değerinin büyük harfle başlayıp başlamadığı.

  • xu-panel, küçük harfli tagName artı bir program özniteliği, başka bir progu gömer; kendi alanları ve olayları olan, veritabanına bağlı ya da durumlu bir alt öğe. program alt öğenin kimliğidir (dinamik biri için xu-exp:prog), değerler _in parametrelerine xu-exp:<param> ile ulaşır.
  • Büyük harfli bir etiket artı bir library özniteliği, derlenmiş bir bileşeni bağlar; bir tasarım sistemi ilkeli ya da uygulamanın kendi derlediği bir parça. Her düz öznitelik bir prop olur (props.<name>), asla bir DOM özniteliği olmaz; çünkü bileşen kendi öğesini oluşturmaz. Bir bileşen düğümünün çıkış parametresi yoktur; xu-panel'den farklı olarak hiçbir şey alanlarınıza değer yazmaz.
Yalnızca büyük harf kullanımı belirler

Yazım hatalı bir <Buton> yine de bir bileşen etiketi olarak sahiplenilir, asla bilinmeyen bir HTML öğesine geri dönmez ve bağlama sırasında etiketi, kitaplığı ve denenen her kaynağı adlandırarak hata atar. validate_prog bugün bileşen etiketlerini ya da library değerlerini denetlemez; tek denetim canlı önizlemedir.

progFields

json
[
  { "id": "<uuid>", "data": { "type": "virtual", "field_id": "search_v" }, "props": { "fieldType": "string" }, "workflow": [] },
  { "id": "<uuid>", "data": { "type": "table", "field_id": "ORD_Total" }, "props": { "fieldType": "number" }, "workflow": [] }
]

data.type, yerel durum için virtual, bağlı veri kaynağının bir sütunu için table ya da expression / datasource değeridir. Bir alanın workflow değeri değişimde çalışır. Varsayılan, props.fieldValue ayarlar; hesaplanan bir alan props.fieldComputed: true ile birlikte propExpressions.fieldValue ayarlar.

progDataSource

Anahtarla tek bir kayıt (form): tablonun kendi tableIndexes değerinde var olan bir dataSourceIndexId ile dataSourceFilterModelType: "index". Filtrelenmiş bir liste (grid veya list): Mongo tarzı bir ifade dizesi olan filterModelMongoFx ile dataSourceFilterModelType: "query". dataSourceType, table, array, json, csv, none değerlerinden biridir ya da hiç veri kaynağı olmayan, tamamen sunumsal bir bileşen için boştur.

progEvents ve üç yaşam döngüsü kancası

Olay türleri: on_load, on_exit, before_record, after_record, record_not_found, locate_not_found, screen_ready, on_refresh, on_unload, client_interval, user_defined. user_defined olayları, raise_event eylemiyle her yerden tetiklenir; screen_ready olağan bağlama kancasıdır.

Bir bileşenin üç yerleşik kancası işi böler; yanlış olanı kullanmak yaygın bir hata kaynağıdır:

screen_ready

Örnek başına bir kez tetiklenir. DOM'u ve pencere öğelerini burada oluşturun.

on_refresh

İlki dahil her yüklemeden sonra, screen_ready hemen ardından tetiklenir. Yeni veriyi zaten var olan pencere öğelerine verin. Yenileme işini bunun yerine screen_ready içine koymak, oluşturma kodunu hâlâ var olan DOM'a karşı yeniden çalıştırır ve ikinci bir pencere öğesi üst üste bindirir.

on_unload

Örnek yıkıldığında tetiklenir. Progun oluşturduğu şeyleri yok edin: pencere öğeleri, zamanlayıcılar, document / window dinleyicileri, gözlemciler. Motor yalnızca kendi oluşturduğunu serbest bırakabilir; aksi halde document'a bağlı bir dinleyici panelden uzun yaşar.

Kalıplar

  • Yükleme ve boş durumlar: veriye bağlı öğeye xu-ref="myref" koyun, ardından iskelet ya da boş öğeleri (@SYS_GLOBAL_OBJ_REFS).myref üzerinde xu-render ile sınırlayın; veri geldiğinde veri kümesi eklenir.
  • Modallar: iletişim kutusunu kendi bileşeni olarak oluşturun, call_modal eylemiyle açın.
  • Bağlı bir satırı kaydetme veya silme: act_save / act_delete ile invoke_action ya da geçerli satırın ötesindeki her şey için özel bir set_data progu.

Mantık programları ve iş akışları

Mantık prog türleri, hiçbir arayüz olmadan bir bileşenin veri mekanizmasını (progDataSource, progFields, progEvents, properties.progParams) paylaşır:

Parametreler

json
"progParams": [
  { "id": 1, "data": { "dir": "in",  "parameter": "order_id_in", "type": "string" }, "props": {} },
  { "id": 2, "data": { "dir": "out", "parameter": "total_out",   "type": "number" }, "props": {} }
]

Bir çağıran, değerleri eylemin name.parameters alanı üzerinden geçirir, { "order_id_in": { "value": "", "fx": "@selected_id_v" } }; statik bir değer için value, bir ifade için fx. Denetleyici hedef programın var olduğunu ve menuType değerinin eylemle eşleştiğini doğrular.

İş akışı eylemleri

Bir iş akışı, sırayla çalışan adımlardan oluşan bir dizidir, { "id": "...", "data": { "action": "...", "name": { ... }, "enabled": true }, "props": {} }. props.condition bir adımı sınırlar, props.async: true onu beklemeden tetikler. İş akışları xu-on:* işleyicilerinde, progEvents[].workflow içinde ve bir alanın kendi workflow değerinde görünür.

invoke_action, act_next, act_prev, act_first, act_last, act_reload, act_refresh, act_print, act_save, act_delete değerlerini kabul eder (yalnızca bileşen bağlamında).

Denetleyicinin reddettiği kullanımdan kaldırılmış eylemler

alter_ui_element, create_ui_element, info_ui_element, remove_ui_element, empty_ui_element, cache_ui_element, load_ui_element. Arayüzü, zorunlu bir öğe eylemi yerine alanlar ve xu-exp / xu-render ile yönlendirin.

call_ai_agent ve call_triage_agent gerçek eylemler değildir

Studio'nun kendi eylem seçicisi, yukarıdaki eylemlerin yanında AI ajanını çağır ve Triyaj ajanını çağır seçeneklerini sunar. Hiçbiri bu tabloda yok, çünkü hiçbiri gerçek bir eylem değil: validate_prog bunlar için bir duruma sahip değildir ve invalid trigger type bildirir; çalışma zamanı iş akışı motorunun da bunlar için işleyicisi yoktur, bu yüzden hata yok sayılsa bile kaydedilmiş bir adım asla çalışmaz. Bir progun yayımlanmış bir ajana ulaşmasını sağlamak için, bunun yerine başka bir ajanın kendi araç listesine bir AI Ajanı aracı ekleyin (bir menuType: "ai_agent" belgesinin agentConfig.agent_tools alanı); bir bileşendeki, get_data ya da başka herhangi bir prog türündeki iş akışı adımı olarak değil.

update'in name.value değeri, alanları noktalı virgülle ayrılmış @field: expression çiftleriyle ya da bir JSON5 nesnesiyle atar, "@saving_v: true; @status_v: 'sent'". Başka bir programı çağırmak onu name.prog altında adlandırır ve eylemi progun kendi türüyle eşleştirir (get_data bir get_data progu, call_native_javascript bir javascript progu gerektirir, vb.).

call_library kurulu bir eklenti yöntemini çağırır: name.plugin_name uygulamaya satın alınmış ve kurulmuş olmalıdır, yoksa denetleyici adımı reddeder; name.library_method eklentinin dışa aktardığı yöntemlerden biri, name.library_props bildirilen alanlarıdır. İki prop adı, herhangi birine özgü olmaktan çok eklentiler arasında bir kuraldır: event_name_for_successful_callback o olayı yöntemin yanıtıyla tetikler, field_id_to_return_result yanıtı doğrudan o alana yazar; ikisi de zorunlu değildir.

progEvents türleri

on_load, on_exit, before_record, after_record, record_not_found, locate_not_found, screen_ready, on_refresh, on_unload, client_interval, user_defined. screen_ready olağan başlatma kancasıdır; before_record / after_record / record_not_found / locate_not_found veri yaşam döngüsüdür, özellikle set_data ve batch için; client_interval tekrarlayan bir zamanlayıcıdır; user_defined, raise_event eyleminden tetiklenir.

Tablolar

Bir tablo progu (menuType: "table") bir veritabanı tablosunu tanımlar: sütunlarını (tableFields), dizinlerini (tableIndexes) ve onu depolayan veritabanı eklentisini (properties.databaseSocket). Ağaç üst öğesi: database ya da altındaki bir klasör.

json
{
  "properties": { "menuType": "table", "menuName": "ORD - Orders", "databaseSocket": "@xuda.io/xuda-dbs-plugin-xuda" },
  "tableFields": [
    { "id": "<uuid>", "data": { "field_id": "ORD_Id" }, "props": { "fieldType": "string", "mandatory": true } }
  ],
  "tableIndexes": [
    { "id": "<uuid>", "data": { "name": "index_1", "unique": true, "keys": ["ORD_Id"] }, "props": {} }
  ]
}
  • databaseSocket, projeye kurulu bir veritabanı eklentisini adlandırmalıdır, @xuda.io/xuda-dbs-plugin-xuda platform varsayılanıdır; aynı projedeki mevcut bir tablo, hangi soketin yeniden kullanılacağı için başvurudur.
  • En az bir alan ve en az bir dizin gereklidir.
  • field_id bir harfle başlar, ardından harfler, rakamlar, alt çizgi, tire, iki nokta veya nokta gelir ve tablo içinde benzersiz kalır.
  • fieldType, string, number, boolean, array, object veya date değerlerinden biridir; mandatory: true kayıtta onu zorunlu kılar.
  • Her dizinin boş olmayan bir name ve keys değeri olmalı ve her anahtar mevcut bir field_id olmalıdır.

Kural: sütunlara üç harfli bir tablo koduyla önek verin; "ORD - Orders" adlı bir tablo ORD_Id, ORD_Total, ORD_Status alır. Her tabloya benzersiz bir dizinle birlikte benzersiz bir <TBL>_Id alanı verin; tek kayıtlı bir bileşen bağlaması buna ihtiyaç duyar.

Bir tablo üç şekilde kullanılır: bir bileşenin ya da sorgunun progDataSource.dataSourceTableId değeri, iş akışlarından satır düzeyinde erişim için bir get_data / set_data / batch progu ya da bir betikten xu.dbs_create / dbs_read / dbs_update / dbs_delete; bu sonuncusu sırada.

JavaScript programları

Bir javascript progu (menuType: "javascript"), kayıtta derlenen gerçek JS kaynağını scriptData.value içinde tutar. save_prog bu derlemeyi tetikler ve sonucu data.compile olarak döndürür, { ok: true, dependencies } ya da { ok: false, error }. Başarısız bir derleme yine de belgeyi kaydeder; bu yüzden bir derleme compile.ok değerini okur ve devam etmeden önce düzeltir.

Yürütme sözleşmesi

Kaynak düz bir async gövde olarak yazılır, export yok, sarmalayıcı yok. Çalışma zamanında şöyle yürütülür:

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

params çağıranın zaten değerlendirilmiş girdileridir; xu aşağıdaki çalışma zamanı API'sidir; bir dönüş değeri isteğe bağlıdır, sonuçları geri vermenin deyimsel yolu çağıran bileşenin alanlarında xu.set_field_value kullanmaktır. Burada tırnaklar sorun değildir; bir xu-script öznitelik değerinden farklı olarak.

xu çalışma zamanı API'si

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 || ``, CNT_Email: row.email || `` });
}
// dbs_read resolves to an ARRAY of { id, value } rows: the row id on .id, table fields under .value.
const all = await xu.dbs_read(`392_tbl_...`, {}, [], null, 999);
await xu.set_field_value(`status_v`, `Saved ` + rows.length + ` rows`);

dbs_* yöntemleri tablo progunun kendi _id değerini alır, asla bir ad almaz. Seçiciler alan kimlikleri üzerinde Mongo tarzı nesnelerdir, {} her şeyi döndürür (varsayılan sınır 999). fields izdüşümü isteğe bağlıdır, [] 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, name.parameters betiğe ham olarak ulaşır. Güvenilir sözleşme: bileşen yükü önce bir alana koyar (bir update adımı ya da bir xu-bind girdisi), iş akışı progu boş parameters: {} ile çağırır ve betik bunu xu.get_field_value ile okuyup xu.set_field_value ile geri bildirir. Bunun yerine başka bir betikten çağırırken, xu.call_javascript(prog_id, {...}) parametreleri doğrudan geçirir.

Canlı önizleme tuhaflıkları

  • Veri yazmaları gerçek veritabanına ulaşır, ancak xu.dbs_read taze sunucu satırlarını tutmayabilen yerel bir taslak deposunu okur; bir yazmadan hemen sonraki okuma, yazma tamamlanmış olsa bile önizlemede boş dönebilir (Studio'da tablonun Veri sekmesinde görünür). Dağıtılmış uygulamalar aynı depoyu okur ve yazar.
  • Derlenmiş betikler geliştirme önizlemelerinde sert şekilde önbelleğe alınır; çalışan bir önizleme, bir kayıt onu yeniden derledikten sonra yeniden yüklemelerde bile önceki betiği çalıştırmaya devam edebilir. Sert bir tarayıcı yenilemesi bunu temizler.
  • modal, toast veya browser gösterimli xu.alert, önizlemede yerel, engelleyici bir alert() olarak ortaya çıkabilir. Bir durum alanına xu.set_field_value yazmak geri bildirmenin daha güvenli yoludur.

javascript progu ile xu-script özniteliği

xu-script / xu-style için tırnaksız teknikler

Tasarımcı tuvali öznitelik değerlerini kaçışsız serileştirir; bu yüzden tek bir tırnak bileşenin işaretlemesini bozar. Şablon değişmezleri dize tırnaklarını tamamen önler (el.textContent = `Ready`); örneğin CSV oluştururken değişmez " karakteri String.fromCharCode(34) ile gelir; CSS öznitelik seçicileri tırnaksız da geçerlidir (el.querySelector(`[data-role=import-btn]`)); ve bir yeniden çalışma koruması, if (el.__bound) return; el.__bound = true;, bir betiği yeniden oluşturmada çift bağlanmaktan korur.

Tuzaklar

Aşağıdaki her girdi bir noktada gerçek bir derlemeyi bozmuştur. validate_prog çoğunu yakalar; her kayıttan önce çalıştırın.

API mekaniği

  • Her yanıt { code, data } biçimindedir, code < 0 bir hatadır.
  • create_prog yeni belgeyi data.prog altında döndürür; tüm yanıtı kaydetmek, properties değeri prog altına gömülmüş hatalı biçimli bir belgeyi kalıcı kılar.
  • save_prog tüm belgeyi değiştirir. Daima mevcut belgeden başlayın, asla elle derlenmiş bir iskeletten değil; -409, son okumadan beri değiştiği anlamına gelir: yeniden getirin, yeniden uygulayın, yeniden deneyin.
  • MCP üzerinden prog_json ve properties_json dize olarak geçirilir; araç şeması katmanı bir nesne parametresindeki bilinmeyen anahtarları ayıklar ve tüm bölümleri sessizce düşürebilir.
  • delete_prog yumuşak bir silmedir, stat: 4 ayarlar. global_<app_id> düğümü silinemez.

Belge içeriği

  • xu-script veya xu-style değerlerinin içinde ' ya da " olmaz.
  • $ önekli anahtarlar ($folded, $childrenClass, $nodeBackClass) ile path, code, editCode tasarımcı görünüm durumudur ve kaydedilmiş bir progUi düğümüne asla ait değildir.
  • comment veya text düğüm türleri yok, yalnızca öğeler, statik metin content içinde.
  • Her öğe düğümü, boş olsa bile, attributes: {} ve children: [] gerektirir.
  • xu-exp:class statik class değerini değiştirir, gereken her sınıf ifadenin içine aittir.
  • xu-bind yalın bir alan kimliğidir, @ yok; başka her yerde alanlar @ kullanır.
  • Yalnızca belgelenmiş xu-* öznitelikleri bir şey yapar; uydurulmuş biri sessizce yok sayılır ve validate_prog uyarır.
  • Bir ai_agent progunun ağaç kökü ai_agents'tir; denetleyici parentId değerini işaretlerse onu studio_meta.parentId: "ai_agents" (veya altındaki bir klasör kimliği) ile kaydedin.

Çalışma zamanı ve oluşturma

  • Büyük harfli bir tagName her zaman bir bileşen olarak sahiplenilir, yazım hatası olsa bile, ve bağlama sırasında etiketi, library değerini ve denenen her kaynağı adlandırarak hata atar; program seçilmemiş bir xu-panel'deki gibi sessiz bir "oluşturulmuyor" durumu yoktur.
  • validate_prog bileşen etiketlerini ya da library değerlerini denetlemez; yanlış yazılmış birini yalnızca canlı önizleme yakalar.
  • Projenin uiFramework eklentisi gerçekten sağlamıyorsa çalışma zamanında yardımcı CSS (Tailwind ya da başka) yoktur; p-4 gibi sınıflar aksi halde sessizce etkisiz kalır. Kendi içinde yeterli stil, [xu-ui-id] ile otomatik kapsamlanan xu-style ile yapılır.
  • xu-script öğe görünürlüğü başına bir kez çalışır ve yeniden oluşturmada yeniden tetiklenebilir; el.__bound ile koruyun ve sorguları el ile sınırlayın.

Veri ve betikler

  • call_native_javascript parametreleri değerlendirilmez, veriyi bunun yerine alanlar üzerinden geçirin (yukarıdaki Veriyi içeri geçirme bölümüne bakın).
  • dbs_read satırları {id, value} biçimindedir, alanlar .value altında, satır kimliği .id üzerinde yaşar. Bir fields izdüşümü geçirmeyin, sunucu tarafı okumayı bozar.
  • xu-for içinde yineleyiciyi parantezle sarın, (@_FOR_VAL).CNT_Name değerlendirilir, @_FOR_VAL.CNT_Name sessizce başarısız olur ve bunun yerine yerine konan kaynak metni oluşturur.
  • Önizleme yazmaları gerçek veritabanına ulaşır; önizleme okumaları, bir yazmadan hemen sonra boş görünebilen yerel bir taslak deposundan gelir.
  • Önizlemelerde xu.alert'in modal veya toast gösterimi yerine bir durum alanını tercih edin; yerel, engelleyici bir alert() olarak oluşturulabilir.

Çalışmanızı doğrulama

Kaydettikten sonra get_prog ile yeniden getirin ve beklenenle farkı karşılaştırın. Arayüz işi için bileşeni Studio'da açıp önizleme oynat düğmesine ya da varsa projenin canlı önizleme URL'sine basın. Bir javascript progu için her kayıtta data.compile.ok değerini kontrol edin. Her validate_prog hatasını düzeltin; uyarılarını, tırnakları, $ anahtarlarını, bilinmeyen öznitelikleri, gürültü olarak değil, şimdi düzeltilecek öğeler olarak ele alın.