ワークフロー機能の拡張

このトピックでは、ワークフロー用のカスタムステップコンポーネントを作成する方法や、プログラムによってワークフローとやり取りする方法について説明します。

カスタムワークフローステップの作成では、次の作業をおこないます。

• ワークフローステップコンポーネントを作成する
• ステップ機能を OSGi サービスまたは ECMA スクリプトとして実装する

プログラムおよびスクリプトからワークフローを操作することもできます。

ワークフローステップコンポーネント - 基本

ワークフローステップコンポーネントは、ワークフローモデルの作成時にステップの外観と動作を定義するものです。

• ワークフローのサイドキックのカテゴリとステップ名。
• ワークフローモデルのステップの外観
• コンポーネントのプロパティを設定する編集ダイアログ
• 実行時に実行されるサービスまたはスクリプト

他のあらゆるコンポーネントと同様、ワークフローステップコンポーネントは、sling:resourceSuperType プロパティに指定されたコンポーネントから継承します。次の図は、すべてのワークフローステップコンポーネントの基礎を形成する cq:component ノードの階層を示しています。この図には、プロセスステップ、参加者ステップ、動的参加者ステップ​の各コンポーネントも含まれています。これらは、カスタムステップコンポーネントを開発する最も一般的で基本的な起点です。

/libs/cq/workflow/components/model/stepコンポーネントは、プロセス手順、参加者手順、動的参加者手順​の最も近い共通の祖先で、すべて次の項目を継承します。

• step.jsp

  step.jspスクリプトは、ステップコンポーネントがモデルに追加されたときに、ステップコンポーネントのタイトルをレンダリングします。

  

• cq:dialog

  ダイアログには次のタブがあります。

  • 共通：タイトルと説明の編集用です。
  • 詳細：電子メール通知プロパティの編集用です。

  

  メモ

  ステップコンポーネントの編集ダイアログのタブがこのデフォルトの外観と一致しない場合、ステップコンポーネントには、これらの継承されたタブをオーバーライドするスクリプト、ノードプロパティまたはダイアログタブが定義されています。

ECMA スクリプト

ECMAスクリプト内では、次のオブジェクトを使用できます（ステップのタイプに応じて異なります）。

• WorkItemworkItem

• WorkflowSessionworkflowSession

• WorkflowDataworkflowData

• args：プロセスの引数を格納する配列

• sling：他の OSGi サービスへのアクセス用

• jcrSession

MetaDataMap

ワークフローメタデータを使用すると、ワークフローの有効期間中に必要とされる情報を保持できます。ワークフローステップの一般的な要件は、そのワークフローで以降に使用するデータを保持したり、保持されているデータを取得することです。

MetaDataMapオブジェクトには、Workflow、WorkflowData、WorkItemの3種類があります。 メタデータを保存する目的は、すべて同じです。

WorkItem には、作業項目（ステップなど）の実行中にのみ使用できる固有の MetaDataMap があります。

WorkflowとWorkflowDataのメタデータマップは両方ともワークフロー全体で共有されます。 このような場合は、WorkflowData MetaDataMap だけを使用することをお勧めします。

カスタムワークフローステップコンポーネントの作成

ワークフローステップコンポーネントは、その他のコンポーネントと同じ方法で作成できます。

（既存の）ベースステップコンポーネントのいずれかから継承するには、次のプロパティを cq:Component ノードに追加します。

• 名前：sling:resourceSuperType

• 型：String

• 値：ベースコンポーネントに解決される次のパスのいずれか

  • cq/workflow/components/model/process
  • cq/workflow/components/model/participant
  • cq/workflow/components/model/dynamic_participant

ステップインスタンスのデフォルトのタイトルおよび説明の指定

「共通」タブの「タイトル」フィールドと「説明」フィールドのデフォルト値を指定するには、以下の手順を実行します。

1. cq:Componentノードの下に、次のノードを追加します。

   • 名前：cq:editConfig
   • 型：cq:EditConfig
   メモ

   cq:editConfigノードの詳細については、「コンポーネントの編集動作の設定」を参照してください。

2. cq:EditConfigノードの下に、次のノードを追加します。

   • 名前：cq:formParameters
   • 型：nt:unstructured

3. 次の追加名前のStringプロパティ（cq:formParametersノードに対する）:

   • jcr:title：この値が「共通」タブの「タイトル」フィールドに設定されます。
   • jcr:description：この値が「共通」タブの「説明」フィールドに設定されます。

ワークフローメタデータにプロパティ値を保存

cq:Widget 項目の name プロパティで、ウィジェットの値を保存する JCR ノードを指定します。ワークフロー手順のコンポーネントのダイアログ内のウィジェットが./metaDataノードの下に値を格納する場合、値はワークフローMetaDataMapに追加されます。

例えば、ダイアログのテキストフィールドは、次のプロパティを持つ cq:Widget ノードです。

名前	タイプ	値
xtype	String	textarea
name	String	./metaData/subject
fieldLabel	String	Email Subject

