Adobe Experience League

ワークフローステップのリファレンス

ワークフローモデルは、各種タイプの一連のステップで構成されます。これらのステップを、それぞれのタイプに応じてパラメーターやスクリプトで設定および拡張し、必要な機能とコントロールを実現することができます。

メモ

この節では、標準ワークフローのステップについて説明します。

モジュール固有のステップについては、次の資料も参照してください。

ステップのプロパティ

各ステップコンポーネントには、ステップのプロパティダイアログがあり、必要なプロパティを定義および編集できます。

Step Properties - Common tab

大部分のワークフローステップコンポーネントでは、プロパティダイアログの「共通」タブで、次のプロパティを組み合わせて使用できます。

タイトル

手順のタイトル。
説明

手順の説明。
ワークフローステージ

ステップにステージを適用するドロップダウンセレクター。
タイムアウト

ステップが「タイムアウト」されるまでの期間。

次のいずれかを選択できます。オフオフ, 1h, 6h, 12h, 24h。
タイムアウトハンドラー

ステップがタイムアウトしたときにワークフローを制御するハンドラ。例：

Auto Advancer
ハンドラー処理の設定

実行後、ワークフローを自動的に次の手順に進める場合は、このオプションを選択します。選択しない場合、実装スクリプトでワークフローの進行を処理する必要があります。

ステップのプロパティ - 「ユーザー／グループ」タブ

多くのワークフローステップコンポーネントでは、プロパティダイアログの「ユーザー／グループ」タブで、次のプロパティを使用できます。

電子メールでユーザーに通知します
- ワークフローがステップに到達したときに、参加者に電子メールを送信して通知できます。
- 有効にすると、User/Group プロパティによって定義されたユーザーに、またはグループが定義されている場合はグループの各メンバーに、電子メールが送信されます。
ユーザー / グループ
- ドロップダウン選択ボックスを使用して、ユーザーやグループ間を移動し、選択することができます
- 特定のユーザーにステップを割り当てた場合は、そのユーザーだけがステップのアクションを実行できます。
- この手順をグループ全体に割り当てる場合、ワークフローがこの手順に達すると、このグループ内のすべてのユーザーは、ワークフローの受信トレイにアクションを持ちます。
- 詳しくは、ワークフローへの参加を参照してください。

AND 分割

AND Splitは、ワークフロー内に分割を作成します。その後、両方の分岐がアクティブになります。必要に応じて、各ブランチにワークフローステップを追加できます。このステップを使用して、ワークフローに複数の処理パスを導入できます。例えば、複数のレビューステップを並列で発生させ、時間を節約することができます。

wf-26

AND 分割 - 設定

AND Splitプロパティを編集します。
- 名前の分割:説明のために名前を割り当てます。
- 必要なブランチの数（2、3、4 または 5）を選択します。
必要に応じて、各ブランチにワークフローステップを追加します。

コンテナステップ

コンテナステップは、子ワークフローとして実行される別のワークフローモデルを開始します。

このコンテナを使用すると、一般的な手順のシーケンスを実装するためにワークフローモデルを再利用できます。例えば、1 つの翻訳ワークフローモデルを複数の編集ワークフローで使用することができます。

wf-28

コンテナステップ - 設定

このステップを設定するには、次のタブを編集および使用します。

共通
コンテナ
- サブワークフロー：開始するワークフローを選択します。

移動ステップ

移動ステップを使用すると、ワークフローモデル内で実行する次のステップを ECMAScript の結果に応じて指定できます。

true：移動ステップが完了すると、ワークフローエンジンが指定のステップを実行します。
false：移動ステップが完了すると、通常のルーティングロジックが次に実行するステップを決定します。

移動ステップを使用すると、ワークフローモデル内に詳細なルーティング構造を実装できます。例えば、ループを実装するには、スクリプトでループ条件を評価し、Goto Stepを定義して、ワークフロー内で前のステップを実行します。

移動ステップ - 設定

このステップを設定するには、次のタブを編集および使用します。

