CQE キュー登録ガイド
CQE（Custom Query Engine）スクリプトを1つ以上の論理サーバー（LSSN）に実行スケジュールとして登録する方法と、開始日時（startdate）のタイムゾーン規約を説明します。
📋 概要
CQE キュー登録は、リポジトリに登録済みのスクリプト（mssn）を選び、それを実行する論理サーバー（lssn）を指定して実行スケジュール（tMgmtScriptList）として登録する画面です。登録が完了すると自動的に CQELSVR 実行リスト 画面へ移動します。
🕒 開始日時（startdate）のタイムゾーン規約 — 必ずお読みください
| 区分 | 基準 |
|---|---|
| 画面での入力・表示 | お使いのブラウザのローカル時刻（日本なら JST、韓国なら KST など） |
| 送信・保存 | UTC（ISO 8601）。画面が送信直前に自動変換します。 |
- 入力欄には、今お使いの PC に表示されている時刻をそのまま入力してください。ご自身で UTC に換算する必要はありません。
- 保存ボタンを押した時点で、画面がローカル時刻から UTC へ変換して送信します。データベースには UTC の値が記録されます。
- そのため CQELSVR 実行リスト の
lastdateなどの列は UTC 基準で表示されます。ローカル時刻との差は時差の分だけずれて見えるのが正常です。
開始日時を未来にすると、その時刻まで実行されません
開始日時は「この時刻より前には実行しない」という意味です。未来の時刻を指定すると、その時刻になるまでエージェントはこのスケジュールを取得しません。今すぐ実行したい場合は、開始日時を現在時刻（または過去）のままにしてください。 画面を開くと既定値として現在のローカル時刻が入っているため、即時実行が目的ならそのままで問題ありません。
⚠️ 以前は画面がローカル時刻の文字列を UTC 変換せずにそのまま送信していたため、UTC で動作する DB に時差の分だけ未来の時刻が保存される問題がありました（giip #2537）。その場合、取得順の候補として永久に後回しにされ、スケジュールがまったく実行されませんでした。現在は画面が変換責任を持つよう修正済みです。
🔍 画面構成
1. スクリプト選択（mssn）
- mssn 入力: 実行するスクリプトの固有 ID を直接入力します。
- 選択ボタン: クリックすると、現在のプロジェクト（csn）のスクリプトリポジトリ一覧がポップアップで開きます。キーワード検索や Prev / Next でのページ送りができ、行の選択を押すと
mssnとscript typeが自動入力されます。 - 必須項目です。空のままでは保存できません。
2. 対象サーバー選択（LSSN グループ）
- 現在のプロジェクト（csn）に登録された論理サーバー一覧がチェックボックスで表示されます。
LSSN — 用途 @ ホスト名の形式です。 - 複数のサーバーを同時に選択でき、選択したサーバーごとにスケジュールが登録されます。
- 最低1つ以上を選択しないと保存できません。
3. 実行オプション
- csn: プロジェクト番号。ログインセッションから自動的に入力されます。
- interval: 繰り返し実行の周期（分単位）。
- active: スケジュールの有効/無効。オフにすると登録されるだけで自動実行はされません。
- script type: スクリプトの種別（スクリプト選択時に自動入力されます）。
- repeat: 繰り返し実行の有無。オフにすると1回限りのスケジュールになります。
- startdate: 開始日時（
YYYY-MM-DD HH:mm）。上記「タイムゾーン規約」の節を参照してください。 - auid: 実行要求者 ID。ログインセッションのユーザー ID が既定値として入ります。
4. カスタム値（custom_values）
元のスクリプトを修正せずに値だけ変えて実行したいときに使います。元のスクリプト内で {{customvalues}} と記されている箇所に、ここで入力した内容が置換されて挿入されます。
5. 保存 / キャンセル
- Save: 入力値を検証してキューに登録し、CQELSVR 実行リスト 画面へ移動します。
- Cancel: 登録せずに実行リスト画面へ戻ります。
⚙️ 要件
- **ログインセッション（CSN）**が必要です。セッションがないとサーバー一覧とスクリプト一覧を取得できません。
- 登録するスクリプト（
mssn）とサーバー（lssn）はいずれも現在のプロジェクトに属している必要があります。
トラブルシューティング
| 症状 | 原因 | 解決 |
|---|---|---|
| LSSN グループの一覧が空 | 現在のプロジェクト（csn）に登録された論理サーバーがない、またはセッション切れ | 上部で正しいプロジェクトを選択しているか確認し、必要なら再ログインします。 |
| 「mssn は必須です」エラー | スクリプトを選択せずに保存を押した | 選択ボタンからリポジトリのスクリプトを選びます。 |
| 「少なくとも1つの LSSN を選択してください」エラー | 対象サーバーを1つもチェックしていない | LSSN グループでサーバーを1つ以上チェックします。 |
| 「開始日: 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）で送る必要があります。ローカル時刻の文字列をそのまま送ると DB に未来の時刻が保存され、スケジュールが実行されません。 - CQERepoList
csn <offset> [N'keyword']— スクリプト選択ポップアップに表示するリポジトリ一覧を照会します（1回あたり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.ja.md