チケット履歴とエクスポート

チケット履歴ビューでは、管理者がキューを通過したすべてのチケットを確認できます。ステータスや日付でフィルタリングでき、大規模なキューでもキーセットページネーションに対応しており、フィルタ済みのチケット群をそのキュー単位でCSVファイルとしてエクスポートできます。

チケット履歴を表示する（管理者）

1. Adminで拠点を開き、サブナビゲーションの チケットログ タブに移動します。
2. リストには、その拠点のキューに属するすべてのチケットが新しい順に表示されます。各行には次の情報が表示されます。
   • チケット番号
   • キュー名
   • ステータス（WAITING、CALLED、COMPLETED、SKIPPED、CANCELED、NO_SHOW）
   • 呼び出し元のデスク（静的トークンのデスクの場合はダッシュ表示）
   • 作成日時
   • 最終更新日時
3. リスト上部のコントロールでステータスや日付範囲によるフィルタリングができます。
4. スクロールまたはページ送りでさらに結果を読み込みます。ページネーションは安定しており、閲覧中に新しいチケットが届いてもページがずれることはありません。

アクセスにはorg-managerまたはlocation-managerロールが必要で、表示は自分が割り当てられている拠点に限定されます。

番号でチケットを検索する（デスク）

スタッフは、ペアリングされたキュー内の任意のチケットを番号で検索できます。「47番のチケットはまだ有効か」を確認したり、スキップした顧客を呼び戻したり、待機中のステータスを確認したりする際に便利です。

1. デスクで 検索 リンク（または検索アイコン）をタップします。
2. チケット番号を入力し、検索 を押します。
3. 結果には、チケットの現在のステータス、タイムスタンプ、スタッフによる注記が表示されます。ここからスタッフはSKIPPEDのチケットを呼び戻したり、不在（no-show）として記録したりすることもできます。

ノート

デスクでの検索は、そのデスクが割り当てられているキューに限定されます。同じ拠点内の別のキューのチケットはこのビューから見ることはできません。

チケットデータをエクスポートする（管理者）

キューのチケットをエクスポートする手順は次のとおりです。

1. 管理者のチケット履歴ビューでキューを選択し、必要に応じてステータスや日付のフィルタを適用します。
2. CSVエクスポート をクリックします。
3. サーバーが結果をファイルダウンロードとしてストリーミングします。大規模なエクスポートはチャンク単位でストリーミングされ、データセット全体をメモリにバッファリングすることなくダウンロードが完了します。

エクスポートに含まれる内容: チケットごとに5つのフィールド（番号、ステータス、呼び出し元のデスク、作成日時、最終更新日時）です。エクスポートは選択したキューに限定され、スタッフによる注記（氏名、人数、メモ）は含まれません。

数式インジェクション対策: =、+、-、@、タブ、または復帰で始まる値には、表計算アプリケーションでプレーンテキストとして表示されるようにシングルクォートが付加されます。

エクスポートのルートは管理者セッションで認証されているため、別途ログインを求められることなくブラウザで即座にダウンロードが開始されます。