共通
プロセス
- 移動する手順:実行するステップを選択します。
- Script Path:手順 Gotoを実行するかどうかを決定するECMAScriptへのパス。
- スクリプト:手順 Gotoを実行するかどうかを決定するECMAScript。

注意

「スクリプトのパス」または「スクリプト」のどちらかを指定してください。両方のオプションを同時に使用することはできません。両方のプロパティに値を指定した場合、手順ではスクリプトパスが使用されます。

ループのシミュレート

ループをシミュレートするには、発生したループの繰り返し回数を記録する必要があります。

この回数は、一般的に、アクションの対象となるワークフロー内の項目のインデックスを表します。
この回数がループの終了基準として評価されます。

例えば、複数の JCR ノードに対してアクションを実行するワークフローを実装するには、ループカウンターをノードのインデックスとして使用できます。回数を保持するには、ワークフローインスタンスのデータマップに integer 値を保存します。回数を増分したり、回数を終了基準と比較するには、移動ステップのスクリプトを使用します。

function check(){
   var count=0;
   var keyname="loopcount"
   try{
      if (workflowData.getMetaDataMap().containsKey(keyname)){ 
        log.info("goto script: found loopcount key");
        count= parseInt(workflowData.getMetaDataMap().get(keyname))+1;
      } 
 
     workflowData.getMetaDataMap().put(keyname,count);
 
     }catch(err) {
         log.info(err.message);
         return false;
    }
   if (parseInt(count) <7){
       return true;
   } else {
      return false;
   }
}

OR 分割

OR 分割は、ワークフロー内に分割を作成し、どちらか 1 つのブランチだけをアクティブにします。これを使用すると、ワークフローに条件付き処理パスを導入できます。必要に応じて、各ブランチにワークフローステップを追加できます。

メモ

OR分割の作成の詳細は、次を参照してください。https://helpx.adobe.com/experience-manager/using/aem64_workflow_servlet.html

wf-29

OR 分割 - 設定

OR Splitプロパティを編集します。
- 共通
  - 必要なブランチの数（2、3、4 または 5）を選択します。
- 分岐： x>
  - スクリプトのパス：スクリプトが格納されたファイルへのパス。
  - スクリプト：スクリプトをボックス内に追加します。
  - デフォルトのルート：複数のブランチが true に評価される場合は、デフォルトのブランチが適用されます。デフォルトとして指定できるブランチは 1 つだけです。
メモ
ブランチごとに別個のタブがあります。
- 各ブランチのスクリプトは一度に 1 つずつ評価されます。
- ブランチは左から右の順番で評価されます。
- trueに評価される最初のスクリプトが実行されます。
- どの分岐もtrueと評価されない場合、ワークフローは進みません。
注意

「スクリプトのパス」または「スクリプト」のどちらかを指定してください。両方のオプションを同時に使用することはできません。両方のプロパティに値を指定した場合、手順ではスクリプトパスが使用されます。

メモ

OR 分割用のルールの定義を参照してください。
必要に応じて、各ブランチにワークフローステップを追加します。

参加者ステップと参加者選択

Participant Step

参加者ステップでは、特定のアクションの所有者を割り当てることができます。ワークフローは、ユーザーが手動で手順を確認した場合にのみ続行されます。これは、ワークフローに関するアクションを誰かに実行させる場合に使用します。例えば、レビューステップです。

余談になりますが、アクションを割り当てる際には、ユーザー認証を考慮する必要があります。ユーザーは、ワークフローのペイロードであるページにアクセスする必要があるからです。

参加者ステップ - 設定

このステップを設定するには、次のタブを編集および使用します。

共通
ユーザー / グループ

メモ

次の場合、ワークフロー開始者には常に通知が送信されます。

ワークフローが完了しました（完了しました）。
ワークフローが中止されました（終了されました）。

メモ

一部のプロパティでは、電子メール通知を有効にするように設定する必要があります。電子メールテンプレートをカスタマイズしたり、新しい言語用の電子メールテンプレートを追加することもできます。AEMで電子メール通知を設定するには、「電子メール通知の設定」を参照してください。

