Μετάβαση στο περιεχόμενο
Επαληθεύτηκε

Καθολικές μεταβλητές

Το ένα πρόγραμμα που μπορεί να διαβάσει κάθε άλλο πρόγραμμα, για κατάσταση και λογική που ανήκει σε ολόκληρη την εφαρμογή αντί για μία οθόνη.

Κάθε έργο Xuda έχει ακριβώς ένα πρόγραμμα Καθολικές μεταβλητές (Globals). Περιέχει τις σταθερές, τις κοινές μεταβλητές και τη λογική εκκίνησης που μπορεί να διαβάσει οποιοδήποτε πρόγραμμα Component, Get Data, Set Data, Batch, JavaScript ή API του έργου, ώστε μια τιμή που σημαίνει το ίδιο πράγμα παντού (ο συνδεδεμένος χρήστης, μια σημαία λειτουργίας, το ενεργό campus) να έχει ακριβώς ένα σπίτι αντί να αντιγράφεται σε κάθε οθόνη που τη χρειάζεται.

Οι Καθολικές μεταβλητές τρέχουν πάντα στον client

Ό,τι κι αν λέει το runAt αλλού, το runtime αναγκάζει τις Καθολικές μεταβλητές σε client. Είναι ο μόνος τύπος προγράμματος που δεν εκτελείται ποτέ στον διακομιστή, επομένως είναι το λάθος μέρος για οτιδήποτε πρέπει να μένει εκτός συσκευής (μυστικά, προνομιακές αναγνώσεις). Χρησιμοποιήστε για αυτά ένα πρόγραμμα Get Data ή Set Data από την πλευρά του διακομιστή.

Πότε να το χρησιμοποιήσετε

Καταφύγετε στις Καθολικές μεταβλητές όταν μια τιμή ή ένα κομμάτι λογικής εκκίνησης χρειάζεται σε περισσότερα από ένα Component και δεν θέλετε να το περνάτε ως παράμετρο σε καθένα από αυτά: το όνομα του συνδεδεμένου χρήστη, ένα επιλεγμένο campus ή tenant, μια σημαία σκοτεινής λειτουργίας, μια διεύθυνση email υποστήριξης, ένας κόμβος raise_event που μπορούν να ακούσουν πολλές άσχετες οθόνες.

Μην το χρησιμοποιείτε για οτιδήποτε ανήκει σε μία μόνο οθόνη (αυτό είναι πεδίο Component) ή οτιδήποτε πρέπει να τρέχει στον διακομιστή.

Ιδιότητες

Το έγγραφο βρίσκεται στο 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 μόνο σε Components· η δήλωση ενός από αυτά σε πρόγραμμα Καθολικές μεταβλητές είναι σοβαρό σφάλμα επικύρωσης. Όσα υποστηρίζουν πραγματικά οι Καθολικές μεταβλητές:

Δεν υπάρχει client_interval ή server_cron στις Καθολικές μεταβλητές

Μια παλαιότερη περιγραφή αυτής της μονάδας ισχυριζόταν ότι οι Καθολικές μεταβλητές μπορούσαν να κάνουν polling με διάστημα (client_interval) ή με χρονοδιάγραμμα cron διακομιστή (server_cron). Κανένα από τα δύο δεν στέκει απέναντι στον τρέχοντα έλεγχο: το client_interval επικυρώνεται ως μόνο για components, και το server_cron δεν είναι καθόλου αναγνωρισμένος τύπος συμβάντος, το μόνο του ίχνος στο runtime είναι ένας χειριστής σε σχόλιο. Αν ένα έργο χρειάζεται σήμερα επαναλαμβανόμενο polling, βάλτε το χρονόμετρο σε ένα Component (το client_interval εκεί είναι πραγματικό και ενεργό) αντί για τις Καθολικές μεταβλητές.

Παράδειγμα εφαρμογής

Δηλώστε την κοινή κατάσταση

Προσθέστε πεδία για τις τιμές που χρειάζεται κάθε οθόνη: selected_campus_v, signed_in_user_v, dark_mode_v.

Διαβάστε τα από οπουδήποτε

Κάθε Component, πρόγραμμα ή έκφραση του έργου τα διαβάζει με τον ίδιο τρόπο, με @: @selected_campus_v.

Ενεργοποιήστε ένα συμβάν που διατρέχει πολλά σημεία

Δώστε στις Καθολικές μεταβλητές ένα συμβάν user_defined (για παράδειγμα campus_changed) και καλέστε το με raise_event από όποιο Component αλλάζει το campus. Κάθε άλλο ανοιχτό Component που έχει επίσης ορίσει ακροατή raise_event για αυτό το όνομα αντιδρά, χωρίς άμεση αναφορά ανάμεσα στις δύο οθόνες.

Στο δέντρο του Studio, οι Καθολικές μεταβλητές είναι ο μοναδικός κόμβος στη ρίζα του δικού τους κλάδου (όχι φωλιασμένος κάτω από τα Προγράμματα). Ανοίξτε τον, προσθέστε γραμμές στον πίνακα Πεδία για κάθε κοινή μεταβλητή με τύπο και προεπιλεγμένη τιμή, και προσθέστε γραμμές στα Συμβάντα για on_load / on_exit / οποιοδήποτε συμβάν με όνομα, καθεμία με τη δική της ροή εργασίας.

xml
<meta lang="json5">
{
  id: "school_globals",
  menuTitle: "School Globals"
}
</meta>

<fields lang="json5">
{
  selected_campus_v: { type: "string", value: "Boston Campus" },
  signed_in_user_v: { type: "string", value: "Avery Walker" },
  support_email_v: { type: "string", value: "[email protected]" },
  dark_mode_v: { type: "boolean", value: false }
}
</fields>
json
{
  "properties": {
    "menuType": "globals",
    "menuName": "School Globals",
    "progDescription": "Campus and operator state shared across the app."
  },
  "progFields": [
    {
      "id": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e",
      "data": { "field_id": "selected_campus_v", "type": "virtual" },
      "props": { "fieldType": "string", "fieldValue": "Boston Campus" }
    }
  ],
  "progEvents": [
    { "id": "d4e5f6a7-b8c9-4d0e-af1a-3b4c5d6e7f8a", "data": { "type": "on_load", "parameters": [], "condition": "" }, "workflow": [] }
  ],
  "progDataSource": {}
}