B1PlusLog - Processo de Instalação do addon

Processo de Instalação add-on B1PlusLog©

O primeiro passo para o processo de instalação do addon e termos o arquivo de instalação. A última versão disponível ficará no portal de chamados da Lago Consultoria, no menu serviços e na sessão de downloads, conforme figura abaixo:

Figura: Sessão de downloads portal Lago.

Feito o download do instalador, podemos salvar em uma pasta no servidor que terá a atualização ou até mesmo em uma máquina com o Sap Business One© instalado e que tenha acesso a conexão com o servidor onde o banco de dados Sap Business One© está instalado:.

Podemos observar dois arquivos, sendo o executável para instalar o addon e pasta 'LagoPlusWMS' contendo os arquivos do portal WMS que iremos comentar em outro manual.

Após salvar o arquivo de instalação, será necessário executar o mesmo. Indicamos que seja executado como administrador. Siga os passos do instalador clicando no botão NEXT. Em uma das etapas, indique uma pasta onde os arquivos de instalação serão salvos.

⚠️Atenção: Essa pasta será muito importante para validar os logs de instalação e selecionar o arquivo de registro na próxima etapa. Recomenda-se anotar o caminho indicado. Essa pasta deve ser acessível na máquina a qual faremos o registro do add-on B1PlusLog©, seguindo a figura de exemplo abaixo:

Figura: Indicação de caminho para salvar os arquivos de instalação do add-on.

Assim que finalizar todas as etapas acima descritas e ter clicado no NEXT, abrirá a tela abaixo para que seja executado o criador de tabelas do add-on B1PlusLog©:

Figura: Tela inicial do criador de tabelas do add-on.

Ao clicar em seguinte teremos que inserir as informações do servidor do cliente, que poderá ser SQL ou HANA. Caso o banco de dados seja SQL, será necessário informar o IP ou nome do servidor ao qual o Sap Business One© está instalado, usuário e senha com acesso a criação de tabelas, campos, views e procedures e qual a versão do SQL Server instalado:

Figura: Tela de configuração de acesso para execução do criador de tabelas SQL.

Caso o banco de dados seja HANA, escolheremos a versão de banco de dados HANADB e indicaremos se o HANA é versão 2.0 ou não. Atualmente, a maioria dos clientes HANA é versão 2.0. Feito isso, deveremos indicar o IP de conexão ao banco de dados, com acesso a criação de tabelas, campos, views e procedures e o tenant da instalação HANA. Atenção ao HANA, que é case sensitive, o que significa que o nome de usuário deve ter letras maiúsculas e minúsculas idênticas ao cadastro de usuários do banco de dados HANA:

Figura: Tela de configuração de acesso para execução do criador de tabelas HANA.

Para termos a certeza do banco de dados, ao abrir o Sap Business One© em uma máquina cliente e clicar em selecionar empresa, temos o tipo do banco de dados e o nome do servidor para usarmos, cabendo a equipe de TI que fez a instalação do banco de dados indicar o usuário e senha para instalação. Para o HANA 2.0 o Tenant é o caminho exato do Current Server ao selecionar empresas no cliente do Sap Business One© e o banco de dados deve ser inserido apenas o IP e a porta do Hana:

Figura: Identificação de tipo de banco de dados ao selecionar empresa.

Em seguida, após indicar os dados do servidor e clicar em seguinte, será necessário escolher uma ou mais bases para a criação de campos, views e procedures do addon. Aqui deve ser um usuário com licença professional e super usuário cadastrado e ativo no Sap Business One©. Deve também ser indicado o numero da instalação e a licença que foi gerada pela equipe Lago Consultoria para o uso do addon B1PlusLog©. Ao indicar todos os dados, o addon fará a validação e indicará se a base está preparada ou emitirá um erro indicando o problema, que pode ser usuário e senha errados ou licença inválida.

⚠️ Atenção: A licença sempre é gerada por número de instalação e não pode ser usada em outros servidores:

Figura: Seleção de banco de dados para criação de estrutura do add-on.

Figura: Indicação de dados de usuário Sap Business One© e licença add-on B1plus©

Para que possamos saber o número da instalação, basta acessar o Sap Business One© e, no menu 'Ajuda', clicar em 'Sobre'. Abrirá uma tela com os dados de instalação. Será necessário usar o número da instalação:

Figura: Acesso ao número de instalação no Sap Business One©.

Figura: Dados de instalação do Sap Business One©.

Seguindo a instalação, após validados os dados de acesso no Sap Business One©, clicaremos em 'Executar', demonstrado abaixo.

Figura: Tela de execução para criação da estrutura do addon.

⚠️ Atenção: Esse processo irá criar novas estruturas no Sap Business One© e irá derrubar os processos e telas de usuários conectados, gerando a mensagem da imagem abaixo. Caso usuário não cliquem em sim, poderá ter problemas com os documentos e cadastros, corrompendo os dados e sendo necessário refazer o processo. É importante e essencial que todos os usuários tenham desconectado do Sap Business One©:

Figura: Mensagem de modificação de banco de dados ao usuário conectado durante o processo.

Após clicar em executar, teremos a barra de evolução da criação das estruturas. Nesse momento, não interromper o processo. Em alguns casos, caso a memória do servidor tenha muita concorrência ou foram selecionadas muitas bases, esse processo pode demorar. É necessário aguardar até que tenham a tela da seguinte maneira:

Figura: Tela indicando finalização da execução de criação de estrutura de add-on.

⚠️Atenção: É boa prática clicar em exibir log e verificar se é demonstrado algum erro no processo. É no log que podemos verificar se houve alguma falha e reportar á equipe de suporte da Lago Consultoria. Teremos mensagens de SUCESSO, AVISO e ERRO. Reportar apenas quando houver erros. Existirá um arquivo de log para cada empresa:

Figura: Log de criação de estrutura e instalação do addon.

O log ficará salvo, criando uma pasta para cada base, na pasta indicada inicialmente ao executar o arquivo de instalação do addon:

Figura: Pasta de log de instalação do addon.

Feito isso, pode ser encerrado o processo e a instalação e criação de estrutura terá sido finalizada, partindo agora para o registro do add-on no Sap Business One©. Na pasta que foi criada durante o processo de instalação existirá uma subpasta com as notas da versão. É nesse documento que serão listadas as correções e melhorias da versão instalada:

⚠️Atenção: Durante o processo de instalação do criador de tabelas é possível que se esgote a memória disponível do host que está sendo usado para executar o processo, isso fará com que o log seja armazenado pela metade e não conclua para uma ou mais bases de dados. Em primeiras instalações é sugerido que seja executada uma base por vez.