Experience League

Exit search

ワークフローモデルの作成

注意

クラシック UI の使用方法については、AEM 6.3 のドキュメントを参照してください。

ワークフローを開始したときに実行される一連のステップを定義するには、ワークフローモデルを作成します。ワークフローを一時的なものにするか、複数のリソースを使用するかなど、モデルのプロパティを定義することもできます。

ユーザーがワークフローを開始すると、インスタンスが開始されます。これは対応するランタイムモデルです。変更内容を同期すると作成されます。

新しいワークフローの作成

初めて作成する新しいワークフローモデルには、次のものが含まれています。

フロー開始ステップとフロー終了ステップ。
これらのステップは、ワークフローの始まりと終わりを表します。これらのステップは必須で、編集または削除できません。
「手順 1」という名前のサンプルの参加者ステップ。
このステップは、作業項目をワークフロー開始者に割り当てるように設定されています。このステップを編集または削除し、必要に応じてステップを追加します。

エディターを使用して新しいワークフローを作成するには：

ツール／ワークフロー／モデルの順にクリックするか、https://localhost:4502/aem/workflow などからワークフローモデルコンソールを開きます。
「作成」を選択してから、「モデルを作成」を選択します。
ワークフローモデルを追加ダイアログが表示されます。「タイトル」と「名前」（オプション）を入力してから、「完了」を選択します。
新しいモデルがワークフローモデルコンソールに表示されます。
新しいワークフローを選択し、「編集」をクリックすると、ワークフローが設定のために開かれます。

メモ

（CRX パッケージを使用して）プログラムによってモデルを作成する場合は、次の場所にサブフォルダーを作成することもできます。

/var/workflow/models

例：/var/workflow/models/prototypes

このフォルダーは、そのフォルダー内のモデルへのアクセス権を管理するために利用できます。

ワークフローの編集

既存のワークフローモデルを編集して、次のことができます。

ステップとパラメーターを定義する
ステージ、ワークフローを一時的にするか、複数のリソースを使用するかなど、ワークフロープロパティを設定する

デフォルトおよびレガシー（初期設定）のワークフローを編集する場合は、変更を加える前に、セーフコピーを作成する追加の手順が必要になります。

ワークフローの変更を完了するには、「同期」を使用して、ランタイムモデルを生成する必要があります。詳しくは、ワークフローの同期を参照してください。

ワークフローの同期 - ランタイムモデルの生成

「同期」（エディターのツールバーの右側）をクリックすると、ランタイムモデルが生成されます。ランタイムモデルは、ユーザーがワークフローを開始したときに実際に使用されるモデルです。変更内容を同期しない場合は、その変更内容は実行時には反映されません。

ワークフローに変更を加えた場合は、「同期」をクリックしてランタイムモデルを生成する必要があります。個々のダイアログ（ステップなど）に保存オプションがある場合でも同様です。

変更内容がランタイム（保存済み）モデルと同期されると、「同期済み」に表示が変わります。

ステップによっては必須のフィールドや組み込みの検証が含まれている場合があります。こうした条件を満たしていない場合は、モデルの同期をおこなうと、エラーが表示されます。例えば次のように、参加者ステップで参加者が定義されていない場合などです。

wf-21

デフォルトまたはレガシーのワークフローの初回編集時

デフォルトまたはレガシーのモデルを開いて編集する際は、次の点に注意してください。

ステップブラウザーを利用できません（左側）。
ツールバーで「編集」操作を利用できます（右側）。
次の理由から、最初はモデルとそのプロパティが読み取り専用モードで開かれます。
- デフォルトのワークフローは /libs にあります。
- レガシーワークフローは /etc にあります。
  選択
  編集を選択すると、次のようになります。
ワークフローが /conf にコピーされます。
ステップブラウザーを利用できるようになります。
変更を加えられるようになります。

メモ

詳しくは、ワークフローモデルの場所を参照してください。

wf-22

モデルにステップを追加

実行するアクティビティを表すために、ステップをモデルに追加する必要があります。各ステップは固有のアクティビティを実行します。標準の AEM インスタンスには、いくつかのステップコンポーネントが用意されています。

モデルを編集する際は、ステップブラウザーの様々なグループに利用可能なステップが表示されます。次に例を示します。

wf-10

メモ

AEM と共にインストールされる主なステップコンポーネントについては、ワークフローステップのリファレンスを参照してください。

ワークフローモデルへのステップの追加手順

