Linha Logix

Páginas filhas
  • LGX - Chaves de configuração no arquivo de Profile

Versões comparadas

Versão antiga 97

changes.mady.by.user Ieda Ferreira Alves Flock

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Ieda Ferreira Alves Flock

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


Pagetitle
LGX - Chaves de configuração no arquivo de Profile
LGX - Chaves de configuração no arquivo de Profile





Extrair
Abaixo segue lista de chaves de configuração usadas pelo Logix que são registradas no arquivo de profile, indicado na chave de configuração FGLPROFILE do arquivo de configuração do AppserSever (Appserver.ini):

Índice
minLevel2


Clique AQUIpara baixar uma arquivo de profile modelo contendo as chaves mais utilizadas.




Relação de Chaves de Profile Logix agrupadas por funcionalidade

     

Configurações Gerais

ChaveDescrição
logix.general.customerCodeCódigo de cliente Totvs utilizado no controle de visualização e manutenção de parâmetros específicos a partir da Central de Parâmetros - LOG00086.
logix.startApp.checkRevision

Bloqueio de execução de programas com revisões anteriores.

0 - Emite alerta ao usuário mas não bloqueia execução de aplicação se a revisão atual for anterior a última executada.

1 - (PADRÃO) Emite alerta ao usuário e bloqueia execução da aplicação se a revisão atual for anterior a última executada.

logix.threads.max

Habilita uso de múltiplas threads pelas aplicações Logix que tiverem algum processo previsto para ser distribuído em múltiplos processos (Threads). O valor padrão para esta chave é 10, caso não seja definido.

logix.source.inactiveTimeOut

Permite determinar um tempo de inatividade diferenciado do AppServer para uma determinado Programa e/ou Usuário.

O valor desta chave obedece o mesmo padrão de tempo utilizado para configurar a chave InactiveTimeOut definida no arquivo de configuração do AppServer (Appserver.ini) na seção [GENERAL], ou seja, em segundos, sendo o valor 0 (zero) para desligar a funcionalidade de checagem de tempo de inatividade de uso.

0 - Desativar a checagem de tempo de inatividade de uso do sistema para a seção do Usuário e/ou Programa.

>0 - Qualquer valor maior que 0 (zero) determinará o tempo de inatividade de uso, sendo esse valor definido obrigatoriamente em segundos, que é o mesmo padrão utilizado para definir o valor da chave InactiveTimeOut no arquivo de configuração do AppServer, contudo, sempre será considerado o minuto cheio para a inatividade. Por exemplo, quando configurado 90 segundos a desconexão será realizada em 2 minutos.

(seleção)Esta chave permite configuração diferenciada por Usuário e/ou Programa. Clique aqui.

Dica
titleATENÇÃO

Opção disponível somente a partir do pacote 12.1.34 ou Framework 12.1.32 (fix02).

logix.threads.4GL.runInNewThread

Indica quando a execução de um novo programa 4GL a partir de um programa 4GL em execução usando algumas funções padrões Framework como LOG1200_executa_programa() ou LOG_4GL_application_run() serão executadas em uma nova thread do AppServer ou serão executadas na mesma thread do programa atual que o acionar.

O objetivo desta funcionalide é reduzir o consumo de memória no AppServer para processos em que as execuções de programas 4GL a partir de outros programas 4GL seja em grande volume o que pode ocasionar um consumo de memória um pouco maior durante o processamento. Fazendo o uso desta funcionalidade, na medida em que o novo processo 4GL é executado em uma nova Thread do appserver, ao finaliza-lo e retornar para o processo 4GL que o invocou, a memória é totalmente liberada, pois a nova thread no AppServer utilizada para sua execução é encerrada.

0 - (PADRÃO) Execução de programas 4GL a partir de outros programas 4GL será realizado na mesma thread do AppServer.

1 - Execução de programa 4GL a partir de outro programa 4GL, utilizando as funções citadas logo acima, serão processadas em uma nova Thread no AppServer.   (aviso) Se os pré-requisitos para uso desta chave não for atendido, esta funcionalidade não terá efeito e o comportamento padrão (valor 0) será adotado.  (aviso)

Dica
titleATENÇÃO

Opção disponível somente a partir do pacote 12.1.2301 ou Framework 12.1.2209 (fix01).

O uso desta chave tem como PRÉ-REQUISITO MÍNIMO o uso do build AppServer revisão 13.1.3.53 e SmartClient revisão 17.3.0.19.

logix.threads.4GL.runADVPLInterface

Permite desativar a funcionalidade que permite executar um programa com interface ADVPL (Metadado/Freeform) a partir de um programa com interface 4GL utilizando as funções LOG_ADVPL_application_run() ou utilizando componente LThreadView para uma função 4GL que acione um formulário Metadado ou instancie uma tela desenvolvida com componentes FreeForm. 

A funcionalidade de executar uma interface ADVPL a partir de uma interface 4GL está disponível a partir do build AppServer 131.3.53 e Smartclient 17.3.0.19 e com estes requisitos atendidos de Build automaticamente a funcionalidade está habilitada por padrão, mas pode ser desativada através desta chave, caso exista necessidade para tal.

0 - Execução de programas com interface ADVPL a partir de programas com interface 4GL desativada. 

1 - (PADRÃO) Execução de programas com interface ADVPL a partir de programas com interface 4GL habilitada.  (aviso) Se os pré-requisitos para uso desta chave não for atendido, esta funcionalidade não terá efeito e o comportamento padrão (valor 0) será adotado.  (aviso)

Dica
titleATENÇÃO

Opção disponível somente a partir do pacote 12.1.2301 ou Framework 12.1.2209 (fix01).

O uso desta chave tem como PRÉ-REQUISITO MÍNIMO o uso do build AppServer revisão 13.1.3.53 e SmartClient revisão 17.3.0.19.


Licença

ChaveDescrição
logix.license.LSDevTest

Ativa o modo de licenças TOTVS Dev Test para os ambientes do Logix que fizerem uso deste arquivo de profile.

0 - (PADRÃO) Ambiente de produção. Consumo de licenças normal.

