Siirry sisältöön
Tarkistettu

Studion LLM-opas

Prog-dokumenttimalli, xu-*-attribuuttiviite ja työnkulun säännöt, jotka tekoälyagentille opetetaan ennen sen ensimmäistä työkalukutsua.

Jokainen Studio-projekti, ja sen sisällä jokainen taulu, näkymä, skripti ja reitti, on yksi CouchDB JSON -dokumentti nimeltä prog (docType: "studio"). Tämä sivu on sama viite, jonka tekoälyagentti saa rakentaessaan sellaista, kirjoitettuna dokumentaatioksi: dokumentin muoto, sen käyttöliittymää ohjaavat attribuutit, toiminnot, joita työnkulku voi tehdä, ja virheet, jotka toistuvat oikeissa rakennuksissa.

Miten tekoälyagentti saa tämän oppaan

Yhdistä MCP-asiakas Xudaan, niin ensimmäinen vastaus, initialize-kutsu, kantaa tämän oppaan istunnon instructions-kentässä, yhdistettynä tuoreeltaan alustan omista elävistä säännöistä, jotta se ei voi koskaan kuvata jotain, jota julkaistu tarkistin ei enää valvo. Katso AI-asiakkaan yhdistäminen MCP:llä.

Istunnon sisältä kaksi metodia tavoittaa saman aineiston suoraan, MCP:n tai tavallisen REST:n yli, eivätkä vaadi muuta kuin tavallisen API-avaimen:

Määrätty järjestys: lue rakennettavaa vastaava aihe, hae vastaava esimerkki, luo prog tehtaan kautta (create_prog), rakenna sen sisältöosioiden sisällä, validoi (validate_prog) ja korjaa kaikki, mitä se raportoi, tallenna (save_prog) ja hae sitten uudelleen varmistaaksesi. Tallennus, joka palauttaa -409, tarkoittaa, että dokumentti on muuttunut lukemisen jälkeen: hae uudelleen, sovella muutokset uudelleen, yritä uudelleen.

Prog-dokumenttimalli

Kirjekuori

Palvelin- ja tehdaskoodi omistavat nämä kentät, kirjoitettu rakennus muokkaa vain niiden alla olevia sisältöosioita.

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 noudattaa muotoa <app_id:n viimeiset 3 merkkiä>_<3-kirjaiminen tyyppilyhenne>_<12 heksaa>, esimerkiksi 392_cmp_... komponentille, 392_tbl_... taululle, 392_jvs_... javascript-progille, 392_gtd_... / 392_std_... get_data- / set_data-progille, 392_fld_... kansiolle. Tehdas generoi tunnisteet, rakennus ei koskaan keksi sellaista.
  • stat on 3 aktiiviselle ja 4 pehmeästi poistetulle (sen asettaa progin poistaminen). Studion puu näyttää vain stat: 3.
  • properties.menuType on yksi arvoista globals, table, get_data, set_data, batch, alert, javascript, folder, route, api, component, ai_agent.
  • studio_meta.parentId sijoittaa solmun Studion puuhun: joko toisen progin tunniste (yleensä kansio) tai yksi tyyppijuurista, programs (logiikka ja komponentit), database (taulut), routes, globals, ai_agents. Tunnistamaton parentId jättää solmun näkymättömäksi puussa ja on tarkistusvirhe.

Sisältöosiot menuType-arvon mukaan

Globals-dokumentti

Jokaisella projektilla on täsmälleen yksi global_<app_id>-dokumentti (menuType: "globals"). Sen progFields ovat luettavissa jokaisesta muusta progista muodossa @field_id. Kaksi järjestelmän globaalia kuuluu jokaiseen projektiin: @SYS_GLOBAL_OBJ_LOGIN_USER_INFO kirjautuneelle käyttäjälle ja @SYS_GLOBAL_OBJ_REFS elementeille, jotka on rekisteröity xu-ref:llä. Globals-dokumenttia eikä puun juurta voi poistaa.

