document-management

用途：在 ServiceNow 中管理附件、文档模板与文档生成，并在智能体与实例之间搬运文件字节。主要能力分两侧。脚本侧使用 GlideSysAttachment 在记录间写入、读取、列出和复制附件；基于 sys_report_template 创建模板并替换 ${字段} 占位符生成内容；用 sn_pdfgeneratorutils.PDFGenerationAPI 将 HTML 转为 PDF 并附加到记录；dms_document 支持审批与版本历史；还提供附件访问检查。接口侧通过 /api/now/attachment 提供六个工具：snow_upload_attachment 与 snow_file_upload 以 base64 上传（参数名不同、端点相同），snow_attach_file 读取本地路径并以 multipart 上传，snow_get_attachments 仅返回元数据，snow_file_download 返回 base64 与内容类型，snow_delete_attachment 永久删除。用法：先 snow_get_attachments 列出元数据，再用 snow_file_download 取内容，需两次调用，没有一次性下载整条记录全部附件的接口。限制：脚本代码仅支持 ES5，不支持现代 JavaScript 语法。snow_attach_file 默认 max_size_mb 为 25，是客户端保护；实例自身由 com.glide.attachment.max_size 与 glide.attachment.extensions 限制，超限会在 API 返回 400。base64 会增大约三分之一，大文件建议用 multipart。附件权限独立于父记录 ACL，由 glide.attachment.role、表级控制和父记录读 ACL 共同决定；无读权限时列表返回空数组，单个附件读取失败常表现为 not-found，删除不可恢复且不进入 update set。其余细节暂未提供。