1 - Ambiente de testes. Consumo de licenças será realizado para a licenças TOTVS Dev Test (Slot 4007), limitado ao volume de licenças de teste existentes. O menu irá apresentar a borda externa na cor púrpura e no título do menu irá apresentar o texto " (AMBIENTE TESTE) " para facilitar a identificação de ambiente em modo Teste ativo.

Para mais detalhes relacionados ao License Server acesse:

       TOTVS | License Server 2014

       TOTVS License Server Virtual


Menu

ChaveDescrição
logix.general.companyImage

Caminho completo de uma imagem a ser apresentada no menu no lugar da atual imagem com o logotipo Totvs.

A imagem deverá ser uma imagem armazenada no disco do servidor onde está em execução o Servidor de Aplicação.

IMPORTANTE: a partir da versão da versão 12.1.31 a imagem de logo foi redimensionada para 162 x 48 pixels. Consulte a documentação DFWKFOUNDATION-4688 DT Alteração do login para atender a Nova Arquitetura de marcas. 

logix.menu.useTimeout

Permite desativar o controle de timeout do menu padrão.

0 - Não finaliza o menu automaticamente quando a chave de configuração INACTIVETIMEOUT do TOTVS Appserver estiver em uso (tempo de inatividade do usuário).

1 - (PADRÃO) Finaliza o menu por tempo de inatividade, se a chave de configuração INACTIVETIMEOUT do TOTVS Appserver estiver em uso.

logix.menu.showStartMenuPopup

Permite desativar a exibição automática do menu iniciar assim que concluir a autenticação no menu.

0 - Não exibe o menu iniciar automaticamente após abertura do menu.

1 - (PADRÃO) Exibe o menu iniciar automaticamente assim que o menu for aberto após LOGIN do usuário.

logix.menu.directRunSingleApp

Ao pesquisar um programa no menu, caso encontre apenas uma única ocorrência na pesquisa, a execução automática pode ser bloqueada.

0 - Não irá executar o programa automaticamente após a pesquisa.

1 - (PADRÃO) Executar o programa automaticamente após a pesquisa, caso só encontre uma única ocorrência.

logix.appBackgroundColor

Define a cor de fundo dos programas com interface 4GL a partir do menu.

0 - (PADRÃO) Branco
1 - Dourado
2 - Azul claro
3 - Cinza claro

Para mais detalhes de como usar esta configuração acesse Alterando a cor dos programas 4GL.


Âncora
Autenticacao
Autenticacao
Autenticação 

ChaveDescrição

logix.login.singleSignOn

Formato de autenticação padrão para acesso de usuários ao menu/programas Logix.

0 - Autenticação por usuário e senha interna Logix. NÃO PERMITE uso da opção "Mantenha-me conectado" (Relembrar login/senha). PERMITE troca de usuário.

1 - (PADRÃO) Autenticação por usuário e senha interna Logix. PERMITE uso da opção "Mantenha-me conectado" (Relembrar login/senha). PERMITE troca de usuário.

2 - Autenticação automática por usuário autenticado em domínio de rede (AD). NÃO PERMITE troca de usuário. 

3 - Autenticação por usuário de domínio de rede (AD). PERMITE uso da opção "Mantenha-me conectado" (Relembrar login/senha). PERMITE troca de usuário.

5 - Autenticação por provedor de identidade. NÃO PERMITE uso da opção "Mantenha-me conectado" (Relembrar login/senha). PERMITE troca de usuário. 



Dica
titleDICAS
  • Para utilizar autenticação 2 (Autenticação por AD - Active Directory) é preciso cadastrar o login da conta e o nome do domínio de rede no cadastro de usuário, para vincular o usuário de rede de domínio ao login de usuário interno no Logix.

  • Autenticação 5 (Autenticação por provedor de identidade) disponível somente Disponível a partir do pacote 12.1.2309 ou Framework 12.1.2305 (fix01).
    Para utilizar este tipo de autenticação deverá ser feito o cadastro de um provedor de identidade pelo Cadastro de Provedores de Identidade (LOG00120) via protocolo OIDC (OpenID Connect).
    Exemplos de provedores de identidade que suportam OIDC:
      • Azure 
      • Google
      • Gluu Server

      Acesse a documentação disponível do provedor de identidade desejado e verifique suporta as especificações do OpenID Connect.

      O vínculo do usuário do provedor de identidade neste caso se dará pelo e-mail do usuário que deverá estar corretamente registrado no Cadastro de Usuários Logix (LOG05050 >> Usuários).

      Para mais detalhes de como ativar e configurar o produto LOGIX para autenticação por provedor de identidade acesse DFWKLOGIX-850 DT Permitir autenticação via OIDC a partir do menu.

Aviso
titleATENÇÃO

O tipo de autenticação 2 (Autenticação automática por usuário autenticado em domínio de rede) NÃO É VÁLIDO para:

    • Autenticação com interface TELNET, geralmente utilizada para coletores de dados, pois trata-se de uma conexão remota e não local, onde não é possível reconhecer o usuário local autenticado no domínio de rede. Neste caso o sistema emitirá um alerta "Não autorizado." no momento da autenticação do usuário no menu do coletor de dados.
    • WEB (via navegador internet), onde será exigida sempre a senha de rede, pois o navegador não consegue acessar o usuário de rede autenticado na máquina local.  Neste caso o sistema irá obrigar o login e a senha de domínio do usuário na tela de autenticação do menu do produto.


O tipo de autenticação 5 (Autenticação via provedor de identidade) NÃO É VÁLIDOpara:

    • Autenticação com interface TELNET, geralmente utilizada para coletores de dados, pois trata-se de uma conexão remota e não local, onde não é possível reconhecer o usuário local autenticado no domínio de rede. Neste caso o sistema emitirá um alerta "Não autorizado." no momento da autenticação do usuário no menu do coletor de dados.
logix.login.ADConnectionString

Endereço URL de conexão LDAP com o servidor AD (Active Directory) para autenticação de usuários.

Dica

Em caso de mais de um domínio de rede, deve-se configurar uma chave separada para cada domínio de rede no seguinte formato: 


     logix.login.ADConnectionString<.dominio>
logix.login.ADDomain

