Centro de soporte de Workiva

Workiva Scripting ofrece un entorno flexible y seguro para ejecutar código Python en la plataforma Workiva. Este artículo cubre algunos de los escenarios más comunes que puedes encontrarte mientras construyes tu script.

Workiva Scripting se incluye con Customize Workiva. Para utilizar Scripting, tu espacio de trabajo debe tener activada la opción «Personalizar Workiva/Scripting», y los usuarios deberán disponer de los roles de Scripting adecuados y de los permisos de archivo correspondientes.

Para cuestiones que no se traten aquí, consulta nuestro artículo « » y otros artículos sobre scripting de Workiva en , o visita las comunidades de Workiva APIs en , y de scripting de Workiva en , .

Incidencias administrativas y de permisos

La acción Ejecutar script no aparece en Automatizaciones

La acción «Ejecutar script» solo está disponible para los usuarios que cuenten con el rol de scripting adecuado de . Ponte en contacto con el administrador de tu espacio de trabajo para que te asigne el rol necesario. Si el rol ya está asignado y la acción sigue sin estar disponible, ponte en contacto con el servicio de asistencia de Workiva.

El conector de Workiva Scripting no está disponible en Cadenas

Esto indica que el conector de Workiva Scripting no se ha habilitado para tu espacio de trabajo. Si crees que debería estar activada y no lo está, ponte en contacto con el equipo de atención al cliente de Workiva.

El Administrador del Espacio de Trabajo no puede ver ningún rol de script.

Esto indica que la función de script no se ha activado para tu espacio de trabajo. Si crees que debería estar activada y no lo está, ponte en contacto con el equipo de atención al cliente de Workiva.

Incidencias con los conectores y comandos de Workiva Scripting (cadenas)

Se inicia la ejecución del comando pero no se ejecuta el script

Verifica que se ha activado la función de script para tu espacio de trabajo. Si crees que debería estar activada y no lo está, ponte en contacto con el equipo de atención al cliente de Workiva.

Si has confirmado que el script está activado, es posible que el usuario de integración para el conector Workiva Scripting no tenga asignado el rol necesario. Ponerse en contacto con el Administrador del espacio de trabajo para asignar un rol apropiado Scripting. También debes verificar que el usuario de integración tiene permiso para acceder al script disparado por el comando.

La ejecución del comando sigue en progreso, pero la ejecución del script se detiene inesperadamente

Si la cadena de comandos sigue ejecutándose después de que el script se haya detenido, comprueba lo siguiente:

• Comprueba si la carrera se ha cancelado:  

  El historial de ejecuciones está disponible en el panel «Propiedades» del Editor de scripts y a través de GET /scripts/{scriptId}/runs o GET /scripts/{scriptId}/runs/{runId} . Las solicitudes a la API requieren el ámbito « script:read» y deben incluir « », «X-Version: 2026-01-01» . 

  Para obtener instrucciones sobre cómo crear o actualizar una autorización de API, consulta Configuración de la API de Workiva .

  

• Comprueba si el script ha superado algún límite de recursos:

  El uso de memoria, CPU, disco y tiempo de ejecución se registra automáticamente en los registros de ejecución de los scripts y en los datos de ejecución de los scripts que devuelve la API.

  Para obtener más información, consulta . Gestión de los límites de recursos en Workiva Scripting: y . Límites de Workiva Scripting: .

• Comprueba si el script ha alcanzado su tiempo máximo de ejecución:

  Si fuera así, reduce la cantidad de trabajo que se realiza en una sola ejecución o divide el trabajo en operaciones más pequeñas. Consulta y los límites de las secuencias de comandos de Workiva en .

• Comprueba si hay funciones que detengan explícitamente el proceso de Python:

  Comprueba que el script no llame a:

  quit() exit() sys.exit() os._exit()

  quit() , exit() , y sys.exit() raise SystemExit . os._exit() detiene el proceso inmediatamente sin ejecutar los controladores de limpieza habituales.

Para obtener más información sobre las operaciones de la API de scripting, consulta la guía de la API de scripting de « » en .

Desincronización del comando y la ejecución del script

Esto ocurre cuando el comando finaliza y el script sigue ejecutándose, o viceversa.

Si el comando finaliza antes de que se ejecute el script, asegúrate de que el tiempo de espera del comando « » sea superior al tiempo de ejecución del script (consulta «Límites de los scripts de Workiva» para obtener más información sobre el tiempo máximo de ejecución de los scripts).

Si la ejecución del script finaliza unos segundos antes que el comando, puede tratarse de un retraso esperado causado por el sistema de Scripting que procesa la información una vez finalizada la ejecución del script. El comando solo informará de la finalización cuando todo el proceso haya terminado.

Editor de scripts

Importar una biblioteca no funciona

Workiva Scripting es compatible desde el principio con la biblioteca estándar de Python, así como con los componentes disponibles en el índice de paquetes de Python (para obtener más información, consulta Bibliotecas y dependencias de Workiva Scripting compatibles). Es posible que no se admitan los componentes de PyPI que requieran instalaciones adicionales.

Asegúrate de que la biblioteca que intentas importar forma parte de la biblioteca estándar de Python o del índice de paquetes de Python. Si es un componente de este último, asegúrate de que no requiere instalaciones adicionales.