ワークフローインスタンスの管理 administering-workflow-instances

CAUTION
AEM 6.4 の拡張サポートは終了し、このドキュメントは更新されなくなりました。 詳細は、 技術サポート期間. サポートされているバージョンを見つける ここ.

ワークフローコンソールには、ワークフローインスタンスを管理し、それらが想定どおりに実行されていることを確認するための複数のツールが用意されています。

NOTE
JMX コンソールを使用すると、追加のワークフローメンテナンス操作を行うことができます。

ワークフローの管理用に、次の各種コンソールが用意されています。グローバルナビゲーションを使用して​ ツール ​パネルを開き、その後「ワークフロー」を選択します。

  • モデル:ワークフロー定義の管理
  • インスタンス:実行中のワークフローインスタンスを表示および管理します
  • ランチャー:ワークフローの起動方法の管理
  • アーカイブ:正常に完了したワークフローの履歴を表示
  • 失敗:エラーで完了したワークフローの履歴を表示

ワークフローインスタンスのステータスの監視 monitoring-the-status-of-workflow-instances

  1. ナビゲーションを使用して、ツールワークフロー ​を選択します。

  2. インスタンス」を選択して現在進行中のワークフローインスタンスのリストを表示します。

    wf-96

  3. 特定の項目を選択し、「履歴を開く」で詳細を確認します。

    wf-97

ワークフローインスタンスの休止、再開および終了 suspending-resuming-and-terminating-a-workflow-instance

  1. ナビゲーションを使用して、ツールワークフロー ​を選択します。

  2. インスタンス」を選択して現在進行中のワークフローインスタンスのリストを表示します。

    wf-96-1

  3. 特定の項目を選択してから、適宜「終了」、「休止」、または「再開」を使用します。この際、確認または詳細(あるいはその両方)を求められます。

    wf-97-1

アーカイブされたワークフローの表示 viewing-archived-workflows

  1. ナビゲーションを使用して、ツールワークフロー ​を選択します。

  2. アーカイブ」を選択して正常に完了したワークフローインスタンスのリストを表示します。

    wf-98

    note note
    NOTE
    abort ステータスは、ユーザーの操作の結果として発生するので、正常終了と見なされます。例:
    • 使用 終了 アクション
    • ワークフローの対象となるページが(強制的に)削除されたことによって、ワークフローが終了した場合
  3. 特定の項目を選択し、「履歴を開く」で詳細を確認します。

    wf-99

ワークフローインスタンスのエラーの修正 fixing-workflow-instance-failures

ワークフローが失敗した場合、AEM の​ エラー ​コンソールを使用してエラーの原因を調べ、特定された原因に応じて適切なアクションを取ることができます。

  • 失敗の詳細:ウィンドウを開き、
    失敗メッセージステップ失敗スタック ​を表示します。

  • 履歴を開く ​ワークフローの履歴の詳細を表示します。

  • ステップを再試行 ​スクリプトステップコンポーネントのインスタンスをもう一度実行します。元のエラーの原因を修正した後に、「ステップを再試行」コマンドを使用します。 例えば、プロセスステップが実行するスクリプトのバグを修正した後にステップを再試行します。

  • 終了 エラーが原因で解決できない問題がワークフローに発生した場合にワークフローを終了します。例えば、ワークフローインスタンスで無効になった環境条件(リポジトリ内の情報など)にワークフローが依存している可能性がある場合などです。

  • 終了して再試行 ​元のペイロード、タイトルおよび説明を使用して新しいワークフローインスタンスが開始される点を除き、終了 ​と同様です。

エラーを調査し、その後ワークフローを再開または停止するには、次のステップに従います。

  1. ナビゲーションを使用して、ツールワークフロー ​を選択します。

  2. 選択 失敗 :正常に完了しなかったワークフローインスタンスのリストを表示します。

  3. 特定の項目を選択し、適切なアクションを選択します。

    wf-47

ワークフローインスタンスの定期的なパージ regular-purging-of-workflow-instances

ワークフローインスタンスの数を最小限に抑えるとワークフローエンジンのパフォーマンスが向上します。このため、完了したまたは実行中のワークフローインスタンスをリポジトリーから定期的に削除できます。

設定 AdobeGranite のワークフローのパージ設定 」をクリックして、年齢とステータスに従ってワークフローインスタンスをパージします。 また、すべてのモデルまたは特定のモデルのワークフローインスタンスをパージすることもできます。

また、サービスの複数の設定を作成して、異なる条件を満たすワークフローインスタンスをパージすることもできます。 例えば、特定のワークフローモデルが予想より長く実行されている場合に、そのインスタンスをパージする設定を作成します。 さらに、リポジトリーのサイズを最小限に抑えるために、特定の日数が経過した後に完了したワークフローをすべてパージするもう 1 つの設定を作成します。

サービスを設定するには、Web コンソールを使用するか、リポジトリに OSGi 設定を追加します。次の表では、どちらの方法でも必要になるプロパティについて説明しています。

NOTE
リポジトリーに設定を追加する場合のサービス PID は次のとおりです。
com.adobe.granite.workflow.purge.Scheduler
このサービスはファクトリサービスなので、sling:OsgiConfig ノードの名前には次のような ID サフィックスが必要です。
com.adobe.granite.workflow.purge.Scheduler-myidentifier
プロパティ名(Web コンソール)
OSGi プロパティ名
説明
ジョブ名
scheduledpurge.name
スケジュールされたパージのわかりやすい名前。
ワークフローのステータス
scheduledpurge.workflowStatus

パージするワークフローインスタンスのステータス。 有効な値は次のとおりです。

  • 完了:完了したワークフローインスタンスはパージされます。
  • 実行中:実行中のワークフローインスタンスはパージされます。
パージするモデル
scheduledpurge.modelIds

パージするワークフローモデルの ID。この ID はモデルノードのパスです(例:
/conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
)。すべてのワークフローモデルのインスタンスをパージする場合は、値を指定しません。

複数のモデルを指定するには、Web コンソールの + ボタンをクリックします。

ワークフローの期間
scheduledpurge.daysold
パージするワークフローインスタンスの経過期間(日数)。

インボックスの最大サイズの設定 setting-the-maximum-size-of-the-inbox

インボックスの最大サイズは、Web コンソールを使用して Adobe Granite Workflow Service を設定する、またはリポジトリに OSGi 設定を追加することで設定できます。次の表では、どちらの方法でも設定するプロパティについて説明しています。

NOTE
リポジトリーに設定を追加する場合のサービス PID は次のとおりです。
com.adobe.granite.workflow.core.WorkflowSessionFactory
プロパティ名(Web コンソール)
OSGi プロパティ名
インボックスクエリの最大サイズ
granite.workflow.inboxQuerySize
recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8