解决常见脚本问题

Workiva Scripting 为在 Workiva 平台上运行 Python 代码提供了一个灵活、安全的环境。本文涵盖了编写脚本时可能遇到的一些常见场景。

Workiva Scripting 包含在 Customize Workiva 中。要使用脚本功能，您的工作区必须启用“自定义 Workiva/脚本”功能，并且用户需要相应的脚本角色和文件权限。

对于此处未涵盖的问题，请查看我们的其他 Workiva Scripting 文章或访问Workiva API和Workiva Scripting社区。

管理员和权限问题

“执行脚本”操作未出现在自动化列表中

只有具有相应脚本角色的用户才能使用“执行脚本”操作。请联系您的工作区管理员以分配所需角色。如果角色已分配但操作仍然不可用，请联系 Workiva 支持。

Chains 中不提供 Workiva Scripting 连接器

这表示您的工作区尚未启用 Workiva Scripting 连接器。如果您认为应该启用该功能但未启用，请联系您的 Workiva 客户团队。

工作区管理员看不到任何脚本角色。

这表示您的工作区尚未启用脚本功能。如果您认为应该启用该功能但未启用，请联系您的 Workiva 客户团队。

命令开始执行，但脚本没有执行。

请确认您的工作区已启用脚本功能。如果您认为应该启用该功能但未启用，请联系您的 Workiva 客户团队。

如果您已确认脚本功能已启用，则 Workiva Scripting 连接器的集成用户可能未分配必要的角色。请联系您的工作区管理员以分配合适的脚本角色。您还应该验证集成用户是否具有访问该命令触发的脚本的权限。

命令仍在执行中，但脚本执行意外停止。

如果脚本停止后链式命令仍在执行，请检查以下内容：

检查运行是否已取消：

运行历史记录可在脚本编辑器的“属性”面板中找到，也可通过 GET /scripts/{scriptId}/runs 或 GET /scripts/{scriptId}/runs/{runId}来查看。API 请求需要 script:read 作用域，并且必须包含 X-Version: 2026-01-01。

有关创建或更新 API 授权的说明，请参阅 Workiva API 设置。
检查脚本是否超出资源限制：

内存、CPU、磁盘和运行时使用情况会自动在脚本运行日志和 API 返回的脚本运行数据中报告。

有关更多信息，请参阅处理 Workiva Scripting 中的资源限制和 Workiva Scripting 限制。
检查脚本是否已达到最大运行时间：

如果确实如此，则减少一次运行中完成的工作量，或者将工作分成更小的操作。请参阅 Workiva 脚本限制。
检查是否存在显式停止 Python 进程的函数：

请确认脚本没有调用：
```
quit() exit() sys.exit() os._exit()
```
quit(), exit(), 和 sys.exit() raise SystemExit. os._exit() 会立即停止进程，而不运行正常的清理处理程序。