Execução de scripts do Python no Servidor AX

Solicite a um administrador do Analytics Exchange para carregar scripts do Python externos no diretório PYTHONPATH do Servidor AX e chame os scripts do Python dos scripts de análise para aproveitar os recursos orientados a objeto da linguagem de programação Python no servidor. Para preparar o ambiente do Servidor AX para executar os scripts do Python, você primeiro precisa instalar o Python, depois, definir a variável de ambiente PYTHONPATH.

Pré-requisitos

Para executar scripts do Python no Servidor AX, é necessário:

Instalar uma versão compatível da linguagem de script do Python em seu computador do Servidor AX.
Definir a variável de ambiente PYTHONPATH no Servidor AX.
No Analytics, crie um projeto para trabalhar e importe no Servidor AX.

Nota

Para obter ajuda para finalizar esses pré-requisitos, entre em contato com seu administrador do Analytics Exchange e consulte:

Criação de um script do Python

Depois de criar seu projeto do Analytics no Analytics, crie um script do Python que você possa chamar a partir de um script de análise.

Depois, entregue ao administrador do Analytics Exchange o arquivo do script para carregar no diretório PYTHONPATH da máquina que hospeda o Servidor AX antes de chamar o script do Python a partir de um script de análise. Quando o script de análise é executado no Servidor AX, o executável do Python procura o script no diretório PYTHONPATH, então ele precisa estar presente.

Exemplo de arquivo do Python

O seguinte arquivo do Python de exemplo contém um script trivial que usa uma expressão lambda para elevar um número à potência dele mesmo. Esse exemplo é para mostrar como os scripts do Python são executados no Servidor AX, e não como analisar os dados com o Python.

Nome do arquivo: lambda_exemplo.py

# minhaFunção eleva ao quadrado valor1 e retorna o valor
minhaFunção = lambda valor1: valor1**2

Criar um script do Analytics

Em seu projeto do Analytics, crie um novo script para usar como o script de análise executado no Servidor AX. Esse script faz o seguinte:

Abre uma tabela simples chamada py com um registro.
Você precisa abrir uma tabela para executar o comando GROUP no Analytics. Aqui, a tabela py é usada apenas para essa finalidade.
Percorre o loop 10 vezes e, em cada loop, executa o script do Python passando e incrementando o contador como um argumento e extraindo a saída para uma tabela de resultados.

Adição do cabeçalho da análise

Adicione as tags adequadas do cabeçalho de análise no início do script para que o script do Analytics possa ser executado no Servidor AX depois de importar seu aplicativo de análise:

COMMENT
//ANALYTIC Teste de integração Python  
 verificar integração do Python no Servidor AX
//DATA py
//DATA resultados
//RESULT TABLE resultados
END

Adição da lógica do script

SET SAFETY OFF
DEL ALL OK
CLOSE

OPEN py

GROUP
  ASSIGN v_máx = 11
  ASSIGN v_contador = 1
  LOOP WHILE v_contador < v_máx
     EXTRACT PYNUMERIC("lambda_exemplo,minhaFunção",0,v_contador) AS "Valor dos resultados" TO "resultados.fil"
     v_contador = v_contador + 1 
  END
END
CLOSE py

O script de análise completo

O script de análise completo que você executa no Servidor AX é assim:

COMMENT
//ANALYTIC Teste de integração Python  
 verificar integração do Python no Servidor AX
//DATA py
//DATA resultados
//RESULT TABLE resultados
END

SET SAFETY OFF
DEL ALL OK
CLOSE

OPEN py

GROUP
  ASSIGN v_máx = 11
  ASSIGN v_contador = 1
  LOOP WHILE v_contador < v_máx
     EXTRACT PYNUMERIC("lambda_exemplo,minhaFunção",0,v_contador) AS "Valor dos resultados" TO "resultados.fil"
     v_contador = v_contador + 1 
  END
END
CLOSE py

Importar o projeto do Analytics

Depois de criar o script da análise:

No Cliente AX, crie uma coleção e pasta para abrigar o projeto do Analytics.
Para importar o projeto:
1. Clique com o botão direito do mouse na pasta criada e selecione Importar.
2. Vá para o projeto do Analytics no seu computador, selecione o arquivo do projeto .acl e clique em Abrir.
  Nota
  Certifique-se de importar os arquivos de dados de origem para importar a tabela py com seu projeto do Analytics.

Explorador do servidor após a importação

nomeColeção
- nomePasta
  - Aplicativos de análise
    - nomeProjetoACL
      - nomeScriptAnálise
  - Dados
    - py
  - Arquivos relacionados

Execute o script de análise

No Explorador do Servidor do Cliente AX, clique com o botão direito do mouse no script de análise e selecione Executar. O script do Python é executado como parte do script de análise e você pode acessar a tabela de resultados no Cliente Web AX.