Páginas filhas
  • Conexão ao DBAccess via Connection String

Versões comparadas

Chave

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

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

Dica
titleImportante

...

:

* 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

Image Modified

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.

Image Modified


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.

...

titleAviso:

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
title

...

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.

Informações
title

...

Disponibilidade:

A

...

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

Nota
titleNota:

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