編集する既存のワークフローモデルを開きます。ワークフローモデルコンソールで、必要なモデルを選択し、編集をクリックします。
サイドパネルを切り替え（上部ツールバーの左端）を使用してステップブラウザーを開きます。ここでは、以下のことができます。
- フィルターを使用して特定のステップのみを表示する。
- ドロップダウンセレクターを使用して、選択対象を特定のステップのグループに限定する。
- 「説明を表示アイコン」を選択して、適切な手順の詳細を確認する。
対象のステップをドラッグしてモデル内の目的の場所に移動します。

参加者ステップなどです。

フローに追加したら、ステップを設定できます。
必要に応じてステップを追加したり、変更を加えたりします。

実行時には、ステップがモデル内に配置されている順序で実行されます。いったん追加したステップコンポーネントを、モデル内の別の場所にドラッグすることもできます。

ページエディターと同様に、ステップのコピー、切り取り、貼り付け、グループ分け、削除をおこなうこともできます。

分割ステップは、ツールバーオプションを利用して折りたたんだり展開したりできます。
同期（エディターツールバー）をクリックして変更内容を確認し、ランタイムモデルを生成します。

詳しくは、ワークフローの同期を参照してください。

ワークフローステップの設定

ステップのプロパティダイアログを使用して、ワークフローステップの動作を設定およびカスタマイズできます。

ステップに対応するステップのプロパティダイアログを開くには、次のどちらかを実行します。
- ワークフローモデルの* *ステップをクリックまたはタップし、コンポーネントのツールバーから設定を選択します。
- ステップをダブルクリックします。
メモ

AEM と共にインストールされる主なステップコンポーネントについては、ワークフローステップのリファレンスを参照してください。
必要に応じてステップのプロパティを設定します。利用できるプロパティはステップのタイプによって異なります。複数のタブが表示されることもあります。例えば、新しいワークフローで Step 1 として表示されるデフォルトの参加者ステップでは、次のようになります。
チェックマークをクリックして、アップデート内容を確認します。
同期（エディターツールバー）をクリックして変更内容を確認し、ランタイムモデルを生成します。

詳しくは、ワークフローの同期を参照してください。

一時的ワークフローの作成

新しいモデルを作成するときに、または既存のモデルに手を加えて、一時的ワークフローモデルを作成することができます。

編集するワークフローモデルを開きます。
ツールバーから「ワークフローモデルのプロパティ」を選択します。
ダイアログで、一時的ワークフローをアクティベート（または必要に応じてアクティベートを解除）します。
「保存して閉じる」をクリックし、同期（エディターツールバー）をクリックして変更内容を確認し、ランタイムモデルを生成します。

詳しくは、ワークフローの同期を参照してください。

メモ

ワークフローを一時的モードで実行した場合は、AEM にはワークフロー履歴が保存されません。したがって、そのワークフローに関連する情報は、タイムラインに表示されません。

タッチ UI でワークフローモデルを使用可能にする

クラシック UI に表示されるワークフローモデルがタッチ UI のタイムラインレールの選択ポップアップメニューに表示されない場合は、設定に従ってワークフローモデルを使用可能にします。以下の手順は、アクティベーションのリクエストと呼ばれるワークフローモデルの使用を説明します。

該当するモデルがタッチ対応 UI で使用できないことを確認します。/assets.html/content/dam パスを使用してアセットにアクセスします。アセットを選択します。左側のレールでタイムラインを開きます。ワークフローを開始をクリックして、アクティベーションのリクエスト モデルがポップアップリストに存在しないことを確認します。
ツール／一般／タグ付けと移動します。ワークフローを選択します。
「作成／タグを作成」を選択します。タイトルを DAM に、名前を dam に、それぞれ設定します。送信を選択します。
ツール／ワークフロー／モデルに移動します。アクティベーションのリクエストを選択し、次に編集を選択してください。
編集を選択し、ページ情報メニューを開き、そこからプロパティを開くを選択してから、基本タブ（まだ開いていない場合）に移動してください。
Workflow : DAM をタグフィールドに追加します。チェック（チェックマーク）で選択を確認します。
保存して閉じるでタグの追加を確認します。
同期でプロセスを完了します。タッチ操作対応 UI でワークフローを使用できるようになりました。

マルチリソースのサポートのためのワークフローの設定

新しいモデルを作成するときに、または既存のモデルに手を加えて、マルチリソースのサポートのためのワークフローモデルを設定できます。

編集するワークフローモデルを開きます。
ツールバーから「ワークフローモデルのプロパティ」を選択します。
ダイアログで、マルチリソースのサポートをアクティベート（または必要に応じてアクティベートを解除）します。
変更内容を「保存して閉じる」で確認し、「同期」（エディターツールバー）でランタイムモデルを生成します。

詳しくは、ワークフローの同期を参照してください。

