Runtime

RT

Descrição

Sub-sistema de uso geral com definições básicas necessárias para TODOS os sistemas.

Dúvidas frequentes

Configurações

RT.ACCESS_MODE

Indica o modo de operação em que este servidor se encontra no momento:
  • "W" (padrão) - Todas as operações são permitidas.
  • "R" - Os usuários poderão apenas consultar os dados do sistema - Nenhuma operação de escrita deve ser permitida.

Ver Controle de bloqueio da aplicação contra alterações nos dados para maiores detalhes.

Tipo: TEXT

Valor padrão: W

RT.APP.DATA_IMPORT

Relação de tabelas que devem ser automaticamente atualizadas

Define uma lista de arquivos que devem ser importados no sistema. A carga ocorre através de uma rotina executada após atualizações e/ou programada em JOB. A ordem da atualização dos dados é exatamente igual à ordem informada na preferência.

Esta preferencia, é normalmente (mas não obrigatoriamente) definida no build do sistema.

O formato é composto de um arquivo por linha informado da seguinte forma:

SISTEMA.BLOCO [ = URL ]

Onde:
  • SISTEMA.BLOCO - Nome global da interface que executará o import. Este interface deverá ter obrigatoriamente o
  • URL - Endereço de onde o arquivo a ser importado deverá ser baixado. Quando não informado, o sistema utilizará um arquivo distribuído junto com o sistema.

Exemplo:
PROD.CAD_CLASSIFICACOES_NCM
FISCAL.CAD_CFOP
CIDADE.CAD_CIDADES = http://www.eligo.com.br/tabelas/cidade_cad_cidades.csv

No exemplo acima, as tabelas de NCM e de CFOP serão atualizadas com base nos arquivos:
../data/prod_cad_classificacoes_ncm.csv
../data/fiscal_cad_cfop.csv
E a tabela de cidades será baixada da url inficada.


Tipo: TEXT_LONG

RT.APP.HOME_PATH

Diretório de base para armazenamento de configurações e arquivos do contexto.
Caso não informado, assume:
${user.home}/apps/${contextPath}/

RT.AUTH.LOGON_SERVICE

Nome global da interface que deve ser utilizada para executar o login de um usuário.

RT.AUTH.LOGOUT_SERVICE

Nome global da interface que deve ser utilizada para executar o logout do usuário.

RT.AUTH.SESSION_CLASS

Nome da classe que será utilizada para representar uma sessão.

Tipo: TEXT

Valor padrão: br.com.telescope.auth.AdsrtSession

RT.AUTH.SESSION_EXPIRATION

Tempo de inatividade em que uma sessão expira em minutos. Por padrão, a sessão do usuário é considerada expirada após 30 minutos sem uso, após esse tempo, é necessário que o usuário faça login novamente.

Tipo: INTEGER

Valor padrão: 30

RT.AUTH.USER_ENTITY_CLASS

Nome da classe que deve ser utilizada para representar um usuário do sistema.

RT.AUTOCOMPLETE.LIMIT

Número máximo de registros a serem apresentados no autocomplete. Caso não informado, assume 20 registros.

RT.DB.TEST_COUNT

Testar quantidade de registros alterada ou excluída

Define se deve testar o número de registros alterados ou excluídos de uma entidade.

Por padrão, quando o registro de uma entidade é excluído ou alterado, o sistema não verifica se o respectivo DML encontrou ou não registro do ID informado. Ou seja, se o sistema tentar alterar ou registro já excluído ou excluir novamente um registro já excluído, não dá erro.

Alterando esta configuração para "S", o sistema passará a gerar uma mensagem de erro e não deixará que isso aconteça.

Tipo: FLAG

RT.DB.TRACK_CONNECTIONS_ORIGIN

Define se deve rastrear quem está pegando as conexões. Quando marcado para rastrear, um stack-trace da thread atual é capturado e registrado no mapa de conexões abertas.

RT.DEBUG.DEFAULT

Padrão do debug

Indica se deve ou não inclur informações de debug caso não exista uma definição específica para a categoria.

Tipo: FLAG

RT.DEBUG.EVENT_LISTENER

Indica se deve gerar informações de debug na ocorrência de erros nos event-listeners.

