Globais
O programa que todos os outros programas podem ler, para estado e lógica que pertencem a toda a aplicação e não a um só ecrã.
Cada projeto Xuda tem exatamente um programa Globais. Contém as constantes, as variáveis partilhadas e a lógica de arranque que qualquer programa Componente, Obter Dados, Definir Dados, Lote, JavaScript ou API do projeto pode ler, pelo que um valor que significa o mesmo em todo o lado (o utilizador com sessão iniciada, um indicador de funcionalidade, o campus ativo) tem exatamente um sítio onde viver, em vez de ser copiado para cada ecrã que precisa dele.
Independentemente do que runAt diga noutro lado, o runtime força os Globais para client. É o único tipo de programa que nunca é executado no servidor, pelo que é o local errado para tudo o que deva ficar fora do dispositivo (segredos, leituras privilegiadas). Utilize um programa Obter Dados ou Definir Dados do lado do servidor para isso.
Quando utilizar
Recorra aos Globais quando um valor ou uma parte da lógica de arranque for necessária a mais do que um Componente e não queira passá-lo como parâmetro em todos eles: o nome do utilizador com sessão iniciada, um campus ou inquilino selecionado, um indicador de modo escuro, um endereço de email de suporte, um centro de raise_event que vários ecrãs não relacionados podem escutar.
Não os utilize para nada que pertença a um só ecrã (isso é um campo de Componente) nem para nada que tenha de correr do lado do servidor.
Propriedades
O documento fica em studio_meta.parentId: "globals", a raiz do seu próprio ramo na árvore, separado de programs, database e routes. O documento Globais de um projeto e a raiz da árvore não podem ser eliminados.
progFields
Cada entrada declara uma variável, legível em todo o lado como @field_id.
Os globais do sistema estão sempre disponíveis a par dos seus: @SYS_GLOBAL_OBJ_LOGIN_USER_INFO (o objeto do utilizador com sessão iniciada) e @SYS_GLOBAL_OBJ_REFS (elementos registados com xu-ref, utilizados para estados de carregamento e de vazio).
progEvents
Os Globais suportam a mesma forma de progEvents que todos os outros programas, mas nem todos os tipos de evento da plataforma se lhes aplicam. O verificador restringe screen_ready, on_refresh, on_unload e client_interval apenas a Componentes; declarar um deles num programa Globais é um erro de validação definitivo. O que os Globais realmente suportam:
Uma descrição mais antiga desta unidade afirmava que os Globais podiam fazer sondagens por intervalo (client_interval) ou por um agendamento cron do servidor (server_cron). Nenhuma das duas se sustenta face ao verificador atual: client_interval é validado como exclusivo de componentes, e server_cron não é de todo um tipo de evento reconhecido, o seu único vestígio no runtime é um handler comentado. Se um projeto precisar hoje de sondagens recorrentes, ponha o temporizador num Componente (client_interval aí é real e ativo) em vez de nos Globais.
Exemplo prático
Declare o estado partilhado
Adicione campos para os valores de que todos os ecrãs precisam: selected_campus_v, signed_in_user_v, dark_mode_v.
Leia-os de qualquer lado
Qualquer Componente, programa ou expressão do projeto os lê da mesma forma, com @: @selected_campus_v.
Levante um evento transversal
Dê aos Globais um evento user_defined (por exemplo campus_changed) e chame-o com raise_event a partir do Componente que mudar o campus. Todos os outros Componentes abertos que também tenham registado um listener de raise_event para esse nome reagem, sem uma referência direta entre os dois ecrãs.
Na árvore do Studio, os Globais são o nó único na raiz do seu próprio ramo (não aninhado em Programas). Abra-o, adicione linhas à tabela Campos para cada variável partilhada com um tipo e um valor predefinido, e adicione linhas a Eventos para on_load / on_exit / qualquer evento nomeado, cada uma com o seu próprio fluxo de trabalho.