ATENÇÃO: Para garantir uma instalação bem-sucedida e sem complicações, recomendamos que este procedimento seja realizado sob a supervisão do nosso especializado time de Suporte Promob. Isso é crucial para prevenir incompatibilidades, instalação e configuração incorretas, bem como evitar possíveis duplicidades na instalação dos serviços do banco de dados. Contamos com a sua colaboração para assegurar o sucesso desse processo.

Entre em contato com o nosso suporte para obter assistência personalizada. Para obter suporte, verifique aqui nossos canais de atendimento.

Banco de Dados

Instalação do SQL Server

Configuração do Banco de Dados

Descrição dos campos

Limpeza Banco de Dados (Local/Servidor)

Situações de Conexão no Serviço DocumentDatabaseService

Situações Inesperadas

Reinstalação do Serviço

Instalação do Banco de Dados

1. No Promob onde será gerado as informações de Produção (tais como, desenhos, etiquetas e programas CNC), instale o Plugin ERP Promob.

2. Acesse a pasta onde o sistema esta instalado, exemplo: C:\Program Files\Promob\Promob Catalog\Program\bin

Esta pasta conterá, os 3 arquivos abaixo:

3. Localize o instalador de acordo com o idioma utilizado. Exemplo: para Português, utilize o instalador Procad.Builder.DocumentDatabaseService.PT_BR.msi

4. Escolha somente uma das opções abaixo:

Instalação em Servidor: Copie para o servidor, o arquivo de instalação desejado (por pen drive ou pela rede). Dê duplo clique sobre o instalador e inicie a instalação.
Instalação Local: Esta opção deve ser escolhida caso o cliente não tenha Servidor. Dê duplo clique sobre o instalador desejado e inicie a instalação.

IMPORTANTE: Para instalar basta clicar sempre em Avançar até finalizar o processo.

5. Após a instalação, acesse:

Windows 10: a aba Painel de Controle - Sistema e Segurança - Ferramentas Administrativas - Serviços .

Windows 11: a aba Painel de Controle - Sistema e Segurança - Ferramentas do Windows - Serviços.

Procure o serviço Promob.DocumentDatabaseService conforme a imagem abaixo, e clique em Parar.

6. Faça o download do SQL Server Compact 4.0. Extraia o arquivo SSCERuntime-ENU e instale o executável conforme o Windows.

Builder – Instalação do SQL Server

7. Caso não seja possível executar a instalação, faça o download do Microsoft .Net Framework 4.8 (Versão Full) e tente fazer o passo 4 novamente.

Microsoft .Net Framework 4.8

No Windows 10 não é necessário realizar essa verificação pois esse pacote é padrão de sistema.

8. Após realizar a instalação, localize novamente o Serviço (passo 5) e clique em Iniciar.

9. Realize a configuração do banco de dados.

Instalação do SQL Server

Disponível a partir da versão:

Plugin Builder 1.12.4 ou superior
Plugin Builder Budget 1.12.4 ou superior
DocumentDatabaseService 1.2.2 ou superior

Este é um procedimento de instalação da versão 4.0 SQL Server Compact Edition, esta versão é obrigatória para o funcionamento do DocumentDatabaseService corretamente.

Realize o download do arquivo SQL Server Compact 4.0.

Após extrair o conteúdo, haverá dois instaladores, portanto deve-se seguir os procedimentos conforme o sistema operacional do computador:

Sistemas Operacional 32 bits: Execute apenas o instalador “SSCERuntime_x86-ENU.msi”.
Sistemas Operacional 64 bits: Execute apenas o instalador “SSCERuntime_x64-ENU.msi”.

Assim, caso a instalação tenha sido feita na ordem incorreta, desinstale as duas versões, e instale-as na ordem correta.

Configuração de Banco de Dados

Disponível a partir da versão:

Plugin Builder Budget – 1.12.9.6 ou superior
Promob.DocumentDatabaseService – 1.2.4.0 ou superior

Através destas configurações informamos qual é o caminho do serviço de banco de dados.

Além disso é possível, se o serviço for local, alterar o caminho de gravação dos arquivos e o número de caracteres do nome dos arquivos gerados.