Lista de nomes de domínios de rede previstos no sistema para realizar autenticação de usuários por AD. Utilize "," (vírgula) para informar mais de um domínio. Exemplo: No caso do domínio "jv01.local", utilizar apenas o nome do domínio "jv01".

logix.login.ADConnectApp

Chave para o aplicativo utilizado para autenticação de usuários no AD.

ADUserInfo - Utiliza aplicativo contido na biblioteca java ADUserInfo.jar. Esta biblioteca precisa estar configurada na lista de bibliotecas java na variável de ambiente CLASSPATH do Appserver. Para mais detalhes de configuração e validação da biblioteca acesse .

(sem ideias) Quando esta chave não está definida no profile ou tem seu valor definido em branco ou não tem valor definido, o sistema irá assumir o uso da função padrão de autenticação do build AppServer.

Nota

Esta chave apenas deve ser utilizada para contornar possíveis problemas que surgirem ao utilizar a funcionalidade padrão de autenticação por AD prevista no build AppServer.

Dica

Independente do valor configurado para esta chave é necessário configurar as chaves logix.login.ADConnectionString e logix.login.ADDomain pois quando o acesso ao sistema Logix é realizado a partir da interface TELNET ou Smartclient HTML ou Portais Web, não existe uma comunicação CLIENT x SERVER e neste caso o sistema realiza a autenticação utilizando sempre o biblioteca java ADUserInfo a partir do AppServer.

Para mais detalhes relacionados as chaves de autenticação de usuário e respectivo funcionamento acesse Chaves Profile Autenticação AD.


Fuso Horário e Horário de Verão

Para controle de fuso horário no Logix ou definir, existem as chaves a seguir a serem definidas no profile:

ChaveDescrição
logix.timezone.server

Indicação do fuso horário do local de instalação do Appserver.

Exemplo:

logix.timezone.server=-03:00


Neste exemplo o fuso horário da cidade/estado onde o Appserver está em execução é UTC-3, que deve ser configurado no formato hh:mm (hora:minuto), no valor da chave de profile, precedido também do sinal positivo ou negativo. Neste caso resultou na configuração -03:00. Já para situações onde o fuso horário for UTC+2, por exemplo, considerar a configuração da chave como +02:00, incluindo o sinal "+" no início do valor da chave.

Dica

Esta chave é obrigatória, quando existe a necessidade de registrar diferentes fusos para empresas no sistema Logix.

logix.summertime.server

Período do horário de verão atual ou então o próximo período de horário de verão a entrar em vigência.

Exemplo:

logix.summertime.server=04/11/2018-16/02/2019


O valor da chave deve ser configurado no seguinte formato dd/mm/aaaa-dd/mm/aaaa onde:

  • dd/mm/aaaa indica o dia (dd), mês (mm) e ano (aaaa)
  • devem ser configuradas duas datas, sendo a data inicial do horário de verão vigente ou próximo horário de verão que entrará em vigor e a data final do horário deste mesmo período de horário de verão.

Nota

Esta chave somente deve ser informada no profile, quando a cidade de localização do AppServer tiver horário de verão, caso contrário, esta chave não deverá ser informada.

Quando esta chave for informada, é obrigatório informar o fuso-horário do servidor, setando a chave logix.timezone.server.



Expandir
titleProcedimentos para uso de FUSO HORÁRIO no Logix
  1. O uso de fuso horário no Logix tem como procedimento os passos a seguir:

    • Ativar a chave de profile logix.timezone.server. 

      Exemplo: 

    Appserver está localizado na cidade de São Paulo, fuso horário (UTC Brasília -03:00)

    No profile deverá ser definido assim:

                    logix.timezone.server=-03:00


    • O fuso horário de cada empresas cadastrada no Logix deverá ser registrado usando o programa LOG00179 (Fuso horário por Empresa).

      Exemplo:

    Empresa 32 é da cidade do Rio Branco - AC (UTC Acre -05:00)

    No cadastro da empresa 32 deverá ser registrado o fuso GMT (-05:00).


    • Para as empresas que não tiverem o cadastro de fuso horário registrado, o sistema não irá aplicar qualquer mudança de fuso horário durante a execução de programas.


  2. O uso de horário de verão no Logix tem como procedimento os passos a seguir:

    • Ativar a configuração do fuso horário citado no item (1) acima.

    • Cadastrar o período de horário de verão vigente LOG00079 por país, relacionando todas as UFs (Unidades Federativas) das empresas registradas no sistema, localizadas em regiões que aplicam o horário de verão. 

  3. Após estas configurações realizadas, no acesso de cada programa, o ajuste de horário será automático de acordo com o código da empresa autenticada na aplicação ou menu do sistema, considerando o fuso horário e/ou horário de verão configurados.


Âncora
GRL
GRL
Gerenciador de Relatórios (GRL)

Quando a variável de ambiente LGXGR é definida com a URL de conexão a ferramenta Gerenciador de Relatórios, que utiliza serviço Apache TomCat, indica que esta opção está ativa para uso a partir do Logix. Neste caso existem algumas chaves de configurações complementares no profile Logix que ajustam alguns comportamentos em relação ao acionamento da ferramenta GRL a partir do Logix.

ChaveDescrição
logix.grl.activate

Ativação automática do gerenciador de relatórios na emissão de relatórios em DISCO a partir de programas com interface 4GL.

0 - (PADRÃO) Inativo. Nunca abre automaticamente o gerenciador de relatórios na emissão de relatórios em disco.

1 - Ativar após término da geração do relatório (PADRÃO). Abre o gerenciador de relatórios automaticamente no término da emissão do relatório em disco, desde que o processamento seja realizado em modo de processamento on-line e não em modo JOB.

2 - Ativar após confirmar geração do relatório em disco. Abre o gerenciador de relatórios automaticamente assim que a opção de emissão em disco for confirmada, ou seja, antes de iniciar o processamento de geração dos relatórios em disco.

logix.grl.activate.metadata

Ativação do gerenciador de relatórios GRL em substituição ao visualizador padrão de relatórios a partir de programas metadado.

0 - (PADRÃO) Inativo. Abertura do Visualizador de relatórios padrão do menu Logix para programas metadado.

1 - Ativo. A visualização de relatórios gerados em disco a partir de programas metadado será via Gerenciador de relatórios (GRL).

