CQE 队列注册指南
介绍如何将 CQE（Custom Query Engine）脚本注册为一台或多台逻辑服务器（LSSN）上的执行调度，以及开始日期（startdate）的时区约定。
📋 概述
CQE 队列注册 用于从仓库中选择脚本（mssn），指定要运行它的逻辑服务器（lssn），并将其注册为执行调度（tMgmtScriptList）。保存成功后会自动跳转到 CQELSVR 执行列表 页面。
🕒 开始日期（startdate）的时区约定 —— 请务必阅读
| 项目 | 基准 |
|---|---|
| 界面输入与显示 | 您的浏览器本地时间（在中国为 CST，在日本为 JST，依此类推） |
| 发送与存储 | UTC（ISO 8601）。界面会在发送前自动转换。 |
- 请直接按当前所用电脑上显示的时间填写，无需自己换算成 UTC。
- 在您按下保存的那一刻，界面会把本地时间转换为 UTC 后发送。数据库中记录的是 UTC 值。
- 因此 CQELSVR 执行列表 中的
lastdate等列是以 UTC 为基准显示的。与本地时间相差一个时区偏移是正常现象。
将开始日期设为未来时，在该时刻之前不会执行
开始日期的含义是"在此时刻之前不要执行"。如果设置为未来的时间，代理在该时刻到来之前不会取走这条调度。如果想立即执行，请将开始日期保持为当前时间（或过去时间）。 打开页面时该字段已默认填入当前本地时间，若目的是立即执行，保持原样即可。
⚠️ 此前界面会把本地时间字符串不做 UTC 转换直接发送，导致以 UTC 运行的数据库中保存了比实际晚一个时区偏移的未来时间（giip #2537）。这种调度会在取用排序中被永久排到最后，完全不会执行。现在已修正为由界面承担转换责任。
🔍 界面组成
1. 选择脚本（mssn）
- 输入 mssn: 直接输入要执行脚本的唯一 ID。
- 选择按钮: 点击后会弹出当前项目（csn）的脚本仓库列表。可以按关键词搜索，并用 Prev / Next 翻页；点击某行的选择会自动填入
mssn和script type。 - 这是必填项，留空将无法保存。
2. 选择目标服务器（LSSN 组）
- 以复选框形式列出当前项目（csn）下已注册的逻辑服务器，显示为
LSSN — 用途 @ 主机名。 - 可以同时选择多台服务器，系统会为每台所选服务器各注册一条调度。
- 保存前至少要选择一台服务器。
3. 执行选项
- csn: 项目编号，由登录会话自动填入。
- interval: 重复执行间隔（单位：分钟）。
- active: 调度是否启用。关闭时仅完成注册，不会自动执行。
- script type: 脚本类型（选择脚本时自动填入）。
- repeat: 是否重复执行。关闭则成为一次性调度。
- startdate: 开始日期时间（
YYYY-MM-DD HH:mm）。请参阅上方"时区约定"一节。 - auid: 执行请求者 ID，默认填入登录会话的用户 ID。
4. 自定义值（custom_values）
当您希望不修改原始脚本、只更换其中的值来执行时使用。此处输入的内容会替换原始脚本正文中标记为 {{customvalues}} 的位置。
5. 保存 / 取消
- Save: 校验输入并注册队列条目，然后跳转到 CQELSVR 执行列表 页面。
- Cancel: 不注册任何内容，返回执行列表页面。
⚙️ 要求
- 需要登录会话（CSN）——没有会话则无法加载服务器列表和脚本列表。
- 要注册的脚本（
mssn）和服务器（lssn）都必须属于当前项目。
故障排除
| 症状 | 原因 | 解决 |
|---|---|---|
| LSSN 组列表为空 | 当前项目（csn）下没有已注册的逻辑服务器，或会话已过期 | 确认已在顶部选择正确的项目，必要时重新登录。 |
| 出现 "mssn 为必填" 错误 | 未选择脚本就按了保存 | 使用选择按钮从仓库中挑选脚本。 |
| 出现 "请至少选择一个 LSSN" 错误 | 一台目标服务器都未勾选 | 在 LSSN 组中勾选至少一台服务器。 |
| 出现 "开始日期：使用 YYYY-MM-DD HH:mm 或 ISO 格式" 错误 | 无法解析开始日期的格式 | 按 2026-09-15 14:30 的形式重新输入，留空也可以。 |
注册后执行列表中的 lastdate 与输入的时间不一致 | lastdate 以 UTC 为基准显示，而输入的是本地时间 | 这是正常现象，相差一个时区偏移是正确的。 |
| 已注册但过了几分钟代理仍未取走 | 开始日期被设为未来，或 active 处于关闭状态 | 检查开始日期，如需立即执行请以当前时间重新注册，并确认 active 已开启。 |
🔌 CQE API（自动化）
本界面的操作对应以下 CQE API 动词（byAK/bySk 分发器）。请求发送 text（动词+参数名）、jsondata（值）和 token。
- CQEQueuePut
mssn lssngroup csn interval active script_type custom_values repeat startdate auid— 为所选的各台服务器（lssngroup，逗号分隔）注册调度。startdate必须以 UTC ISO 8601 字符串发送（例如2026-09-15T05:30:00.000Z）。若直接发送本地时间字符串，数据库中会保存未来时间，调度将永远不会执行。 - CQERepoList
csn <offset> [N'keyword']— 查询脚本选择弹窗中显示的仓库列表（每次 15 条）。 - LSVRList
csn— 查询该项目下注册的逻辑服务器列表（用于 LSSN 组复选框）。
认证模型: 此页面的 API 并非使用 giip-issue 技能的 x-api-key（SK）方式，而是使用登录会话的令牌方式，每次请求随附 user_id + token。
相邻功能的完整规范: CQELSVR 执行列表指南、CQE 仓库脚本管理指南，以及 giipdb
docs/30_Specs/CQE_SPECIFICATION.md。
版本: 1.0
最后更新: 2026-09-15
源文件: giipv3/public/help/cqeQueuePut.zh-CN.md