Configuración de Python para uso con Analytics

Analytics le ofrece distintas opciones para integrar el lenguaje de programación de Python y los scripts de Python en sus flujos de trabajo de automatización y análisis de datos.

Área funcional de Analytics	Arquitectura de bits de Python	Versión de Python compatible	Método de configuración de Python
Comando Python de ACLScript (PYCOMMAND)	64-bit (recomendado) 32-bit	3.12.4 (probado) Otras versiones de Python probablemente funcionarán, pero no han sido probadas.	El cliente instala y configura Python por separado de Analytics Véase Configuración de Python para que admita el comando Python de ACLScript
Funciones de Python de ACLScript	32-bit	3.7.x o posterior	El cliente instala y configura Python por separado de Analytics Véase Configuración de Python para que admita las funciones de Python de ACLScript
Comandos de aprendizaje automático de ACLScript	32-bit	3.7.9	El cliente selecciona la instalación opcional de Python durante el proceso de instalación de Analytics Véase Instalar ACL para Windows

Configuración de Python para que admita el comando Python de ACLScript

Instalar y configurar Python para soportar el uso del comando Python de ACLScript (PYCOMMAND). El comando Python permite integrar a la perfección las secuencias de comandos de Analytics y Python, así como mover datos de un entorno a otro.

Instalar Python (64 bits o 32 bits)

1. Desde la página de descargas de Python, descargue una versión reciente de Python a su computadora o el servidor.

   El comando Python de ACLScript ha sido probado con Python 3.12.4. Otras versiones recientes de Python deberían funcionar, aunque no se garantiza que lo hagan.

2. En su computadora o el servidor, haga doble clic en el instalador de Python.

3. En el instalador, seleccione Utilizar privilegios de administrador al instalar py.exe.

4. Haga clic en Instalar ahora y siga las instrucciones que aparecen en la pantalla.

Agregue las rutas de las carpetas de Python a la variable de entorno PATH

Agregue dos rutas de carpetas para la instalación de Python a la variable de entorno PATH.

1. En la barra de tareas de Windows, busque en variables de entorno.

2. Seleccione Editar las variables de entorno del sistema.

   Aparece el cuadro de diálogo Propiedades del sistema.

3. En la ficha Avanzado, seleccione Variables de entorno.

   Aparece el cuadro de diálogo Variables de entorno.

4. En la lista Variables del sistema, seleccione Ruta y, a continuación, Editar.

   Aparece el cuadro de diálogo Editar variables de entorno.

5. Haga lo siguiente para agregar dos rutas de carpetas Python:

   1. Seleccione Nuevo y agregue esta ruta de carpeta (ubicación predeterminada de instalación de Python):

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

      Nota

      Si instaló Python en una ubicación diferente, especifique la ruta correcta a la carpeta que contiene el ejecutable de Python (python.exe).

   2. Seleccione la ruta recién agregada y utilice Subir para mover la ruta a la parte superior de la lista.

   3. Seleccione de nuevo Nuevo y agregue esta ruta de carpeta, modificada según sea necesario:

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

   4. Seleccione la segunda ruta agregada y utilice Subir para mover la ruta por debajo de la primera ruta agregada.

6. Para guardar los cambios, seleccione Aceptar en cada cuadro de diálogo:

   • Editar variable de entorno

   • Variables de entorno

   • Propiedades del sistema

7. Reinicie su computadora o el servidor para asegurarse de que las actualizaciones de la variable de entorno Ruta surtan efecto.

   Nota

   Dependiendo de su sistema operativo y entorno, puede que no sea necesario reiniciar. No obstante, si el siguiente conjunto de pasos no funciona, reinicie el ordenador o el servidor antes de volver a intentar los pasos.

Crear un entorno virtual de Python

1. Cree una carpeta de Windows para contener el entorno virtual de Python.

   Por ejemplo, C:\Python_ACL_integration.

2. Abra el símbolo del sistema de Windows y Ejecutar como administrador.

3. Escriba python.exe --version y pulse Intro.

   La versión de Python que ha instalado debe ser devuelto. Por ejemplo:
   Python 3.12.4.

   Si el comando no es reconocido por la línea de comandos de Windows, es posible que las actualizaciones de la variable de entorno Ruta no hayan surtido efecto. Reinicie su computadora o el servidor y vuelva a intentarlo.

4. Cambie a la carpeta que creó para el entorno virtual de Python.

   Por ejemplo, cd C:\Python_ACL_integration.

5. Para crear el entorno virtual de Python, introduzca este comando: python -m venv venv.

   El primer venv especifica que se utiliza el módulo venv de Python. El segundo venv nombra el entorno virtual. Puede especificar un nombre diferente para el entorno virtual si lo desea, pero asegúrese de que el nombre hace referencia obvia a un entorno virtual.

   Ahora debería tener una subcarpeta venv en la carpeta que creó para el entorno virtual de Python. Por ejemplo, C:\Python_ACL_integration\venv.

   Si la creación del entorno virtual de Python no se ha realizado correctamente, es posible que las actualizaciones de la variable de entorno Ruta no hayan surtido efecto. Reinicie su computadora o el servidor y vuelva a intentarlo.