Nota
  • O Gerenciador de Relatórios (GRL) somente será aberto para visualização de relatórios gerados no servidor.
  • Para relatórios em disco LOCAL será apresentado o visualizador padrão do menu.


Em relação aos procedimentos de instalação e atualização do gerenciador de relatórios, acesse o pacote de instalação disponível na central de downloads AQUI. Neste pacote existe um arquivo no formato PDF com os procedimentos de instalação e outro arquivo no formato TXT com os procedimentos de atualização do GRL.


Impressão de relatórios 

ChaveDescrição
logix.printfile.onlyLocalPrinter

Indica se apenas impressoras locais poderão ser selecionadas como destino de impressão pelo LOGIX, ou seja, não será permitido selecionar impressoras do SERVIDOR. Este controle é utilizado em caso de controle de bilhetagem de impressão, onde existe a necessidade de controlar o volume de impressões por área numa empresa.

1 - Ativo

0 - (PADRÃO) Inativo

(seleção)Esta chave permite configuração diferenciada por Usuário e/ou Programa. Clique aqui.

logix.printfile.onlyLogixPrinter

Indica se apenas impressoras Logix poderão ser selecionadas como destino de impressão pelo LOGIX, ou seja, não será permitido selecionar impressoras LOCAIS.

1 - Ativo

0 - (PADRÃO) Inativo

(seleção)Esta chave permite configuração diferenciada por Usuário e/ou Programa. Clique aqui.

logix.printfile.queueEnabled

Ativar o uso de fila de impressão.

1 - Ativo

0 - (PADRÃO) Inativo

Dica

Esta funcionalidade pode ser utilizada para ambientes CLOUD que utilizam acesso do tipo TELNET e precisam realizar impressão a partir do Logix, utilizando impressoras locais. Como não existe comunicação do acesso via TELNET com dispositivos da máquina local, é necessário enviar o arquivo para uma fila de impressão para que o arquivo seja impresso por uma aplicação que leia esta fila e envie o arquivo para a impressora definida.

Mais detalhes em Fila de Impressão.

logix.printfile.queueInterval

Intervalo de tempo para verificação da fila de impressão ativada via chave logix.printfile.queueEnabled.

O valor da chave deve deve ser definido em segundos, sendo aceito no mínimo 60 segundos.

O tempo padrão desta chave é 180 segundos (3 minutos).

logix.printfile.application

Indicar o aplicativo que será responsável por realizar a impressão de arquivos a partir do sistema operacional utilizado na máquina local ou servidor.

Esta chave permite indicar aplicativos distintos para ambientes distintos (windows / linux / macos) e para extensões distintas de arquivos (lst, txt, pdf, etc.). Para isso pode-se adicionar a chave o sistema operacional e/ou extensão de arquivos distintamente no seguinte formato:

   logix.printfile<.extensão_arquivo>.application<.sistema_operacional>

Quando o sistema não encontrar a chave identificada para os respectivos sistema operacional e extensão do arquivo em questão, irá adotar o valor padrão para a chave padrão.

Os aplicativos padrões de impressão para cada ambiente são:

AmbienteAplicativo padrão
Windows

LPDOS.EXE

Este aplicatiovo deve estar localizado na pasta TOOLS abaixo da pasta indicada como ROOTPATH do ambiente em uso do Appserver.

Linux ou MacOSComando nativo linux "lp"


A chave permite definir apenas SISTEMA_OPERACIONAL ou apenas EXTENSÃO_ARQUIVO ou ambos. Neste caso teremos as seguintes possibilidades:

Formato
logix.printfile<.extensão_arquivo>.application
logix.printfile.application<.sistema_operacional>
logix.printfile<.extensão_arquivo>.application<.sistema_operacional>

Para extensão_arquivo pode informar as extensões desejadas. Exemplo: .pdf, .txt, .lst, .doc, etc.

Para sistema_operacional pode informar: windows, linux ou macos.

logix.printfile.param

Indicar a lista de parâmetros para o aplicativo registrado na chave logix.printfile.application. A forma como esta chave é parametrizada é a mesma da chave logix.printfile.application, ou seja, permite informar o sistema operacional e/ou extensão de arquivo na chave.

Os parâmetros informados aceitam as seguintes TAGs, que são substituídas automaticamente durante a execução pelo sistema são:

TAGDescrição
FILE(Obrigatório) Caminho completo do arquivo a ser impresso.
PRINTER(Obrigatório) Nome da impressora selecionada pelo usuário.
LOGFILE(Opcional) Caminho completo do arquivo de LOG. Quando não for informada uma pasta do arquivo, irá registrar o LOG automaticamente na pasta Temporária do servidor ou local.
logix.printfile.logfile

(OPCIONAL) Nome de arquivo de LOG de saida gerado pelo aplicativo de impressão configurado na chave logix.printfile.application.

Esta chave por padrão é utilizada para o aplicativo LPDOS.EXE e para isso também possui um nome de arquivo de log padrão gerado pelo sistema como lpdos.log.

A pasta padrão de geração do arquivo será sempre a pasta temporária do servidor ou Local.

Este arquivo de log é gerado para identificar falhas no processo de impressão e com isso, se o conteúdo do arquivo de LOG possuir algum conteúdo após impressão, indica a existência de possíveis problemas na impressão.

logix.printfile.execmode

Modo de execução para o aplicativo de impressão parametrizado na chave logix.printfile.application.

0 - (PADRÃO) WaitRun. O sistema irá aguardar o término da execução do aplicativo de impressão antes de retomar a execução do sistema.

1 - ShellExecute. O sistema irá invocar a operação "OPEN" do sistema operacional para o aplicativo de impressão configurado na chave logix.printfile.application.

logix.printfile.debug

Ativar o modo DEBUG para impressão de relatórios para auxiliar na identificação de problemas em alguma impressão de relatório.

1 - Ativo

0 - (PADRÃO) Inativo

Dica
Quando a chave logix.debug estiver inativa (0), pode-se ativar o debug apenas das operações de impressão de relatórios usando esta chave logix.printfile.debug, onde serão emitidas mensagens no arquivo de LOG para acompanhar o processo de impressão.
logix.printfile.keepfile

