Versões comparadas

Versão antiga 17

changes.mady.by.user Usuário desconhecido (alexandre.oliveira)

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Cassio Klafke Ferreira

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


ré

Pré-condições

Não há.


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


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 zip para criar a pasta  linx-integrador-idb-1.4.3  

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

Copie a pasta integrador-idb para c:\




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

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

pip install -r requirements.txt



4

- Rodando migrações de Banco de DadosAinda c:\integrador

-

idb , execute o comando abaixo:

python manage.py migrate

5 – Configurando arquivo de parâmetros

Em c:\

Configurando arquivos de parâmetros

 

  • No diretório do integrador-idb, crie o arquivo “.env_temp”  executando o seguinte comanado:
  • Image Removed
         
  • temp” com as variáveis abaixo.

CRIANDO O ARQUIVO .ENV_TEMP pelo CMD.

No CMD, no diretório integrador-idb digitar ( echo > .env_temp Edite ) conforme imagem abaixo,   ele irá criar o arquivo .env_temp  copie as linhas a baixo 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    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


Informações
title1.7.0+

Para o integrador na versão 1.7.0 ou maior, os seguintes campos referente ao IDB precisam ser adicionado no final do arquivo .env_temp:


HEADER=
API_IDB_KEY=
API_IDB_URL=



Os valores de cada variável devem ser reatribuídos 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;


Informações
title1.7.0+

Para o integrador na versão 1.7.0 ou maior os campos devem ser retribuídos conforme informado abaixo:

  • O valor “chave” em API_KEY deve ser substituído pela chave da API do NFEIO;
  • O valor “https://api-test.leroymerlin.com.br/” em API_URL deve ser substituído pela correspondente url do NFEIO;
  • O valor em "HEADER" deve ser substituído pelo atributo usado pelo Endpoint de conexão com o IDB, ex: "apikey";
  • O valor “chave” em API_IDB_KEY deve ser substituído pela chave da API do IDB;
  • O valor em API_IDB_URL deve ser substituído pela correspondente url do IDB;
  •   login/senha@ip:porta/banco " em CX_ORACLE_URL a url do banco oracle que será consumido.


Execute no prompt do diretorio do integrador(c:\integrador-idb) execute o comando :

 python


                  python manage.

py 

py runscript criptografa_

configuracao 

Image Removed

   configuracao


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

Apague o arquivo .env_temp


Para descriptografar execute o comando :   python python manage.py py runscript descriptografa_configuracao

   O

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

  Abra o CMD  e acesse a pasta  c:\integrador-idb 

   Execute o comando abaixo:

Pelo prompt, na pasta do projeto, execute:

  • python manage.py createsuperuser

Image Removed

  • 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

acima

abaixo) para baixar.

Image RemovedImage Added


7.5

– Descompactar 

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

.zip dentro de c:\

) na raiz da pasta integrador-idb 

Image Removed



                                                   --INSTALANDO INTEGRADORINTERFACE—


7.6

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

Image Removed

7.7 -  Na Tela da interface do NSSM  digite as informações abaixo nos seguintes campos
 No campo path digitar :

–  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

 No

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

 No

7.11      – No campo Arguments digitar: manage.

py 

py runserver

Image Removed

 

7.

8

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
 No campo path digitar : 


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

 No

7.16  – No campo Startup directory digitar:

 

   C:\integrador-idb

 No

7.17      - No campo Arguments

digitar

 digitar :

 manage

manage.

py  runscript

pyrunscript run_integration

Image Removed

 

7.

12

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

Image Removed

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


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. 2 - Login (Login foi criado pelo Prompt no processo 6 do manual)

    Image Modified

    3. Entre com  os seguintes dados :
          Username = admin2
          Password=Leroy123



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

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


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 arquivos
  2. Copiar o arquivo  .ENV 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.
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)

Instalando o Python no windows

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

 Image Removed

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

Image Removed

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

Image Removed

  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.

Image Removed

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 zip para criar a pasta  linx-integrador-idb-1.4.3  

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

Copie a pasta integrador-idb para c:\

3 - Instalação de dependências Python

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):

pip install -r requirements.txt

4 - Rodando migrações de Banco de Dados

Ainda c:\integrador-idb , execute o comando abaixo:

python manage.py migrate

5 – Configurando arquivo de parâmetros

  • Em c:\integrador-idb, crie o arquivo “.env_temp”  executando o seguinte comanado:
  • Image Removed

          echo > .env_temp

 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 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(c:\integrador-idb) execute o comando :

  •  python manage.py runscript criptografa_configuracao 

Image Removed

   

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

  •    O arquivo .env_temp será criado com as variáveis descriptografadas.

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

  Abra o CMD  e acesse a pasta  c:\integrador-idb 

   Execute o comando abaixo:

  • python manage.py createsuperuser

Image Removed

  • 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 acima)

7.3 – Tela de download

Image Removed

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 Removed

Image Removed

7.6- Acesse a pasta c:\integrador-idb\nssm-2.24\win64

 nssm install IntegradorInterface

 execute o comando  nssm install IntegradorInterface

7.7 -  Tela da interface do NSSM

Image RemovedImage Removed

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

Image Removed

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

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

Image Removed

7.13 – Ir para o diretório win64 do nssm via prompt e executar o comando: nssm install Integrador
7.13 – Repetir o procedimento de 7.8 e 7.9

7.14 - No campo Arguments digitar : manage.py runscript run_integration

7.15 – Repetir o procedimento de 7.11

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://127.0.0.1:8000/admin/ 2. Login
Image Removed
  • Acessar o menu "Parâmetros"
    Image Removed
  • 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. 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:\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. 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:\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.