ダイアログ参加者ステップ

ダイアログ参加者ステップは、作業項目を割り当てられたユーザーから情報を収集するために使用します。このステップは、ワークフロー内で後で使用する少量のデータを収集するのに役立ちます。

ステップの完了時、作業項目を完了ダイアログには、ダイアログで定義したフィールドが表示されます。各フィールドで収集されたデータは、ワークフローペイロードのノードに保存されます。後続のワークフローステップは、この値をリポジトリから読み取ることができます。

このステップを設定するには、作業項目を割り当てるユーザーまたはグループ、およびダイアログへのパスを指定します。

ダイアログ参加者ステップ - 設定

このステップを設定するには、次のタブを編集および使用します。

共通
ユーザー / グループ
ダイアログ
- ダイアログパス:🔗を作成するダイアログのダイアログノードへのパス。

ダイアログ参加者の手順 — ダイアログの作成

ダイアログを作成するには：

収集されたデータをペイロード内に保存する場所を決定します。
ダイアログを定義します。データの収集（および保存）に使用するフィールドの定義も含まれます。

ダイアログ参加者ステップ - ペイロードにデータを保存

ウィジェットデータは、ワークフローペイロードまたは作業項目のメタデータに保存できます。widget ノードの name プロパティの形式によって、データの保存場所が決定されます。

データをペイロードと共に保存
- ウィジェットデータをワークフローペイロードのプロパティとして保存するには、ウィジェットノードのnameプロパティの値に次の形式を使用します。
  
  ./jcr:content/nodename
- データは、ペイロードのノードの nodename プロパティに保存されます。ノードにこのプロパティが含まれていない場合は、プロパティが作成されます。
- ペイロードと共に保存した場合は、後で同じペイロードを持つダイアログを使用したときに、プロパティの値が上書きされます。
データを作業項目と共に保存
- ウィジェットデータを作業項目メタデータのプロパティとして保存するには、nameプロパティの値に次の形式を使用します。
  
  nodename
- データは、作業項目metadataのnodenameプロパティに保存されます。この場合は、同じペイロードを持つダイアログを使用しても、データは保存されます。

ダイアログ参加者ステップ - ダイアログ定義

ダイアログ構造

ダイアログ参加者ステップのダイアログは、コンポーネントのオーサリング用に作成するダイアログと似ています。ダイアログは、次の場所に保存されます。

/apps/myapp/workflow/dialogs

標準のタッチ操作対応 UI 用ダイアログは、次のノード構造を持ちます。
```
newComponent (cq:Component)
  |- cq:dialog (nt:unstructured)
    |- content 
      |- layout 
        |- items 
          |- column 
            |- items 
              |- component0
              |- component1
              |- ...
```
メモ

詳しくは、ダイアログの作成と設定を参照してください。
ダイアログパスのプロパティ

ダイアログ参加者ステップには、ダイアログパスプロパティがあります（参加者ステップのプロパティと共に使用）。 ダイアログパスのプロパティの値は、ダイアログの dialog ノードへのパスです。

例えば、ダイアログが、ノードに保存されている EmailWatch というコンポーネントに含まれているとします。

/apps/myapp/workflows/dialogs

タッチ操作対応 UI の場合、ダイアログパスのプロパティには次の値を使用します。

/apps/myapp/workflow/dialogs/EmailWatch/cq:dialog

ダイアログ定義の例

次の XML コードスニペットは、ペイロードコンテンツの String ノードに watchEmail 値を保存するダイアログを表しています。title ノードは、TextField コンポーネントを表します。