Remover arquivo PDF gerado no servidor, quando for selecionada a impressão local de um relatório no formato PDF.

1 - Ativo. Arquivo PDF será removido do servidor após finalizar o processo de impressão local do relatório, mantendo cópia do relatório PDF apenas no disco local.

0 - (PADRÃO) Inativo. O arquivo no formato PDF do relatório gerado no servidor será mantido mesmo após finalizar a impressão local.


Freeform / Metadados 
Âncora
metadado
metadado

somente somente
ChaveDescrição
logix.metadata.resPrefix

Lista dos prefixos para criação de formulários CRUD (FRM1002), Formulários de processamento (FRM1003), Barra de Ferramentas (FRM1001) e Zooms (FRM1008) específicos.

Bloco de código
languagegroovy
themeConfluence
titleExemplo
logix.metadata.resPrefix=rvdp,rman,rsf,tst
Nota
titleATENÇÃO
  • Para informar mais de um prefixo válido, deve-se separar os prefixos usando vírgula (,).
  • Nenhum dos prefixos informados nesta chave pode coincidir com prefixos de programas padrões Totvs como, por exemplo, VDP, LOG, MAN, MEN, MIN, entre outros.


Deve-se utilizar "," (vírgula) para separar os prefixos na lista, quando for informado mais de um.

logix.metadata.customEnabled

Viabiliza a customização de formulários padrões Totvs no Metadados Logix.

1 - Ativo. Permitirá ajustar algumas informações e registrar alguns eventos adicionais para formulários padrões Totvs no metadados.

0 - (PADRÃO) Inativo. Não permitirá realizar qualquer mudança em formulários padrões Totvs no metadados. 


Dica
titleATENÇÃO
  • Opção disponível
  • a partir do pacote 12.1.26 ou Framework 12.1.25 (fix02).
  • Esta chave não interfere sobre a criação e/ou alteração de informações em formulários específicos que são reconhecidos a partir do seu prefixo, que deverá coincidir com um dos prefixos definidos na chave de profile logix.metadata.resPrefix. 
logix.freeform.debug.listOfComponents

Permite realizar a listagem de componentes criados em cada janela (DIALOG) de uma execução de programa metadado/FreeForm no arquivo de LOG do Appserver, sempre que uma nova DIALOG é aberta durante a execução de um programa.

O objetivo desta chave apenas visa facilitar a identificação da nomenclautura e estruturação de componentes de uma janela, caso exista necessidade de capturar alguma propriedade de componente ou desenvolver alguma rotina para forçar a execução de algum evento para algum componente de tela. 

Esta função é um utilitário para uso na construção de rotinas de automação de testes utilizando modelo desenvolvido com scripts de instruções 4GL.

0 - (PADRÃO) Listagem de componentes de janelas (DIALOG) desligada.

1 - Listagem de componentes de janelas (DIALOG) ativa. Essa listagem é registrada no LOG do AppServer a cada abertura de janela durante a execução de programas Freeform/Metadado.

(seleção)Esta chave permite configuração diferenciada por por ambiente e/ou sistema operacional. Clique aqui.

logix.freeform.grid.addRowOption

Comportamento padrão para inclusão de linhas em componente GRID.

0 - (PADRÃO) A inclusão de uma nova linha em grid será realizada sempre após a última linha de dados preenchida.

1 - A inclusão de uma nova linha em grid será realizada na linha onde o cursor estiver posicionado.

(seleção)Esta chave permite configuração diferenciada por Usuário e/ou Programa. Clique aqui.

logix.metadata.filter.caseSensitive

Comportamento padrão na tela de filtro de pesquisa em relação a diferenciar ou não as letras maiúsculas das minúsculas no momento da confirmação da pesquisa no metadado. 
Na tela de filtro de pesquisa atualmente existe a opção Image Modified que por padrão aparecer desmarcada para o usuário, no entanto é possível mudar este padrão através desta chave de configuração.

0 - (PADRÃO) Modo Case Sensitive desligado. 

1 - Modo Case Sensitive ligado.

logix.metadata.filter.mainGuide

Qual é a aba padrão para exibição na tela de filtro de pesquisa no metadado.

1 - (PADRÃO) Aba 1-Básico. 

2 - Aba 2-Avançado

3 - Aba 3-Ordenação

Dica
titleATENÇÃO

Opção disponível a partir do pacote 12.1.2403 ou Framework 12.1.2311 (fix01).

logix.metadata.sincronizer.import.enable

Permite desabibilitar a ação de IMPORTAÇÃO de dados a partir do Sincronizador Metadados (LOG00074). 

Habilitando esta chave, apenas a ação de EXPORTAÇÃO ficará disponível para uso.

0 - (PADRÃO) A inclusão de uma nova linha em grid será realizada sempre após a última linha de dados preenchida.

1 - A inclusão de uma nova linha em grid será realizada na linha onde o cursor estiver posicionado.

(seleção)Esta chave permite configuração diferenciada por Usuário. Clique aqui.


Dica
titleATENÇÃO

Opção disponível

a partir do pacote 12.1.33 ou Framework 12.1.32 (fix01).


Geração de LOG com Debug 
Âncora
debug
debug

ChaveDescrição
logix.source.logFileUser

Permite ativação de geração de um arquivo de LOG separado a cada execução de programa.


ValorFormato geração DEBUG
0(PADRÃO) Desativado
1Debug SQL + Debug Framework
2Profiler + Debug Framework
3Debug Framework


O Profiler envolve a geração de informações detalhadas de processamento que geralmente são utilizadas para avaliar e identificar problemas de performance. Para mais detalhes sobre o formato do log Profiler acesse a documentação da chave LOGPROFILER.

O Debug Framework envolve a geração de informações geradas a partir do uso de funções de log de mensagens com foco em análise de comportamento das funcionalidades do produto envolvendo:

      • Autenticação
      • Comunicações REST / SOAP / HTTP
      • Impressões
      • Processamentos de I/O
      • Informações relacionadas a processamento de regras de negócio
      • Carga de formulários metadado, eventos de componentes metadado/freeform
      • Outros
      • Estas informações são geradas com base no uso da função LogConsoleDebugMessage([Mensagem])