Rakenteelliset pakolliset

  • properties, properties.menuType, properties.menuName, studio_meta ja studio_meta.parentId ovat pakollisia jokaisessa dokumentissa.
  • progFields-merkintä tarvitsee yksilöllisen id:n, data.field_id:n, data.type:n arvoltaan virtual, table, expression tai datasource ja props.fieldType:n arvoltaan string, number, boolean, array tai object.
  • Varattuja suoritusaikaisia muuttujanimiä, _NULL, _THIS, _FOR_KEY, _FOR_VAL, _ROWNO, _ROWID, _ROWDOC, _KEY, _VAL, ei koskaan määritellä uudelleen kenttätunnisteina.
  • Päällekkäiset tunnisteet, tuntemattomat menuType-arvot ja virheelliset osiot ovat kaikki kovia virheitä, jotka validate_prog raportoi suoraan.

Lausekkeet ja xu-*-attribuutit

Lausekesyntaksi

Lausekkeet ajetaan progin oman datajoukon päällä. Mihin tahansa kenttään, paikalliseen, taulusidonnaiseen, globaaliin tai parametriin, viitataan @:lla: @search_v, @ORD_Total, @SYS_GLOBAL_OBJ_LOGIN_USER_INFO, tavallista JavaScriptiä sen ympärillä, @count_v > 0 ? 'has rows' : 'empty'. Olioliteraali tarvitsee ympärilleen sulkeet, ({ ORD_Status: @status_v }). xu-for-silmukan sisällä nykyinen kohde on @_FOR_VAL ja sen avain tai indeksi @_FOR_KEY (uudelleennimettävissä xu-for-key / xu-for-val -attribuuteilla). xu-render ja muut ehdot palauttavat tosi- tai epätosi-arvon suoraan, ei koskaan "Y" / "N" -merkkijonoa tai ylimääräistä vertailua.

xu-bind on ainoa poikkeus

Kaikkialla muualla kenttään viitataan @:lla. xu-bind ottaa sen sijaan pelkän kenttätunnisteen: xu-bind="search_v", ei koskaan xu-bind="@search_v".

xu-attribuutit

Etuliiteperheet

Attribuuttiperheet, jotka ottavat päätteen. xu-on-arvot ovat aina taulukoita käsittelijäolioita, xu-exp-arvot ovat aina lausekemerkkijonoja.

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

xu-on:*-attribuutin arvo on aina taulukko käsittelijäolioita, ja kukin workflow on taulukko toimintoaskeleita (täysi toimintoviite on alla kohdassa Logiikkaprogit ja työnkulut). Askeleen props.condition rajaa sen, props.async: true laukaisee sen odottamatta.

