- Criado por Taisa Da Silva Lins, última alteração por Tiago Sousa Bezerra de Carvalho em jun 17, 2024
Você está vendo a versão antiga da página. Ver a versão atual.
Comparar com o atual Ver Histórico da Página
« Anterior Versão 22 Atual »
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”)
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 – 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
3 - Instalação de dependências Python
Na pasta integrador-idb, pelo cmd, 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 - 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.
- 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
1.7.0+
A partir da versão 1.7.0, os seguintes campos referente ao IDB precisam ser adicionados ao final do arquivo .env_temp:
HEADER=
API_IDB_KEY=
API_IDB_URL=
Os valores de cada variável devem ser 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-test.leroymerlin.com.br/” em API_URL deve ser substituído pela correspondente url do IDB e;
1.7.0+
A partir da versão 1.7.0, os campos devem ser configurados 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 manage.py runscript criptografa_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
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
7.2 – Selecionar a opção Download(marcada na figura abaixo)
7.3 – Tela de download
7.4 – Selecionar nssm(marcado na figura abaixo) para baixar.
7.5 – Descompactar o arquivo baixado, colocar a pasta descompactada (nssm-2.24) na raiz da pasta integrador-idb
--INSTALANDO INTEGRADORINTERFACE—
7.6 – Pelo prompt acessar a pasta NSSM-2.24 que esta localizada no integrador-idb e ir até a pasta win64.
7.7 - No prompt digitar o comando : nssm install IntegradorInterface
7.8 - Tela da interface do NSSM
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
7.12 – Clicar no botão Install service e o serviço será criado.
--INSTALANDO INTEGRADOR—
7.13 – Pelo prompt acessar a pasta NSSM-2.24 que esta localizada no integrador-idb e ir até a pasta win64.
7.14 E executar o comando: nssm install Integrador
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.py runscript run_integration
7.18 – Clicar no botão Install service e o serviço será criado.
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/
Ou http://localhost:8000/admin/
2 - Login (Login foi criado pelo Prompt no processo 6 do manual)
3. Acessar o menu "Parâmetros"- Selecionar “ADD PARAMETROS”
- 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
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.
- Sem rótulos