Instruções de Atualização

LIBERAR ACESSO ÀS SEGUINTES URLS

O acesso às seguintes URLs deve estar liberado pelo firewall da máquina local para que seja possível fazer o download das dependências do projeto, bem como sua execução.

PREPARANDO AMBIENTE

1 - Dependências

Siga Instant Client para Instalar Oracle caso não esteja instalado, instalar o (Versão 19.6, seguir etapas de manual no fim da página “Instalação do Instant Client para Microsoft Windows 64 bits”)

Em https://www.oracle.com/database/technologies/instant-client/winx64-64-

Localize a pasta onde foram feitos os arquivos, extraia basiclite para a para raiz C:, em seguida extraia sqlplus também para C: (ambos os arquivos ficarão na pasta C:\ instantclient_19_11)

Instalando o Python no windows

Baixe o instalador. Acesse o site oficial neste link e clique em download, como mostrado abaixo.

No executável baixado, clique com o botão direito e selecione a opção “Run as administrator”.

Marque a opção "Add Python to PATH"
Clique em "Customize Installation"

Next em "Optional Features"
Em "Advanced Options", marque a opção "Install for all users"
No campo "Customize install location", o seguinte caminho: C:\Python\Python39

Para verificar se a instalação do Python foi bem-sucedida, pesquise no menu iniciar por "cmd" e clique para abri-lo.

Digite o seguinte comando:

python --version

Este comando retornará a versão do python instalada.

pip --version

Esse comando retornará a versão do pip instalada (gerenciador de pacote do Python).

2- Instalando integrador IDB

Baixe do repositório /Produtos/LINX INTEGRADOR IDB/ a versão mais recente do integrador exemplo linx-integrador-idb-1.4.3.zip para a pasta c:\temp

Image Modified

Descompact o zip para criar a pasta linxaquivo linx-integrador-idb-1.4.3 .3.zip na opção que cria uma pasta

Image Added

Renomeei a pasta linx-integrador-idb-1.4.3 para para integrador-idb

Image Added

Copie a pasta pasta integrador-idb para cidb de C:\temp para C:\

3 - Instalação de dependências Python

Image Added

Acesse o diretório c:\integrador-idb , pelo cmd, digite o comando para instalar as dependências do projeto (arquivo requirements.txt pode ser visualizado dentro da pasta do projeto): e execute o seguinte o comando abaixo :

pip install -r requirements.txt

4 - Rodando migrações de Banco de Dados

Image Added

Ainda Acesse o diretório c:\integrador-idb pelo CMD, e execute o comando abaixo:

python manage.py migrate

5 – Configurando arquivo de parâmetros

Em

Image Added
5.1. Acesse o diretório c:\integrador-idb, crie o arquivo “.env_temp” executando o seguinte
comanado:
Image Removed
comando:    echo > .env_temp

Edite 5.2. Edite o arquivo .env_temp copie as linhas a baixo e defina os variáveis das variáveis “API_KEY”, “API_URL” e “CX_ORACLE_URL” conforme especificado:
API_KEY=chave
API_URL=https://api.leroymerlin.com.br/
CX_ORACLE_URL=login/senha@ip:porta/banco
API_ENDPOINT_CEP=v2/postal-codes
API_ENDPOINT_CNPJ=v1/partner/nfeio/legalentities/basicInfo
API_ENDPOINT_IE=v1/partner/nfeio/legalentities/stateTaxInfo/SP
API_ENDPOINT_GET_CLIENT=v2/idb/items
API_ENDPOINT_POST_CLIENT=v2/idb/items
API_ENDPOINT_UPDATE_CLIENT=v2/idb/items
ESQUEMA_IDB=lmbr_client

Os valores de cada variável devem ser reatribuídos retribuídos de acordo, onde:
O valor “chave” em API_KEY deve ser substituído pela chave da API do IDB;
O valor “https://api.leroymerlin.com.br/” em API_URL deve ser substituído pela correspondente url do IDB e;
O valor " login/senha@ip:porta/banco" em CX_ORACLE_URL a url do banco oracle que será consumido.
Execute no prompt do diretorio do integrador(

Image Added
5.3 Acesso diretório  c:\integrador-idb ) execute e  execute o comando abaixo :
python
python manage.py runscript criptografa_configuracao

