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.

1. https://pypi.org/
2. https://www.python.org/
3. https://www.oracle.com/
4. https://api-test.leroymerlin.com.br/
5. 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 Modified

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

Image Modified

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

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

1. Next em "Optional Features"
2. Em "Advanced Options", marque a opção "Install for all users"
3. 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

Image Removed

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 Removed

Descompact  o aquivo  linx-integrador-idb-1.4.3.zip na opção que cria uma pasta

Image Removed

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

Image Removed

2  – Criando o Diretório

Na raiz do C:\ criar o diretório integrador-idd.

E no diretório (pasta) colocar os arquivos do integrador nela, após dezipar.

OBS: Colocar direto na C:\integrador-idb e não deixar C:\integrador-idb\integrador-idb

 Image Added

3 - Instalação de dependências Python

Image Removed

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

pip install -r requirements.txt

4 -

Image Removed

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

• python manage.py migrate

5 – Configurando arquivo de parâmetros

Image Removed

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

Configurando arquivos de parâmetros

• No diretório do integrador-idb, crie o arquivo “.env_temp” com as variáveis abaixo.

CRIANDO O ARQUIVO .ENV_TEMP pelo CMD.

No CMD, no diretório integrador-idb digitar ( echo > .env_temp) conforme imagem abaixo,   ele irá criar o arquivo .env_temp no formato correto, se criar na mão direto na pasta, não irá funcionar.

Image Added

• Abra .env_temp e defina os variáveis das variáveis “API_KEY”, “API_URL” e “CX_ORACLE_URL” e o “ESQUEMA_IDB”.

conforme especificado:

API_KEY=

chave

API_URL=https://api-test.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_preprod

Os valores de cada variável devem ser retribuídos de acordo, onde:

• O  o valor “chave”  “chave” em API_KEY deve ser substituído pela chave da API do IDB;
• O  O valor “https://api-test.leroymerlin.com.br/” em API_URL deve ser substituído pela correspondente url do IDB e;

•   login/senha@ip:porta/banco " em CX_ORACLE_URL a url do banco oracle que será consumido.

Image Removed

   5.3 Acesso  diretório  Execute no prompt do diretorio do integrador(c:\integrador-idb e  execute ) execute o comando abaixo :

                  python manage.

py runscript criptografa_

Image Removed

   5.4  Será criado  configuracao

Em seguida o arquivo .env será criado com as variáveis criptografadas.

Apague o arquivo .env_temp

Para descriptografar execute o comando :

python manage.

py runscript descriptografa_configuracao

Em seguida o arquivo .env_temp será criado com as variáveis descriptografadas.

5 - Rodando migrações de Banco de Dados

Ainda pelo prompt, na pasta do projeto, execute:

python manage.py migrate

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

Image Removed

  Acesse o diretório  c:\integrador-idb  e execute o comando abaixo:

         python manage.py createsuperuser 

          Preencha Pelo prompt, na pasta do projeto, execute:

• python manage.py createsuperuser
• Preencher 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

Image Removed

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

Image Added

7.3 – Tela de download

Image Removed

7.4 – Selecionar nssm(marcado na figura

abaixo) para baixar.

Image RemovedImage Added

7.5

– Descompactar o arquivo baixado, colocar a pasta descompactada (nssm-2.24

) na raiz da pasta integrador-idb 

Image Removed

                                                   --INSTALANDO INTEGRADORINTERFACE—

7.6

•     nssm install IntegradorInterface

Image Removed

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

–  Pelo prompt acessar a pasta NSSM-2.24 que esta localizada no integrador-idb e ir até a pasta win64.

Image Added

7.7 -  No prompt digitar o comando : nssm install IntegradorInterface

Image Added

7.8 -  Tela da interface do NSSM

Image Added

7.9 –No campo path digitar :   C:\Python\Python39\python.exe

7.10  – No campo Startup directory digitar:   C:\integrador-idb

7.11      – No campo Arguments digitar: manage.

py runserver

Image Removed

7.

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

Image Removed

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

Image Removed

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

•    nssm install Integrador

Image Removed

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

                                                         --INSTALANDO INTEGRADOR—

7.13  – Pelo prompt acessar a pasta NSSM-2.24 que esta localizada no integrador-idb e ir até a pasta win64.

Image Added

7.14       E executar o comando: nssm install Integrador

Image Added

7.15  – No campo path digitar :   C:\Python\Python39\python.exe

7.16  – No campo Startup directory digitar:

   C:\integrador-idb

7.17      - No campo Arguments

 digitar :

_manage.

_pyrunscript run_integration

Image Removed

7.

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

Image Removed

.

8 - Rodando Servidor Django

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

ATUALIZANDO OS PARÂMETROS DO SERVIÇO

           1 -  O servidor do django estará disponível no endereço:http://127.0.0.1:8000/admin/

1. Ou    http://localhost:8000/admin/

   

2. 
   2 - Login (Login foi criado pelo Prompt no processo 6 do manual)
   
   Image Modified

Entre com  os seguintes dados :
      Username = admin2
      Password=Leroy123
Image Removed
Em Django administration   na opção ETL  Clique no botão   Add para entrar nas configurações de parâmetros
Image Removed
 

3. 
   

4. 
   3.  Acessar o menu "Parâmetros"
   Image Added

5. Selecionar “ADD PARAMETROS”
   Image Added
6. Criar parâmetros (formato de tempo: horas:minutos) e salvar
   

Image Removed

   5. Será exibida a mensagem de confirmação da criação do parâmetro.

1. Image Added

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 (Para versões anteriores 1.7.0)

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

1. Substituir arquivosSubstitua os arquivos da pasta de instalação anterior com os da nova versão do Integrador IDB 
2. Copiar o arquivo  .ENV e a pasta NSSM-2.24 do backup para a pasta de produção (c:\integrador-idb)
3. cd c:\integrado-idb
4. Rodar via CMD o comando python manage.py runscript descriptografa_configuracao
5. Editar arquivo .ENV_temp
6. Criar campos no fim do arquivo :
   HEADER=
   API_IDB_KEY=
   API_IDB_URL=
   Salvar e rodar o comando :  python manage.py runscript criptografa_configuracao
7. pip install -r requirements.txt
8. python manage.py migrate
9. inicializar os serviços do integrador.

ATUALIZANDO VERSÃO 

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

1. Substitua os arquivos da pasta de instalação anterior com os da nova versão do Integrador IDB 
2. Copiar o arquivo  .ENV e a pasta NSSM-2.24 do backup para a pasta de produção (c:\integradoridb\.env)
3. cd c:\integrado-idb
4. pip install -r requirements.txt
5. python manage.py migrate
6. inicializar os serviços do integrador.