Kriittiset semantiikat

  • xu-exp:class korvaa staattisen class-attribuutin sen sijaan, että lisäisi siihen. Elementillä, jolla on molemmat, staattinen ohitetaan, joten asettelun luokat kuuluvat myös lausekkeen sisään: xu-exp:class="'card p-4 ' + (@active_v ? 'ring' : '')".
  • xu-script ottaa pelkän function (el) { ... }-lausekkeen, joka eval-ajetaan ja kutsutaan DOM-elementillä, kun solmu tulee näkyviin. Suojaudu uudelleenajoilta (if (el.__bound) return; el.__bound = true;) ja rajaa jokainen kysely el:iin, ei koskaan document:iin.
  • xu-style on automaattisesti rajattu: jokaiseen valitsimeen lisätään etuliitteeksi solmun [xu-ui-id], joten tavalliset elementti- ja luokkavalitsimet pysyvät paikallisina eivätkä vuoda.
  • Kumpikaan xu-script- tai xu-style-arvo ei saa sisältää lainausmerkkiä (' tai "): suunnittelukanvas sarjallistaa attribuutit ilman escapeja, ja yksi lainausmerkki turmelee komponentin. Alla oleva JavaScript-progit-osio käsittelee lainausmerkittömiä tekniikoita.
  • Staattinen teksti kuuluu elementin content-ominaisuuteen. xu-exp:xu-content on vain dynaamista tekstiä varten.

Tagit

Kirjoitustagit tavallisen HTML:n lisäksi: xu-template, xu-single-view, xu-multi-view, xu-panel, xu-teleport, xu-slot.

  • xu-single-view rajaa yksittäisen tietueen (lomakkeen juuri, käytettävissä myös sisäkkäin).
  • xu-multi-view toistaa lapsensa kerran sidotun datan jokaista riviä kohden.
  • xu-panel upottaa toisen progin (program-attribuutti sekä xu-exp:<param>-syötteet). Siihen kuuluvat parametrilausekkeiden lisäksi vain tavalliset HTML-attribuutit (class, id, style, title, hidden, slot, name, role, tabindex).
  • xu-teleport renderöi lapsensa toiseen DOM-kohteeseen (to tai xu-exp:to).
  • Isolla alkukirjaimella kirjoitettu tagin nimi (Button, Card) on käännetty komponentti, ei HTML-elementti, katso alla Upottaminen.

Komponentit

Komponentti (menuType: "component") on käyttöliittymäyksikkö: elementtipuu (progUi), joka on sidottu paikalliseen tilaan (progFields), valinnaiseen dataan (progDataSource), elinkaarilogiikkaan (progEvents) ja syöte-/tulostekäyttöliittymään (properties.progParams).

Ominaisuudet

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 on form yhdelle tietueelle (juurielementti xu-single-view) tai grid / list yhdelle toistetulle datariviä kohden (juurielementti xu-multi-view).
  • rwMode on R lukemiselle tai U päivitykselle, allowCreate kertoo, voiko uuden rivin lisätä, kun mikään ei täsmää.
  • progParams-nimeämiskäytäntö: parametrit päättyvät _in / _out, komponentin paikalliset virtuaalikentät päättyvät _v.
  • uiFramework peilaa sitä, mitä projektin olemassa olevat komponentit jo käyttävät. Olemassa oleva projekti, joka jättää sen pois, jättää sen jatkossakin pois: kehysliitännäisen asettaminen, jota projektin drive ei oikeasti tarjoa, jumittaa live-esikatselun tyhjälle näytölle.

Elementtipuu (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" } }
      ] }
  ]
}

Tehtaan root-solmu pysyy, rakennus työskentelee sen children-kentän sisällä. Jokainen solmu tarvitsee yksilöllisen tunnisteen (uudet solmut käyttävät ui-<uuid>), type: "element" ja tagName:n, ei comment- tai text-solmutyyppejä, staattinen teksti on content-kentässä. Jokainen solmu tarvitsee attributes: {} ja children: [] vaikka tyhjänä: suunnittelukanvaksen sarjallistaja viittaa molempiin jokaisella solmulla, ja puute rikkoo komponentin oman esikatselun.

Upottaminen: xu-panel vai käännetty komponentti

Molemmat liitetään läpinäkyvästi ilman kääreelementtiä, ja molemmat ratkaistaan yhdellä signaalilla: alkaako tagName isolla kirjaimella.

  • xu-panel, pienellä kirjoitettu tagName sekä program-attribuutti, upottaa toisen progin, tietokantasidonnaisen tai tilallisen lapsen omine kenttineen ja tapahtumineen. program on lapsen tunniste (tai xu-exp:prog dynaamiselle), arvot saavuttavat sen _in-parametrit xu-exp:<param>:n kautta.
  • Isolla alkukirjaimella kirjoitettu tagi sekä library-attribuutti liittää käännetyn komponentin, suunnittelujärjestelmän primitiivin tai sovelluksen itse kääntämän osan. Jokaisesta tavallisesta attribuutista tulee prop (props.<name>), ei koskaan DOM-attribuutti, koska komponentti ei renderöi omaa elementtiä. Komponenttisolmulla ei ole out-parametreja: toisin kuin xu-panel, mikään ei kirjoita arvoa takaisin kentillesi.
Pelkkä isot kirjaimet ratkaisevat

Kirjoitusvirheellinen <Buton> tulkitaan yhä komponenttitagiksi, ei koskaan putoa takaisin tuntemattomaksi HTML-elementiksi, ja heittää liitettäessä virheen, joka nimeää tagin, kirjaston ja jokaisen kokeillun lähteen. validate_prog ei tarkista komponenttitageja eikä library-arvoja nykyisin, live-esikatselu on ainoa tarkistus.

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 on virtual paikalliselle tilalle, table sidotun datalähteen sarakkeelle tai expression / datasource. Kentän workflow ajetaan muutoksessa. Oletusarvo asettaa props.fieldValue:n, laskettu kenttä asettaa props.fieldComputed: true sekä propExpressions.fieldValue:n.

