Conexão ao DBAccess via Connection String

O Protheus passa a contar com uma conexão mais ágil ao Banco de Dados, com uma configuração descomplicada. Se antes era necessário configurar a conexão no arquivo appserver.ini, alias no DBAccess e ODBC no Sistema Operacional, agora basta uma configuração inicial através de uma tela de wizard, e todas as informações necessárias serão automaticamente guardadas apenas no arquivo appserver.ini.

Importante:

* 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.


Para que essa configuração seja feita, siga os passos abaixo:

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.

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.


Aviso:

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.

Disponibilidade:

A partir da LIB versão 20180820 e DBAccess versão 20171117-20180412

Nota:

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