6. Para activar el entorno virtual de Python, introduzca este comando: .\venv\Scripts\activate.

   La línea de comandos debería devolver la carpeta del entorno virtual precedida por (venv). Por ejemplo, (venv) c:\Python_ACL_integration>

7. Para instalar el módulo Pandas en el entorno virtual de Python, introduzca este comando: pip install pandas.

   Si la instalación de Pandas se realiza correctamente, el mensaje de la línea de comandos debería mostrar una línea final como:

   Instalado correctamente numpy-2.2.2 pandas-2.2.3 python-dateutil-2.9.0.post0 pytz-2024.2 six-1.17.0 tzdata-2025.1

Agregue la ruta del entorno virtual a las Opciones de Analytics

1. Abra Analytics.

2. Desde el menú principal de Analytics, seleccione Herramientas > Opciones.

3. Seleccione la ficha Sistema.

4. En el campo Ruta de Python, introduzca la ruta completa y el nombre de archivo del ejecutable de Python en el entorno virtual que acaba de crear.

   Por ejemplo, C:\Python_ACL_integration\venv\Scripts\python.exe

5. Haga clic en Aceptar para guardar los cambios.

Siguientes pasos

Si la instalación y configuración de Python, el entorno virtual y Pandas se ha realizado correctamente, está listo para probar la integración de Analytics y Python. Si desea obtener más información, consulte Integración de scripts de Python o Comando PYCOMMAND.

Configuración de Python para que admita las funciones de Python de ACLScript

Para configurar a Python para que funcione con Analytics, usted debe instalar una versión compatible de Python y agregar el ejecutable de Python a la variable de entorno PATH de su computadora. También debe ajustar las variables de entorno del sistema ACLPYTHONDLL y PYTHONPATH.

Cómo funciona

Para ejecutar los scripts de Python, Analytics debe ser capaz de invocar el ejecutable de Python y de encontrar los scripts que deban ejecutarse. Analytics usa la variable de entorno PATH para localizar Python y la variable de entorno PYTHONPATH para localizar los scripts.

Instalar Python (32 bits)

1. Desde la página de descargas de Python, descargue una de las siguientes versiones de Python en su computadora o servidor:
   • 3.7.x
   • 3.8.x
   • 3.9.x

   Nota

   Las versiones enumeradas de Python se han probado y verificado para que funcionen con Analytics o el Agente de Robots.

   Cualquier versión de Python desde la 3.7.x en adelante debería funcionar. Sin embargo, no se garantiza que funcionen versiones distintas a las enumeradas.

2. En su computadora o el servidor, haga doble clic en el instalador.
3. En el instalador, seleccione Agregar Python número_de_versión a RUTA.
4. Haga clic en Instalar y siga las instrucciones que aparecen en la pantalla.
5. Reinicie la computadora o el servidor antes de ejecutar los scripts de Python invocados en un script de Analytics.

Ajuste las variables de entorno ACLPYTHONDLL y PYTHONPATH

1. En la unidad C:\ del sistema operativo, cree una o más carpetas para alojar sus scripts de Python.

   Por ejemplo C:\python_scripts

2. Desde el sistema operativo, abra el cuadro de diálogo Propiedades del sistema y haga clic en Variables de entorno.
3. En la sección Variables del sistema, haga clic en Nuevo e ingrese las siguientes variables:

   Nombre de la variable	Valor de la variable
   PYTHONPATH	La ruta completa a las carpetas que creó para alojar los scripts de Python. Separe las rutas de varias carpetas con punto y coma. Ejemplo: C:\python_scripts;C:\dev;C:\tmp
   ACLPYTHONDLL	La ruta de acceso completa y el nombre de archivo del archivo DLL de Python en la carpeta de instalación de Python. Ejemplo: c:\python_install\python35.dll Nota Tras la instalación, Python agrega la DLL a la carpeta del sistema (c:\windows\system32\python35.dll) en lugar de a la carpeta de instalación. Debe copiar la DLL desde la carpeta del sistema a la carpeta de instalación y utilizar la ubicación de la carpeta de instalación como valor de la variable. Analytics o el Agente de Robots buscan la DLL en la carpeta de instalación de Python. Es posible que también deba quitar toda configuración de solo lectura de la carpeta de instalación.

4. Para guardar la variable, haga clic en Aceptar y luego en el cuadro de diálogo Propiedades del sistema, haga clic en Aceptar nuevamente.

Use Python en las funciones de Python de Analytics

Desde Analytics, use las funciones de Python de Analytics para invocar las funciones en los scripts incluidos en PYTHONPATH.AnalyticsAnalytics

Si desea obtener más información, consulte Python.