- Criado por Wesley Avelino De Carvalho, última alteração por Fábio Augusto Amaral Melo Nunes em 04 jun, 2020
CONTEÚDO
- Visão Geral
- Exemplo de utilização
01. VISÃO GERAL
A funcionalidade "Gerenciamento de Config" tem por objetivo simplificar a maneira de administrar os arquivos de configurações das estações de trabalho, utilizando uma única interface. Com a unificação do arquivo de configuração podemos visualizar, incluir, excluir e alterar as configurações de qualquer estação mesmo estando desligada.
A partir da versão 12.1.27, será apresentado um modelo diferente de Config. Global, em JSON. Veja a documentação.
Atenção
Observação
Para a execução de TLS 1.1 e 1.2 no Windows 7 é necessário adicionar os registros abaixo, visto que são os protocolos de comunicação ativos atualmente e que por padrão não são ativos na versão Windows7:
Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.1\Client]
"DisabledByDefault"=dword:00000000
[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.1\Server]
"DisabledByDefault"=dword:00000000
[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Client]
"DisabledByDefault"=dword:00000000
[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Server]
"DisabledByDefault"=dword:00000000
Arquivo disponível para download: Arquivo.reg
02. EXEMPLO DE UTILIZAÇÃO
INSTALADORES
Instruções:
1. Acesse a Central de Download em www.totvs.com/suporte
2. Faça o login, com seu Email e Senha.
3. Na barra de menu superior, clique em DOWNLOAD.
4. No boxe “Central de Downloads” pesquise pela versão da biblioteca RM.
Pronto! Todos os instaladores correspondentes do filtro aplicado no passo 4 serão disponibilizados para download. Para iniciar o download do arquivo, clique na figura com uma seta para baixo localizada na primeira coluna da grid ou no link da versão selecionada.
Escolha o método mais apropriado de download e salve o arquivo na pasta desejada.
Requisitos:
- Linha de Software: RM
- Versão: 12.01.01 e posteriores
- Data de Liberação: Outubro/2014
- Observação: Para requisitos de software consulte nossa portabilidade: Portabilidade RM 12.01
COMO CONFIGURAR
Para utilizar esta configuração é necessário o compartilhamento de uma pasta em rede contendo o arquivo "Configuracaorm.config". Neste arquivo constará o cadastro do aplicativo desejado, utilizando as configurações desejadas para o seu ambiente.
Arquivo Configuracaorm.config | Arquivo exemplo: RM.Host.exe.config |
---|---|
Disponibilizado o arquivo em rede torna-se necessário ajustar os arquivos de conexão (RM.Host.exe.config, RM.Host.Service.exe.config) e aplicações (RM.exe.Config, RMBis.exe.config, RMLabore.exe.config etc) em cada estação utilizada.
Dentro do arquivo de configuração, em cada estação, remova todo o contexto que esteja dentro de <appSettings> e substitua por tag <add key="configpath" value="\\PastaCompartilhadaNaRede" />. O tag ConfigPath deve ser preenchido com o diretório onde o arquivo "Configuracaorm.config" foi compartilhado.
Abaixo um exemplo de como ficarão os arquivos de configurações em cada estação:
Máquina que não utiliza o Gerenciamento de config | Máquina que utiliza o gerenciamento de config |
---|---|
<?xml version="1.0"?> <configuration> <appSettings> <add key="JobServer3Camadas" value="false" /> <add key="Port" value="8050" /> <add key="Host" value="localhost" /> <add key="LibPath" value="C:\totvs\CorporeRM\RM.Net" /> </appSettings> </configuration> | <?xml version="1.0"?> <configuration> <appSettings> <add key="CONFIGPATH" value="\\PastaCompartilhadaNaRede" /> </appSettings> </configuration> |
Após realizar estas configurações o ambiente está preparado para utilizar o arquivo unificado de configuração.
Observações:
COMO FUNCIONA
1) Inicio do Fluxo → CreateFile();
Verifica o Registro → [Nome do Aplicativo] + [Domínio] + [Nome da Máquina]; EX: RM.EXE_BH01_TESTE.
Caso o Registro exista →
- Altera o registro com as modificações realizadas.
- Save(); //Salva as alterações no registro.
Fim do Fluxo → Fim do CreateFile();
2) Inicio do Fluxo → Verifica o Registro [Nome do Aplicativo] + [Domínio] + "Default"; EX: RM.EXE_BH01_DEFAULT.
Caso o Registro exista → Verifica a tag CONFIGAUTOGENERATE.
Se estiver com o valor true →
- Cria o registro [Nome do Aplicativo] + [Domínio] + [Nome da Máquina] EX: RM.EXE_BH01_TESTE.
- Save(); //Salva as alterações no registro.
Se estiver com o valor false → Uma mensagem é enviada ao Usuário.
Fim do Fluxo → Fim do CreateFile();
3) Inicio do Fluxo → Verifica o Registro [Nome do Aplicativo - Principal (Sem múltiplos hosts)] + [Domínio] + "Default"; EX: RM.EXE_BH01_DEFAULT.
Caso o Registro exista →
- Cria o registro [Nome do Aplicativo] + [Domínio] + "Default"; EX: RM.EXE_BH01_DEFAULT.
- Save(); //Salva as alterações no registro.
- Verifica a tag CONFIGAUTOGENERATE.
Se estiver com o valor true → Cria o registro [Nome do Aplicativo] + [Domínio] + [Nome da Máquina] EX: RM.EXE_BH01_TESTE.
Fim do Fluxo → Fim do CreateFile();
4) Inicio do Fluxo → Verifica o Registro [Nome do Aplicativo] + "Todos" + "Default"; EX: RM.EXE_TODOS_DEFAULT.
Caso o Registro exista →
- Cria o registro [Nome do Aplicativo] + [Domínio] + "Default"; EX: RM.EXE_BH01_DEFAULT.
- Save(); //Salva as alterações no registro.
- Verifica a tag CONFIGAUTOGENERATE.
Se estiver com o valor true → Cria o registro [Nome do Aplicativo] + [Domínio] + [Nome da Máquina] EX: RM.EXE_BH01_TESTE.
Fim do Fluxo → Fim do CreateFile();
5) Inicio do Fluxo → Verifica o Registro [Nome do Aplicativo - Principal (Sem múltiplos hosts)] + "Todos" + "Default"; EX: RM.EXE_TODOS_DEFAULT.
Caso o Registro exista →
- Cria o registro [Nome do Aplicativo] + [Domínio] + "Default"; EX: RM.EXE_BH01_DEFAULT.
- Save(); //Salva as alterações no registro.
- Verifica a tag CONFIGAUTOGENERATE.
Se estiver com o valor true → Cria o registro [Nome do Aplicativo] + [Domínio] + [Nome da Máquina] EX: RM.EXE_BH01_TESTE.
Fim do Fluxo → Fim do CreateFile();
6) Inicio do Fluxo → Verifica o Registro "RM" + "Todos" + "Default"; EX: RM_TODOS_DEFAULT.
Caso o Registro exista →
- Cria o registro [Nome do Aplicativo] + [Domínio] + "Default"; EX: RM.EXE_BH01_DEFAULT.
- Save(); //Salva as alterações no registro.
- Verifica a tag CONFIGAUTOGENERATE.
Se estiver com o valor true → Cria o registro [Nome do Aplicativo] + [Domínio] + [Nome da Máquina] EX: RM.EXE_BH01_TESTE.
Se estiver com o valor false → Levanta uma exceção ao Usuário (REGISTERNOTFOUND).
Fim do Fluxo → Fim do CreateFile();
O arquivo "Configuracaorm.config" armazenará as configurações de cada aplicativo. Para cada primeiro acesso, será inserido um novo registro com as configurações padrões referente à aplicação acessada.
É necessário que o arquivo "Configuracaorm.config" possua um registro padrão contendo as configurações desejadas, para cada aplicativo a ser utilizado.
Exemplo:
Para o aplicativo RM.exe, executado no domínio BH01, será respeitada a seguinte identificação:
RM.exe_BH01_DEFAULT onde default será o padrão de configuração para todos os novos registros de aplicativos RM.exe que estiverem do domínio BH01, respeitando a nomenclatura da opção Novo Registro.
Exemplo de Registro Padrão:
<RM.EXE_BH01_DEFAULT> <appSettings> <add key="JOBSERVER3CAMADAS" value="True" /> <add key="PORT" value="8050" /> <add key="HOST" value="localhost" /> <add key="LibPath" value="C:\RM.Net_Atual\Bin" /> <add key="CONFIGAUTOGENERATE" value="True" /> </appSettings> </RM.EXE_BH01_DEFAULT>
Observações:
Observações:
Lembrando que o CONFIGAUTOGENERATE cria um novo registro baseado nas estações de trabalho, outros registros podem ser criados independente da tag estar "true" ou "false", como um exemplo, o registro RM.EXE.BH01.DEFAULT.
Alterar o valor do CONFIGAUTOGENERATE, aplica-se apenas aos registros baseados nas estações de trabalho. Por exemplo, alterando o valor de "true" para "false" fará com que apenas os registros das estações de trabalho não sejam criados.
O novo registro será inserido levando em consideração as configurações do Registro Padrão e respeitando a seguinte identificação:
Nome do aplicativo + _ + Domínio do usuário + _ + Nome da máquina
Exemplo:
- Nome do aplicativo: RM.EXE
- Domínio do usuário: BH01
- Nome da máquina: Teste
Como ficará o novo registro no arquivo:
<RM.EXE_BH01_Teste> <appSettings> <add key="JOBSERVER3CAMADAS" value="True" /> <add key="PORT" value="8050" /> <add key="HOST" value="localhost" /> <add key="LibPath" value="C:\RM.Net_Atual\Bin" /> <add key="CONFIGAUTOGENERATE" value="True" /> </appSettings> </RM.EXE_BH01_Teste>
Observações:
Versão: 12.01.XX