גלובליים
התוכנית האחת שכל תוכנית אחרת יכולה לקרוא ממנה, למצב ולוגיקה ששייכים לכל האפליקציה ולא למסך אחד.
לכל פרויקט ב-Xuda יש בדיוק תוכנית גלובליים אחת. היא מחזיקה את הקבועים, המשתנים המשותפים ולוגיקת ההפעלה שכל תוכנית רכיב, קבלת נתונים, שמירת נתונים, אצווה, JavaScript או API בפרויקט יכולה לקרוא, כך שלערך שמשמעותו זהה בכל מקום (המשתמש המחובר, דגל תכונה, הקמפוס הפעיל) יש בית אחד בלבד, במקום שיועתק לכל מסך שצריך אותו.
בלי קשר למה ש-runAt אומר במקומות אחרים, סביבת הריצה מכריחה את גלובליים להיות client. זה סוג התוכנית היחיד שאף פעם לא רץ בשרת, ולכן זה המקום הלא נכון לכל דבר שצריך להישאר מחוץ למכשיר (סודות, קריאות מורשות). לשם כך משתמשים בתוכנית קבלת נתונים או שמירת נתונים בצד השרת.
מתי להשתמש בה
פונים ל-גלובליים כשערך או חלק מלוגיקת הפתיחה נחוצים ליותר מרכיב אחד ואין רצון להעביר אותם כפרמטר בכל אחד מהם: שם המשתמש המחובר, קמפוס או דייר שנבחרו, דגל מצב כהה, כתובת אימייל של תמיכה, מוקד raise_event שכמה מסכים לא קשורים יכולים להאזין לו.
לא משתמשים בה לשום דבר ששייך למסך בודד (זה שדה של רכיב) או לשום דבר שחייב לרוץ בצד השרת.
מאפיינים
המסמך נמצא ב-studio_meta.parentId: "globals", שורש הענף שלו בעץ, נפרד מ-programs, מ-database ומ-routes. אי אפשר למחוק את מסמך גלובליים של הפרויקט ואת שורש העץ.
progFields
כל רשומה מצהירה על משתנה אחד, שנקרא בכל מקום כ-@field_id.
גלובליים של המערכת זמינים תמיד לצד אלה שלכם: @SYS_GLOBAL_OBJ_LOGIN_USER_INFO (אובייקט המשתמש המחובר) ו-@SYS_GLOBAL_OBJ_REFS (אלמנטים שנרשמו עם xu-ref, בשימוש למצבי טעינה ומצבים ריקים).
progEvents
גלובליים תומכת באותו מבנה progEvents כמו כל תוכנית אחרת, אבל לא כל סוג אירוע בפלטפורמה חל עליה. הבודק מגביל את screen_ready, את on_refresh, את on_unload ואת client_interval לרכיבים בלבד; הצהרה על אחד מהם בתוכנית גלובליים היא שגיאת אימות קשה. מה ש-גלובליים תומכת בו בפועל:
תיאור ישן של היחידה הזאת טען ש-גלובליים יכולה לדגום במרווח (client_interval) או לפי לוח זמנים של קרון בשרת (server_cron). אף אחד מהם לא עומד מול הבודק הנוכחי: client_interval מאומת כסוג של רכיבים בלבד, ו-server_cron אינו סוג אירוע מוכר בכלל, והעקבה היחידה שלו בסביבת הריצה היא מטפל שהוסב להערה. אם פרויקט צריך כיום דגימה חוזרת, שמים את הטיימר על רכיב (client_interval שם אמיתי ופעיל) ולא על גלובליים.
דוגמת עבודה
להצהיר על המצב המשותף
מוסיפים שדות לערכים שכל מסך צריך: selected_campus_v, signed_in_user_v, dark_mode_v.
לקרוא אותם מכל מקום
כל רכיב, תוכנית או ביטוי בפרויקט קורא אותם באותה דרך, עם @: @selected_campus_v.
להפעיל אירוע חוצה
נותנים ל-גלובליים אירוע user_defined (למשל campus_changed) וקוראים לו עם raise_event מכל רכיב ששינה את הקמפוס. כל רכיב פתוח אחר שגם רשם מאזין raise_event לשם הזה מגיב, בלי הפניה ישירה בין שני המסכים.
בעץ של Studio, גלובליים היא הצומת היחיד בשורש הענף שלה (לא מקוננת תחת תוכניות). פותחים אותה, מוסיפים שורות לטבלת שדות לכל משתנה משותף עם סוג וערך ברירת מחדל, ומוסיפים שורות לאירועים עבור on_load / on_exit / כל אירוע בשם, לכל אחד תהליך עבודה משלו.