progDataSource

Yksi tietue avaimella (lomake): dataSourceFilterModelType: "index" ja dataSourceIndexId, joka on olemassa taulun omassa tableIndexes-kentässä. Suodatettu lista (grid tai list): dataSourceFilterModelType: "query" ja filterModelMongoFx, Mongo-tyylinen lausekemerkkijono. dataSourceType on table, array, json, csv, none tai tyhjä puhtaasti esittävälle komponentille, jolla ei ole lainkaan datalähdettä.

progEvents ja kolme elinkaarikoukkua

Tapahtumatyypit: 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-tapahtumat laukeavat mistä tahansa raise_event-toiminnolla, screen_ready on tavallinen liitoskoukku.

Komponentin kolme sisäänrakennettua koukkua jakavat työn, ja väärän käyttö on yleinen virheiden lähde:

screen_ready

Laukeaa kerran instanssia kohden. Luo DOM ja widgetit täällä.

on_refresh

Laukeaa jokaisen latauksen jälkeen, myös ensimmäisen, heti screen_ready:n jälkeen. Anna uusi data widgeteille, jotka jo ovat olemassa. Jos päivitystyö laitetaan sen sijaan screen_ready:iin, luontikoodi ajetaan uudelleen DOMia vasten, joka yhä on olemassa, ja pinoaa toisen widgetin.

on_unload

Laukeaa, kun instanssi puretaan. Tuhoa se, minkä prog loi: widgetit, ajastimet, document / window -kuuntelijat, tarkkailijat. Moottori voi vapauttaa vain sen, minkä se loi: document:iin sidottu kuuntelija elää muuten paneelin yli.

Mallit

  • Lataus- ja tyhjätilat: aseta xu-ref="myref" datasidotulle elementille ja rajaa sitten luuranko- tai tyhjäelementit xu-render:llä lausekkeella (@SYS_GLOBAL_OBJ_REFS).myref, sen datajoukko liittyy, kun data saapuu.
  • Modaalit: rakenna dialogi omana komponenttinaan ja avaa se call_modal-toiminnolla.
  • Sidotun rivin tallennus tai poisto: invoke_action arvolla act_save / act_delete tai oma set_data-prog kaikelle nykyistä riviä laajemmalle.

Logiikkaprogit ja työnkulut

Logiikkaprog-tyypit jakavat komponentin datakoneiston (progDataSource, progFields, progEvents, properties.progParams) ilman käyttöliittymää:

Parametrit

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

Kutsuja välittää arvot toiminnon name.parameters-kentän kautta, { "order_id_in": { "value": "", "fx": "@selected_id_v" } }, value staattiselle arvolle, fx lausekkeelle. Tarkistin varmistaa, että kohdeohjelma on olemassa ja sen menuType vastaa toimintoa.

Työnkulun toiminnot

Työnkulku on taulukko askeleita, { "id": "...", "data": { "action": "...", "name": { ... }, "enabled": true }, "props": {} }, ajettuna järjestyksessä. props.condition rajaa askeleen, props.async: true laukaisee sen odottamatta. Työnkulut esiintyvät xu-on:*-käsittelijöissä, progEvents[].workflow:ssa ja kentän omassa workflow:ssa.

invoke_action hyväksyy arvot act_next, act_prev, act_first, act_last, act_reload, act_refresh, act_print, act_save, act_delete (vain komponenttikontekstissa).

Vanhentuneet toiminnot, jotka tarkistin hylkää

alter_ui_element, create_ui_element, info_ui_element, remove_ui_element, empty_ui_element, cache_ui_element, load_ui_element. Ohjaa käyttöliittymää kenttien ja xu-exp / xu-render:in kautta imperatiivisen elementtitoiminnon sijaan.

call_ai_agent ja call_triage_agent eivät ole oikeita toimintoja

