プロセスレポートのアドホッククエリ

プロセスレポートのアドホッククエリを使用すると、AEM Forms 環境で定義された AEM Forms プロセスインスタンスのプロセスとタスクの詳細を検索するために使用できるカスタムクエリを作成できます。

また、アドホッククエリは、プロセスおよびタスクのプロパティフィルターを使用して定義できます。その後、これらのフィルターを保存し、後でレポートを実行するために使用できます。

プロセスの検索：プロセス属性に基づいて、ユーザー定義の検索フィルターを使用してプロセスインスタンスを検索します。

プロセスの詳細：プロセス ID を指定して、プロセスインスタンスの詳細を表示します。

タスクの検索：タスク属性に基づいて、ユーザー定義の検索フィルターを使用してタスクインスタンスを検索します。

タスクの詳細：タスク ID を指定して、タスクインスタンスの詳細を表示します。

プロセスとタスク

フィルターを作成しクエリを実行してプロセスの詳細を得る際に行う手順は、タスクの場合の手順と同じです。

つまり、「プロセスの検索」と「タスクの検索」のユーザーインターフェイスは、検索フィールドと、検索結果が返されるフィールドのみが異なります。これは単に、多くのフィールドが同一ですが、プロセスに固有のフィールドもあれば、タスクに固有のフィールドもあるためです。

この記事では、「プロセスとタスクの検索」および「プロセスとタスクの詳細」の各節の詳細を説明します。具体的な違いを、適切な場所で具体的に示します。

プロセスとタスクの検索

プロセスとタスクの検索を使用して、プロセスとタスクのインスタンスを問い合わせるフィルターを定義します。

プロセスとタスクの検索クエリを作成するには

保存したプロセスとタスクの検索クエリを表示するか、クエリを作成するには、アドホッククエリ／プロセスとタスクの検索をクリックします。

マイフィルターパネルがツリービューの右側に表示されます。

マイフィルターパネルでは、新しいアドホッククエリを作成し、クリックして以前に保存したクエリを実行できます。
既存のクエリを実行するには、マイフィルターパネルのクエリを単にクリックします。
クエリを作成するには、追加（+）をクリックします。

フィルターを作成パネルが表示されます。

クエリは、1 つまたは複数のクエリフィルターで構成されます。フィルターを作成するには、クエリにフィルター行を追加します。デフォルトでは、1 つのフィルター行がクエリに追加されます。

フィルターを定義するには
1. フィールドを選択します。
  
  メモ
  
  フィールドリストには、AEM Forms のプロセスとタスクに固有のフィールドが含まれています。
2. 条件を選択します。
  
  メモ
  
  表示される条件は、フィルタリング用に選択した属性によって異なります。
3. 値を入力します。
4. クエリに別のフィルターを追加するには、フィルター行の右側にある「追加」（+） をクリックします。
  
  クエリからフィルターを削除するには、フィルター行の右側にある「削除」（-） をクリックします。

クエリを作成した後、フィルターを作成パネルの右上隅のオプションを使用します。

キャンセル：変更をキャンセルし、マイフィルターパネルに戻ります。
実行：現在のクエリを実行して、結果を確認または検証します。この場合、クエリを実行する前にクエリを保存する必要はありません。結果を確認し、必要に応じて変更して、出力に満足したらクエリを保存できます。
保存：フィルターを保存します。その後、フィルターをマイフィルターパネルで表示して実行できます。

マイフィルターパネルのオプション

マイフィルターパネルのオプションを使用し、 lc_pr_add_filter を追加し、 lc_pr_delete_filter を編集するか、 lc_pr_edit_filter アドホッククエリを削除してください。

my_filters_options

検索クエリを実行するには

クエリを実行するには、フィルターを作成もしくは編集している場合、マイフィルターパネルまたは「実行」ボタンをクリックしてください。
クエリの結果は、プロセスのレポートウィンドウのレポートパネルに表示されます。

レポートの下部に表示されるページネーションパネルを使用して、検索結果にページ番号を付けることができます。

表示ドロップダウンリストから、1 ページに表示する結果の数を選択します。

「ページ」テキストボックスに、ページ番号を入力してそのページに直接移動します。
プロセスの検索結果には、次のフィールドが表示されます。
- プロセス ID：プロセスの ID。このフィールドにはハイパーリンクが付いています。このフィールドでプロセス ID をクリックすると、プロセスのプロセスの詳細パネルにリダイレクトされます。
- イニシエーター：プロセスインスタンスを開始した AEM Forms ユーザー
- 作成時刻：プロセスインスタンスが開始した日時
- 完了時間：プロセスインスタンスが完了した日時
- 期間：プロセスインスタンスの開始から完了までの期間
- ステータス：プロセスインスタンスの現在のステータス。
デフォルトでは、結果はプロセス ID で並べ替えられます。ただし、任意のフィールドで結果を並べ替える場合は、フィールドのタイトルをクリックしてください。

並べ替えは切り替えによる操作なので、列ヘッダーをクリックして結果を昇順に並べ替え、もう一度クリックして降順に並べ替えます。

