ワークフロー機能の拡張

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

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

• ワークフローステップコンポーネントを作成する
• ステップ機能を 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 ノードです。

このテキストフィールドに指定された値がワークフローインスタンスの [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. Stringプロパティをcq:formParametersノードに追加します。 コンポーネントのスーパータイプによって、プロパティの名前が次のように決定されます。

   • プロセスステップ: 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は、適切なMetaDataMapオブジェクトを提供するWorkflowDataオブジェクトを返すWorkflow.getWorkflowDataメソッドを提供します。 この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 のオブジェクトへのアクセスを提供する変数を以下の表に示します。

次のサンプルスクリプトは、ワークフローのペイロードを表す 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 オブジェクトにすぐにアクセスできる変数を以下の表に示します。

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

     ステップにCoralアイコンを指定するために使用します。

   • 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>