Studion oma toimintovalitsin tarjoaa Kutsu tekoälyagenttia ja Kutsu triage-agenttia yllä olevien toimintojen rinnalla. Kumpaakaan ei ole tässä taulukossa, koska kumpikaan ei ole sellainen: validate_prog:lla ei ole niille tapausta ja se raportoi invalid trigger type, eikä suoritusaikaisella työnkulkumoottorilla ole niille käsittelijää, joten tallennettu askel ei koskaan aja, vaikka virhe ohitettaisiin. Jotta yksi prog tavoittaisi julkaistun agentin, lisää Tekoälyagentti-työkalu toisen agentin omaan työkaluluetteloon (menuType: "ai_agent"-dokumentin agentConfig.agent_tools), älä työnkulun askeleena komponentissa, get_data:ssa tai missään muussa prog-tyypissä.

update:n name.value antaa kentille arvoja puolipisteellä erotetuilla @field: expression -pareilla tai JSON5-oliolla, "@saving_v: true; @status_v: 'sent'". Toisen ohjelman kutsuminen nimeää sen kohdassa name.prog, ja toiminto täsmätään progin omaan tyyppiin (get_data tarvitsee get_data-progin, call_native_javascript javascript-progin ja niin edelleen).

call_library kutsuu asennetun liitännäisen metodia: name.plugin_name täytyy olla ostettu ja asennettu sovellukseen tai tarkistin hylkää askeleen, name.library_method yksi liitännäisen viemistä metodeista, name.library_props sen ilmoitetut kentät. Kaksi prop-nimeä on käytäntö liitännäisten kesken eikä minkään yksittäisen erityinen: event_name_for_successful_callback nostaa kyseisen tapahtuman metodin vastauksella, field_id_to_return_result kirjoittaa vastauksen suoraan kyseiseen kenttään, kumpikaan ei ole pakollinen.

progEvents-tyypit

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 on tavallinen alustuskoukku, before_record / after_record / record_not_found / locate_not_found ovat datan elinkaarta, erityisesti set_data:lle ja batch:lle, client_interval on toistuva ajastin, user_defined laukeaa raise_event-toiminnosta.

Taulut

Taulu-prog (menuType: "table") määrittelee tietokantataulun: sen sarakkeet (tableFields), indeksit (tableIndexes) ja sen tallentavan tietokantaliitännäisen (properties.databaseSocket). Puun vanhempi: database tai sen alla oleva kansio.

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:n täytyy nimetä projektiin asennettu tietokantaliitännäinen, @xuda.io/xuda-dbs-plugin-xuda on alustan oletus, saman projektin olemassa oleva taulu on viite siitä, mitä socketia käyttää uudelleen.
  • Vähintään yksi kenttä ja vähintään yksi indeksi vaaditaan.
  • field_id alkaa kirjaimella, sitten kirjaimia, numeroita, alaviiva, tavuviiva, kaksoispiste tai piste, ja on yksilöllinen taulun sisällä.
  • fieldType on string, number, boolean, array, object tai date, mandatory: true tekee siitä pakollisen tallennettaessa.
  • Jokainen indeksi tarvitsee ei-tyhjän name:n ja keys:n, ja jokaisen avaimen täytyy olla olemassa oleva field_id.

Käytäntö: etuliitä sarakkeet kolmikirjaimisella taulukoodilla, taulu nimeltä "ORD - Orders" saa ORD_Id, ORD_Total, ORD_Status. Anna jokaiselle taululle yksilöllinen <TBL>_Id-kenttä ja sille yksilöllinen indeksi, yhden tietueen komponenttisidonta tarvitsee sen.

Taulua käytetään kolmella tavalla: komponentin tai kyselyn progDataSource.dataSourceTableId, get_data / set_data / batch -prog rivitason pääsyyn työnkuluista tai xu.dbs_create / dbs_read / dbs_update / dbs_delete skriptistä, katso seuraavaksi.

JavaScript-progit

Javascript-prog (menuType: "javascript") sisältää oikeaa JS-lähdettä kentässä scriptData.value, käännettynä tallennettaessa. save_prog käynnistää koonnin ja palauttaa tuloksen muodossa data.compile, { ok: true, dependencies } tai { ok: false, error }. Epäonnistunut käännös tallentaa dokumentin silti, joten rakennus lukee compile.ok:n ja korjaa sen ennen jatkamista.

Suoritussopimus

