Saltar al contenido
Verificada

Globales

El programa del que puede leer cualquier otro programa, para el estado y la lógica que pertenecen a toda la app y no a una sola pantalla.

Cada proyecto de Xuda tiene exactamente un programa Globales. Contiene las constantes, las variables compartidas y la lógica de arranque que puede leer cualquier programa Component, Get Data, Set Data, Batch, JavaScript o API del proyecto, de modo que un valor que significa lo mismo en todas partes (el usuario con sesión iniciada, un indicador de función, el campus activo) tiene un único hogar en lugar de copiarse en cada pantalla que lo necesita.

Globales siempre se ejecuta en el cliente

Diga lo que diga runAt en otros sitios, el entorno de ejecución fuerza Globales a client. Es el único tipo de programa que nunca se ejecuta en el servidor, así que es el lugar equivocado para cualquier cosa que deba quedarse fuera del dispositivo (secretos, lecturas con privilegios). Usa para eso un programa Get Data o Set Data del lado del servidor.

Cuándo usarlo

Recurre a Globales cuando un valor o una pieza de lógica de arranque la necesita más de un componente y no quieres pasarla como parámetro en cada uno de ellos: el nombre del usuario con sesión iniciada, un campus o inquilino seleccionado, un indicador de modo oscuro, una dirección de correo de soporte, un centro de raise_event al que pueden escuchar varias pantallas no relacionadas.

No lo uses para nada que pertenezca a una sola pantalla (eso es un campo de Componente) ni para nada que deba ejecutarse en el servidor.

Propiedades

El documento está en studio_meta.parentId: "globals", la raíz de su propia rama en el árbol, separada de programs, database y routes. El documento Globales de un proyecto y la raíz del árbol no se pueden eliminar.

progFields

Cada entrada declara una variable, legible en todas partes como @field_id.

Los globales del sistema siempre están disponibles junto a los tuyos: @SYS_GLOBAL_OBJ_LOGIN_USER_INFO (el objeto del usuario con sesión iniciada) y @SYS_GLOBAL_OBJ_REFS (los elementos registrados con xu-ref, usados para estados de carga y de vacío).

progEvents

Globales admite la misma forma de progEvents que cualquier otro programa, pero no todos los tipos de evento de la plataforma se aplican a él. El comprobador restringe screen_ready, on_refresh, on_unload y client_interval solo a los componentes; declarar uno de ellos en un programa Globales es un error de validación duro. Lo que Globales admite realmente:

Sin client_interval ni server_cron en Globales

Una descripción anterior de esta unidad afirmaba que Globales podía hacer sondeo a intervalos (client_interval) o con un calendario cron de servidor (server_cron). Ninguna de las dos cosas se sostiene frente al comprobador actual: client_interval se valida como exclusivo de componentes, y server_cron no es un tipo de evento reconocido en absoluto, su único rastro en el entorno de ejecución es un manejador comentado. Si un proyecto necesita sondeo periódico hoy, pon el temporizador en un componente (client_interval ahí es real y funciona) en lugar de en Globales.

Ejemplo práctico

Declara el estado compartido

Añade campos para los valores que necesita cada pantalla: selected_campus_v, signed_in_user_v, dark_mode_v.

Léelos desde cualquier lugar

Cualquier componente, programa o expresión del proyecto los lee del mismo modo, con @: @selected_campus_v.

Lanza un evento transversal

Dale a Globales un evento user_defined (por ejemplo campus_changed) y llámalo con raise_event desde el componente que cambie el campus. Cualquier otro componente abierto que también haya registrado un oyente de raise_event con ese nombre reacciona, sin una referencia directa entre las dos pantallas.

En el árbol de Studio, Globales es el único nodo en la raíz de su propia rama (no anidado bajo Programas). Ábrelo, añade filas a la tabla Campos para cada variable compartida con un tipo y un valor por defecto, y añade filas a Eventos para on_load / on_exit / cualquier evento con nombre, cada uno con su propio flujo de trabajo.

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