Para a configurar:

1. Acesse o menu Integradores e a opção de Configuração de banco de dados.

2. A seguinte tela é exibida:

Informações: ao posicionar o mouse sobre este ícone será exibido informações sobre a configuração específica.

Configurações: descrição da configuração.

Ambiente: Mostrará a Local ou Servidor, somente antes das configurações de diretórios, de acordo com o local do diretório definido.

Botões Abrir e Editar: Serão exibidos após os campos de configurações de diretório. Caso o Ambiente deste diretório não seja Local, o botão Abrir não será exibido.

Descrição dos campos

1. Configurações

Endereço do banco de dados: Endereço onde o serviço está instalado e em execução.
Para configurar o Banco Local: Digite localhost
Para configurar o Banco no Servidor: Digite http:// + o nome do computador do servidor. Exemplo: http://nomedoservidor

Após definir o endereço do serviço, clique em Testar conexão para testar a conexão com o serviço. Clique em OK para confirmar a alteração.

IMPORTANTE: Quando a instalação for feita no servidor e mesmo assim o teste de conexão não funcionar, peça ao administrador de redes verificar se a porta 27014 está liberada.

Caminho dos arquivos de configuração do serviço: Endereço de instalação do serviço onde se encontra o arquivo de configuração do serviço do banco de dados DatabaseService.cfg ou DatabaseService.json, dependendo da versão do serviço
Caminho do banco de dados (.sdf): Local onde o banco de dados (arquivo sdf) está salvo. Importante: Caso o local selecionado não tenha um arquivo de banco de dados, será criado um novo banco.

2. Configurações de Gravação do Serviço

Caminho de gravação dos arquivos: Diretório onde os arquivos: Desenhos, Programas de máquina e imagens serão salvos durante o processo de integração.

IMPORTANTE: Por convenção colocamos o diretório na pasta do ERP (para ser acessado por todos usuários do mesmo) e a chamamos de BancoBuilder. Caminho padrão: PromobERP\BancoBuilder.

Número de caracteres do nome dos arquivos gerados: Define quantos caracteres irão formar o nome dos arquivos gerados durante o processo de integração.

IMPORTANTE: Os 3 primeiros caracteres são a identificação do grupo e os demais referente ao código.

Exemplo: Informando 12, o código será BAS123456789.

3. Configuração de Backup do banco de dados

Caminho do backup do banco de dados (.sdf): Diretório onde será realizado o backup do arquivo do banco de dados “DocumentDatabase.sdf”.
Frequência de backup, em dias*: Define em dias, a frequência com que o backup será realizado.
Quantidade de backups salvos*: Define a quantidade de arquivos .sdf de backup que ficarão salvos na pasta de backup. Quando a quantidade configurada for atingida, o backup mais antigo será excluído e assim por diante.

Ao configurar os diretórios de arquivos, caso deseje selecionar um diretório em outro computador, não é possível utilizar pastas mapeadas (ex.: R:\\, S:\\), mas sim o caminho original começando com 2 barras invertidas (\\\\servidor\\...).

Caso o serviço não esteja na versão compatível com as informações, será exibida a mensagem Informação não disponível: Atualize o serviço nos campos.

IMPORTANTE: * Essas alterações só serão permitidas com senha.

Limpeza Banco de Dados (Local/Servidor)

1. Abra o Promob, acesse o Plugin ERP Promob, selecione Configurações de Banco de Dados e verifique onde esta instalado o Serviço.

IMPORTANTE: Os passos do 2 ao 6 devem ser feitos no computador onde está instalado o serviço. O passo 7 deve ser realizado onde está instalado o Plugin de Integração.

2. No computador onde esta instalado o Serviço DocumentDataBase, acesse Painel de Controle - Sistema e Segurança - Ferramentas Administrativas - Serviços. Localize o serviço conforme a imagem abaixo, e clique em Parar.

3. Acesse a pasta C:\Program Files (x86)\Procad\Document Database Service e exclua o arquivo Procad.Builder.DocumentDatabase.sdf;