Image Modified
Em seguida 5.4 Será criado o arquivo .env será criado com as variáveis criptografadas.Apague o

Nota
title Nota
O arquivo .env_temp deverá ser excluido
Para descriptografar execute o comando : python manage.py runscript descriptografa_configuracao
O arquivo .env_temp será criado com as variáveis descriptografadas
.

6 - Criando usuário com status de superuser do Servidor

Image Added

Abra o CMD e acesse a pasta Acesse o diretório c:\integrador-idb Execute e execute o comando abaixo:

python

python manage.py

createsuperuser

Image Removed

Preencher

createsuperuser

Preencha as informações de login, email e senha. (admin2, [email protected], Leroy123)

7 – Criando os serviços

7.1 – Acessar o site http://nssm.cc

7.2 – Selecionar a opção Download(marcada na figura acima)

7.3 – Tela de download

7.4 – Selecionar nssm (marcado na figura acima) para baixar.

7.5 – Descompactar o arquivo nssm-2.24.zip dentro de c:\integrador-idb

Image Modified

7.6 - Acesse o diretorio c:\integrador-idb\nssm-2.24\win64 via CMD e execute o comando abaixo

nssm install IntegradorInterface

7.7 - Na Tela da interface do NSSM digite as informações abaixo nos seguintes campos

No campo path digitar : C:\Python\Python39\python.exe
No campo Startup directory digitar : C:\integrador-idb
No campo Arguments digitar : manage.py runserver

Image Modified

7.8 – Clicar no botão Install service e o serviço será criado.

7.9 - Inicialize o serviço através do Serviço do Windows

Image Modified

7.10 – Acesse o diretório c:\integrador-idb\nssm-2.24\win64 via CMD e execute o comando abaixo

nssm install Integrador

7.11 - Na Tela da interface do NSSM digite as informações abaixo nos seguintes campos

No campo path digitar : C:\Python\Python39\python.exe
No campo Startup directory digitar : C:\integrador-idb
No campo Arguments digitar : manage.py runscript run_integration

7.12 –Clicar no botão Install service e o serviço será criado.

Image Modified

7.13-Inicialize o serviço através do Serviço do Windows

8 - Rodando Servidor Django

Inicializar o serviço IntegradorInterface na aba de serviços do windows.

ATUALIZANDO OS PARÂMETROS DO SERVIÇO

O servidor do django estará disponível no endereço:http://localhost:8000/admin/
Entre com os seguintes dados :
Username = admin2
Password=Leroy123
Acessar o menu "Parâmetros"
Selecionar “ADD PARAMETROS”
Image Removed
Criar parâmetros (formato de tempo: horas:minutos) e salvar
Image Removed

9 - Rodando o script de execução da Integração

Inicializar o serviço Integrador na aba de serviços do windows.

CONSULTANDO LOG DO SISTEMA

Dentro da pasta do serviço haverá um arquivo ‘integrador.log’, onde estará os logs do sistema

ATUALIZANDO VERSÃO

1) Parar a aplicação (pare os serviços IntegradorInterface e Integrador)

Substituir arquivos
Copiar o arquivo .ENV do backup para a pasta de produção (c:\integradoridb\.env)
cd c:\integrado-idb
pip install -r requirements.txt
python manage.py migrate
inicializar os serviços do integrador.

Pré-condições

Não há.

Instruções de Atualização

LIBERAR ACESSO ÀS SEGUINTES URLS

O acesso às seguintes URLs deve estar liberado pelo firewall da máquina local para que seja possível fazer o download das dependências do projeto, bem como sua execução.

https://pypi.org /https://www.python.org /https://www.oracle.com /https://api-test.leroymerlin.com.br/https://support.microsoft.com /

PREPARANDO AMBIENTE

1 - Dependências

Siga Instant Clientpara Instalar Oracle caso não esteja instalado, instalar o (Versão 19.6, seguir etapas de manual no fim da página “Instalação do Instant Client para Microsoft Windows 64 bits”)

Image Removed

Em https://www.oracle.com/database/technologies/instant-client/winx64-64-

Image Removed

Localize a pasta onde foram feitos os arquivos, extraia basiclite para a para raiz C:, em seguida extraia sqlplus também para C: (ambos os arquivos ficarão na pasta C:\ instantclient_19_11)