Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
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.
Dica | ||
---|---|---|
| ||
* 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. |
Informações | ||
---|---|---|
| ||
A partir da LIB versão 20180616 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 |