Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
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.
- 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 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”.
- 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
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 o seguinte o comando abaixo : digite o 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 -
Rodando migrações de Banco de DadosImage 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
5.2. Edite o arquivo .env_temp copie as linhas a baixoConfigurando 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=
chavechave
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 | ||
---|---|---|
| ||
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:
|
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;
Informações | ||
---|---|---|
| ||
Para o integrador na versão 1.7.0 ou maior os campos devem ser retribuídos conforme informado abaixo:
|
- 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 :
pythonpython manage.
pypy runscript criptografa_
configuracaoImage Removed
5.4 Será criado configuracao
Em seguida o arquivo .env será criado com as variáveis criptografadas.
title | Nota |
---|
Apague o arquivo .env_temp
deverá ser excluidoPara descriptografar execute o comando :
pythonpython manage.
pypy runscript descriptografa_configuracao
OEm 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
![](/download/attachments/230193587/image2021-7-28_11-55-43.png?version=1&modificationDate=1627484480805&api=v2)
7.2 – Selecionar a opção Download(marcada na figura acimaabaixo)
Image Added
7.3 – Tela de download
![](/download/attachments/230193587/image2021-7-28_11-56-27.png?version=1&modificationDate=1627484480787&api=v2)
7.4 – Selecionar nssm(marcado na figura
acimaabaixo) para baixar.
Image Removed
Image 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
--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
No7.10 – No campo Startup directory digitar: C:\integrador-idb
No7.11 – No campo Arguments digitar: manage.
pypy runserver
7.
812 – 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
No7.16 – No campo Startup directory digitar:
C:\integrador-idb
No7.17 - No campo Arguments
digitardigitar :
managemanage.
py runscriptpyrunscript run_integration
7.
1218 – Clicar no botão Install service e o serviço será criado.
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/
2 - Login (Login foi criado pelo Prompt no processo 6 do manual)Image Modified
Entre com os seguintes dados :
3. Acessar o menu "Parâmetros"Image Added
- Selecionar “ADD PARAMETROS”
Image Added
- Criar parâmetros (formato de tempo: horas:minutos) e salvar
Username = admin2
Password=Leroy123
![](/download/attachments/230193587/image2021-7-28_11-59-1.png?version=1&modificationDate=1627484480718&api=v2)
Em Django administration na opção ETL Clique no botão Add para entrar nas configurações de parâmetros
Image Removed
5. Será exibida a mensagem de confirmação da criação do parâmetro.
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
Image Removed
Acesse a pasta C:\integrador-idb onde será localizado o arquivo ‘integrador.log’ .
ATUALIZANDO VERSÃODentro 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)
- Substitua os arquivos da pasta de instalação anterior com os da nova versão do Integrador IDB
- Copiar o arquivo .ENV e a pasta NSSM-2.24 do backup para a pasta de produção (c:\integrador-idb)
- cd c:\integrado-idb
- Rodar via CMD o comando python manage.py runscript descriptografa_configuracao
- Editar arquivo .ENV_temp
- Criar campos no fim do arquivo :
HEADER=
API_IDB_KEY=
API_IDB_URL=
Salvar e rodar o comando : python manage.py runscript criptografa_configuracao - pip install -r requirements.txt
- python manage.py migrate
- inicializar os serviços do integrador.
ATUALIZANDO VERSÃO
1) Parar a aplicação (pare os serviços IntegradorInterface e Integrador)
- Substituir arquivosSubstitua os arquivos da pasta de instalação anterior com os da nova versão do Integrador IDB
- Copiar o arquivo .ENV e a pasta NSSM-2.24 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.