O Debug SQL envolve a geração das instruções SQL executadas durante o processamento dos programas. Esta funcionalidade é nativa da Tecnologia TOTVS AppServer utilizando a chave de configuração FGLSQLREPLAY. Para mais detalhes acessa a documentação das chaves de configuração do Application Server em Seção [Environment].

(seleção)Esta chave permite configuração diferenciada por Usuário e/ou Programa. Clique aqui.

logix.sqldebug

Permite ativar o modo DEBUG SQL para toda execução realizada para um determinado programa e/ou usuário Logix. Este modo DEBUG SQL equivale a ativação da chave de ambiente FGLSQLREPLAY que pode ser definida no arquivo de configuração do Appserver (Appserver.ini).

0 - (PADRÃO) Desativar o modo DEBUG SQL.

1 - Ativar o modo DEBUG SQL.

(seleção)Esta chave permite configuração diferenciada por Usuário e/ou Programa. Clique aqui.

logix.dbtrace

Permite ativar a geração de TRACE de banco de dados (DBTRACE) na execução de um determinado programa e/ou usuário no seguinte formato:

   logix.dbtrace.<programa>.<usuario>


1 - Ativo. Gerar DBTRACE para um determinado programa.

0 - (PADRÃO) Inativo.


Onde:

<programa> Nome do programa que deverá ter a geracao de TRACE de Banco de dados criada durante a execução.

<usuario> Login do usuário Logix.


Nota
  • O arquivo de TRACE de Banco de Dados será gerado em um arquivo no servidor de banco de dados.
  • O caminho de diretório e nome do arquivo será registrado em uma mensagem no arquivo CONSOLE.LOG do Appserver ou no arquivo de LOG de DEBUG da execução do programa, quando executar em modo Debug a partir do Menu Logix.
  • Pode ser definida ativação desta chave para vários programas. Para isso basta definir esta chave UMA vez para cada programa desejado.
Aviso

Chave NÃO disponível para banco de dados SQLServer.

(seleção)Esta chave permite configuração diferenciada por Usuário e/ou Programa. Clique aqui

logix.license.debug

Geração de LOG envolvendo consumo de licenças.

0 - (PADRÃO) Inativo

1 - Ativo

Âncora
logixdebug
logixdebug
logix.debug

Ativa ou não a geração de LOG de mensagens no AppServer para todas as execuções de programas, quando forem utilizadas algumas funções padrões de geração de mensagens.

0 - (PADRÃO) Inativo.

1 - DEBUG SQL + DEBUG Framework. Ativo para geração de instruções SQLs executadas durante o processamento das aplicações e ativo também para geração de mensagens de Debug emitidas pela função LOG_consoleDebugMessage.

2 - PROFILER + DEBUG Framework. Ativo para geração de instruções PROFILER, utilizado para avaliar performance de processamento das aplicações e ativo também para geração de mensagens de Debug emitidas pela função LOG_consoleDebugMessage.

3 - DEBUG Framework. Ativo para geração de mensagens de Debug emitidas pela função LOG_consoleDebugMessage.


Informações

O conteúdo gerado no LOG do AppServer quando esta chave estiver ativa (Valor diferente de zero) é o mesmo conteúdo gerado quando é feita execução de um programa pelo modo DEBUG a partir do menu, ao acionar o botão direito do mouse sobre o atalho de um programa do menu e escolher uma das opções a seguir:

   ♦ "Executar processo" corresponde ao valor 0 (Inativo), onde não serão geradas mensagens adicionais de DEBUG no LOG do AppServer.

   ♦ "Executar processo (DEBUG)" corresponde ao valor 1 (DEBUG SQL + DEBUG Framework)

   ♦ "Executar processo (PROFILER)" corresponde ao valor 2 (PROFILER + DEBUG Framework)

   ♦ "Executar processo (FRAMEWORK)" corresponde ao valor 3 (DEBUG Framework)


Todas as mensagens relacionadas a Debug Framework serão registradas no LOG precedidas com a TAG [DEBUG].


A função que gera mensagens no LOG do Appserver, respeitando o valor desta chave é LOG_consoleDebugMessage.

logix.source.debug

Permite ativar a geração de DEBUG para um ou mais fontes (4GL/ADVPL) de forma isolada ou ativar a geração de DEBUG para qualquer fonte.

1 - Ativo. Gerar mensagens de LOG no AppServer.

0 - (PADRÃO) Inativo.


Esta chave funciona em conjunto com a chave logix.debug, ou seja, somente se a chave logix.debug estiver ativa (valor diferente de zero), irá avaliar se a geração de mensagem no LOG deve ou não ser realizada de acordo com a restrição de fontes para os quais devem ser gerados os LOGs.

O padrão desta chave, quando ativo, gera mensagens para todo e qualquer fonte, ou seja:

Bloco de código
   logix.source.debug = 1


Quando houver a necessidade de restringir a geração de LOG apenas de uma lista específica de fontes, deve-se omitir ou comentar a chave GERAL (logix.source.debug = 1) e ativar para todos os fontes desejados, assim:

Bloco de código
   logix.source.<fonte1>.debug = 1
   logix.source.<fonte2>.debug = 1
   logix.source.<fonte3>.debug = 1

Onde:

<fonte> Nome do fonte (4GL/ADVPL) que deverá ter a geração de mensagens no LOG do AppServer ativadas durante a execução.

logix.epl.debug 

Ativar geração de LOG para registro de chamadas de funções de pontos de entrada específicos (EPL).

1 - Ativo

0 - (PADRÃO) Inativo

Informações

Todas as mensagens serão registradas no LOG precedidas com a TAG [LOGIX EPL].

logix.cnv.debug

Geração de mensagens de DEBUG no uso das rotinas de processamento de conversores (LOG00086 e LOG6000).

1 - Ativo

0 - (PADRÃO) Inativo

logix.balanca.debug

Geração de mensagens de DEBUG no uso das rotinas envolvendo pesagem de balança. Funções da biblioteca BALANCA.4GL.

1 - Ativo

0 - (PADRÃO) Inativo

logix.pdf.removeConfigFile

