Configuração do Python para uso com o Analytics

O Analytics oferece diferentes opções de integração da linguagem de programação Python e o script do Python com seus fluxos de trabalho de automação e análise de dados.

Área funcional do Analytics	Número de bits do Python necessário	Versão do Python compatível	Método de configuração do Python
Comando ACLScript Python (PYCOMMAND)	64 bits (recomendado) 32 bits	3.12.4 (testado) Outras versões do Python não foram testadas, mas provavelmente funcionarão.	O cliente instala e configura o Python separadamente do Analytics Ver Configuração do Python para compatibilidade com o comando ACLScript Python
Funções do ACLScript Python	32 bits	3.7.x ou mais recente	O cliente instala e configura o Python separadamente do Analytics Ver Configuração do Python para compatibilidade com as funções do ACLScript Python
Comandos de aprendizado de máquina do ACLScript	32 bits	3.7.9	O cliente seleciona a instalação opcional do Python durante o processo de instalação do Analytics Ver Instalar o ACL para Windows

Configuração do Python para compatibilidade com o comando ACLScript Python

Instale e configure o Python para ser compatível com o uso do comando ACLScript Python (PYCOMMAND). O comando Python permite que você integre perfeitamente os scripts do Analytics e do Python e movimente dados entre os dois ambientes.

Instale o Python (64 bits ou 32 bits)

1. Na página de downloads do Python, baixe uma versão recente do Python para seu computador ou servidor.

   O comando ACLScript Python foi testado com Python 3.12.4. Não há garantias de que outras versões do Python funcionem, mas existe a possibilidade.

2. No computador ou servidor, clique duas vezes no arquivo de instalação do Python.

3. No instalador, selecione Usar privilégios de administrador ao instalar py.exe.

4. Clique em Instalar agora e siga as instruções na tela.

Adicione os caminhos da pasta do Python à variável de ambiente PATH

Adicione dois caminhos de pasta para a instalação do Python à variável de ambiente PATH.

1. Na barra de ferramentas do Windows, pesquise por variáveis de ambiente.

2. Selecione Editar as variáveis ​​de ambiente do sistema.

   A caixa de diálogo Propriedades do Sistema é exibida.

3. Na guia Avançado, selecione Variáveis ​​de ambiente.

   A caixa de diálogo Variáveis ​​de ambienteé exibida.

4. Na lista Variáveis ​​do sistema, selecione Caminho e selecione Editar.

   A caixa de diálogo Editar variável ​​de ambiente é exibida.

5. Para adicionar dois caminhos de pasta Python, faça o seguinte:

   1. Selecione Novo e adicione esse caminho de pasta (local de instalação padrão do Python):

      C:\Users\<USER>\AppData\Local\Programs\Python\Python<version>\

      Nota

      Se você instalou o Python em um local diferente, especifique o caminho correto para a pasta que contém o executável do Python (python.exe).

   2. Selecione o caminho recém-adicionado e use Mover para cima para mover o caminho para o topo da lista.

   3. Selecione Novo mais uma vez e adicione esse caminho de pasta, fazendo as alterações necessárias:

      C:\Users\<USER>\AppData\Local\Programs\Python\Python<version>\Scripts

   4. Selecione o segundo caminho adicionado e use Mover para cima para mover o caminho para baixo do primeiro caminho adicionado.

6. Para salvar suas alterações, selecione OK em cada caixa de diálogo:

   • Edite a variável de ambiente

   • Variáveis de ambiente

   • Propriedades do sistema

7. Reinicie o computador ou o servidor para garantir que as atualizações na variável de ambiente Path entrem em vigor.

   Nota

   Pode não ser necessário reiniciar, dependendo do seu sistema operacional e do ambiente. No entanto, se o próximo conjunto de etapas não funcionar, reinicie o computador ou o servidor antes de tentar executar as etapas novamente.

Crie um ambiente virtual do Python

1. Crie uma pasta do Windows para colocar o ambiente virtual do Python.

   Por exemplo, C:\Python_ACL_integração.

2. Abra um prompt de comando do Windows e Executar como administrador.

3. Digite python.exe --version e aperte Enter.

   A versão do Python que você instalou deve ser retornada. Por exemplo:
   Python 3.12.4.

   Se o comando não for reconhecido pelo prompt de comando do Windows, suas atualizações na variável de ambiente Path podem não ter estar em vigor. Reinicie o computador ou o servidor e tente novamente.

4. Mude para a pasta que você criou para o ambiente virtual do Python.

   Por exemplo, cd C:\Python_ACL_integração.