（ワークフローの進行状況を表示する）ワークフローステージの設定

ワークフローステージは、タスクを処理するときにワークフローの進行状況を確認するのに役立ちます。

注意

ワークフローステージがページのプロパティで定義されていても、いずれのワークフローステップでも使用されない場合は、（現在のワークフローステップに関係なく）進行状況バーに進行状況は表示されません。

使用可能なステージは、ワークフローモデルで定義されます。既存のワークフローモデルを更新すると、ステージの定義を含めることができます。ワークフローモデルに対して任意の数のステージを定義できます。

ワークフローのステージを定義するには：

編集するワークフローモデルを開きます。
ツールバーから「ワークフローモデルのプロパティ」を選択します。「ステージ」タブを開きます。
必要なステージを追加（および配置）します。ワークフローモデルに対して任意の数のステージを定義できます。

次に例を示します。
「保存して閉じる」をクリックしてプロパティを保存します。
ワークフローモデルの各ステップにステージを割り当てます。次に例を示します。

1 つのステージを複数のステップに割り当てることができます。次に例を示します。

ステップ ステージ

手順 1 作成

手順 2 作成

手順 3 レビュー

手順 4 承認

手順 5 承認

手順 6 完了
「同期」（エディターツールバー）をクリックして変更内容を確定し、ランタイムモデルを生成します。

詳しくは、ワークフローの同期を参照してください。

ステップ	ステージ
手順 1	作成
手順 2	作成
手順 3	レビュー
手順 4	承認
手順 5	承認
手順 6	完了

パッケージのワークフローモデルのエクスポート

パッケージのワークフローモデルを書き出す方法は次のとおりです。

パッケージマネージャーを使用して新しいパッケージを作成します。
1. ツール／導入／パッケージに移動してパッケージマネージャーにアクセスします。
2. 「パッケージを作成」をクリックします。
3. パッケージ名と、その他の必要な情報を指定します。
4. 「OK」をクリックします。
新しいパッケージのツールバーの「編集」をクリックします。
「フィルター」タブを開きます。
「フィルターを追加」を選択し、ワークフローモデルの設計のパスを指定します。

/conf/global/settings/workflow/models/<*your-model-name*>

「完了」をクリックします。
「フィルターを追加」を選択し、ランタイムワークフローモデルのパスを指定します。

/var/workflow/models/<*your-model-name*>

「完了」をクリックします。
モデルで使用されるカスタムスクリプトのフィルターを追加します。
「保存」をクリックしてフィルターの定義を確定します。
パッケージ定義のツールバーの「ビルド」を選択します。
パッケージのツールバーの「ダウンロード」を選択します。

ワークフローを使用したフォーム送信処理

フォームを特定のワークフローで処理するように設定できます。ユーザーがフォームを送信すると、フォームの送信データをペイロードとして持つ新しいワークフローインスタンスが作成されます。

フォームを使用するためのワークフローの設定手順

新しいページを作成して、編集用に開きます。
フォームコンポーネントをページに追加します。
ページに表示されたフォーム開始コンポーネントを設定します。
「ワークフローを開始」で、使用可能なワークフローの中から目的のワークフローを選択します。
チェックマークをクリックして、新しいフォーム設定を確認します。

ワークフローのテスト

ワークフローのテスト時には、開発時のタイプと異なるものも含め、様々なペイロードタイプを使用してワークフローをテストすることをお勧めします。例えば、アセットを処理するワークフローの場合、ページをペイロードとして設定して、ワークフローでエラーがスローされないことを確認します。

例えば、新しいワークフローを次のようにテストします。

コンソールからワークフローモデルを開始します。
ペイロードを定義して確定します。
ワークフローが進行するように、必要なアクションを実行します。
ワークフローの動作中にログファイルを監視します。

ログファイルにデバッグメッセージを記録するように AEM を設定することもできます。詳しくは、ログを参照してください。開発が完了したら、ログレベルを情報に戻します。

例

例：公開のリクエストを承認／拒否する（単純な）ワークフローの作成

ワークフロー作成の可能性をいくつか示すために、ここでは、Publish Example ワークフローのバリエーションを作成します。

新しいワークフローモデルを作成します。

