Conexão ao DBAccess via Connection String

Produto:

Microsiga Protheus

Versões:

12

Descrição:

A partir da LIB versão 20180616 e DBAccess versão 20171117-20180412, foi implementada uma melhoria que permite configurar a conexão entre o Protheus e o banco de dados através de uma tela wizard, sem precisar configurar as linhas no arquivo appserver.ini, nem alias no DBAccess, nem configurar ODBC. Para que essa configuração seja feita, siga os passos abaixo:


* O arquivo appserver.ini não pode ter a seção [DBAccess] nem as linhas DBAlias, DBServer, DBDatabase e DBPort na seção do [Ambiente].

* A melhoria está disponível apenas para os bancos de dados Oracle, MSSQL e Postgres, nas versões homologadas e dentro do seu ciclo de vida.


1. Remova as linhas de configuração do DBAccess do arquivo appserver.ini, conforme aviso acima;
2. Acesse o Protheus entrando em qualquer módulo;
3. Será exibida uma tela de Comunicação com o Banco de dados

DNS do servidor do DBAccess: Endereço IP do servidor onde está o Dbaccess
Porta do servidor do DBAccess: Porta que o DBAccess está iniciando
Banco de dados proprietário: Banco de dados que está sendo utilizado
Driver: Driver a ser utilizado para o banco de dados (Oracle não possui driver, deixar em branco)
Schema ou banco de dados: Nome da base de dados
DNS do servidor de banco de dados: Endereço IP do servidor onde está o banco de dados
- Para Oracle, é o endereço do servidor+porta+Service Name, encontrado no tnsname.ora:
P11A=
(DESCRIPTION =
(ADDRESS = (PROTOCOL = TCP)(HOST = VMFW66213.sp01.local)(PORT = 1521))
(CONNECT_DATA =
(SERVER = DEDICATED)
(SERVICE_NAME = orcl)

No exemplo acima, o DNS será : VMFW66213.sp01.local:1521/orcl
- Para MSSQLServer basta incluir o nome/endereço do servidor+porta
Ex.: SPON010114158\SQLEXPRESS:1433
- Para Postgres basta informar o endereço com porta.
Ex.: localhost:5433

Login do banco de dados: Usuário do banco de dados (dbo) que irá acessar o sistema. Importante: O usuário deve ter as permissões mínimas necessárias para acesso ao sistema e criação de usuários
Senha do banco de dados: Senha do usuário acima

4. Após configurar, clique em Validar conexão para testar se a configuração está correta. Caso positivo, será exibida uma janela Conexão realizada com sucesso.



5. Clique em Gravar para confirmar a configuração

6. A partir deste momento o sistema já está configurado e pronto para uso. Os dados da conexão foram gravados no arquivo appserver.ini, e esta tela de configuração não será mais apresentada.


Caso seja necessário alterar alguma informação após essa configuração inicial, deve-se editar diretamente no arquivo appserver.ini

O usuário dbo e a sua senha são gravadas no banco de dados, em uma tabela específica. Os dados são gravados criptografados e seu acesso somente é permitido por um usuário específico criado pelo Protheus (sysdba). Somente ele é capaz de ler a tabela e descriptografar os dados guardados. De posse do usuário e senha do banco, ele realiza as conexões do ERP.

A tela de wizard de conexão será exibida para cada ambiente que for acessado e que não tiver as linhas de configuração DB no arquivo appserver.ini