ワークフローモデルの作成 creating-workflow-models
次の項目を作成します。 ワークフローモデル ：ユーザーがワークフローを開始したときに実行される一連の手順を定義します。 ワークフローを一時的なものにするか、複数のリソースを使用するかなど、モデルのプロパティを定義することもできます。
ユーザーがワークフローを開始すると、1 つのインスタンスが開始されます。これは、次の場合に作成される、対応するランタイムモデルです。 同期 変更内容。
新しいワークフローの作成 creating-a-new-workflow
最初に新しいワークフローモデルを作成すると、そのモデルには次の内容が含まれます。
-
フロー開始 ステップと フロー終了 ステップ。
これらのステップは、ワークフローの始まりと終わりを表します。これらの手順は必須で、編集または削除できません。
-
「手順 1」という名前のサンプルの 参加者 ステップ。
このステップは、作業項目をワークフロー開始者に割り当てるように設定されています。このステップを編集または削除し、必要に応じてステップを追加します。
エディターを使用して新しいワークフローを作成するには：
-
を開きます。 ワークフローモデル コンソール～の方法で ツール, ワークフロー, モデル 例：
-
「作成」を選択してから、「モデルを作成」を選択します。
-
この ワークフローモデルを追加 ダイアログボックスが表示されます。 次を入力します。 タイトル および 名前 （オプション）を選択する前に 完了.
-
新しいモデルが ワークフローモデル コンソールに表示されます。
-
新しいワークフローを選択し、「編集」をクリックすると、ワークフローが設定のために開かれます。
/var/workflow/models/var/workflow/models/prototypesワークフローの編集 editing-a-workflow
既存のワークフローモデルは、次の目的で編集できます。
-
ワークフローのプロパティを設定します。 ステージ, ワークフローが一時的かどうか および/または 複数のリソースを使用
の編集 デフォルトまたはレガシー （標準）ワークフロー には、 セーフコピー は、変更がおこなわれる前に実行されます。
ワークフローの更新が完了したら、 同期 から ランタイムモデルの生成. 詳しくは、 ワークフローを同期 」を参照してください。
ワークフローの同期 — ランタイムモデルの生成 sync-your-workflow-generate-a-runtime-model
同期 （エディターツールバーの右側）に、 ランタイムモデル. ランタイムモデルは、ユーザーがワークフローを開始したときに実際に使用されるモデルです。 変更内容を 同期 しない場合は、その変更内容は実行時には反映されません。
ワークフローに変更を加える場合は、 同期 個々のダイアログ（ステップなど）に独自の保存オプションがある場合でも、ランタイムモデルを生成する。
変更がランタイム（保存済み）モデルと同期された場合、 同期済み が代わりに表示されます。
一部のステップには、必須のフィールドが含まれているか、組み込みの検証が含まれています。 これらの条件が満たされない場合、 同期 モデル。 例えば次のように、参加者 ステップで参加者が定義されていない場合などです。
初めてのデフォルトまたはレガシーワークフローの編集 editing-a-default-or-legacy-workflow-for-the-first-time
を開くと、 デフォルトまたはレガシーモデル （編集用）:
-
この 手順 ブラウザーを使用できません（左側）。
-
ツールバーで「編集」操作を利用できます（右側）。
-
次の理由から、最初はモデルとそのプロパティが読み取り専用モードで開かれます。
- デフォルトのワークフローは
/libsにあります。 - レガシーワークフローは、
/etc
- デフォルトのワークフローは
選択 編集 は次のようになります。
- ワークフローが
/confにコピーされます。 - ～を作る 手順 使用可能なブラウザー
- 変更を加えられるようになります。
モデルへのステップの追加 adding-a-step-to-a-model
実行するアクティビティを表す手順をモデルに追加する必要があります。各手順は特定のアクティビティを実行します。 標準のAEMインスタンスでは、様々なステップコンポーネントを使用できます。
モデルを編集すると、使用可能なステップが 手順 ブラウザー。 次に例を示します。
モデルにステップを追加するには:
-
既存のワークフローモデルを編集用に開きます。 ワークフローモデル コンソールで、必要なモデルを選択し、編集 をクリックします。
-
を開きます。 手順 ブラウザ；using サイドパネルを切り替え（上部のツールバーの左端） ここでは、以下のことができます。
- フィルター を参照してください。
- ドロップダウンセレクターを使用して、選択を特定のステップのグループに限定します。
- 「説明を表示アイコン」
-
適切なステップをモデル内の必要な場所にドラッグします。
例： 参加者ステップ.
フローに追加された後は、次の操作を実行できます。 ステップの設定.
-
必要に応じて、手順やその他の更新をいくつでも追加します。
実行時に、ステップはモデルに表示される順序で実行されます。 ステップコンポーネントを追加した後、モデル内の別の場所にドラッグできます。
既存のステップのコピー、切り取り、貼り付け、グループ化、削除もできます。例えば ページエディター。
分割ステップは、ツールバーオプション
-
同期（エディターツールバー）をクリックして変更内容を確認し、ランタイムモデルを生成します。
詳しくは、 ワークフローを同期 」を参照してください。
ワークフローステップの設定 configuring-a-workflow-step
以下が可能です。 設定 をクリックし、 ステップのプロパティ ダイアログボックス
-
次の手順で ステップのプロパティ ステップのダイアログボックスは、次のいずれかの方法で表示されます。
- ワークフローモデルのステップをタップし、「 」を選択します。 設定 を選択します。
- ステップをダブルクリックします。
note note NOTE AEMと共にインストールされる主なステップコンポーネントについて詳しくは、 ワークフローステップのリファレンス. -
の設定 ステップのプロパティ 必要に応じて使用できるプロパティは、ステップのタイプに応じて異なります。複数のタブを使用することもできます。 例えば、新しいワークフローで
Step 1として表示されるデフォルトの 参加者ステップ では、次のようになります。
-
チェックマークをクリックして、アップデート内容を確認します。
-
同期（エディターツールバー）をクリックして変更内容を確認し、ランタイムモデルを生成します。
詳しくは、 ワークフローを同期 」を参照してください。
一時的なワークフローの作成 creating-a-transient-workflow
次の項目を作成できます。 一時的 新しいモデルを作成する場合、または既存のモデルを編集する場合のワークフローモデル：
タッチ UI でワークフローモデルを使用可能にする make-workflow-models-available-in-touchui
クラシック UI に表示されるワークフローモデルがタッチ UI の タイムライン レールの選択ポップアップメニューに表示されない場合は、設定に従ってワークフローモデルを使用可能にします。以下の手順は、アクティベーションのリクエスト と呼ばれるワークフローモデルの使用を説明します。
-
該当するモデルがタッチ対応 UI で使用できないことを確認します。
/assets.html/content/damパスを使用してアセットにアクセスします。アセットを選択します。左側のレールで タイムライン を開きます。ワークフローを開始 をクリックして、アクティベーションのリクエスト モデルがポップアップリストに存在しないことを確認します。 -
ツール／一般／タグ付け と移動します。ワークフロー を選択します。
-
「作成／タグを作成」を選択します。タイトル を
DAMに、名前 をdamに、それぞれ設定します。送信 を選択します。
-
ツール／ワークフロー／モデル に移動します。アクティベーションのリクエスト を選択し、次に 編集 を選択してください。
-
選択 編集 を開き、 ワークフローモデルのプロパティ. 次に移動： 基本 タブをクリックします。
-
Workflow : DAMを タグ フィールドに追加します。チェック（チェックマーク）で選択を確認します。 -
保存して閉じる でタグの追加を確認します。
-
同期 でプロセスを完了します。タッチ操作対応 UI でワークフローを使用できるようになりました。
マルチリソースサポートのためのワークフローの設定 configuring-a-workflow-for-multi-resource-support
次のワークフローモデルを設定できます。 マルチリソースのサポート 新しいモデルを作成する場合、または既存のモデルを編集する場合：
ワークフローステージの設定（ワークフローの進行状況を表示） configuring-workflow-stages-that-show-workflow-progress
ワークフローステージ タスクを処理する際のワークフローの進行状況を視覚化します。
使用可能なステージは、ワークフローモデルで定義されます。既存のワークフローモデルを更新して、ステージ定義を含めることができます。 ワークフローモデルに対して任意の数のステージを定義できます。
定義するには ステージ ワークフローの場合：
-
編集するワークフローモデルを開きます。
-
選択 ワークフローモデルのプロパティ をクリックします。 次に、 ステージ タブをクリックします。
-
必要な ステージ を追加（および配置）します。ワークフローモデルに対して任意の数のステージを定義できます。
次に例を示します。
-
クリック 保存して閉じる をクリックしてプロパティを保存します。
-
ワークフローモデル内の各ステップにステージを割り当てます。 次に例を示します。
1 つのステージを複数のステップに割り当てることができます。 次に例を示します。
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 ステップ ステージ 手順 1 作成 手順 2 作成 手順 3 レビュー 手順 4 承認 手順 5 承認 手順 6 完了 -
「同期」（エディターツールバー）をクリックして変更内容を確定し、ランタイムモデルを生成します。
詳しくは、 ワークフローを同期 」を参照してください。
パッケージでのワークフローモデルの書き出し exporting-a-workflow-model-in-a-package
-
を使用して新しいパッケージを作成します。 パッケージマネージャー:
- 次の方法でパッケージマネージャーに移動します。 ツール, 導入, パッケージ.
- 「パッケージを作成」をクリックします。
- 次を指定： パッケージ名、および必要に応じてその他の詳細。
- 「OK」をクリックします。
-
新しいパッケージのツールバーの「編集」をクリックします。
-
「フィルター」タブを開きます。
-
「フィルターを追加」を選択し、ワークフローモデルの 設計 のパスを指定します。
/conf/global/settings/workflow/models/<*your-model-name*>「完了」をクリックします。
-
「フィルターを追加」を選択し、ランタイムワークフローモデルのパスを指定します 。
/var/workflow/models/<*your-model-name*>「完了」をクリックします。
-
モデルで使用されるカスタムスクリプトに対してフィルターを追加します。
-
クリック 保存 をクリックして、フィルター定義を確認します。
-
選択 ビルド をクリックします。
-
選択 ダウンロード をクリックします。
ワークフローを使用したフォーム送信の処理 using-workflows-to-process-form-submissions
選択したワークフローで処理されるフォームを設定できます。 ユーザーがフォームを送信すると、フォーム送信のデータをペイロードとして使用した新しいワークフローインスタンスが作成されます。
フォームで使用するワークフローを設定するには、次の手順を実行します。
-
新しいページを作成し、編集用に開きます。
-
を追加します。 フォーム コンポーネントをページに追加します。
-
の設定 フォーム開始 ページに表示されたコンポーネント
-
「ワークフローを開始」で、使用可能なワークフローの中から目的のワークフローを選択します。
-
チェックマークを使用して、新しいフォーム設定を確認します。
ワークフローのテスト testing-workflows
ワークフローをテストする際には、様々なペイロードタイプを使用することをお勧めします。開発されたタイプとは異なるタイプを含む。 例えば、ワークフローで Assets を処理する場合は、ページをペイロードとして設定し、エラーがスローされないことを確認して、アセットをテストします。
例えば、次のようにして、新しいワークフローをテストします。
-
コンソールからワークフローモデルを開始します。
-
ペイロード を定義して確定します。
-
ワークフローが進行するように、必要に応じてアクションを実行します。
-
ワークフローの実行中にログファイルを監視します。
また、AEMを デバッグ ログファイル内のメッセージ。 詳しくは、ログを参照してください。開発が完了したら、ログレベル を 情報 に戻します。
例 examples
例：公開のリクエストを承認／拒否する（単純な）ワークフローの作成 example-creating-a-simple-workflow-to-accept-or-reject-a-request-for-publication
ワークフロー作成の可能性をいくつか示すために、ここでは、Publish Example ワークフローのバリエーションを作成します。
-
新しいワークフローには、次の情報が含まれます。
- フロー開始
Step 1- フロー終了
-
Step 1を削除します（この例には不適切なステップタイプです）。- ステップをクリックし、コンポーネントツールバーの「削除」を選択します。アクションを確認します。
-
次の ワークフロー ステップブラウザーの選択、 参加者ステップ をワークフロー上に配置し、次の間に配置します。 フロー開始 および フロー終了.
-
プロパティダイアログボックスを開くには、次のいずれかを実行します。
- 参加者ステップをクリックし、コンポーネントツールバーの「設定」を選択します。
- 参加者ステップをダブルクリックします。
-
「共通」タブで、「タイトル」と「説明」の両方に
Validate Contentと入力します。 -
を開きます。 ユーザー/グループ タブ：
- 有効化 電子メールでユーザーに通知.
- 「ユーザー／グループ」フィールドで「
Administrator（admin）」を選択します。
note note NOTE E メールを送信する場合は、 メールサービスとユーザーアカウントの詳細を設定する必要があります. -
チェックマークを付けて更新を確認します。
ワークフローモデルの概要に戻ります。ここで、参加者ステップが
Validate Contentという名前に変更されます。 -
OR 分岐 をワークフローにドラッグして、「
Validate Content」と「フロー終了」の間に配置します。 -
を開きます。 OR 分割 設定用。
-
設定：
- 共通:選択 2 ブランチ
- ブランチ 1:選択 デフォルトルート.
- ブランチ 2:確実にする デフォルトルート が選択されていません。
-
更新内容を OR 分割.
-
ドラッグ 参加者ステップ 左側のブランチに対して、プロパティを開き、次の値を指定して、変更を確定します。
- タイトル：
Reject Publish Request - ユーザー／グループ：
projects-administratorsなど - メールでユーザーに通知する：有効にすると、ユーザーにメールで通知が届きます。
- タイトル：
-
プロセスステップ を右側のブランチにドラッグし、プロパティを開き、次の値を指定してから変更内容を確認します。
- タイトル：
Publish Page as Requested - プロセス：
Activate Pageを選択します。このプロセスは、選択されているページをパブリッシャーインスタンスに公開します。
- タイトル：
-
クリック 同期 （エディターのツールバー）を使用して、ランタイムモデルを生成します。
詳しくは、 ワークフローを同期 」を参照してください。
新しいワークフローモデルは次のようになります。
-
このワークフローをページに適用します。その結果、ユーザーが「コンテンツを検証」ステップの「完了」に移動すると、「リクエストに応じてページを公開」と「公開リクエストを拒否」のどちらを実行するかを選択できます。
例：OR 分割のルールの定義 example-defining-a-rule-for-an-or-split
OR 分割 ステップを使用すると、ワークフローに条件付き処理パスを導入できます。
OR ルールを定義するには：
-
2 つのスクリプトを作成し、リポジトリに保存します。例えば、次の場所です。
/apps/myapp/workflow/scriptsnote note NOTE スクリプトには、ブール値を返す関数 check()を含める必要があります。 -
ワークフローを編集し、 OR 分割 をモデルに追加します。
-
のプロパティを編集 ブランチ 1 の OR 分割:
-
「値」を
trueに設定して、これを「デフォルトのルート」として定義します。 -
「ルール」として、そのスクリプトへのパスを設定します。次に例を示します。
/apps/myapp/workflow/scripts/myscript1.ecma
note note NOTE 必要に応じて、ブランチの順序を切り替えることができます。 -
-
OR 分割 の ブランチ 2 のプロパティを編集します。
-
「ルール」として、もう 1 つのスクリプトへのパスを設定します。次に例を示します。
/apps/myapp/workflow/scripts/myscript2.ecma
-
-
各ブランチ内の個々のステップのプロパティを設定します。「ユーザー／グループ」が設定されていることを確認します。
-
クリック 同期 （エディターのツールバー）を使用して、ランタイムモデルに対する変更を保持します。
詳しくは、 ワークフローを同期 」を参照してください。
関数 Check() function-check
次のサンプルスクリプトは、ノードが /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;
}
}
例：アクティベーションのカスタマイズリクエスト example-customized-request-for-activation
標準搭載の任意のワークフローをカスタマイズできます。 動作をカスタマイズするには、該当するワークフローの詳細をオーバーレイします。
例： アクティベーションのリクエスト. このワークフローは、 サイト コンテンツ作成者が適切なレプリケーション権限を持っていない場合に、自動的にトリガーされます。 詳しくは、ページオーサリングのカスタマイズ - アクティベーションをリクエストワークフローのカスタマイズを参照してください。