Globale
Programul unic din care pot citi toate celelalte programe, pentru starea și logica ce aparțin întregii aplicații, nu unui singur ecran.
Fiecare proiect Xuda are exact un program Globale. Acesta păstrează constantele, variabilele partajate și logica de pornire pe care o poate citi orice program Component, Get Data, Set Data, Batch, JavaScript sau API din proiect, așa că o valoare care înseamnă același lucru peste tot (utilizatorul conectat, un indicator de funcționalitate, campusul activ) are un singur loc, în loc să fie copiată în fiecare ecran care are nevoie de ea.
Orice ar spune runAt în altă parte, runtime-ul forțează Globale pe client. Este singurul tip de program care nu se execută niciodată pe server, deci este locul nepotrivit pentru orice trebuie să rămână în afara dispozitivului (secrete, citiri privilegiate). Pentru asta folosește un program Get Data sau Set Data pe server.
Când îl folosești
Folosește Globale când o valoare sau o bucată de logică de pornire este necesară mai multor componente și nu vrei s-o transmiți ca parametru la fiecare dintre ele: numele utilizatorului conectat, un campus sau un tenant selectat, un indicator de mod întunecat, o adresă de email de suport, un hub raise_event la care pot asculta mai multe ecrane fără legătură între ele.
Nu-l folosi pentru nimic ce aparține unui singur ecran (acela este un câmp al unei componente) sau pentru nimic ce trebuie să ruleze pe server.
Proprietăți
Documentul se află la studio_meta.parentId: "globals", rădăcina propriei ramuri din arbore, separată de programs, database și routes. Documentul Globale al unui proiect și rădăcina arborelui nu pot fi șterse.
progFields
Fiecare intrare declară o variabilă, care poate fi citită peste tot ca @field_id.
Globalele de sistem sunt întotdeauna disponibile alături de ale tale: @SYS_GLOBAL_OBJ_LOGIN_USER_INFO (obiectul utilizatorului conectat) și @SYS_GLOBAL_OBJ_REFS (elementele înregistrate cu xu-ref, folosite pentru stările de încărcare și de gol).
progEvents
Globale acceptă aceeași structură progEvents ca orice alt program, dar nu orice tip de eveniment din platformă i se aplică. Verificatorul limitează screen_ready, on_refresh, on_unload și client_interval doar la componente; declararea uneia dintre ele într-un program Globale este o eroare gravă de validare. Ce acceptă de fapt Globale:
O descriere mai veche a acestei unități spunea că Globale poate face polling la un interval (client_interval) sau după un program cron pe server (server_cron). Niciuna nu rezistă în fața verificatorului actual: client_interval este validat ca exclusiv pentru componente, iar server_cron nu este deloc un tip de eveniment recunoscut, singura lui urmă în runtime fiind un handler comentat. Dacă un proiect are nevoie azi de polling recurent, pune temporizatorul pe o componentă (client_interval acolo este real și activ), nu pe Globale.
Exemplu lucrat
Declară starea partajată
Adaugă câmpuri pentru valorile de care are nevoie fiecare ecran: selected_campus_v, signed_in_user_v, dark_mode_v.
Citește-le de oriunde
Orice componentă, program sau expresie din proiect le citește la fel, cu @: @selected_campus_v.
Ridică un eveniment transversal
Dă-i lui Globale un eveniment user_defined (de exemplu campus_changed) și apelează-l cu raise_event din componenta care schimbă campusul. Fiecare altă componentă deschisă care a ridicat și ea un listener raise_event pentru acel nume reacționează, fără o referință directă între cele două ecrane.
În arborele Studio, Globale este nodul unic de la rădăcina propriei ramuri (nu este imbricat sub Programe). Deschide-l, adaugă rânduri în tabelul Câmpuri pentru fiecare variabilă partajată, cu un tip și o valoare implicită, și adaugă rânduri în Evenimente pentru on_load / on_exit / orice eveniment cu nume, fiecare cu propriul workflow.