jcr:primaryType="nt:unstructured" 
    jcr:title="Watcher Email Address Dialog" 
    sling:resourceType="cq/gui/components/authoring/dialog">
    <content jcr:primaryType="nt:unstructured"
        sling:resourceType="granite/ui/components/foundation/container">
        <layout jcr:primaryType="nt:unstructured" 
            margin="false" 
            sling:resourceType="granite/ui/components/foundation/layouts/fixedcolumns"
        />
        <items jcr:primaryType="nt:unstructured">
            <column jcr:primaryType="nt:unstructured"
                sling:resourceType="granite/ui/components/foundation/container">
                <items jcr:primaryType="nt:unstructured">
                    <title jcr:primaryType="nt:unstructured" 
                        fieldLabel="Notification Email Address" 
                        name="./jcr:content/watchEmails"
                        sling:resourceType="granite/ui/components/foundation/form/textfield"
                    />
                </items>
            </column>
        </items>
    </content>
</cq:dialog>

タッチ操作対応 UI の場合、この例は次のようなダイアログになります。

chlimage_1-177

動的参加者ステップ

動的参加者ステップコンポーネントは参加者ステップに似ていますが、参加者が実行時に自動的に選択される点が異なります。

このステップを設定するには、ダイアログと、作業項目を割り当てる参加者を識別する参加者選択を選択します。

動的参加者ステップ - 設定

このステップを設定するには、次のタブを編集および使用します。

共通
参加者選択
- 参加者選択：作成する参加者選択の名前。
- 引数：必要なすべての引数。
- 電子メール：電子メール通知をユーザーに送信するかどうか。
ダイアログ
- ダイアログパス：作成するダイアログ（ダイアログ参加者ステップの場合と同様）の dialog ノードへのパス。

動的参加者ステップ - 参加者選択の作成

参加者選択を作成します。そのために、あらゆる選択ロジックまたは選択条件を使用できます。例えば、参加者選択を使用して、（グループ内で）最も作業項目が少ないユーザーを選択できます。任意の数の参加者選択を作成して、ワークフローモデル内の動的参加者ステップコンポーネントの異なるインスタンスで使用できます。

作業項目を割り当てるユーザーを選択する OSGi サービスまたは ECMAScript を作成します。

ECMAScript

スクリプトには、ユーザー ID を String 値として返す、getParticipant という関数を含める必要があります。カスタムスクリプトは、/apps/myapp/workflow/scriptsフォルダーやサブフォルダーなどに保存します。

標準 AEM インスタンスには、次のサンプルスクリプトが付属しています。

/libs/workflow/scripts/initiator-participant-chooser.ecma

注意

/libs パス内の設定は一切変更しないでください。

これは、次回インスタンスをアップグレードする際に/libsの内容が上書きされるためです（修正プログラムまたは機能パックを適用すると、上書きされる場合があります）。

このスクリプトは、ワークフロー開始者を参加者として選択します。
```
function getParticipant() {
    return workItem.getWorkflow().getInitiator();
}
```
メモ

ワークフロー開始者参加者選択機能コンポーネントは、動的参加者手順を拡張し、このスクリプトを手順の実装として使用します。
OSGi サービス

サービスでは、com.day.cq.workflow.exec.ParticipantStepChooserインターフェイスを実装する必要があります。このインターフェイスは、次の構成要素を定義します。
- SERVICE_PROPERTY_LABEL フィールド：このフィールドを使用して、参加者選択の名前を指定します。この名前が、動的参加者ステップのプロパティで使用可能な参加者選択のリストに表示されます。
- getParticipant メソッド：動的に解決されるプリンシパルIDを String 値として返します。
注意

getParticipantメソッドは、動的に解決されるプリンシパルIDを返します。この ID は、グループ ID またはユーザー ID のいずれかになります。

ただし、グループ ID を使用できるのは、参加者ステップに対してのみです（参加者のリストが返された場合）。動的参加者ステップに対して空のリストが返され、これを委任に使用することはできません。

動的参加者ステップコンポーネントに対して実装を使用可能にするには、サービスを書き出す OSGi バンドルに Java クラスを追加し、バンドルを AEM サーバーにデプロイします。

メモ

ランダム参加者選択は、ランダムにユーザーを選択するサンプルサービスです（com.day.cq.workflow.impl.process.RandomParticipantChooser）。ランダム参加者選択ステップコンポーネントのサンプルは、動的参加者ステップを拡張し、このサービスをステップ実装として使用します。

動的参加者ステップ - 参加者選択サービスの例