Tipo: FLAG

RT.DEBUG.HTTP_REQUESTER

Debug das comunicações realizadas pelo HttpRequester

Indica se deve gerar informações de debug das operações de comunicação que utilizam o HTTP_REQUESTER

Tipo: FLAG

RT.DEBUG.PABX

Debug das comunicações com a(s) centrais telefonicas

Indica se deve gerar informação de debug com as centrais telefônicas.

Tipo: FLAG

Valor padrão: N

RT.DEBUG.RETORNAR_ESTOQUE

Indica se deve gerar informações sobre as consultas ao estoque de um produto

Tipo: FLAG

RT.DEBUG.SCHEDULER

Debug do Scheduler (JOBs)

Indica se deve gerar informações de debug no funcionamento do scheduler.

Tipo: FLAG

RT.DEBUG.SESSION

Debug para a sessão

Indica se deve gerar informações de debug para a sessão.

Tipo: FLAG

RT.DETAIL_LIST_LINKS

Indica se deve gerar links nas listas de detalhe (geradas por eventos de pos-display)
S = Gerar links
N = Não gerar os links

Tipo: TEXT

Valor padrão: S

RT.FEATURE.LIST.SHOW_SQL_USED

Mostrar o SQL utilizado

Quando configurado, nas listagens do sistema, apresenta o SQL utilizado, incluindo os filtros.
Utilizado em tempo de desenvolvimento para identificar como SQL efetivamente gerado pelo sistema.

Tipo: FLAG

RT.FEATURE.QUERY.SHOW_GROUP_BY

Apresentar "Agrupar por"?

Define se formulários de pesquisa (query) deverão incluir o campo "Agrupar por" que causará a lista abrir já agrupada por algum campo. Blocos específicos podem ser customizados utilizando a preferencia:

{SISTEMA}.{BLOCO}.SHOW_GROUP_BY

Tipo: FLAG

Valor padrão: N

RT.FILE_REPOSITORY.PATH

Caminho físico do repositório de arquivos do sistema.
Caso não informado, usará ${RT.APP.HOME_PATH}/files/

RT.FILE_REPOSITORY.URL

URL de base para o repositório de arquivos acessível pelo cliente (browser).
Caso não configurado, irá utilizar o mesmo que o cliente está utilizando.

Exemplo:
http://host.dominio.com:8080/ELIGO/file/

Tipo: TEXT

RT.FORCE_COMPILE_SKIN

Indica que o SKIN deve ser compilado toda vez que a aplicação é inicializada.

Tipo: FLAG

Valor padrão: S

RT.GOOGLE.API_KEY

Chave de acesso as APIs do Google

Chave necessária para acesso aos serviços do Google tais como: GEO, Youtube.
Para criar uma chave é preciso utilizar uma conta no Developer no Google através do site https://console.developers.google.com.
Ver Como criar uma conta/projeto no Google Developer Console?.

Tipo: TEXT

RT.HIDE_NULL_FIELDS

Indica quando os campos nulos devem ser omitidos nas telas de consulta.

Valor padrão: S

RT.LIST_FILTERED_COLUMNS

Listar colunas filtradas com valores absolutos

Esta preferencia permite controlar como as listas serão geradas. Existem 3 opções:
S (padrão) - Todas as colunas da lista são apresentadas indiferente do que foi filtrado.
N - As colunas dos campos que estão sendo filtrados com um valor específico não são apresentadas na lista. Considera-se filtros de valor específico o uso do operador "é igual a" sem o uso de '%' ou do operador "é nulo".
U - A decisão fica a critério do usuário (preferencia do usuário)

RT.LIVE_UPDATE.REMOVE_UNUSED_FILES

Remover arquivos não usados

Indica se uma atualização deve excluir arquivos que não são mais utilizados. Quando esta preferencia estiver com valor = "S", então após copiar os arquivos da nova versão, o sistema remove todos os arquivos (classes, javascripts, CSSs, libs, etc.) que não são mais necessários.

Tipo: FLAG

Valor padrão: N

RT.LOG.DB_NAME

Nome do datasource a ser utilizado para gravar o LOG.

