Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
ré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”)
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
EmImage Added
5.1. Acesse o diretório c:\integrador-idb, crie o arquivo “.env_temp” executando o seguinte
comanado: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.
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 | ||
---|---|---|
| ||
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:
pythonpython manage.py
createsuperuserImage Removed
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ênciasImage 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
- Marque a opção "Add Python to PATH"
- Clique em "Customize Installation"
Image Removed
- 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.
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 Removed
Image 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
- Acessar o menu "Parâmetros"
Image Removed
- Selecionar “ADD PARAMETROS”
Image Removed
- Criar parâmetros (formato de tempo: horas:minutos) e salvar
Image RemovedEm Django administration na opção ETL Clique no botão Add para entrar nas configurações de parâmetros
Image Added
- Criar parâmetros (formato de tempo: horas:minutos) e salvar
![](/download/thumbnails/230193587/image2021-7-28_11-57-39.png?version=1&modificationDate=1627484480735&api=v2)
Image Added
5. Será exibida a mensagem de confirmação da criação do parâmetro.
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.
...