このテキストフィールドに指定する値は、ワークフローインスタンスの [MetaDataMap](#metadatamaps)オブジェクトに追加され、subjectキーに関連付けられます。

Overriding the Step Implementation

各基本手順コンポーネントにより、ワークフローモデル開発者は、設計時に次の主な機能を設定できます。

• プロセスステップ：実行時に実行されるサービスまたは ECMA スクリプト。
• 参加者ステップ：生成された作業項目を割り当てるユーザーの ID。
• 動的参加者ステップ：作業項目を割り当てるユーザーの ID を選択するサービスまたは ECMA スクリプト。

コンポーネントを特定のワークフローシナリオ専用にするために、デザイン時に設定した主要機能をモデル開発者が変更できないようにします。

1. cq:Component ノードの下に、次のノードを追加します。

   • 名前：cq:editConfig
   • 型：cq:EditConfig

   cq:editConfig ノードについて詳しくは、コンポーネントの編集動作の設定を参照してください。

2. cq:EditConfig ノードの下に、次のノードを追加します。

   • 名前：cq:formParameters
   • 型：nt:unstructured

3. 追加cq:formParametersノードのStringプロパティ。 コンポーネントのスーパータイプによって、プロパティの名前が次のように決定されます。

   • プロセスステップ: PROCESS
   • Participant Step: PARTICIPANT
   • 動的参加者ステップ: DYNAMIC_PARTICIPANT

4. プロパティの値を次のように指定します。

   • PROCESS：ステップの動作を実装する ECMA スクリプトへのパスまたはサービスの PID。
   • PARTICIPANT：作業項目を割り当てるユーザーの ID。
   • DYNAMIC_PARTICIPANT:作業項目を割り当てるユーザーを選択するECMAスクリプトのパスまたはサービスのPID。

5. モデル開発者がプロパティ値を変更できないようにするために、コンポーネントのスーパータイプのダイアログをオーバーライドします。

フォームとダイアログを参加者ステップに追加

参加者ステップコンポーネントをカスタマイズして、フォーム参加者ステップおよびダイアログ参加者ステップコンポーネントに含まれる機能を提供します。

• 生成された作業項目を開いたときに、フォームを表示する
• 生成された作業項目を完了したときに、カスタムダイアログを表示する

新しいコンポーネントに対して次の手順を実行します（「カスタムワークフロー手順コンポーネントの作成」を参照）。

1. cq:Componentノードの下に、次のノードを追加します。

   • 名前：cq:editConfig
   • 型：cq:EditConfig

   cq:editConfigノードの詳細については、「コンポーネントの編集動作の設定」を参照してください。

2. cq:EditConfig ノードの下に、次のノードを追加します。

   • 名前：cq:formParameters
   • 型：nt:unstructured

3. 作業項目を開くとフォームが表示されるようにするには、次のプロパティを cq:formParameters ノードに追加します。

   • 名前：FORM_PATH
   • 型：String
   • 値：フォームに解決されるパス

4. 作業項目を完了するとカスタムダイアログが表示されるようにするには、次のプロパティを cq:formParameters ノードに追加します。

   • 名前：DIALOG_PATH
   • 型：String
   • 値：ダイアログに解決されるパス

ワークフローステップの実行時の動作の設定

cq:Componentノードの下にcq:EditConfigノードを追加します。 その下にnt:unstructuredノードを追加（cq:formParametersという名前を付ける必要があります）し、そのノードに次のプロパティを追加します。

• 名前：PROCESS_AUTO_ADVANCE

  • 型：Boolean

  • 値:

    • trueに設定すると、ワークフローはそのステップを実行し、続行します。これはデフォルトであり、推奨されます。
    • false に設定した場合、ワークフローはそのステップを実行して停止します。これには追加の処理が必要なので、true に設定することをお勧めします。

• 名前：DO_NOTIFY

  • 型：Boolean
  • 値：ユーザー参加ステップについて電子メール通知を送信するかどうかを示します（メールサーバーが正しく設定されていると想定しています）。

データの保持とアクセス

後続のワークフローステップのためのデータ保持

ワークフローメタデータを使用して、ワークフローの有効期間中およびステップの間で必要とされる情報を保持できます。ワークフローステップの一般的な要件は、以降に使用するデータを保持したり、以前のステップから保持されているデータを取得したりすることです。

ワークフローメタデータは、MetaDataMap オブジェクトに保存されます。Java APIは、Workflow.getWorkflowDataメソッドを提供して、適切なMetaDataMapオブジェクトを提供するWorkflowDataオブジェクトを返します。 このWorkflowData MetaDataMapオブジェクトは、OSGiサービスまたはECMAスクリプト（ステップコンポーネント）で使用できます。

Java

WorkflowProcess 実装の execute メソッドは、WorkItem オブジェクトに渡されます。このオブジェクトを使用して、現在のワークフローインスタンスの WorkflowData オブジェクトを取得します。次の例では、ワークフローの MetaDataMap オブジェクトに項目を追加してから、各項目を記録します。("mykey", "My Step Value") 項目は、ワークフローの後続ステップで使用可能です。

public void execute(WorkItem item, WorkflowSession session, MetaDataMap args) throws WorkflowException {

    MetaDataMap wfd = item.getWorkflow().getWorkflowData().getMetaDataMap();

    wfd.put("mykey", "My Step Value");

    Set<String> keyset = wfd.keySet();
    Iterator<String> i = keyset.iterator();
    while (i.hasNext()){
     Object key = i.next();
     log.info("The workflow medata includes key {} and value {}",key.toString(),wfd.get(key).toString());
    }
}

ECMA スクリプト

graniteWorkItem 変数は、現在の WorkItem Java オブジェクトの ECMA スクリプト表現です。したがって、graniteWorkItem 変数を使用して、ワークフローメタデータを取得できます。次の ECMA スクリプトを使用すると、ワークフローの オブジェクトに項目を追加してから各項目を記録する​プロセスステップMetaDataMapを実装できます。これらの項目は、ワークフローの後続の手順で使用できます。

var currentDateInMillis = new Date().getTime();

graniteWorkItem.getWorkflowData().getMetaDataMap().put("hardcodedKey","theKey");

graniteWorkItem.getWorkflowData().getMetaDataMap().put("currentDateInMillisKey",currentDateInMillis);

var iterator = graniteWorkItem.getWorkflowData().getMetaDataMap().keySet().iterator();
while (iterator.hasNext()){
    var key = iterator.next();
    log.info("Workflow metadata key, value = " + key.toString() + ", " + graniteWorkItem.getWorkflowData().getMetaDataMap().get(key));
}

実行時のダイアログプロパティ値へのアクセス

ワークフローインスタンスの MetaDataMap オブジェクトは、ワークフローの有効期間全体を通じてデータを保存および取得する場合に役立ちます。ワークフローステップコンポーネントの実装では、特に実行時のコンポーネントプロパティ値を取得するときに MetaDataMap が役立ちます。

ワークフローの MetaDataMap は、Java および ECMA スクリプトプロセス実装で次のように使用できます。

• WorkflowProcessインターフェイスのJava実装では、argsパラメーターはワークフローのMetaDataMapオブジェクトです。

• ECMAスクリプトの実装では、args変数とmetadata変数を使用して値を取得できます。

例：プロセスステップコンポーネントの引数の取得

プロセスステップ​コンポーネントの編集ダイアログには、Arguments プロパティが含まれます。Arguments​プロパティの値は、ワークフローメタデータに保存され、PROCESS_ARGSキーに関連付けられます。

次の図では、Arguments​プロパティの値はargument1, argument2です。

Java

次の Java コードは、execute 実装の WorkflowProcess メソッドです。メソッドは、PROCESS_ARGSキーに関連付けられたargs MetaDataMapに値を記録します。

public void execute(WorkItem item, WorkflowSession session, MetaDataMap args) throws WorkflowException {
     if (args.containsKey("PROCESS_ARGS")){
      log.info("workflow metadata for key PROCESS_ARGS and value {}",args.get("PROCESS_ARGS","string").toString());
     } 
    }

この Java 実装を使用するプロセスステップが実行されると、ログに次のエントリが記録されます。

16.02.2018 12:07:39.566 *INFO* [JobHandler: /var/workflow/instances/server0/2018-02-16/model_855140139900189:/content/we-retail/de] com.adobe.example.workflow.impl.process.LogArguments workflow metadata for key PROCESS_ARGS and value argument1, argument2

ECMA スクリプト

次の ECMA スクリプトは、プロセスステップ​のプロセスとして使用されます。このスクリプトは、引数の数と値を記録します。

var iterator = graniteWorkItem.getWorkflowData().getMetaDataMap().keySet().iterator();
while (iterator.hasNext()){
    var key = iterator.next();
    log.info("Workflow metadata key, value = " + key.toString() + ", " + graniteWorkItem.getWorkflowData().getMetaDataMap().get(key));
}
log.info("hardcodedKey "+ graniteWorkItem.getWorkflowData().getMetaDataMap().get("hardcodedKey"));
log.info("currentDateInMillisKey "+ graniteWorkItem.getWorkflowData().getMetaDataMap().get("currentDateInMillisKey"));

スクリプトとプロセスの引数

プロセスステップ​コンポーネント用のスクリプト内で、引数は args オブジェクトを通して使用できます。

カスタムステップコンポーネントを作成する場合、オブジェクトmetaDataはスクリプトで使用できます。 このオブジェクトは、1つの文字列引数に制限されます。

プロセスステップ実装の作成

ワークフローのプロセスでプロセスステップが開始されると、そのステップは OSGi サービスにリクエストを送信するか、ECMA スクリプトを実行します。そのため、ワークフローに必要なアクションを実行するサービスまたは ECMA スクリプトを作成します。

Java クラスを使用したプロセスステップの実装

OSGI サービスコンポーネント（Java バンドル）としてプロセスステップを定義する

1. バンドルを作成して、OSGI コンテナにデプロイします。CRXDE LiteまたはEclipseを使用したバンドルの作成に関するドキュメントを参照してください。

   メモ

   OSGIコンポーネントは、execute()メソッドを使用してWorkflowProcessインターフェイスを実装する必要があります。 以下のコード例を参照してください。

   メモ

   パッケージ名をmaven-bundle-plugin設定の<*Private-Package*>セクションに追加する必要があります。

2. 追加SCRプロパティprocess.labelを設定し、必要に応じて値を設定します。 これは、汎用​プロセスステップ​コンポーネントを使用する場合に、プロセスステップが表示される名前になります。 下の例を参照してください。

3. モデル​エディターで、汎用の​プロセスステップ​コンポーネントを使用して、プロセスステップをワークフローに追加します。

4. （プロセス手順​の）編集ダイアログで、「プロセス」タブに移動し、プロセス実装を選択します。

5. コード内で引数を使用する場合は、プロセスの引数​を設定します。例：false

6. ステップとワークフローモデルの両方に対する変更を保存します（モデルエディターの左上隅）。

実行可能なJavaメソッドを実装するクラスはそれぞれOSGIサービスとして登録され、実行時にいつでもメソッドを追加できます。

次のOSGIコンポーネントは、ペイロードがページの場合に、プロパティapprovedをページコンテンツノードに追加します。

package com.adobe.example.workflow.impl.process;

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

import org.apache.felix.scr.annotations.Component;
import org.apache.felix.scr.annotations.Property;
import org.apache.felix.scr.annotations.Service;

import org.osgi.framework.Constants;

import javax.jcr.Node;
import javax.jcr.RepositoryException;
import javax.jcr.Session;

/**
 * Sample workflow process that sets an <code>approve</code> property to the payload based on the process argument value.
 */
@Component
@Service
public class MyProcess implements WorkflowProcess {

 @Property(value = "An example workflow process implementation.")
 static final String DESCRIPTION = Constants.SERVICE_DESCRIPTION; 
 @Property(value = "Adobe")
 static final String VENDOR = Constants.SERVICE_VENDOR;
 @Property(value = "My Sample Workflow Process")
 static final String LABEL="process.label";

 private static final String TYPE_JCR_PATH = "JCR_PATH";

 public void execute(WorkItem item, WorkflowSession session, MetaDataMap args) throws WorkflowException {
  WorkflowData workflowData = item.getWorkflowData();
  if (workflowData.getPayloadType().equals(TYPE_JCR_PATH)) {
   String path = workflowData.getPayload().toString() + "/jcr:content";
   try {
    Session jcrSession = session.adaptTo(Session.class); 
    Node node = (Node) jcrSession.getItem(path);
    if (node != null) {
     node.setProperty("approved", readArgument(args));
     jcrSession.save();
    }
   } catch (RepositoryException e) {
    throw new WorkflowException(e.getMessage(), e);
   }
  }
 }

 private boolean readArgument(MetaDataMap args) {
  String argument = args.get("PROCESS_ARGS", "false");
  return argument.equalsIgnoreCase("true");
 }
}

ECMAScript の使用

スクリプト開発者は、ECMA スクリプトを使用してプロセスステップを実装できます。スクリプトは JCR リポジトリ内に配置され、そこから実行されます。

スクリプトの処理にすぐに使用でき、ワークフロー Java API のオブジェクトへのアクセスを提供する変数を以下の表に示します。

Java クラス	スクリプト変数名	説明
com.adobe.granite.workflow.exec.WorkItem	graniteWorkItem	現在のステップインスタンス。
com.adobe.granite.workflow.WorkflowSession	graniteWorkflowSession	現在のステップインスタンスのワークフローセッション。
String[] （プロセスの引数が含まれます）	args	ステップの引数。
com.adobe.granite.workflow.metadata.MetaDataMap	metaData	現在のステップインスタンスのメタデータ。
org.apache.sling.scripting.core.impl.InternalScriptHelper	sling	Sling ランタイム環境へのアクセスを可能にします。

次のサンプルスクリプトは、ワークフローのペイロードを表す JCR ノードにアクセスする方法を示しています。graniteWorkflowSession 変数を JCR セッション変数に適応させます。この変数を使用して、ペイロードパスからノードを取得します。

var workflowData = graniteWorkItem.getWorkflowData();
if (workflowData.getPayloadType() == "JCR_PATH") { 
    var path = workflowData.getPayload().toString(); 
    var jcrsession = graniteWorkflowSession.adaptTo(Packages.javax.jcr.Session);
    var node = jcrsession.getNode(path);
    if (node.hasProperty("approved")){
     node.setProperty("approved", args[0] == "true" ? true : false);
     node.save();
 }
}

次のスクリプトでは、ペイロードが画像（.pngファイル）であるかどうかを確認し、ペイロードから白黒画像を作成し、兄弟ノードとして保存します。

var workflowData = graniteWorkItem.getWorkflowData();
if (workflowData.getPayloadType() == "JCR_PATH") { 
    var path = workflowData.getPayload().toString(); 
    var jcrsession = graniteWorkflowSession.adaptTo(Packages.javax.jcr.Session);
    var node = jcrsession.getRootNode().getNode(path.substring(1));
     if (node.isNodeType("nt:file") && node.getProperty("jcr:content/jcr:mimeType").getString().indexOf("image/") == 0) { 
        var is = node.getProperty("jcr:content/jcr:data").getStream();
        var layer = new Packages.com.day.image.Layer(is);
        layer.grayscale();
                var parent = node.getParent();
                var gn = parent.addNode("grey" + node.getName(), "nt:file"); 
        var content = gn.addNode("jcr:content", "nt:resource");
                content.setProperty("jcr:mimeType","image/png");
                var cal = Packages.java.util.Calendar.getInstance();
                content.setProperty("jcr:lastModified",cal);
                var f = Packages.java.io.File.createTempFile("test",".png");
        var tout = new Packages.java.io.FileOutputStream(f);
        layer.write("image/png", 1.0, tout);
        var fis = new Packages.java.io.FileInputStream(f);
                content.setProperty("jcr:data", fis);
                parent.save();
        tout.close();
        fis.close();
        is.close();
        f.deleteOnExit();
    }
}

スクリプトを使用するには：

1. スクリプト(例えばCRXDE Lite)を作成し、/apps/myapp/workflow/scriptsの下のリポジトリに保存します。

2. プロセスステップ​の編集ダイアログでスクリプトを識別するタイトルを指定するには、次のプロパティをスクリプトの jcr:content ノードに追加します。

   名前	タイプ	値
   jcr:mixinTypes	Name[]	mix:title
   jcr:title	String	編集ダイアログに表示される名前。

3. プロセスステップ​インスタンスを編集し、使用するスクリプトを指定します。

参加者選択の作成

動的参加者ステップ​コンポーネント用の参加者選択を作成できます。

ワークフロー中に​動的参加者ステップ​コンポーネントを開始する場合は、そのステップで、生成された作業項目を割り当てる参加者を決定する必要があります。 そのためには、ステップで次のいずれかを実行します。

• OSGiサービスにリクエストを送信
• 参加者を選択する ECMA スクリプトを実行する

ワークフローの要件に応じて参加者を選択するサービスまたは ECMA スクリプトを作成できます。

Java クラスを使用した参加者選択の作成

参加者ステップを OSGI サービスコンポーネント（Java クラス）として定義する

1. OSGIコンポーネントは、getParticipant()メソッドを使用してParticipantStepChooserインターフェイスを実装する必要があります。 以下のコード例を参照してください。

   バンドルを作成して、OSGI コンテナにデプロイします。

2. 追加SCRプロパティchooser.labelを設定し、必要に応じて値を設定します。 これは、動的参加者ステップ​コンポーネントを使用して、参加者の選択者のリストに表示される名前になります。 次に例を示します。

   package com.adobe.example.workflow.impl.process;
   
   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.exec.WorkflowData;
   import com.adobe.granite.workflow.metadata.MetaDataMap;
   
   import org.apache.felix.scr.annotations.Component;
   import org.apache.felix.scr.annotations.Property;
   import org.apache.felix.scr.annotations.Service;
   
   import org.osgi.framework.Constants;
   
   /**
    * Sample dynamic participant step that determines the participant based on a path given as argument.
    */
   @Component
   @Service
   
   public class MyDynamicParticipant implements ParticipantStepChooser {
   
    @Property(value = "An example implementation of a dynamic participant chooser.")
    static final String DESCRIPTION = Constants.SERVICE_DESCRIPTION; 
       @Property(value = "Adobe")
       static final String VENDOR = Constants.SERVICE_VENDOR;
       @Property(value = "Dynamic Participant Chooser Process")
       static final String LABEL=ParticipantStepChooser.SERVICE_PROPERTY_LABEL;
   
       private static final String TYPE_JCR_PATH = "JCR_PATH";
   
       public String getParticipant(WorkItem workItem, WorkflowSession workflowSession, MetaDataMap args) throws WorkflowException {
           WorkflowData workflowData = workItem.getWorkflowData();
           if (workflowData.getPayloadType().equals(TYPE_JCR_PATH)) {
               String path = workflowData.getPayload().toString();
               String pathFromArgument = args.get("PROCESS_ARGS", String.class);
               if (pathFromArgument != null && path.startsWith(pathFromArgument)) {
                   return "admin";
               }
           }
           return "administrators";
       }
   }
   

3. モデル​エディターで、汎用の​動的参加者手順​コンポーネントを使用して、ワークフローに動的参加者手順を追加します。

4. 編集ダイアログで、「参加者セレクター」タブを選択し、セレクターの実装を選択します。

5. コードセット内で引数を使用する場合は、プロセスの引数​を設定します。 次の例では、/content/we-retail/de.

6. ステップとワークフローモデルの両方に対する変更を保存します。

ECMA スクリプトを使用した参加者選択の作成

参加者ステップ​で生成される作業項目を割り当てるユーザーを選択する ECMA スクリプトを作成できます。スクリプトには、getParticipant という関数を含める必要があります。この関数は引数が不要で、ユーザーまたはグループの ID を格納した String を返します。

スクリプトは JCR リポジトリ内に配置され、そこから実行されます。

スクリプト内のワークフロー Java オブジェクトにすぐにアクセスできる変数を以下の表に示します。

Java クラス	スクリプト変数名
com.adobe.granite.workflow.exec.WorkItem	graniteWorkItem
com.adobe.granite.workflow.WorkflowSession	graniteWorkflowSession
String[] （プロセスの引数が含まれます）	args
com.adobe.granite.workflow.metadata.MetaDataMap	metaData
org.apache.sling.scripting.core.impl.InternalScriptHelper	sling

function getParticipant() {
    var workflowData = graniteWorkItem.getWorkflowData();
    if (workflowData.getPayloadType() == "JCR_PATH") { 
        var path = workflowData.getPayload().toString(); 
        if (path.indexOf("/content/we-retail/de") == 0) {
            return "admin";
        } else {
            return "administrators";
        }
    }
}

1. スクリプト(例えばCRXDE Lite)を作成し、/apps/myapp/workflow/scriptsの下のリポジトリに保存します。

2. プロセスステップ​の編集ダイアログでスクリプトを識別するタイトルを指定するには、次のプロパティをスクリプトの jcr:content ノードに追加します。

   名前	タイプ	値
   jcr:mixinTypes	Name[]	mix:title
   jcr:title	String	編集ダイアログに表示される名前。

3. 動的参加者ステップインスタンスを編集し、使用するスクリプトを指定します。

ワークフローパッケージの処理

ワークフローパッケージをワークフローに渡して処理することができます。ワークフローパッケージには、ページやアセットなどのリソースへの参照が含まれます。

パッケージリソースを取得して処理するワークフローステップを作成できます。com.day.cq.workflow.collection パッケージの以下の構成要素は、ワークフローパッケージへのアクセスを可能にします。

• ResourceCollection:ワークフローパッケージクラス。
• ResourceCollectionUtil：ResourceCollection オブジェクトの取得に使用されます。
• ResourceCollectionManager:コレクションを作成し、取得します。実装は、OSGi サービスとしてデプロイされます。

次の Java クラスの例は、パッケージリソースの取得方法を示しています。

package com.adobe.example;

import java.util.ArrayList;
import java.util.List;

import com.day.cq.workflow.WorkflowException;
import com.day.cq.workflow.WorkflowSession;
import com.day.cq.workflow.collection.ResourceCollection;
import com.day.cq.workflow.collection.ResourceCollectionManager;
import com.day.cq.workflow.collection.ResourceCollectionUtil;
import com.day.cq.workflow.exec.WorkItem;
import com.day.cq.workflow.exec.WorkflowData;
import com.day.cq.workflow.exec.WorkflowProcess;
import com.day.cq.workflow.metadata.MetaDataMap;

import org.apache.felix.scr.annotations.Component;
import org.apache.felix.scr.annotations.Property;
import org.apache.felix.scr.annotations.Service;
import org.apache.felix.scr.annotations.Reference;
import org.osgi.framework.Constants;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import javax.jcr.Node;
import javax.jcr.PathNotFoundException;
import javax.jcr.RepositoryException;
import javax.jcr.Session; 

@Component
@Service
public class LaunchBulkActivate implements WorkflowProcess {
 
 private static final Logger log = LoggerFactory.getLogger(LaunchBulkActivate.class);

 @Property(value="Bulk Activate for Launches")
  static final String PROCESS_NAME ="process.label";
 @Property(value="A sample workflow process step to support Launches bulk activation of pages")
 static final String SERVICE_DESCRIPTION = Constants.SERVICE_DESCRIPTION;
 
 @Reference
 private ResourceCollectionManager rcManager;
public void execute(WorkItem workItem, WorkflowSession workflowSession) throws Exception {
    Session session = workflowSession.getSession();
    WorkflowData data = workItem.getWorkflowData();
    String path = null;
    String type = data.getPayloadType();
    if (type.equals(TYPE_JCR_PATH) && data.getPayload() != null) {
        String payloadData = (String) data.getPayload();
        if (session.itemExists(payloadData)) {
            path = payloadData;
        }
    } else if (data.getPayload() != null && type.equals(TYPE_JCR_UUID)) {
        Node node = session.getNodeByUUID((String) data.getPayload());
        path = node.getPath();
    }

    // CUSTOMIZED CODE IF REQUIRED....

    if (path != null) {
        // check for resource collection
        ResourceCollection rcCollection = ResourceCollectionUtil.getResourceCollection((Node)session.getItem(path), rcManager);
        // get list of paths to replicate (no resource collection: size == 1
        // otherwise size >= 1
        List<String> paths = getPaths(path, rcCollection);
        for (String aPath: paths) {

            // CUSTOMIZED CODE....

        }
    } else {
        log.warn("Cannot process because path is null for this " + "workitem: " + workItem.toString());
    }
}

/**
 * helper
 */
private List<String> getPaths(String path, ResourceCollection rcCollection) {
    List<String> paths = new ArrayList<String>();
    if (rcCollection == null) {
        paths.add(path);
    } else {
        log.debug("ResourceCollection detected " + rcCollection.getPath());
        // this is a resource collection. the collection itself is not
        // replicated. only its members
        try {
            List<Node> members = rcCollection.list(new String[]{"cq:Page", "dam:Asset"});
            for (Node member: members) {
                String mPath = member.getPath();
                paths.add(mPath);
            }
        } catch(RepositoryException re) {
            log.error("Cannot build path list out of the resource collection " + rcCollection.getPath());
        }
    }
    return paths;
}
}

例：カスタムステップの作成

独自のカスタムステップを作成する場合は、次の場所から既存のステップをコピーする方法が簡単です。

/libs/cq/workflow/components/model

基本的なステップの作成

1. 次の例のように、/apps の下にパスを再作成します。

   /apps/cq/workflow/components/model

   新しいフォルダーのタイプはnt:folderです。

   - apps
     - cq
       - workflow (nt:folder)
         - components (nt:folder)
           - model (nt:folder)
   

   メモ

   この手順は、クラシック UI のモデルエディターには適用されません。

2. 次の例のように、コピーしたステップを /apps フォルダーに配置します。

   /apps/cq/workflow/components/model/myCustomStep

   カスタマイズしたステップの例は次のとおりです。

   

   注意

   標準 UI ではカードに表示されるのはタイトルのみで、説明は表示されないので、クラシック UI エディター用の details.jsp は不要です。

3. このノードに次のプロパティを適用します。

   /apps/cq/workflow/components/model/myCustomStep

   対象プロパティ：

   • sling:resourceSuperType

     既存のステップから継承する必要があります。

     この例では、cq/workflow/components/model/stepの基本手順を継承していますが、participantやprocessなど他のスーパータイプを使用できます。

   • jcr:title

     コンポーネントがステップブラウザー（ワークフローモデルエディターの左側のパネル）に一覧表示されたときに表示されるタイトルです。

   • cq:icon

     手順のサンゴのアイコンを指定するために使用します。

   • componentGroup

     次のいずれかである必要があります。

     • コラボレーションワークフロー
     • DAM ワークフロー
     • Forms のワークフロー
     • プロジェクト
     • WCM ワークフロー
     • ワークフロー

   

4. 以上でワークフローを開いて編集できるようになります。ステップブラウザーでは、次の手順でフィルターを適用して​カスタムステップ​を表示できます。

   

   カスタムステップ​をモデルにドラッグすると、カードが表示されます。

   

   ステップで cq:icon が定義されていない場合は、タイトルの最初の 2 文字を使用したデフォルトのアイコンが表示されます。次に例を示します。

   

ステップの設定ダイアログの定義

基本ステップを作成したら、次の手順に沿ってステップの​設定​ダイアログを定義します。

1. ノードcq:editConfigのプロパティを次のように設定します。

   対象プロパティ：

   • cq:inherit

     trueに設定した場合、ステップコンポーネントはsling:resourceSuperTypeで指定したステップからプロパティを継承します。

   • cq:disableTargeting

     必要に応じて設定します。
     

2. ノードcq:formsParameterのプロパティを次のように設定します。

   対象プロパティ：

   • jcr:title

     モデルマップのステップカードと、カスタム - ステップのプロパティ​設定ダイアログの​タイトル​フィールドのデフォルトのタイトルを設定します。

   • 独自のカスタムプロパティも定義できます。

   

3. ノードcq:listenersのプロパティを設定します。

   cq:listener ノードとそのプロパティを利用すると、ステップをモデルページにドラッグしたり、ステップのプロパティを編集したりして、タッチ操作対応 UI のモデルエディターでイベントに対処するイベントハンドラーを設定できます。

   対象プロパティ：

   • afterMove: REFRESH_PAGE
   • afterdelete: CQ.workflow.flow.Step.afterDelete
   • afteredit: CQ.workflow.flow.Step.afterEdit
   • afterinsert: CQ.workflow.flow.Step.afterInsert

   この設定は、エディターを適切に機能させるために必要です。ほとんどのケースで、この設定は変更しないでください。

   ただし、cq:inherit を true に設定した場合は（cq:editConfig ノードで設定します。上記を参照）、この設定を継承できるので、ステップの定義に明示的に含める必要はありません。継承が存在しない場合は、次のプロパティと値を持つこのノードを追加する必要があります。

   次の例では継承が有効になっているので、cq:listeners ノードを削除できます。削除しても、ステップは正常に機能します。

   

4. これで、ステップのインスタンスをワークフローモデルに追加できます。ステップを​設定​する際は、次のダイアログが表示されます。

   

この例で使用するマークアップのサンプル

カスタムステップのマークアップは、コンポーネントのルートノードの.content.xmlに表示されます。 この例で使用するサンプル.content.xml:

/apps/cq/workflow/components/model/myCustomStep/.content.xml

<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:sling="https://sling.apache.org/jcr/sling/1.0" xmlns:cq="https://www.day.com/jcr/cq/1.0" xmlns:jcr="https://www.jcp.org/jcr/1.0"
    cq:icon="bell"
    jcr:primaryType="cq:Component"
    jcr:title="My Custom Step"
    sling:resourceSuperType="cq/workflow/components/model/process"
    allowedParents="[*/parsys]"
    componentGroup="Workflow"/>

この例で使用されている_cq_editConfig.xmlサンプル：

<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:cq="https://www.day.com/jcr/cq/1.0" xmlns:jcr="https://www.jcp.org/jcr/1.0" xmlns:nt="https://www.jcp.org/jcr/nt/1.0"
    cq:disableTargeting="{Boolean}true"
    cq:inherit="{Boolean}true"
    jcr:primaryType="cq:EditConfig">
    <cq:formParameters
        jcr:primaryType="nt:unstructured"
        jcr:title="My Custom Step Card"
        SAMPLE_PROPERY="sample value"/>
    <cq:listeners
        jcr:primaryType="cq:EditListenersConfig"
        afterdelete="CQ.workflow.flow.Step.afterDelete"
        afteredit="CQ.workflow.flow.Step.afterEdit"
        afterinsert="CQ.workflow.flow.Step.afterInsert"
        afterMove="REFRESH_PAGE"/>
</jcr:root>

この例で使用されている_cq_dialog/.content.xmlサンプル：

<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:sling="https://sling.apache.org/jcr/sling/1.0" xmlns:cq="https://www.day.com/jcr/cq/1.0" xmlns:jcr="https://www.jcp.org/jcr/1.0" xmlns:nt="https://www.jcp.org/jcr/nt/1.0"
    jcr:primaryType="nt:unstructured"
    jcr:title="My Custom - Step Properties"
    sling:resourceType="cq/gui/components/authoring/dialog">
    <content
        jcr:primaryType="nt:unstructured"
        sling:resourceType="granite/ui/components/coral/foundation/tabs">
        <items jcr:primaryType="nt:unstructured">
            <common
                cq:hideOnEdit="true"
                jcr:primaryType="nt:unstructured"
                jcr:title="Common"
                sling:resourceType="granite/ui/components/coral/foundation/fixedcolumns"/>
            <process
                cq:hideOnEdit="true"
                jcr:primaryType="nt:unstructured"
                jcr:title="Process"
                sling:resourceType="granite/ui/components/coral/foundation/fixedcolumns"/>
            <mycommon
                jcr:primaryType="nt:unstructured"
                jcr:title="Common"
                sling:resourceType="granite/ui/components/coral/foundation/fixedcolumns">
                <items jcr:primaryType="nt:unstructured">
                    <columns
                        jcr:primaryType="nt:unstructured"
                        sling:resourceType="granite/ui/components/coral/foundation/container">
                        <items jcr:primaryType="nt:unstructured">
                            <title
                                jcr:primaryType="nt:unstructured"
                                sling:resourceType="granite/ui/components/coral/foundation/form/textfield"
                                fieldLabel="Title"
                                name="./jcr:title"/>
                            <description
                                jcr:primaryType="nt:unstructured"
                                sling:resourceType="granite/ui/components/coral/foundation/form/textarea"
                                fieldLabel="Description"
                                name="./jcr:description"/>
                        </items>
                    </columns>
                </items>
            </mycommon>
            <advanced
                jcr:primaryType="nt:unstructured"
                jcr:title="Advanced"
                sling:resourceType="granite/ui/components/coral/foundation/fixedcolumns">
                <items jcr:primaryType="nt:unstructured">
                    <columns
                        jcr:primaryType="nt:unstructured"
                        sling:resourceType="granite/ui/components/coral/foundation/container">
                        <items jcr:primaryType="nt:unstructured">
                            <email
                                jcr:primaryType="nt:unstructured"
                                sling:resourceType="granite/ui/components/coral/foundation/form/checkbox"
                                fieldDescription="Notify user via email."
                                fieldLabel="Email"
                                name="./metaData/PROCESS_AUTO_ADVANCE"
                                text="Notify user via email."
                                value="true"/>
                        </items>
                    </columns>
                </items>
            </advanced>
        </items>
    </content>
</jcr:root>