Como Usar Variáveis Globais

Algumas etapas explícitas podem referenciar campos chamados Valores Predefinidos. Além de indicar um valor da constante ad hoc (por exemplo, a letra Y), você pode indicar também uma variável global em um valor de campo. Uma variável global é usada para indicar dados do sistema.

Quando você usa o tipo de etapa de Editar Dados, as variáveis disponíveis são um pouco diferentes. Para obter detalhes, consulte Sintaxe de Editar Dados.

Variáveis globais para scripts do BPA:


Nome da Variável	Comentários
%PARM-<name>	O valor de um parâmetro com esse nome transferido para o aplicativo durante a inicialização pelo URL do sistema padrão. Para obter mais informações sobre esses parâmetros, consulte Ativando um Script ao Iniciar o Sistema.
%PARM-NOT-SET	Essa variável é comparada com os parâmetros %PARM-< > para verificar se eles foram definidos durante a inicialização do aplicativo. Um parâmetro não definido seria considerado igual à variável. Recomendação: compare os parâmetros com essa variável global antes de usá-los pela primeira vez.
%BLANK	Uma constante que contém um valor em branco (sem valor).
%SPACE	Uma constante que contém um valor de espaço.
%CURRENT-DATE	A data atual como mostrada no navegador, não no servidor.
%SYSTEM-DATE	A data do servidor. Essa data é afetada pela lógica de substituição de data do sistema.
%SAVE-REQUIRED	Um flag que contém uma indicação de se os dados em uma página foram alterados (e, portanto, precisam ser salvos). Esse flag pode ser usado para forçar um usuário a salvar seu trabalho antes de executar as etapas seguintes. O valor desse flag será VERDADEIRO ou FALSO.
%NEWLINE	Uma constante que contém um caractere de nova linha (retorno de carro). Depois da substituição, uma quebra de linha é inserida no texto final. Observação: Essa constante não tem o efeito desejado quando o texto resultante é HTML. Por exemplo, strings de texto e prompt de uma etapa. Isso ocorre porque o HTML ignora caracteres especiais, como novas linhas. Para saber como inserir uma quebra de linha em um texto HTML, consulte Como Usar Tags e Delimitadores HTML em Texto.

Para referenciar uma variável de contexto global, use %FIELD_NAME. Por exemplo, se o campo SP_ID está no contexto global, é possível usar %SP_ID para referenciar o ID do ponto de serviço atualmente no contexto. São aceitos os seguintes valores especiais:


Nome da Variável	Comentários
%CONTEXT-PERSONID	Uma constante que contém o ID da pessoa atual.
%CONTEXT-ACCOUNTID	Uma constante que contém o ID da conta atual.
%CONTEXT-PREMISEID	Uma constante que contém o ID da unidade consumidora atual.

Além disso, se o script está chamando mais alguma coisa por meio de um dos vários tipos de etapa de "invoke" e retorna um erro, as seguintes variáveis globais contém informações sobre o erro:


Nome da Variável	Comentários
%ERRMSG-CATEGORY %ERRMSG-NUMBER	O identificador exclusivo do número da mensagem de erro.
%ERRMSG-TEXT	Uma breve descrição do erro.
%ERRMSG-LONG	Uma descrição completa do erro.