Permite inativar a exclusão física do arquivo de configuração gerado pelo programa do LOGIX que é utilizado como base para criar um documento no formato PDF, utilizando a ferramenta freePDF.

1 - (PADRÃO) Ativo. Excluir arquivo de configuração após geração do documento PDF.

0 - Inativo. Manter arquivo de configuração em disco após a geração do documento PDF.


TAS (Totvs API Services) 

Extrair

Todas as chaves a seguir são obrigatórias para uso da funcionalidade envolvendo Totvs API Service (TAS), nova ferramenta que substituiu os serviços da ferramenta MashupTotvs que foi descontinuada a partir de 15/04/2023.

Para mais informações acesse DFWKLOGIX-890 DT Integração LOGIX x TOTVS API Services (Troca Mashups).

Exemplos:

  • Consulta de CPF
  • Consulta de CEP
  • etc.


TAS disponível a partir do pacote Logix 12.1.2305 ou Fix Framework Logix 12.1.2305.fix01.

A ferramenta TAS, entrega os mesmos serviços em funcionamento da ferramenta MASHUPS que foi descontinuada, além dos serviços atualmente quebrados (Receita, Sintegra e Suframa), de forma mais otimizada, (estrela) sem a necessidade da instalação do proxy e resolução de captchas (estrela).


ChaveDescrição

logix.tas.apiKey

Código da API-KEY (token) registrado para uso dos serviços disponíveis no TAS (Totvs API Services).


(informação) Para obter o código da API-KEY (token) ou revogar o acesso ao ambiente TOTVS API Services acesse AQUI ou acesse a página de apoio Sobre o Totvs API Services.

Envio de e-mail

A seguir a lista das chaves de profile utilizadas para configurar o envio de e-mail a partir do Logix.

Para informações de como configurar o envio de e-mail acesse Base de conhecimento Logix - Email.


ChaveDescrição
logix.mail.SmtpServerEndereço do servidor de Email.
logix.mail.SmtpProtocolProtocolo de autenticação de envio do e-mail.
logix.mail.SmtpPortPorta de conexão do servidor de E-mail. A porta padrão adotada será 25 (Protocolo SSL) ou 587 (Protocolo TLS).
logix.mail.SmtpAuth

Indicador de uso de autenticação SMTP como obrigatória pelo servidor de e-mail para o envio de e-mails.

1 - (PADRÃO) Autenticação SMTP habilitada. 

0 - Autenticação SMTP desabilitada.  

Dica
iconfalse
  • Caso as chaves SmtpUser e SmtpPassword não forem configuradas ou estiverem com valor em branco, o valor padrão da chave SmtpAuth é 0 (desabilitado).
  • Esta configuração somente pode ser desligada no LOGIX quando estiver disponível e desativada nas configurações do provedor de e-mails. 
  • Para mais informações sobre a funcionalidade relacionada a autenticação SMTP, acesse a documentação disponível para o serviço de provedor de e-mail utilizado (Exemplos: G Suite, Office 365, Locaweb, outros).
  • Disponível a partir do pacote Logix 12.1.31.


(ideia) Com esta opção desligada será possível realizar envio de e-mails com remetentes distintos a partir do LOGIX, respeitando as exceções de autenticação SMTP configuradas no servidor de e-mails. (ideia) 

logix.mail.SmtpTimeoutTempo de espera, em segundos,, para envio do e-mail. Em caso de lentidão de conexão esta chave pode ser alterada. O padrão de tempo é de 30 segundos.
logix.mail.SmtpEmailEmail do remetente padrão para envio de e-mails.
logix.mail.SmtpUserLogin de usuário para autenticação do envio de e-mails.
logix.mail.SmtpPasswordSenha do usuário indicado para autenticação do envio de e-mails.
logix.mail.confirmReadAtiva o modo de confirmação de leitura dos e-mails.
logix.mail.replyToE-mail de destino de resposta dos e-mails.
logix.mail.smtpStartTls

Indicador de uso do protocolo StartTLS.

1 - Utiliza protocolo StartTLS

0 - (PADRÃO) Não utiliza protocolo StartTLS

logix.mail.sendApp

Ferramenta utilizada para envio de e-mails.

SENDMAIL - (PADRÃO) Utiliza métodos nativos da tecnologia Totvs AppServer para enviar e-mails.

JAVAENVIA - Utiliza uma ferramenta Java (Send.jar) para enviar e-mails. Esta biblioteca precisa estar configurada na lista de bibliotecas java da variável de ambiente CLASSPATH para que o AppServer consiga fazer seu uso. Para mais detalhes acesse o manual de instalação de configuração do Build AppServer para Logix.

logix.mail.occultCopyDestinatários de e-mail em cópia oculta. Caso exista mais de um e-mail, devem ser separados por "," (vírgula).
Dica

Existe a possibilidade de configurar o valor das chaves acima com valores distintos por empresa no Logix. Para isso faz-se necessário configurar as respectivas chaves acima com o seguinte padrão:

[chave].[codigo_empresa] = [valor]

Exemplo:

logix.mail.SmtpPort.02 = 587 → Para empresa de código 02 a chave SmtpPort será 587

logix.mail.SmtpPort = 25 → Para as demais empresas, com exceção da empresa 02 o valor da chave SmtpPort será assumido como 25.


Observações:

Não importa a ordem como as chaves são definidas no arquivo de Profile.

Com exceção da chave logix.mail.sendApp, todas as demais chaves acima aceitam definição diferenciada por código de empresa.


Âncora
EPL
EPL
EPL 

EPL são pontos de entrada no Logix. São chamadas de funções customizadas a partir de programas padrões que invocam funções customizadas que podem ser mantidos pela Totvs (Equipe Fábrica de Software) ou mantidos pelo cliente. Para mais informações acesse a documentação disponível sobre padrões EPL em LGX - Pontos de Entrada (EPL).

ChaveDescrição
logix.epl.enable

Permite desativar a chamada de funções EPL que existam no RPO em uso durante a execução do produto.

0 - Desativar chamadas EPL. Desta forma o Logix irá executar 100% no padrão, sem nenhum acionamento de customizações EPL.

1 - (PADRÃO) Ativo

logix.epl.source.<fonte>.enable