Lähde kirjoitetaan tavallisena async-runkona, ei export:ia, ei kääretta. Ajon aikana se suoritetaan seuraavasti:

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

params ovat kutsujan jo arvioidut syötteet, xu on alla oleva suoritusaikainen API, paluuarvo on valinnainen, idiomaattinen tapa palauttaa tuloksia on xu.set_field_value kutsuvan komponentin kentille. Lainausmerkit ovat täällä sallittuja, toisin kuin xu-script-attribuutin arvossa.

xu-suoritusaikainen API

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_*-metodit ottavat taulu-progin oman _id:n, ei koskaan nimeä. Valitsimet ovat Mongo-tyylisiä olioita kenttätunnisteista, {} palauttaa kaiken (oletusraja 999). fields-projektio on valinnainen: [] palauttaa kaikki kentät, ja kenttätunnisteiden lista palauttaa vain ne.

Datan välittäminen: kentät, ei parametrit

call_native_javascript ei arvioi {value, fx}-parametrikääreitä, name.parameters saavuttaa skriptin raakana. Luotettava sopimus: komponentti asettaa kuorman ensin kenttään (update-askel tai xu-bind-syöte), työnkulku kutsuu progia tyhjillä parameters: {}, ja skripti lukee sen xu.get_field_value:lla ja raportoi takaisin xu.set_field_value:lla. Kutsuttaessa sen sijaan toisesta skriptistä, xu.call_javascript(prog_id, {...}) välittää parametrit suoraan.

Live-esikatselun oikut

  • Datakirjoitukset päätyvät oikeaan tietokantaan, mutta xu.dbs_read lukee paikallista luonnosvarastoa, jossa ei välttämättä ole tuoreita palvelimen rivejä: kirjoituksen jälkeen heti tehty luku voi palata tyhjänä esikatselussa, vaikka kirjoitus onnistui (näkyy taulun Data-välilehdellä Studiossa). Julkaistut sovellukset lukevat ja kirjoittavat samaa varastoa.
  • Käännetyt skriptit välimuistitetaan kovasti dev-esikatseluissa, käynnissä oleva esikatselu voi jatkaa edellisen skriptin suorittamista uudelleenlatausten yli, vaikka tallennus kääntäisi sen uudelleen. Selaimen kova päivitys tyhjentää sen.
  • xu.alert näytöllä modal, toast tai browser voi esiintyä esikatselussa natiivina, estävänä alert():ina. xu.set_field_value tilakenttään on turvallisempi tapa raportoida takaisin.

javascript-prog vs xu-script-attribuutti

Lainausmerkittömät tekniikat xu-script / xu-style -attribuuteille

Suunnittelukanvas sarjallistaa attribuuttiarvot ilman escapeja, joten yksi lainausmerkki turmelee komponentin merkinnän. Template-literaalit välttävät merkkijonolainausmerkit kokonaan (el.textContent = `Ready`), kirjaimellinen "-merkki, esimerkiksi CSV:tä rakennettaessa, tulee String.fromCharCode(34):stä, CSS-attribuuttivalitsimet ovat kelvollisia ilman lainausmerkkejä (el.querySelector(`[data-role=import-btn]`)) ja uudelleenajosuoja, if (el.__bound) return; el.__bound = true;, estää skriptiä sitomasta kahdesti uudelleenrenderöinnissä.

Sudenkuopat

Jokainen alla oleva kohta rikkoi jossain vaiheessa oikean rakennuksen. validate_prog pyydystää useimmat niistä, aja se ennen jokaista tallennusta.

API:n mekaniikka

  • Jokainen vastaus on { code, data }, code < 0 on virhe.
  • create_prog palauttaa uuden dokumentin kohdassa data.prog, koko vastauksen tallentaminen sen sijaan tallentaa virheellisen dokumentin, jossa properties on haudattu prog:n alle.
  • save_prog korvaa koko dokumentin. Aloita nykyisestä dokumentista, ei koskaan käsin kootusta rungosta, -409 tarkoittaa, että se on muuttunut viimeisen lukemisen jälkeen: hae uudelleen, sovella uudelleen, yritä uudelleen.
  • MCP:n yli prog_json ja properties_json välitetään merkkijonoina, työkaluskeemakerros poistaa tuntemattomat avaimet oliokentästä ja voi hiljaa pudottaa kokonaisia osioita.
  • delete_prog on pehmeä poisto, se asettaa stat: 4. global_<app_id>-solmua ei voi poistaa.

