キュー管理 (Queue Management)

送信ステータスの監視、エラーのトラブルシューティング、およびメールキューの管理を行います。

Queue Management (キュー管理) では、PDF生成およびメール送信タスクの進行状況を監視できます。全体的なプロファイルステータスから個々のメールアイテムまで、すべてのジョブの詳細なビューを提供します。

概要

キュー管理システムは、問題を掘り下げるのに役立つように4つのレベルで構成されています：

  1. Profile List (プロファイル一覧): すべてのプロファイルとその最近のアクティビティの概要。
  2. Batch List (バッチ一覧): 特定のプロファイルのインポート履歴（ファイル）。
  3. Queue List (詳細一覧): バッチ内の個々のアイテム（受信者）。
  4. Item Details (詳細編集): 単一アイテムの詳細データとステータス。

1. Profile List (プロファイル一覧 - 概要)

メインビューには、設定した各 Profile のカードが表示されます。

  • Stats (統計): 各カードは、過去30日間のアイテムのステータスを可視化します。
    • Error: 失敗したアイテム（PDF生成、送信、またはインポート）。
    • Pend: 処理待ちのアイテム（PDF生成）。
    • PDF Generated: PDFが生成され、送信待ちのアイテム。

アクション: プロファイルカード（または Edit アイコン）をクリックすると、その Batch List が表示されます。

2. Batch List (バッチ一覧 - 履歴)

このリストには、選択したプロファイルにインポートしたすべてのファイルが表示されます。

  • Batch Name (バッチ名): インポートされたCSVの ファイル名 に対応します。
  • Import Date (インポート日時): 同じファイルの複数のインポートを区別するために使用します。
  • Status Columns:
    • Total: バッチ内のアイテム総数。
    • Error: 失敗の合計。
    • Pending: PDF生成待ち。
    • PDF Generated: PDF生成済み、メール送信待ち。
    • Sent: 送信成功。

アクション: 特定のバッチ行の Edit アイコンをクリックすると、その Queue List が表示されます。

3. Queue List (詳細一覧 - アイテム)

このビューには、選択したバッチ内の個々の受信者がすべてリストされます。

機能

  • Search (検索): 受信者(To)、ステータス、エラーメッセージ、またはデータ内容(JSON)で検索できます。
  • Filter (フィルター): ドロップダウンを使用して、特定のステータス（「Error」のみなど）を表示します。
  • Delete Batch (バッチ削除): Delete Batch ボタンを使用すると、バッチ履歴全体を削除できます。

ステータス定義

ステータス説明
Pending (待機中)システムがPDFを生成するのを待っています。
PDF Generated (生成完了)PDFは正常に作成されました。メール設定を検証中か、送信待ちです。
Sent (送信済)メールはSMTPサーバーに正常に配信されました。
Error (エラー)プロセスが失敗しました。詳細は「Error Message」列を参照してください。

一般的なエラーメッセージ

以下のエラーは、Error Message 列またはバッチの Error List に表示される場合があります：

メール送信エラー

  • SMTP server rejected recipients: メールサーバーがアドレスを拒否しました。アドレスがスパムリスクを示唆していないか、ドメインがブロックされていないか確認してください。
  • MISSING_TO_RECIPIENT: "To" アドレスが空です。マッピング設定を確認してください。
  • BACKEND_CONNECTION_FAILED: SMTPサーバーに接続できませんでした。インターネット接続またはVPNを確認してください。
  • RETRY_LIMIT_REACHED: プロファイルで定義された最大再試行回数に達した後、システムが諦めました。

インポートと処理のエラー

  • TEMPLATE_FILE_NOT_FOUND: 設定されたPDFテンプレートファイルがワークスペースにありません。
  • MISSING_MASTER_LOOKUP_VALUE: アイテムにルックアップキーの値がない（例：顧客IDが空）ため、マスターデータを取得できませんでした。
  • CSV_DATA_EMPTY_OR_UNREADABLE: インポートされたCSVファイルが空か、破損していました。

4. Item Details (詳細編集 - 編集と再試行)

アイテムの Edit アイコンをクリックすると、データを修正したり、失敗したプロセスを再試行したりできます。

データの修正

誤ってインポートされた場合、メールアドレス（To, CC, BCC）を修正できます。

ステータスの変更（再試行）

保存してもステータスは自動的に変更されません。再試行をトリガーするには、適切なステータスを手動で選択する必要があります：

  • Pending (待機中): 現在のPDFを破棄し、再生成を試みる場合にこのステータスを選択します（例：JSONデータを修正した後）。
  • PDF Generated (生成完了): 既存の PDFの送信を再試行する場合にこのステータスを選択します（例：メールアドレスを修正した後）。

JSONの編集

Document Content Data および Customer Master Data を直接編集できます。