- Criado por Stella Gleyse Macedo Vilaca, última alteração por Karina Dos Santos Costa em 25 jan, 2021
Índice
Objetivo
Introdução
Para utilizar o Smart Client com o Configurador Global, é necessário informar somente o endereço HTTP do servidor de aplicação ou o caminho do arquivo de configuração global no arquivo .config dos aplicativos, conforme exemplos abaixo.
Será necessário criar um arquivo de configuração unificada. Mais detalhes ao longo desta documentação.
Arquivo [Aplicação].config
Seu arquivo .config deverá conter somente o caminho do arquivo de configuração global. Essa informação estará na tag configpath. Onde, ENDEREÇOEXTERNO será substituído pelo endereço ou IP do servidor de aplicação onde o arquivo de configuração global está hospedado.
O Caminho do arquivo global configuracaorm.config deve estar definido na tag CONFIGPATH, no arquivo de configuração do seu aplicativo.
<add key="configpath" value="http://ENDEREÇOEXTERNO:8051/" />
O caminho pode ser definido de forma absoluta ou relativa.
Como exemplo, adicionamos o arquivo configuracaorm.config no caminho c:/RM/Atual/Release/bin/arquivo/configuracaorm.config
A forma absoluta é quando o caminho do arquivo é adicionado por completo:
<add key="configpath" value="c:/RM/Atual/Release/bin/arquivo" />
Na forma relativa, o caminho do arquivo é adicionado a partir do local de instalação do aplicativo:
<add key="configpath" value="./arquivo" />
O arquivo RM.EXE.Config terá o seguinte layout:
<?xml version="1.0"?> <configuration> <appSettings> <add key="configpath" value="c:/RM/Atual/Release/bin" /> </appSettings> </configuration>
Arquivo de Configuração Global ou Unificada
O configurador global tem capacidade de receber diferentes grupos de configuração, podendo ser divididos em aplicação, domínio e nome da máquina. O _ é utilizado para separa cada identificador desses grupos.
Por exemplo:
<RM.EXE_BH01.LOCAL_NOTEBOOK1> - Neste caso a configuração será aplicada para a aplicação RM.exe, domínio BH01.LOCAL e o computador NOTEBOOK1.
<RM.EXE_BH01.LOCAL_DEFAULT> - Neste caso a configuração será aplicada para a aplicação RM.exe, domínio BH01.LOCAL e qualquer máquina.
<RM.HOST.EXE_TODOS_DEFAULT> - Neste caso a configuração será aplicada para a aplicação RM.exe, qualquer domínio e qualquer computador.
<RM_TODOS_DEFAULT> - Neste caso a configuração será aplicada a qualquer aplicativo, domínio e máquina.
A configuração mais especifica sempre sobrepõe a configuração mais genérica, caso haja este cenário no arquivo de configuração global.
No exemplo acima, na tag <RM.EXE_BH01.LOCAL_DEFAULT>, foi definido que máquinas que estiverem no domínio BH01.LOCAL, acessarão o host localmente. A tag Host deve identificar o endereço da rede interna, onde o host responderá.
O arquivo deve conter também, os dados de conexão do host que será utilizado quando a conexão for feita por uma máquina fora do domínio especificado anteriormente:
No exemplo acima, na tag <RM_TODOS_DEFAULT>, foi definido que todas as máquinas que não estiverem no domínio BH01, acessarão o host de forma pública. A tag Host deve identificar o endereço IP onde o host responderá.
Lembre-se de alterar o nome do domínio no cabeçalho do arquivo de configuração unificada:
Observação:
O usuário do IIS e do Host precisa ter acesso ao arquivo de configuração global.
Acesse nos links abaixo os arquivos de configuração com configurações padrão que podem ser utilizado em qualquer instalação.
Produto: Framework
Versão: 12.01.XX
Processo: Configurar Totvs Update para acesso local e remoto
Status: Finalizado
Data: 11/01/2019