ワークフローの設定とカスタマイズ id181AI0OJ0RO
ワークフローを使用すると、Adobe Experience Manager \(AEM\) アクティビティを自動化できます。 ワークフローは、特定の順序で実行される一連のステップで構成されます。 各ステップで実行するアクティビティを個別に定義できます。 例えば、トピックレビューが作成されたときに、グループ内のすべてのレビュー担当者にメール通知を送信できます。 または、出力生成タスクが完了したときにパブリッシャーに通知を送信します。
AEMのワークフローについて詳しくは、以下を参照してください。
-
ワークフローの適用とワークフローへの参加:ワークフローの操作。
-
ワークフローモデルの作成とワークフロー機能の拡張:ワークフローの開発と拡張。
-
重要なサーバーリソースを使用するワークフローのパフォーマンスの向上:ワークフローの同時処理
このトピックの節では、AEM Guidesに付属しているデフォルトのワークフローで実行できる様々なカスタマイズについて説明します。
レビューワークフローのカスタマイズ id176NE0C00HS
すべての組織のコンテンツオーサリングチームは、ビジネス要件を満たすために特定の方法で作業します。 組織によっては、専用のエディターがあるのに対して、他の組織では、自動編集審査システムを導入している場合があります。 例えば、組織では、一般的なオーサリングと公開のワークフローに、のようなタスクを含めることができます。作成者がコンテンツのオーサリングを完了すると、自動的にレビュー担当者に送信され、レビューが完了すると、最終出力を生成するために公開者に送信されます。 AEMでは、コンテンツやアセットに対して実行するアクティビティを、プロセスの形式で組み合わせて、AEMのワークフローにマッピングできます。 AEMのワークフローについて詳しくは、AEM ドキュメントの ワークフローの管理を参照してください。
AEM Guidesでは、デフォルトのレビューワークフローをカスタマイズできます。 他のオーサリングワークフローまたは公開ワークフローで、次の 4 つのカスタムレビュー関連のプロセスを使用できます。
-
レビューを作成:このプロセスでは、レビュータスクの作成に必要なメタデータを準備します。 例えば、レビュー権限をレビュー担当者に割り当て、トピックのステータスをレビュー中に設定し、レビュータイムラインを設定します。 4 つのプロセスのうち、これはカスタムワークフローに含める必要がある唯一の必須プロセスです。 ワークフローで、他の 3 つのプロセスを含めるか除外するかを選択できます。
-
レビュータスクの割り当て:このプロセスは、レビュータスクを作成し、開始者とレビュー担当者にタスク通知を送信します。
-
レビューメールの送信:このプロセスは、レビューメールをイニシエーターとレビュー担当者に送信します。
-
レビューをクローズするジョブのスケジュール:このプロセスにより、期限に達したレビュー・プロセスが確実に完了します。
カスタムレビューワークフローを作成する場合、最初のタスクは、作成レビュープロセスで必要なメタデータを設定することです。 それには、ECMA スクリプトを作成します。 メタデータを割り当てる ECMA スクリプトのサンプルを、トピックとマップの両方について以下に示します。
トピック用
var workflowdata=workItem.getWorkflowData();
workflowdata.getMetaDataMap().put("initiator","admin");
workflowdata.getMetaDataMap().put("operation","AEM_REVIEW");
workflowdata.getMetaDataMap().put("orgTopics","/content/dam/xml-solution/review.xml");
workflowdata.getMetaDataMap().put("payloadJson","{\"base\":\"/content/dam/xml-solution\",\"asset\":[\"/content/dam/xml-solution/review.xml\"],\"referrer\":\""}");
workflowdata.getMetaDataMap().put("deadline","2017-06-27T13:19:00.000+05:30");
workflowdata.getMetaDataMap().put("title","Review through custom workflow");
workflowdata.getMetaDataMap().put("description","Initiate this review process using the AEM workflow");
workflowdata.getMetaDataMap().put("assignee","user-one", "user-two");
workflowdata.getMetaDataMap().put("status","1");
workflowdata.getMetaDataMap().put("projectPath","/content/projects/review");
workflowdata.getMetaDataMap().put("startTime", System.currentTimeMillis());
workflowdata.getMetaDataMap().put("reviewType", "AEM");
workflowdata.getMetaDataMap().put("versionJson", "[{\"path\":\"GUID-ca6ae229-889a-4d98-a1c6-60b08a820bb3.dita\",\"review\":true,\"version\":\"1.0\",\"reviewers\":[\"projects-samplereviewproject-owner\"]}]");
workflowdata.getMetaDataMap().put("isDitamap","false");
workflowdata.getMetaDataMap().put("reviewVersion","3.0");
マップ用
var workflowdata = workItem.getWorkflowData();
workflowdata.getMetaDataMap().put("initiator", "admin");
workflowdata.getMetaDataMap().put("operation", "AEM_REVIEW");
workflowdata.getMetaDataMap().put("orgTopics", "GUID-ae42f13c-7201-4453-9a3a-c87675a5868e.dita|GUID-28a6517b-1b62-4d3a-b7dc-0e823225b6a5.dita|GUID-dd699e10-118d-4f1b-bf19-7f1973092227.dita|");
var payloadJson = "{\"referrer\":\"\",\"rootMap\":\"GUID-17feb385-acf3-4113-b838-77b11fd6988d.ditamap\",\"asset\":[\"GUID-17feb385-acf3-4113-b838-77b11fd6988d.ditamap\"],\"base\":\"/content/dam\"}";
workflowdata.getMetaDataMap().put("payloadJson", payloadJson);
workflowdata.getMetaDataMap().put("deadline", "2047-06-27T13:19:00.000+05:30");
workflowdata.getMetaDataMap().put("title", "Review task via workflow with map");
workflowdata.getMetaDataMap().put("description", "Review task via workflow with map Description");
workflowdata.getMetaDataMap().put("assignee", "user-one");
workflowdata.getMetaDataMap().put("status", "1");
workflowdata.getMetaDataMap().put("projectPath", "/content/projects/review_project_via_workflow");
workflowdata.getMetaDataMap().put("startTime", new Date().getTime());
var versionJson = "[{\"path\":\"GUID-ae42f13c-7201-4453-9a3a-c87675a5868e.dita\",\"version\":\"1.0\",\"review\":true,\"reviewers\":[\"starling-regression-user\"]},{\"path\":\"GUID-28a6517b-1b62-4d3a-b7dc-0e823225b6a5.dita\",\"version\":\"1.0\",\"review\":true,\"reviewers\":[\"starling-regression-user\"]},{\"path\":\"GUID-dd699e10-118d-4f1b-bf19-7f1973092227.dita\",\"version\":\"1.0\",\"review\":true,\"reviewers\":[\"starling-regression-user\"]}]";
workflowdata.getMetaDataMap().put("versionJson", versionJson);
workflowdata.getMetaDataMap().put("notifyViaEmail", "true");
workflowdata.getMetaDataMap().put("allowAllReviewers", "false");
workflowdata.getMetaDataMap().put("isDitamap", "true");
workflowdata.getMetaDataMap().put("ditamap", "GUID-17feb385-acf3-4113-b838-77b11fd6988d.ditamap");
var ditamapHierarchy = "[{\"path\":\"GUID-17feb385-acf3-4113-b838-77b11fd6988d.ditamap\",\"items\":[{\"path\":\"GUID-db5787bb-5467-4dc3-b3e5-cfde562ee745.ditamap\",\"items\":[{\"path\":\"GUID-ae42f13c-7201-4453-9a3a-c87675a5868e.dita\",\"items\":[],\"title\":\"\"},{\"path\":\"GUID-28a6517b-1b62-4d3a-b7dc-0e823225b6a5.dita\",\"items\":[],\"title\":\"\"}],\"title\":\"\"},{\"path\":\"GUID-dd699e10-118d-4f1b-bf19-7f1973092227.dita\",\"items\":[],\"title\":\"\"}]}]";
workflowdata.getMetaDataMap().put("ditamapHierarchy", ditamapHierarchy);
workflowdata.getMetaDataMap().put("reviewVersion","3.0");
/etc/workflows/scripts
ノードにこのスクリプトを作成できます。 次の表に、この ECMA スクリプトによって割り当てられるプロパティを示します。
initiator
operation
AEM_REVIEW
として設定された静的な値。orgTopics
payloadJson
~
base
:レビュー用に送信されたトピックを含む親フォルダーのパス。-
asset
:確認用に送信されたトピックのパス。-
referrer
:空白のままにします。deadline
yyyy-MM-dd'T'HH:mm:ss.SSSXXX
形式で指定します。title
description
assignee
status
startTime
System.currentTimeMillis()
関数を使用して、現在のシステム時間を取得します。projectPath
reviewType
versionJson
isDitamap
ditamapHierarchy
ditamap
allowAllReviewers
notifyViaEmail
スクリプトを作成したら、ワークフローで作成レビュープロセスを呼び出す前に呼び出します。 その後、要件に応じて、他のレビューワークフロープロセスを呼び出すことができます。
パージ設定からレビューワークフローを削除
ワークフローエンジンのパフォーマンスを向上させるために、完了したワークフローインスタンスをAEM リポジトリーから定期的に削除することができます。 デフォルトのAEM設定を使用している場合は、完了したすべてのワークフローインスタンスが、指定した期間の後にクリーンアップされます。 これにより、すべてのレビューワークフローがAEM リポジトリからパージされます。
自動パージ設定からレビューワークフローモデル \(情報\)を削除することで、レビューワークフローが自動パージされないようにすることができます。 レビューワークフローモデルを自動パージリストから削除するには Adobe Granite のワークフローパージ設定を使用する必要があります。
「Adobe Granite のワークフローのパージ設定」で、安全にパージできるワークフローを少なくとも 1 つリストしていることを確認します。 例えば、AEM Guidesで作成された次のワークフローのいずれかを使用できます。
- /etc/workflow/models/publishditamap/jcr:content/model
- /etc/workflow/models/post-dita-project-creation-tasks/ jcr:content/model
Adobe Granite のワークフローのパージ設定にワークフローを追加すると AEMによって設定にリストされているワークフローのみがパージされます。 これにより、AEMからレビューワークフロー情報がパージされなくなります。
Adobe Granite のワークフローのパージ設定の指定について詳しくは AEM ドキュメントの ワークフローインスタンスの管理 を参照してください。
メールとAEM通知のカスタマイズ
メール通知は、多数のAEM Guides ワークフローで利用されます。 例えば、レビュータスクを開始すると、レビュー担当者にメール通知が送信されます。 ただし、メール通知が送信されるようにするには、AEMでこの機能を有効にする必要があります。 AEMでメール通知を有効にするには、AEM ドキュメントの メール通知の設定を参照してください。
AEM Guidesには、カスタマイズ可能なメールおよびAEM通知のセットが含まれています。 これらの通知をカスタマイズするには、次の手順を実行します。
-
パッケージマネージャーを使用してフォルダー
/libs/fmdita/mail/review
ダウンロードします。note note NOTE libs
ノードでデフォルトの設定ファイルをカスタマイズする必要はありません。libs
ノードにapps
ノードのオーバーレイを作成し、apps
ノードでのみ必要なファイルを更新する必要があります。 -
review
フォルダーには、次のサブフォルダーが含まれます。aem-notification
CSS
email-notification
これらのサブフォルダーについて詳しくは、以下で説明します。
table 0-row-2 1-row-2 2-row-2 3-row-2 サブフォルダーの確認 説明 aem-notification
カスタマイズ可能な様々なAEM通知タイプが含まれます。 closed
content-updated
feedback-addressed
feedback-provided
requested
reviewer-removed
tag-mention
これらのサブフォルダー内にprimary.vm
ファイルとsecondary.vm
ファイルがあり、これを使用してAEM通知のタイトルと説明をそれぞれカスタマイズできます。CSS
メール通知のスタイル設定をカスタマイズするための email-notification.css
ファイルが含まれています。email-notification
カスタマイズ可能な様々なメール通知タイプが含まれます。 closed
content-updated
feedback-addressed
feedback-provided
requested
reviewer-removed
tag-mention
これらのサブフォルダー内に、primary.vm
ファイルとsecondary.vm
ファイルがあり、それぞれメール通知の件名と本文をカスタマイズできます。
各通知タイプの定義の概要を次に示します。
closed
:レビュータスクが閉じられたときのトリガー。content-updated
:作成者またはイニシエーターがコンテンツを更新する際のトリガー。feedback-addressed
:作成者またはイニシエーターがコメントに対処し、レビュー担当者に再検討をリクエストする際のトリガー。- レビュー担当者がタスクに完了のマークを付けるときに、レビュータスクの作成者または開始者にタスクレベルのコメントを提供して、トリガーを
feedback-provided
します。 requested
:作成者またはイニシエーターがレビュータスクを作成する際にトリガーが発生します。reviewer-removed
:レビュータスクからレビュー担当者が割り当て解除されたときのトリガー。tag-mention
:レビューのコメントでユーザーがメンションされたり、タグ付けされたりした場合のトリガー。
メールまたはAEM通知をカスタマイズする際は、primary.vm
ファイルと secondary.vm
ファイルで使用する、次の事前定義済みの変数セットのみを使用してください。
projectPath
reviewTitle
projectName
commentator
commentExcerpt
taskLink
authorName
dueDate
reviewerName
user
recipient
出力後生成ワークフローのカスタマイズ id17A6GI004Y4
AEM Guidesでは、出力後の生成ワークフローを柔軟に指定できます。 AEM Guidesを使用して生成された出力に対して、いくつかの後処理タスクを実行できます。 例えば、生成されたAEM Site の出力に一部の CQ タグを適用したり、PDFの出力に特定のプロパティを設定したり、出力の生成後に一連のユーザーにメールを送信したりできます。
新しいワークフローモデルを作成して、出力後生成ワークフローとして使用できます。 出力後生成ワークフローがトリガーされると、出力生成ワークフローは、ワークフローメタデータマップを介してコンテキスト情報を共有します。このマップを使用して、生成された出力に対して処理を実行できます。 次の表に、メタデータとして共有されるコンテキスト情報を示します。
outputName
generatedPath
outputType
outputTitle
outputHistoryPath
isSuccess
logPath
generatedTime
initiator
出力生成メタデータを利用するには、ECMA スクリプトまたは OSGi バンドルを作成します。 メタデータを使用する ECMA スクリプトのサンプルを以下に示します。
/etc/workflows/scripts
ノードにこのスクリプトを作成できます。var session = workflowSession.getSession(); // Obtain session object to read/write the repository.
var payload = workItem.getWorkflowData().getPayload().toString(); // Get the workflow payload (the ditamap file on which the generation was triggered)
var metadata = workItem.getWorkflowData().getMetaDataMap(); // Get the workflow metadata object
var generatedPath = metadata.get("generatedPath"); // supplied by AEM Guides
var username = metadata.get("initiator"); // supplied by AEM Guides
var successful = metadata.get("isSuccess"); // supplied by AEM Guides
var title = metadata.get("outputTitle"); // supplied by AEM Guides
var subject = "Output Generation Finished";
var message = "Generation of output " + title + " just finished " +
(successful ? "successfully. " : "unsuccessfully. ");
message += "It was triggered by " + username;
if (successful) {
message += "<br/><br/>The path to the generated output is " +
generatedPath;
}
/*
MailerAPI.sendMail("dl-docs-authors", subject, message);
*/
スクリプトを作成したら、ワークフローでカスタムスクリプトを呼び出します。 その後、要件に応じて、他のワークフロープロセスを呼び出すことができます。 カスタムワークフローを設計したら、ワークフロープロセスの最後の手順として 生成後に最終処理 を呼び出します。 生成後に最終処理 ステップでは、出力生成プロセスの完了時に、出力生成タスクのステータスが確実に 完了 に更新されます。 カスタムの出力後生成ワークフローを作成したら、任意の出力生成プリセットを使用して設定できます。 必要なプリセットの 生成後のワークフローを実行 プロパティで、必要なワークフローを選択します。 設定した出力プリセットを使用して出力生成タスクを実行すると、タスクのステータス\(「出力」タブ内)が 後処理 に変わります。
アセットを更新ワークフローのカスタマイズ id18C3D0I0B5Z
デフォルトでは、AEM アセットを作成または更新するたびに DAM アセットの更新 ワークフロートリガーが表示されます\(XML または非 XML\)。 例えば、トピックを作成または更新すると、DAM アセットの更新 ワークフローが実行されます。 DAM アセットの更新 ワークフローは、Assetsから関連するメタデータの抽出を試みます。 標準の アセットの更新ワークフロー には、DITA ファイルから関連するメタデータを抽出する手順が含まれていないので、DAM アセットの更新 ワークフローは、実行時に多くのログを生成します。 余分なログを回避する場合は、すべての XML ファイルを処理からスキップするようにワークフローを設定できます。
次の手順を実行して、「DAM アセットの更新」ワークフローをカスタマイズします。
-
ワークフローランチャー ページを開きます。
ワークフローランチャーページにアクセスするためのデフォルトの URL は次のとおりです。
code language-http http://<server name>:<port>/libs/cq/workflow/admin/console/content/launchers.html
-
ワークフローランチャーのリストから、「DAM アセットの更新」ワークフローのプロパティを開きます。
-
次の式を使用して条件を追加します。
code language-json jcr:content/metadata/dc:format!=application/xml
-
「保存して閉じる」をクリックします。
後処理 XML ワークフローの設定 id18CJB03J0Y4
AEM Guidesは、AEMで DITA コンテンツを操作できる多数のワークフローを作成します。 例えば、DITA コンテンツのアップロード時や既存のコンテンツの更新時に実行されるワークフローがあります。 これらのワークフローは DITA 文書を解析し、メタデータの設定、新しい DITA マップへのデフォルト出力プリセットの追加、その他の関連タスクなど、様々なタスクを実行します。
次のプロパティは、AEM Guidesでの後処理ワークフローの実行方法を制御します。
com.adobe.fmdita.postprocess.PostProcessObservation
com.adobe.fmdita.config.ConfigManager
デフォルト値は 1 です。