次の Java クラスは、ParticipantStepChooser インターフェイスを実装します。このクラスは、ワークフローを開始した参加者の名前を返します。コードでは、サンプルスクリプト(initator-participant-chooser.ecma)で使用しているのと同じロジックが使用されます。

@Property注釈は、SERVICE_PROPERTY_LABELフィールドの値をWorkflow Initiator Participant Chooserに設定します。

package com.adobe.example;

import org.apache.felix.scr.annotations.Component;
import org.apache.felix.scr.annotations.Properties;
import org.apache.felix.scr.annotations.Property;
import org.apache.felix.scr.annotations.Service;
import org.osgi.framework.Constants;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import com.adobe.granite.workflow.WorkflowException;
import com.adobe.granite.workflow.WorkflowSession;
import com.adobe.granite.workflow.exec.ParticipantStepChooser;
import com.adobe.granite.workflow.exec.WorkItem;
import com.adobe.granite.workflow.metadata.MetaDataMap;

@Component
@Service
@Properties({
        @Property(name = Constants.SERVICE_DESCRIPTION, value = "An example implementation of a dynamic participant chooser."),
        @Property(name = ParticipantStepChooser.SERVICE_PROPERTY_LABEL, value = "Workflow Initiator Participant Chooser (service)") })
public class InitiatorParticipantChooser implements ParticipantStepChooser {

 private Logger logger = LoggerFactory.getLogger(this.getClass());

 public String getParticipant(WorkItem arg0, WorkflowSession arg1,
   MetaDataMap arg2) throws WorkflowException {

  String initiator = arg0.getWorkflow().getInitiator();
  logger.info("Assigning Dynamic Participant Step work item to {}",initiator);

  return initiator;
 }
}

動的参加者ステップのプロパティダイアログで、参加者選択リストには、このサービスを表す項目Workflow Initiator Participant Chooser (script)が含まれます。

「ワークフローモデルが開始されると、ログには、ワークフローを開始したユーザーのIDと、作業項目が割り当てられているユーザーのIDが示されます。この例では、admin ユーザーがワークフローを開始しています。

13.09.2015 15:48:53.037 *INFO* [10.176.129.223 [1347565733037] POST /etc/workflow/instances HTTP/1.1] com.adobe.example.InitiatorParticipantChooser Assigning Dynamic Participant Step work item to admin

フォーム参加者ステップ

フォーム参加者ステップは、作業項目が開かれるとフォームを表示します。ユーザーがフォームに入力して送信すると、フィールドデータがワークフローペイロードのノードに保存されます。

このステップを設定するには、作業項目を割り当てるユーザーまたはグループ、およびフォームへのパスを指定します。

注意

この節では、ページオーサリング用のFoundationコンポーネントのFormsの節について説明します。

フォーム参加者ステップ - 設定

このステップを設定するには、次のタブを編集および使用します。

共通
ユーザー / グループ
フォーム
- Form Path:作成するフォームへのパス。

フォーム参加者ステップ - フォームの作成

通常どおり、フォーム参加者ステップで使用するフォームを作成します。ただし、フォーム参加者ステップ用のフォームには、次の設定が必要です。

フォームコンポーネントの開始には、Action TypeプロパティをEdit Workflow Controlled Resource(s)に設定する必要があります。
フォームコンポーネントの開始は、Form Identifierプロパティの値を持つ必要があります。
フォームコンポーネントでは、エレメント名プロパティを、フィールドデータを保存するノードのパスに設定する必要があります。パスは、ワークフローペイロードコンテンツ内のノードを見つける必要があります。値には次の形式を使用します。

./jcr:content/path_to_node
フォームには、ワークフロー送信ボタンコンポーネントが含まれている必要があります。このコンポーネントのプロパティは一切設定しないでください。

ワークフローの要件によって、フィールドデータを保存する場所が決定されます。例えば、フィールドデータを使用して、ページコンテンツのプロパティを設定できます。次のElement Nameプロパティの値は、jcr:contentノードのredirectTargetプロパティの値としてフィールドデータを保存します。