Dokumentin sisältö

  • Ei '- tai "-merkkiä xu-script- tai xu-style-arvojen sisällä.
  • $-etuliitteiset avaimet ($folded, $childrenClass, $nodeBackClass) sekä path, code, editCode ovat suunnittelijan näkymätilaa eivätkä koskaan kuulu tallennettuun progUi-solmuun.
  • Ei comment- tai text-solmutyyppejä, vain elementtejä, staattinen teksti content-kentässä.
  • Jokainen elementtisolmu tarvitsee attributes: {} ja children: [] vaikka tyhjänä.
  • xu-exp:class korvaa staattisen class:n, jokainen tarvittava luokka kuuluu lausekkeen sisään.
  • xu-bind on pelkkä kenttätunniste ilman @:a, kaikkialla muualla kentät käyttävät @:a.
  • Vain dokumentoidut xu-*-attribuutit tekevät mitään, keksitty ohitetaan hiljaa ja validate_prog varoittaa.
  • ai_agent-progin puun juuri on ai_agents, tallenna se arvolla studio_meta.parentId: "ai_agents" (tai sen alla olevan kansion tunnisteella), jos tarkistin liputtaa parentId:n.

Suoritusaika ja renderöinti

  • Isolla alkukirjaimella kirjoitettu tagName tulkitaan aina komponentiksi, myös kirjoitusvirhe, ja heittää liitettäessä virheen, joka nimeää tagin, library:n ja jokaisen kokeillun lähteen, hiljaista "ei renderöidy" -tilaa ei ole, toisin kuin xu-panel:lla, jolle ei ole valittu ohjelmaa.
  • validate_prog ei tarkista komponenttitageja eikä library-arvoja, vain live-esikatselu pyydystää väärin kirjoitetun.
  • Ei apuohjelma-CSS:ää (Tailwind tai muu) suoritusaikana, ellei projektin uiFramework-liitännäinen oikeasti tarjoa sitä, luokat kuten p-4 eivät muuten tee mitään. Itsenäinen tyylitys on xu-style, automaattisesti rajattu [xu-ui-id]:llä.
  • xu-script ajetaan kerran elementin näkyvyyttä kohden ja voi laueta uudelleen uudelleenrenderöinnissä, suojaa el.__bound:lla ja rajaa kyselyt el:iin.

Data ja skriptit

  • call_native_javascript-parametreja ei arvioida, välitä data kenttien kautta (katso yllä Datan välittäminen).
  • dbs_read-rivit ovat {id, value}, kentät ovat kohdassa .value, rivin tunniste kohdassa .id. Älä anna fields-projektiota, se rikkoo palvelinpuolen luvun.
  • xu-for:in sisällä kääri iteraattori sulkeisiin, (@_FOR_VAL).CNT_Name arvioituu, @_FOR_VAL.CNT_Name epäonnistuu hiljaa ja renderöi sen sijaan korvatun lähdetekstin.
  • Esikatselun kirjoitukset päätyvät oikeaan tietokantaan, esikatselun luvut tulevat paikallisesta luonnosvarastosta, joka voi näyttää tyhjältä heti kirjoituksen jälkeen.
  • Suosi tilakenttää xu.alert:in modal- tai toast-näytön sijaan esikatseluissa, se voi renderöityä natiivina, estävänä alert():ina.

Työn varmistaminen

Hae uudelleen get_prog:lla tallennuksen jälkeen ja vertaa odotettuun. Käyttöliittymätyössä avaa komponentti Studiossa ja paina esikatselun toistopainiketta tai projektin live-esikatselun URL-osoitetta, kun sellainen on saatavilla. Javascript-progille tarkista data.compile.ok jokaisella tallennuksella. Korjaa jokainen validate_prog-virhe, käsittele sen varoitukset, lainausmerkit, $-avaimet, tuntemattomat attribuutit, korjaa-nyt-kohteina eikä kohinana.