Valor padrão: DEFAULT

RT.LOG.IGNORE_ERRORS

Ignorar error no LOG

Indica se erros de LOG devem ser ignorados ou apresentados para o usuário final.
Caso "S", erros são simplesmente ignorados.

Tipo: FLAG

Valor padrão: S

RT.LOG.INSERT_DML

Comando DML a ser usado para incluir um LOG em uma tabela do banco de dados.

RT.LOG.LISTENER_EVENTS

Logar eventos executados por "ouvintes"

Indica se a execução de eventos através de ouvintes (listeners) deve ser logada por padrão ou não:

  • NO - Não gerar qualquer log na execução dos listeners
  • ERROR - Gerar log apenas se a execução encontrou um erro
  • SUCCESS - Gerar log sempre

Note que esta preferencia determina o padrão do sistema. É possível determinar um valor para esta configuração diferente para CADA evento, usando através da preferencia:
{nome-do-evento}.LOG


Exemplos:
  • APPREF.PEDIDOS.PRE_INSERT.LOG=SUCCESS
  • NOME_DA_TABELA.POS_REPLICATE.LOG=NO
  • RT.POS_LOGIN.LOG=SUCCESS
  • CHAT.NEW_MESSAGE.LOG=ERROR

Ver também:

Tipo: OPCAO

Valor padrão: ERROR

RT.LOG.SHOW_LOG_EXCEPTION

Indica se deve apresentar um aviso de que não foi possível registrar o LOG para o usuário ou não. Por padrão, não apresenta esta mensagem. Sugere-se manter em S nos ambientes de desenvolvimento.

Valor padrão: N

RT.LOGON_INTERFACE

Indica a interface que deve ser usada para logon no sistema.
Quando um usuário acesso o sistema, ele deve ter uma opção para se identificar. Ao chamar esta opção ele é levado para esta interface.
A interface é informada com o ID correspondente a entidade INTERFACES_SISTEMAS que deve estar previamente carregada.

Valor padrão: RTACCS.PRO_LOGON

RT.LOGOUT_INTERFACE

Interface que executa o encerramento da sessão do usuário.

RT.MAX_LOG_PARAMETER_VALUE_SIZE

Indica qual o tamanho máximo dos valores a serem logados no sistema de log.
Quando o texto é maior do que o configurado, ele é truncado e acrescentado de "... (999 chars)"

Valor padrão: 80

RT.MENU.MENU_ITEM_QUERY

Comando SQL que busca os itens de um menu do sistema.

Caso seja necessário forçar os menus a utilizarem a versão antiga (ProReport2), deve-se configurar a preferencia com o SQL abaixo:

SELECT im.id
, im.sequencia AS sequence
, p.menu AS subMenu
, intf.nome AS service
, im.titulo AS label
, case when intf.tipo_registro = 'I' then 'CadOperacoesCustom?Z_ACTION=EXEC&A_ID='||intf.id
       when intf.tipo_registro = 'R' then 'ProReport2?Z_ACTION=EXEC_M&A_ID='||intf.id
       else im.url end as url
, im.ativo AS enabled
, im.menu_id AS menuId
, im.parametros as parameters
 FROM itens_menus im
 LEFT JOIN interfaces_sistemas intf ON im.interface_id = intf.id
 LEFT JOIN menus p ON im.sub_menu_id = p.id
 ORDER BY im.sequencia, im.titulo

RT.MENU.MENU_QUERY

Comando SQL que irá buscar os menus do sistema.

RT.MENU.REPOSITORY_CLASS

Nome da classe que deve ser usada para armazenar os menus.

RT.MENU.TOP_MENUS

Relação de menus que devem ser utilizados no sistema.

RT.MOF.CACHE_FILES

Relação de arquivos que devem ser mantidos em cache no browser.
Esta configuração segue o padrão de manifesto para cache do HTML5.
Os arquivos poderão conter a macro ${contextPath} para representar o caminho de contexto do sistema.

RT.MOF.DISABLE_CACHE

Parametrização que desativa o cache.
O uso prático é para ambientes de desenvolvimento.

RT.MONITOR.FILE_SYSTEM_MAX_PERCENT_USED