./jcr:content/redirectTarget

次の例では、フィールドデータがペイロードページのTextコンポーネントのコンテンツとして使用されます。

./jcr:content/par/text_3/text

"最初の例は、cq:Pageコンポーネントがレンダリングするページに使用できます。 2 番目の例は、ペイロードページに「」という ID を持つテキストtext_3コンポーネントが含まれる場合にのみ使用できます。

フォームは、リポジトリ内のどこにでも配置できますが、ワークフローユーザーにはフォームを読み取るための権限が必要です。

ランダム参加者選択

ランダム参加者選択ステップは、生成された作業項目をリストからランダムに選択されたユーザーに割り当てる参加者選択機能です。

wf-31

ランダム参加者選択 - 設定

このステップを設定するには、次のタブを編集および使用します。

共通
引数
- 参加者：選択に使用できるユーザーのリストを指定します。ユーザーをリストに追加するには、「項目を追加」をクリックし、ユーザーノードのホームパスまたはユーザー ID を入力します。ユーザーの順序は、作業項目が割り当てられる可能性に影響を与えません。

ワークフローイニシエーター参加者選択

ワークフローイニシエーター参加者選択ステップは、生成された作業項目を、そのワークフローを開始したユーザーに割り当てる参加者選択です。共通プロパティ以外に、設定するプロパティはありません。

ワークフローイニシエーター参加者選択 - 設定

このステップを設定するには、次のタブを使用して編集します。

共通

プロセスステップ

プロセスステップは、ECMAScriptを実行するか、OSGiサービスを呼び出して自動処理を実行します。

wf-32

プロセスステップ - 設定

このステップを設定するには、次のタブを編集および使用します。

共通
プロセス
- プロセス：実行するプロセス実装。ドロップダウンメニューを使用して、ECMAScriptまたはOSGiサービスを選択します。参考情報：
  - 標準の ECMAScript および OSGi サービスについては、プロセスステップ用のビルトインプロセスを参照してください。
  - プロセス手順用のECMAScriptの作成については、ECMAScriptを使用したプロセス手順の実装を参照してください。
  - プロセスステップ用のOSGiサービスの作成については、Javaクラスを使用したプロセスステップの実装を参照してください。
- ハンドラー処理の設定：実行後にワークフローを次のステップに自動的に進めるには、このオプションを選択します。選択しない場合、実装スクリプトでワークフローの進行を処理する必要があります。
- 引数：プロセスに渡される引数。

adobe.com 上のリソース

Multichannel Communication Customer Communications Embedded Charts Mobile Forms Content As A Service Content Management

このページ

次を表示：

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now

ワークフローステップのリファレンス

ステップのプロパティ

Step Properties - Common tab

ステップのプロパティ - 「ユーザー／グループ」タブ

AND 分割

AND 分割 - 設定

コンテナステップ

コンテナステップ - 設定

移動ステップ

移動ステップ - 設定

ループのシミュレート

OR 分割

OR 分割 - 設定

参加者ステップと参加者選択

Participant Step

参加者ステップ - 設定

ダイアログ参加者ステップ

ダイアログ参加者ステップ - 設定

ダイアログ参加者の手順 — ダイアログの作成

ダイアログ参加者ステップ - ペイロードにデータを保存

ダイアログ参加者ステップ - ダイアログ定義

動的参加者ステップ

動的参加者ステップ - 設定

動的参加者ステップ - 参加者選択の作成

動的参加者ステップ - 参加者選択サービスの例

フォーム参加者ステップ

フォーム参加者ステップ - 設定

フォーム参加者ステップ - フォームの作成

ランダム参加者選択

ランダム参加者選択 - 設定

ワークフローイニシエーター参加者選択

ワークフローイニシエーター参加者選択 - 設定

プロセスステップ

プロセスステップ - 設定

adobe.com 上のリソース

このページ

次を表示：

Time to shine!

Time to shine!

トレーニング

ドキュメント

コミュニティ

サポート

リソース

Adobeアカウント

Adobe