4. Ainda na pasta C:\Program Files (x86)\Procad\Document Database Service. Abra o arquivo DatabaseService.cfg e verifique o caminho onde estão sendo geradas as informações de produção;

5. Localize a pasta criada pelo caminho do item 4, e exclua as pastas Desenho, Etiquetas e Programas (caso existam).

6. Após realizada a exclusão, acesse novamente até o Serviço (passo 1) e clique em Iniciar.

7. Abra o Promob e faça a configuração do banco de dados:

Banco de Dados Local: Digite o endereço: localhost;
Banco de Dados no Servidor: Digite o nome do computador do servidor;

Após definir o endereço do serviço, clique em Testar conexão para testar a conexão com o serviço. Clique em OK para confirmar a alteração.

IMPORTANTE: Este procedimento influenciará no ERP. Os produtos já importados e cadastrados dentro dele estão com as informações de Desenhos, Etiquetas e Programas com os nomes dos desenhos da pasta. Caso seja feita uma limpeza no Banco de Dados, é aconselhado que seja feita uma limpeza no ERP.

Situações de Conexão no Serviço DocumentDatabaseService

Verifique as possíveis situações que podem ocorrer na conexão entre o serviço DocumentDatabaseService e o Promob:

Formas de detecção

1. Servidor : No servidor (local onde esta instalado o serviço) acessar o browser e colocar o seguinte caminho. ( http://localhost:27014/Version ).

Caso o resultado for o acima citado (mudando a versão) significa que o serviço esta funcionando corretamente no servidor.

2. Local: No computador que tiver o Promob, acesse o browser e coloque o caminho do banco de dados (http://servidor:27014/Version), onde “servidor” é o nome ou ip do servidor. Caso der o mesmo resultado do servidor, significa que o computador tem acesso ao servidor.

Situações Inesperadas

Caso houver situações inesperadas na instalação/atualização do serviço, realize os seguintes procedimentos:

1. Servidor

Caso não for possível acessar a versão do serviço, esse não se encontra inicializado corretamente. O fato do serviço estar iniciado não significa que o mesmo esta funcionando perfeitamente.
Deve-se acessar o logs de eventos do Windows. (no Prompt de comando digitar eventvwr). Na tela do mesmo, acessar “Logs de Aplicativos e Serviços” e escolher a opção “DocumentDatabaseServiceLog”

Nessa tela será exibido o log do serviço, e o motivo do porque não estar inicializando.

As situações mais comuns para o serviço não funcionar perfeitamente, nesse caso são:

1. Não ter instalado o SQL Compact 4.0

Download

2. Local

Caso o serviço esteja funcionando no servidor e não é possível acessar na maquina que possui o Promob, deve-se observar os seguintes fatos:

Restrição de firewall do servidor: Nesse caso, devem-se criar regras de exceção para a porta 27014.
Restrição de firewall na máquina local: Nesse caso, devem-se criar regras de exceção para a porta 27014.
Restrição de antivírus: Observar se o antivírus possui algum bloqueio.

Reinstalação do Serviço

Ao tentar fazer a conexão com o serviço dentro do Promob, e o mesmo exibir a seguinte mensagem Não foi possível conectar ao servidor do banco de dados:

1. Para reinicializar o serviço você terá de ir até a aba Painel de Controle - Sistema e Segurança - Ferramentas Administrativas - Serviços . Procure o serviço (DocumentDataBase) conforme a imagem abaixo, e clique em Reiniciar.

2. Se mesmo reinicializando o serviço não for possível realizar a conexão certifique-se que o SQL Server Compact 4.0, está instalado corretamente no mesmo local onde o serviço está instalado.

Se necessário clique aqui para baixar o arquivo SQL Server Compact 4.0.

Instale o executável conforme o Windows que o cliente tem (caso o Windows seja 64bits, deve ser instalado antes o 32bits e depois o 64bits).

3. Faça o download do Microsoft .Net Framework 4.8 (Versão Full) e reinicialize o serviço e tente novamente a conexão.

4. Se mesmo com os passos acima não foi possível a conexão entre em contato com o Suporte Promob.