Indica o percentual máximo de ocupação que é considerado normal para uso do sistema. Qualquer valor superior gera um e-mail de aviso. O destinatário deste e-mail é o mesmo que recebe as mensagens de erro do sistema.
Caso informado com 0, o sistema não envia e-mails de aviso.

RT.MONITOR.FILE_SYSTEM_PATHS

Caminhos dos sistemas de arquivos que deverão ser monitorados. Caso não informado, o sistema localiza o sistema de arquivos onde a aplicação está instalada e monitora apenas ele. Caso informado, deve-se relacionar os caminhos raízes separados por vírgulas.

RT.MONITOR.FIRST_UPDATE

Tempo em segundos para disparar o envio do primeiro de pacote de monitoramento. Por padrão, assume 30 segundos. Em servidores com muitas aplicações sendo inciadas, sugere-se aumentar este tempo.

RT.MONITOR.REFRESH_RATE

Tempo de atualização do monitoramento em minutos. Caso não informado, assume 5 minutos.

Tipo: INTEGER

RT.MONITOR.URL

URL a ser conectada para o envio de informações de monitoramento.

Valor padrão: http://ads.prd.inf.br:8080/ADS2/app/UtlSystemMonitorLog

RT.NET.SSL_PROTOCOLS

Lista de protocolos que devem ser habilitados para as conexões SSL

Configura os protocolos habiltados nas conexões realizadas com SSL.

Este parâmetro pode corrigir problemas do tipo:

  • javax.net.ssl.SSLException: Received fatal alert: unexpected_message

Deve-se informar os protocolos desejados separados por vírgula. Exemplos:
  • TLSv1, TLSv1.1, TLSv1.2
  • SSLv2Hello, SSLv3, TLSv1, TLSv1.1, TLSv1.2

Caso se deseje habilitar TODOS os protocolos suportados, basta configurar
  • ALL_SUPPORTED

Tipo: TEXT

RT.PABX.SIMULATED_TICKETS

Tickets para o simulador de central

Preferencia utilizada para simular uma central telefônica.

Tipo: SOURCE_CODE

Valor padrão: { tickets:[ { delay:4000, campaing_id:456, mailing_id:789, person_id:1001, person_name:"FULANO DA SILVA", phone_ddd:"51", phone_number:"35680123", queue_id:"123", custom_0: "PARCEIRO" }, { delay:4000, campaing_id:456, mailing_id:790, person_id:1002, person_name:"OUTRA PESSOA QUALQUER", phone_ddd:"51", phone_number:"35680123", queue_id:"123", custom_0: "PARCEIRO" } ] }

RT.PREVENT_NULL_VALUES

Indica se o sistema deve prevenir valores nulos nos domínios assumindo o valor zero para domínios numéricos ou uma string vazia para domínios alfanuméricos.

Valor padrão: N

RT.PUBLIC_HOME_INTERFACE

Interface de entrada para usuários não autenticados.

RT.REPORT.EMPRESA

Nome da empresa como deve aparecer no cabeçalhos dos relatórios. Para ambientes multi-empresa/multi-estabelecimento, este nome pode ser definido para a sessão do usuário.

RT.SEQUENCE_MANAGER

Classe gerenciadoras de sequencias padrão.
Usada apenas se não existir um gerenciador de sequencia específico para a conexão de banco (CONFIG.DB.nome.SEQUENCE_MANAGER).

RT.SERVICE_IS_PUBLIC_QUERY

Query que determina se um serviço é público ou não.

RT.SMTP.TIMEOUT

Tempo limite para conexão com o servidor de SMTP (em milisegundos)

Indica o tempo máximo em segundos que o sistema irá aguardar a conexão com o servidor de SMTP.

Tipo: INTEGER

RT.SUGGEST_FILTERED_VALUES_ON_INSERT

Determina que valores de filtros (query) informados com o operador "igual a" devem ser utilizados como sugestão na inclusão de um novo registro (tela de INSERT).

Esta preferência pode ser definida separadamente para cada interface no formato
SISTEMA.BLOCO.SUGGEST_FILTERED_VALUES_ON_INSERT

Tipo: TEXT

Valor padrão: S