5. Para criar o ambiente virtual do Python, digite este comando: python -m venv venv.

   O primeiro venv especifica que o módulo venv do Python é usado. O segundo venv nomeia o ambiente virtual. Se desejar, você pode especificar um nome diferente para o ambiente virtual, mas certifique-se de que o nome faça uma referência óbvia a um ambiente virtual.

   Agora você deve ter uma subpasta venv na pasta que criou para o ambiente virtual do Python. Por exemplo, C:\Python_ACL_integration\venv.

   Se a criação do ambiente virtual do Python não foi bem-sucedida, suas atualizações na variável de ambiente Path podem não estar em vigor. Reinicie o computador ou o servidor e tente novamente.

6. Para ativar o ambiente virtual do Python, digite este comando: .\venv\Scripts\activate.

   O prompt de comando deve retornar a pasta do ambiente virtual precedida por (venv). Por exemplo, (venv) c:\Python_ACL_integração>

7. Para instalar o módulo Pandas no ambiente virtual do Python, digite este comando: pip install pandas.

   Se a instalação do Pandas for bem-sucedida, a mensagem do prompt de comando deverá mostrar uma linha final como:

   Instalação bem-sucedida numpy-2.2.2 pandas-2.2.3 python-dateutil-2.9.0.post0 pytz-2024.2 six-1.17.0 tzdata-2025.1

Adicione o caminho do ambiente virtual às Opções do Analytics

1. Abra o ACL Analytics.

2. No menu principal do Analytics, selecione Ferramentas > Opções.

3. Selecione a guia Sistema.

4. No campo Caminho do Python, digite o caminho completo e o nome do arquivo para o executável do Python no ambiente virtual que você acabou de criar.

   Por exemplo, C:\Python_ACL_integração\venv\Scripts\python.exe

5. Clique em OK para salvar suas alterações.

Próximas etapas

Se a instalação e a configuração do Python, do ambiente virtual e do Pandas foram bem-sucedidas, você está pronto para testar a integração do Analytics com o Python. Para obter mais informações, consulte Integrando scripts Python ou Comando PYCOMMAND.

Configuração do Python para compatibilidade com as funções do ACLScript Python

Para configurar o Python para uso com o Analytics, é necessário instalar uma versão compatível do Python e adicionar o executável do Python à variável de ambiente de sistema PATH. Também é necessário definir as variáveis de ambiente de sistema ACLPYTHONDLL e PYTHONPATH.

Como funciona?

Para executar scripts do Python, o Analytics deve ser capaz de chamar o executável do Python e encontrar os scripts que ele está instruído a executar. O Analytics usa a variável de ambiente PATH para localizar o Python e a variável de ambiente PYTHONPATH para localizar scripts.

Instale o Python (32 bits)

1. Na página Downloads Python, baixe uma das seguintes versões do Python no computador ou servidor:
   • 3.7.x
   • 3.8.x
   • 3.9.x

   Nota

   As versões listadas do Python foram testadas e verificadas como funcionais com o Analytics ou o Agente do Robôs.

   Qualquer versão do Python a partir da 3.7.x deve funcionar. No entanto, não garantimos que versões diferentes das listadas funcionem.

2. No computador ou servidor, clique duas vezes no arquivo de instalação.
3. No instalador, selecione Adicionar Python número_da_versão ao PATH.
4. Clique em Instalar e siga as instruções na tela.
5. Reinicie o computador ou o servidor antes de executar qualquer script do Python chamado por um script do Analytics.

Defina as variáveis de ambiente de sistema ACLPYTHONDLL e PYTHONPATH

1. Na unidade C:\ do sistema operacional, crie uma ou mais pastas para arquivar os scripts Python.

   Exemplo C:\python_scripts

2. No sistema operacional, abra a caixa de diálogo Propriedades do sistema e clique em Variáveis do Ambiente.
3. Na seção Variáveis do sistema, clique em Novo e insira as seguintes variáveis:

   Nome da variável	Valor da variável
   PYTHONPATH	O caminho completo para a(s) pasta(s) que criou para arquivar os scripts do Python. Separe vários caminhos de pasta com um ponto e vírgula. Exemplo: C:\python_scripts;C:\dev;C:\tmp
   ACLPYTHONDLL	O caminho completo e o nome do arquivo de DLL do Python na pasta de instalação do Python. Exemplo: c:\python_install\python35.dll Nota Na instalação, o Python adiciona a DLL à pasta de sistema (c:\windows\system32\python35.dll) em vez de adicionar à pasta de instalação. É necessário copiar a DLL da pasta do sistema para a pasta de instalação e usar a pasta de instalação como o valor da variável. O Analytics ou o Agente do Robôs procuram a DLL na pasta de instalação do Python. Você também pode precisar remover qualquer configuração somente leitura da pasta de instalação.

4. Para salvar a variável, clique em OK e na caixa de diálogo Propriedades do Sistema, clique em OK.

Use o Python em funções do Python do Analytics

No Analytics, use as funções do Python do Analytics para chamar funções dos scripts existentes no PYTHONPATH.

Para obter mais informações, consulte Python.