Permite desativar a chamada de funções EPL invocadas a partir de um determinado fonte .4gl existente no RPO em uso durante a execução do produto. Neste caso somente as chamadas EPL a partir do fonte indicado é que serão desativadas. Todas demais chamadas EPL a partir de outros fontes, durante a execução do produto, continuarão ativas, caso não existam outras chaves para inativar.

0 - Desativar chamadas EPL

1 - (PADRÃO) Ativo

Dica

Substitua a TAG <fonte> pelo nome do fonte .4gl que deseja inibir as chamadas EPL.

logix.epl.mainsource.<programa>.enable

Permite desativar a chamada de todas funções EPL invocadas a partir de um determinado programa invocado a partir do menu ou a partir de outro programa. Neste caso todas chamadas EPL do programa ou funções invocadas por este programa serão desativadas.

0 - Desativar chamadas EPL

1 - (PADRÃO) Ativo

Dica

Substitua a TAG <programa> pelo nome do programa (4GL ou metadado) que deseja inibir as chamadas EPL.

logix.epl.function.<funcao>.enable

Permite desativar a chamada de todas funções EPL invocadas a partir de uma determinada função 4GL. Neste caso todas demais chamadas EPL continuarão habilitadas, salvo se forem definidas chaves para inativação.

0 - Desativar chamadas EPL

1 - (PADRÃO) Ativo

Dica

Substitua a TAG <funcao> pelo nome da função 4gl da qual deseja inibir as chamadas EPL.


RFI 

Para uso de algumas funções RFI para o produto Logix, que disponibilizam gerenciamento de links de acesso usando um token de acesso de código único existem chaves de profile que precisam ser configuradas no profile.

Para acessar as lista de chaves de profile da funcionalidade RFI para o Logix acesse RFI - Configuração.


POOL JOB Threads

POOL Job Thread é uma funcionalidade criada semelhante ao uso do componente LTHREAD, onde a aplicação pode quebrar o processamento de uma rotina longa em vários processos menores que podem ser executados de forma paralela, para redução de tempo de processamento, no entanto a diferença para o uso do POOL Jobs é que também terá redução do consumo de memória por AppServer, pois de acordo com o volume de processos paralelos no mesmo AppServer, pode gerar alto consumo de memória e onerar a performance.

Quer saber mais sobre a funcionalidade POOL Jobs? Acesse LGX - Pool Job Threads

Para acessar a lista de chaves de profile da funcionalidade POOL JOB Threads para o Logix acesse LGX - Configuração POOL Job Threads.


Fluig Identity

ChaveDescrição
logix.fluigIdentity.postBatchLimit

Permite limitar o número de registros de usuários a enviar ao Fluig Identity durante sua sincronização. Valor padrão: 50.

Para evitar inconsistências de Timeout durante a sincronização de usuários, o Logix envia, por padrão, 50 usuários por vez, até concluir o envio de todos os usuários.

Para mais detalhes relacionados à integração do Logix com Fluig Identity, acesse Identity - Linha Logix.



Observações

Configuração de chave por usuário e/ou programa 

Âncora
ChaveProgramaUsuario
ChaveProgramaUsuario

A definição de algumas chaves de profile permitem configuração diferenciada por usuário e/ou programa. Neste caso pode-se definir a chave no profile da seguinte forma:

   [chave].[programa].[usuario] = [valor]
   Ativação para toda execução de um determinado programa e usuário.

   [chave].[programa] = [valor]
   Ativação para toda execução de um determinado programa, independente de usuário.

   [chave].[usuario] = [valor]
   Ativação para execução de qualquer programa realizado por um determinado usuário.


Onde:

CHAVENome da chave de profile, conforme listagem nos tópicos anteriores.
PROGRAMANome do programa executado que deseja registrar configuração diferenciada da chave.
USUARIOLogin do usuário Logix para qual deseja registrar configuração diferenciada da chave.
VALORValor que a chave de configuração deve assumir.


Âncora
ChaveAmbienteSistemaOperacional
ChaveAmbienteSistemaOperacional

A configuração também permite definir valores diferenciados por ambiente e/ou sistema operacional, considerando sempre o ambiente atual em uso e o sistema operacional em que o AppServer está executando:

   [chave].[ambiente].[sistema_operacional] = [valor]
   Ativação para toda execução realizada a partir de um determinado ambiente e sistema operacional do AppServer.

   [chave].[ambiente] = [valor]
   Ativação para toda execução realizada a partir de um determinado ambiente do AppServer.

   [chave].[sistema_operacional] = [valor]
   Ativação para toda execução realizada a partir de um determinado sistema operacional do AppServer.


Dica
titleExemplos de uso

   #Ajuste do Timeout de todos os programas executados a partir do Menu Logix, com exceção do menu para 5 minutos.
   logix.source.inactiveTimeOut = 300


   #Ajuste do Timeout de todos os programas executados a partir do Menu Logix, com exceção do menu para 10 minutos apenas para o usuário de login "user0183"
   logix.source.inactiveTimeOut.user0183 = 600


   #Ativar a geração de arquivo de DEBUG (Debug SQL + Debug Framework) para toda execução realizada do programa SUP3760.
   logix.source.logFileUser.sup3760 = 1


   #Ativar a geração de arquivo de DEBUG (Debug SQL + Debug Framework) para toda execução realizada pelo usuário de login "user0183"
   logix.source.logFileUser.user0183 = 1


   #Ativar a geração de arquivo de DEBUG (Debug SQL + Debug Framework) para toda execução do programa MAN10021 realizada a partir do ambiente LOGIX12_DEBUG
   logix.source.logFileUser.man10021.logix12_debug = 1




Dica
titleDICA

Fiquei atento a opção disponível para cada parâmetro pois nem todo parâmetro disponibiliza chave de configuração tanto por usuário quanto por programa. Esta informação consta destacada juntamente com a descrição de cada parâmetro.

Para eliminar a definição de uma chave de profile, você pode optar por uma das duas opções a seguir:

  • Eliminar a linha onde a chave está registrada no arquivo de profile
  • Informar o símbolo "#" no início da linha onde a chave está registrada. Para esta ação também podemos denominar como "Comentar a chave no profile".