RT.UI.BROWSER_FORM_AUTOCOMPLETE

Indica se deve permitir ou não que o navegador do usuário autocomplete os formulários

Por padrão, o ELIGO não permite os navegadores autocompletarem os formulários. Caso se deseje liberar para que o navegador autocomplete os formulários, esta preferência deverá ser alterada para "S".

Deve-se observar que se a preferência estiver desligada (padrão), as tags FORM nas telas HTML enviadas para o navegador incluirão o atributo "autocomplete=off".

Ver também:

Tipo: FLAG

RT.UI.CONFIG

Nome global da interface que deve ser utilizada para a configuração primária do sistema.

Valor padrão: RTCONFIG.CFG_CONFIG

RT.UI.CONTEXT_NAVIGATION_ICON

Define o ícone a ser apresentado para a navegação de contexto. Esta preferencia somente é utilizada no caso da preferencia RT.UI.CONTEXT_NAVIGATION_IS_DEFAULT estar marcada com "false".

RT.UI.CONTEXT_NAVIGATION_IS_DEFAULT

Define se a navegação de contexto é apresentada através de link no próprio campo (padrão) ou através de um ícone apresentado logo após o campo.

Valor padrão: true

RT.UI.CONTEXT_NAVIGATION_TARGET

Define se os links deverão ser abertos na mesma janela do browser (padrão) ou em uma nova aba. ATENÇÃO: NÃO CONFIGURAR PARA ABRIR EM UMA NOVA ABA POR PADRÃO - O USO EXAGERADO DE ABAS CRIA PROBLEMAS COM O CONSUMO DE MEMÓRIA NA ESTAÇÃO DO CLIENTE !!!!
ORIENTE OS USUÁRIO A UTILIZAR CTRL+CLICK OU CLICAR COM A RODA DO MOUSE.

Valor padrão: _self

RT.UI.CUSTOM_CSS

Definições de CSS a serem incluídas no CSS do sistema.

RT.UI.CUSTOM_JS

Conteúdo de Javascript a ser acrescentado na biblioteca compilada de javascript.

RT.UI.ENABLE_BROWSER_BACK

Define se o botão de back (voltar) dos browsers pode ser usado ou não.
S = Pode usar
N = O botão será dasabilitado

Valor padrão: N

RT.UI.FIELD_STRING_MODE

Mode de apresentação dos valores dos campos

Permite configurar como os campos são apresentados em interfaces geradas por Velocity, por exemplo.

   public static final int STRING_VALUE = 0;
   public static final int TEXT = 1;
   public static final int HTML = 2;

Tipo: TEXT

RT.UI.GENERATE_SHEET_XLSX

Padrão da extensão ao gerar planilhas

Esta preferência define o padrão da extensão dos arquivos de planilhas.

  • Ao informar S, o padrão da extensão do arquivo passa a ser XLSX;
  • Ao informar N, o padrão da extensão do arquivo passa a ser XLS.

Tipo: FLAG

Valor padrão: S

RT.UI.HOME

Nome global da interface (tela de entrada) que será usada quando um usuário NÃO LOGADO informar a URL .../app/

RT.UI.HOME_INTERFACE

Nome global da interface (tela de entrada) que será usada para montar o link do logotipo para um usuário NÂO LOGADO.

RT.UI.JAVASCRIPT_PATH

URI (relativa ao contexto) que aponta para as bibliotecas de javascript em uso pelo sistema.

Valor padrão: js/

RT.UI.LOCALE

Locale padrão a ser usado peloa aplicação. Quando informado, o sistema irá usar obrigatoriamente este locale, independente do locale informado no sistema operacional ou, quando for o caso, na requisição web conforme definição do browser.
Os valores devem seguir os exemplos a seguir: pt_BR, en_US

RT.UI.MODULE_GUIDE_RENDERER

Nome da classe a ser utilizada para renderizar as guias de navegação dos módulos.

RT.UI.POST_MAX_AGE

Tempo máximo (em minutos) que um formulário pode ser submetido. Caso um usuário tentar submeter um formulário depois deste tempo, o sistema irá apresentar um mensagem dizendo que o mesmo está expirado. O tempo padrão é de 240 minutos (4 horas).