新しいワークフローには、次のステップが含まれます。
- フロー開始
- Step 1
- フロー終了
Step 1 を削除します（この例には不適切なステップタイプです）。
- ステップをクリックし、コンポーネントツールバーの「削除」を選択します。アクションを確認します。
ステップブラウザーのワークフロー選択欄から、参加者ステップをワークフローにドラッグして、「フロー開始」と「フロー終了」の間に配置します。
次のいずれかの方法でプロパティダイアログを開きます。
- 参加者ステップをクリックし、コンポーネントツールバーの「設定」を選択します。
- 参加者ステップをダブルクリックします。
「共通」タブで、「タイトル」と「説明」の両方に Validate Content と入力します。
「ユーザー / グループ」タブを開きます。
- 「電子メールでユーザーに通知します」を有効にします。
- 「ユーザー／グループ」フィールドで「Administrator（admin）」を選択します。
メモ

電子メールを送信するには、メールサービスとユーザーアカウントの詳細を設定する必要があります。
チェックマークをクリックして、変更内容を確認します。

ワークフローモデルの概要に戻ります。ここで、参加者ステップが Validate Content という名前に変更されます。
OR 分岐をワークフローにドラッグして、「Validate Content」と「フロー終了」の間に配置します。
OR 分割を設定用に開きます。
設定：
- 共通：分割名を指定します。
- ブランチ 1：「デフォルトのルート」を選択します。
- ブランチ 2：「デフォルトのルート」を選択しません。
OR 分割の変更内容を確定します。
参加者ステップを左側のブランチにドラッグし、プロパティを開き、次の値を指定してから変更内容を確定します。
- タイトル：Reject Publish Request
- ユーザー／グループ：projects-administrators など
- メールでユーザーに通知する：有効にすると、ユーザーにメールで通知が届きます。
プロセスステップを右側のブランチにドラッグし、プロパティを開き、次の値を指定してから変更内容を確認します。
- タイトル：Publish Page as Requested
- プロセス：Activate Page を選択します。このプロセスは、選択されているページをパブリッシャーインスタンスに公開します。
「同期」（エディターのツールバー）をクリックし、ランタイムモデルを生成します。

詳しくは、ワークフローの同期を参照してください。

新しいワークフローモデルは次のようになります。
このワークフローをページに適用します。その結果、ユーザーが「コンテンツを検証」ステップの「完了」に移動すると、「リクエストに応じてページを公開」と「公開リクエストを拒否」のどちらを実行するかを選択できます。

例：ECMA スクリプトを使用した OR 分割のルールの定義

OR 分割ステップを使用すると、ワークフローに条件分岐の処理パスを導入できます。

OR ルールを定義するには、次の手順に従います。

2 つのスクリプトを作成して、リポジトリ内の次の場所などに保存します。

/apps/myapp/workflow/scripts

メモ

スクリプトには、ブール値を返す関数 check() を含める必要があります。
ワークフローを編集し、OR 分割をモデルに追加します。
OR 分割のブランチ 1 のプロパティを編集します。
- 「値」を true に設定して、これを「デフォルトのルート」として定義します。
- 「ルール」として、そのスクリプトへのパスを設定します。次に例を示します。
  /apps/myapp/workflow/scripts/myscript1.ecma
メモ

必要に応じて、ブランチの順序を切り替えることができます。
OR 分割のブランチ 2 のプロパティを編集します。
- 「ルール」として、もう 1 つのスクリプトへのパスを設定します。次に例を示します。
  /apps/myapp/workflow/scripts/myscript2.ecma
各ブランチ内の個々のステップのプロパティを設定します。「ユーザー／グループ」が設定されていることを確認します。
「同期」（エディターのツールバー）をクリックして、ランタイムモデルに対する変更を保持します。

詳しくは、ワークフローの同期を参照してください。

関数 Check()

メモ

ECMAScript の使用を参照してください。

次のサンプルスクリプトは、ノードが /content/we-retail/us/en の下に位置する JCR_PATH の場合、true を返します。

function check() {
    if (workflowData.getPayloadType() == "JCR_PATH") {
      var path = workflowData.getPayload().toString();
      var node = jcrSession.getItem(path);

      if (node.getPath().indexOf("/content/we-retail/us/en") >= 0) {
       return true;
      } else {
       return false;
      }
     } else {
      return false;
     }
}

例：アクティベーション用にカスタマイズされたリクエスト

標準提供のワークフローは、いずれもカスタマイズすることができます。動作をカスタマイズするには、適切なワークフローの詳細をオーバーレイします。

例えば、アクティベーションをリクエストをカスタマイズするとします。このワークフローは、サイト内でページを公開するために使用され、コンテンツ作成者が適切なレプリケーション権限を持っていない場合に自動的に実行されます。詳しくは、ページオーサリングのカスタマイズ - アクティベーションをリクエストワークフローのカスタマイズを参照してください。

Business.Adobe.com リソース

Auto Text Summarization Automated Onboarding Personalized Experiences Theme Editor Headless Cms Content Management System