同様に、次のフィールドがタスクの検索結果に表示されます。
- Task ID：タスクの ID。このフィールドにはハイパーリンクが付いています。このフィールドでタスク ID をクリックすると、そのタスクのタスクの詳細パネルにリダイレクトされます。
- イニシエーター：プロセスインスタンスを開始した AEM Forms ユーザー
- 作成時刻：プロセスインスタンスが開始した日時
- 完了時間：プロセスインスタンスが完了した日時
- 期間：プロセスインスタンスの開始から完了までの期間
- ステータス：プロセスインスタンスの現在のステータス。
デフォルトでは、結果はタスク ID で並べ替えられます。ただし、任意のフィールドで結果を並べ替えるには、フィールドのタイトルをクリックします。結果は、列ヘッダーの横に暗い矢印が表示される列で並べ替えられます。

並べ替えは切り替え操作なので、結果を昇順に並べ替えるにはフィールドヘッダーをクリックし、降順に並べ替えるには再度クリックします。現在の並べ替え順（昇順／降順）は、列ヘッダーの隣にある暗い矢印の方向で示されます。
左上のレールボタンをクリックし、マイフィルターペインを折りたたみ、レポートパネルで利用可能なスペースを展開します。
**レポート ** パネルの右上隅にあるオプションを使用して、クエリ結果に対する操作を実行します。
- 更新：ストレージに存在する最新のデータでレポートを更新します
- CSV に書き出し：レポートデータをコンマ区切りファイルにエクスポートします。
メモ

レポートをエクスポートする場合、検索結果全体が現在のページだけでなく CSV ファイルにエクスポートされます

プロセス／タスクの詳細

プロセスの詳細パネルを使用して、特定のプロセスの詳細を表示できます。

同様に、タスクの詳細パネルを使用して、特定のタスクの詳細を表示します。

プロセス／タスクの詳細の表示

特定の AEM Forms プロセス／タスクの詳細を表示できます。

プロセス／タスク検索結果から
プロセス／タスクの詳細パネルでプロセス／タスク ID を入力する

プロセス／タスク検索結果から

プロセス/タスク検索を実行します。詳しくは、プロセス検索クエリを実行するにはを参照してください。

結果で返されるプロセス ID の表示はハイパーリンクされていることにご注意ください。
リストでプロセス ID をクリックすると、プロセスの詳細パネルにこのプロセスの詳細が表示されます。

プロセス／タスクの詳細のクエリ結果には、プロセス／タスクに含まれるタスク／フォームの詳細が表示されます。

デフォルトでは、結果はタスク／フォーム ID で並べ替えられます。ただし、任意のフィールドで結果を並べ替えるには、フィールドのタイトルをクリックします。結果の並べ替えに使用される列は、列ヘッダーの隣にある暗い矢印で示されます。

並べ替えは切り替え操作なので、結果を昇順に並べ替えるにはフィールドヘッダーをクリックし、降順に並べ替えるには再度クリックします。現在の並べ替え順（昇順／降順）は、列ヘッダーの隣にある暗い矢印の方向で示されます。

プロセスの詳細の結果

左パネル：選択したプロセスに関する次の詳細が表示されます。
- プロセスの名前
- プロセスの作成日時
- プロセスの完了日時
- プロセスの期間
- プロセスのステータス
- プロセスの開始者
右上のパネル：選択したプロセスを構成するタスクに関する次の詳細が表示されます。
- タスク ID
- タスクの名前
- タスクの所有者
- タスクの作成日時
- タスクの更新日時
- タスクの完了日時
- タスクの期間
- タスクのステータス
右下のパネル：選択したプロセスのプロセス履歴に関する次の詳細が表示されます。
- プロセス名
- プロセスの開始者
- プロセスの更新日時
- プロセスの完了日時
- プロセスのステータス
タスクの詳細の結果

左パネル：選択したタスクに関する次の詳細が表示されます。
- タスク名
- このタスクが属するプロセスの ID
- タスクの説明
- タスクの作成日時
- タスクの完了日時
- タスクの期間
- タスクのステータス
- タスクの選択されたルート
右上のパネル： 選択したタスクを構成するフォームに関する次の詳細を表示します。
- フォーム ID
- フォームの作成日時
- フォームの更新日時
- フォームのテンプレート URL
右下のパネル：選択したタスクのプロセス履歴に関する次の詳細が表示されます。
- タスクの割り当てのタイプ
- タスクの所有者
- タスクの割り当ての作成日時
- タスクの更新日時
「プロセス／タスクの検索に戻る」をクリックして、プロセス／タスクの詳細がドリルダウンされた検索結果に戻ります。

ただし、特定のプロセス／タスク ID を入力してプロセス／タスクの詳細が見つかった場合に、「プロセス／タスクの検索に戻る」をクリックすると、「プロセス／タスクの検索」に戻り、検索結果は表示されません。

プロセス／タスクの詳細パネルでプロセス／タスク ID を入力する

プロセス／タスクの詳細パネルに移動します。
「プロセス／タスク ID」テキストボックスに、プロセス／タスク ID を入力します。

プロセス／タスクの詳細のクエリ結果のフィールドは、AEM Forms のプロセス／タスクに特有のフィールドです。

プロセスの場合、クエリ結果には、プロセスに含まれるタスクの詳細が表示されます。

タスクの場合、クエリ結果にはタスクに含まれるフォームの詳細が表示されます。