RT.UI.PUBLIC_MENU

Menu a ser usado para usuários não logados.
Caso não informado, usa o menu definido em RT.MENU.TOP_MENUS

RT.UI.REMEMBER_QUERY

Define que o sistema deve ou não memorizar os filtros utilizados na última query de cada interface acessada.
A preferencia pode ser redefinida por interface usando a preferencia SISTEMA.INTERFACE.REMEMBER_QUERY.

Valor padrão: S

RT.UI.SHORT_CUT_KEYS

Teclas de atalho gerais para a aplicação.
Informar um texto onde cada linha representa um atalho no formato:
F6=APPREF.CAD_PEDIDOS
ALT+F8=APPREF.CAD_PRODUTOS

RT.UI.SHOW_USER_MESSAGES_SERVICE

Serviço utilizado para apresentar as mensagens do usuário

Nome global do serviço utilizado para mostrar as mensagens do usuário.

Tipo: TEXT

RT.UI.SKIN_PATH

URL para o skin a ser utilizado no sistema.
Caso a URL informada não inicie com "http://" ou "https://" ou simplesmente "/", então o context-path é automaticamente incluído.
Se existir uma preferencia específica para o controller em uso (tipo RT.UI.SKIN_PATH.APP), então esta será utilizada.

Valor padrão: skins/t2/

RT.UI.SOUND_ON_ERROR

Define o som que deve ser emitido quando alguma mensagem de erro é disparada (indiferente de ser CRITICAL, UNKNOW ou ERROR). Cada bloco pode sobre-escrever este valor através de uma preferência tipo {NOME-GLOBAL-BLOCO}.SOUND_ON_ERROR. A palavra reservada 'none' indica que não haverá nenhum som (padrão)

Valor padrão: none

RT.UI.SOUND_ON_SUCCESS

Define o som que deve ser emitido quando alguma mensagem de sucesso é disparada. Cada bloco pode sobreescrever este valor através de uma preferência tipo {NOME-GLOBAL-BLOCK}.SOUND_ON_SUCCESS. A palavra reservada 'none' indica que não haverá nenhum som (padrão)

Valor padrão: none

RT.UI.SOUND_ON_WARNING

Define o som que deve ser emitido quando alguma mensagem de warning é disparada. Cada bloco pode sobreescrever este valor através de uma preferência tipo {NOME-GLOBAL-BLOCK}.SOUND_ON_WARNING. A palavra reservada 'none' indica que não haverá nenhum som (padrão)

Valor padrão: none

RT.UI.TABLE_NAVIGATION

Define se será habilitado a possibilidade de navegar entre os links via setas (cima e baixo), quando pressionado a tecla baixo o próximo foco será no link logo abaixo da mesma coluna.

Valor padrão: s

RT.UI.USER_HOME

Nome global da interface (tela de entrada) que será usada quando um usuário LOGADO informar a URL .../app/
Também define qual a interface que será aberta quando o usuário executa o login.
Esta é uma user-preference podendo então ter um valor padrão e valores específicos para diferentes usuários.
Caso não seja definida, usa o mesmo valor da RT.UI.HOME.

RT.UI.USER_HOME_INTERFACE

Nome global da interface (tela de entrada) que será usada para montar do link do logotipo para um usuário LOGADO.
Esta é uma user-preference podendo então ter um valor padrão e valores específicos para diferentes usuários.
Caso não seja definida, usa o mesmo valor da RT.UI.HOME_INTERFACE.

RT.UI.USER_MENU

Menu do usuário.

RT.USER_HOME_INTERFACE

OBSOLETO: Substituído por RT.UI.USER_HOME_INTERFACE
Interface (tela) de entrada do sistema para usuário autenticados.

Tipo: TEXT

RT.WIKI.DEFAULT_MACROS

Macros tratadas por padrão no ambiente

Configura a relação de macros aceitas por padrão nos campos tipo WIKI do sistema.

Tipo: TEXT

Valor padrão: img = br.com.telescope.util.WikiMacroAnexos sys = br.com.telescope.util.WikiMacroSystem doc = br.com.telescope.util.WikiMacroDoc b = br.com.telescope.util.WikiMacroButton