OSGi 上の Forms 中心のワークフロー - ステップリファレンス

Forms のワークフローステップ

Forms ワークフローステップは、AEM ワークフローで AEM Forms 固有の操作を実行します。これらのステップを使用すると、OSGi でアダプティブフォームをベースとした Forms 中心型ワークフローを迅速に構築できます。これらのワークフローは、基本的なレビューおよび承認ワークフロー、内部およびファイアウォール全体のビジネスプロセスの開発に使用できます。 Forms ワークフローを使用して、ドキュメントサービスの開始や Adobe Sign 署名ワークフローとの統合など、AEM Forms の操作を実行することもできます。これらのステップをワークフローで使用するには、AEM Forms アドオンが必要です。

タスクを割り当てステップ

タスクを割り当てステップは、タスクを作成してユーザーまたはグループに割り当てます。このコンポーネントは、タスクの割り当てに加えて、タスクのアダプティブフォームまたは非インタラクティブ PDF を指定します。アダプティブフォームは、ユーザーからの入力を受け取るために必要です。また、非インタラクティブ PDF または読み取り専用のアダプティブフォームは、レビュー専用のワークフローに使用されます。

このコンポーネントを使用すると、タスクの動作を制御することもできます。例えば、レコードのドキュメントの自動作成、特定のユーザーまたはグループへのタスクの割り当て、送信済みデータのパスの指定、事前入力されるデータのパスの指定、デフォルトアクションの指定が対象になります。タスクを割り当てステップには、次のプロパティがあります。

• タイトル：​タスクのタイトル。タイトルは AEM インボックスに表示されます。

• 説明：​タスクで実行される操作の説明。この情報は、共有開発環境で作業している場合に他のプロセス開発者にとって有用です。

• サムネールのパス：​タスクサムネールのパス。パスを指定しない場合、アダプティブフォームではデフォルトのサムネールが表示され、レコードのドキュメントではデフォルトのアイコンが表示されます。

• ワークフローステージ： 1 つのワークフローに複数のステージを含めることができます。これらのステージは、AEM インボックスに表示されます。これらのステージは、モデルのプロパティ（サイドキック／ページ／ページのプロパティ／ステージ）で定義できます。

• 優先度：​選択した優先度が AEM インボックスに表示されます。使用可能なオプションは、「高」、「中」および「低」です。デフォルト値は「中」です。

• 期限：​タスクが期限切れとマークされるまでの日数または時間数を指定します。「オフ」を選択した場合、タスクが期限切れとマークされることはありません。タイムアウトハンドラーを指定して、タスクが期限切れになった後に特定のタスクを実行することもできます。

• 日：​タスクを完了するまでの日数。この日数は、タスクがユーザーに割り当てられた後にカウントされます。タスクが完了せず、「日」フィールドに指定された日数を過ぎると、期限後にタイムアウトハンドラー（選択した場合）が呼び出されます。

• 時間：​タスクを完了するまでの時間数。この時間数は、タスクがユーザーに割り当てられた後にカウントされます。タスクが完了せず、「時間」フィールドに指定された時間数を過ぎると、期限後にタイムアウトハンドラー（選択した場合）が呼び出されます。

• 期限後にタイムアウト：​このオプションを選択して、タイムアウトハンドラー選択フィールドを有効にします。

• タイムアウトハンドラー：​タスクを割り当てステップが期限切れになったときに実行するスクリプトを選択します。CRX リポジトリー（[apps]/fd/dashboard/scripts/timeoutHandler）にあるスクリプトを選択できます。指定されたパスは crx リポジトリーに存在しません。このパスは、使用する前に管理者が作成します。

• タスクの詳細で最後のタスクのアクションとコメントを強調表示する：​タスクの詳細セクションで最後に実行されたアクションと受け取ったコメントを表示するには、このオプションを選択します。

• タイプ：​ワークフローの開始時に入力するドキュメントのタイプを選択します。アダプティブフォーム、読み取り専用のアダプティブフォーム、非インタラクティブPDFドキュメント、インタラクティブ通信エージェントUI、またはインタラクティブ通信Webチャネルドキュメントを選択できます。

• アダプティブフォームを使用： 入力アダプティブフォームを検索する方法を指定します。このオプションは、「タイプ」ドロップダウンリストから「アダプティブフォーム」または「読み取り専用」のアダプティブフォームを選択した場合に使用できます。 ワークフローに送信されたアダプティブフォームを使用することも、絶対パスで使用することも、変数内のパスで使用することもできます。 パスを指定するには、String 型の変数を使用します。
  1つのワークフローに複数のアダプティブフォームを関連付けることができます。 その結果、利用可能な入力メソッドを使用して、ランタイム上のアダプティブフォームを指定できます。

• インタラクティブ通信を使用： 入力されたインタラクティブ通信を検索する方法を指定します。ワークフローに送信されたインタラクティブ通信を、絶対パスで使用することも、変数内のパスで使用することもできます。 パスを指定するには、String 型の変数を使用します。このオプションは、「タイプ」ドロップダウンリストから「インタラクティブ通信エージェントUI」または「インタラクティブ通信Webチャネルドキュメント」を選択した場合に使用できます。

• アダプティブフォームまたはインタラクティブ通信パス:アダプティブフォームまたはインタラクティブ通信のパスを指定します。ワークフローに送信されたアダプティブフォームまたはインタラクティブ通信を絶対パスで使用するか、文字列データ型の変数に格納されたパスからアダプティブフォームを取得することができます。

• 次を使用して入力PDFを選択： 非インタラクティブPDFドキュメントのパスを指定します。このフィールドは、「タイプ」フィールドで非インタラクティブ PDF ドキュメントを選択した場合に使用できます。入力 PDF は、ペイロードに対する相対パス、絶対パスで保存されたもの、またはドキュメントデータ型の変数を使用して選択できます。例えば、[Payload_Directory]/Workflow/PDF/credit-card.pdf となります。このパスは crx リポジトリーに存在しません。このパスは、使用する前に管理者が作成します。「PDF のパス」オプションを使用する場合は、有効な「レコードのドキュメント」オプションか、フォームテンプレートベースのアダプティブフォームが必要です。

• 完了したタスクのアダプティブフォームを次の形式でレンダリングする：​タスクが完了とマークされると、アダプティブフォームを読み取り専用のアダプティブフォームまたは PDF ドキュメントとしてレンダリングできます。アダプティブフォームをレコードのドキュメントとしてレンダリングするには、有効な「レコードのドキュメント」オプションか、フォームテンプレートベースのアダプティブフォームが必要です。

• 事前入力済み： 以下に示すフィールドは、タスクへの入力として機能します。

  • 次を使用して入力データファイルを選択します。 入力データファイルのパス(.json、.xml、.doc、またはフォームデータモデル)。ペイロードに対する相対パスを使用して入力データファイルを取得したり、ドキュメント、XML、JSON データ型の変数に格納されたファイルを取得したりできます。例えば、ファイルには、AEM インボックスアプリケーションを介してフォームに送信されるデータが含まれています。一例として、[Payload_Directory]/workflow/data というパスを指定します。

  • 次を使用して入力添付ファイルを選択： 場所で使用可能な添付ファイルは、タスクに関連付けられたフォームに添付されます。必ずペイロードに対する相対パスを指定します。パスの例は[Payload_Directory]/attachments/です。

  • 入力JSONを選択： ペイロードに対する相対パス、またはDocument、JSON、またはForm Data Modelデータ型の変数に格納されたパスを使用して、入力JSONファイルを選択します。このオプションは、「タイプ」ドロップダウンリストから「インタラクティブ通信エージェントUI」または「インタラクティブ通信Webチャネルドキュメント」を選択した場合に使用できます。

  • カスタム事前入力サービスの選択： 事前入力サービスを選択してデータを取得し、インタラクティブ通信WebチャネルドキュメントまたはエージェントUIを事前入力します。

  • 上で選択したインタラクティブ通信の事前入力サービスを使用する： このオプションを使用して、インタラクティブ通信を使用ドロップダウンリストで定義したインタラクティブ通信の事前入力サービスを使用します。

  • リクエスト属性マッピング： 「リクエスト属性マッピング」セクションを使用し て、リクエスト属性の名前と値を定義します。リクエストで指定された属性名と値に基づいて、データソースから詳細を取得します。リテラル値または String データ型の変数を使用して、要求属性値を定義できます。\

    事前入力サービスと要求属性のマッピングオプションは、「タイプ」ドロップダウンリストから「インタラクティブ通信エージェントUI」または「インタラクティブ通信Webチャネルドキュメント」を選択した場合にのみ使用できます。

• 送信される情報：​以下のフィールドは、タスクの出力先として使用できます。

  • 次を使用して出力データファイルを保存： データファイル(.json、.xml、.doc、またはフォームデータモデル)。このデータファイルには、関連付けられたフォームを介して送信された情報が含まれます。ペイロードに対する相対パスを使用して出力データファイルを保存するか、ドキュメント、XML または JSON データ型の変数に保存できます。例えば、[Payload_Directory]/Workflow/data のように指定します。ここで、data はファイルです。

  • 添付ファイルの保存方法： タスクで提供されたフォームの添付ファイルを保存します。ペイロードに対する相対パスを使用して添付ファイルを保存するか、またはDocumentデータ型の配列の変数に保存できます。

  • レコードのドキュメントを次を使用して保存： レコードのドキュメントファイルを保存するパス。例えば、[Payload_Directory]/DocumentofRecord/credit-card.pdf のように指定します。レコードのドキュメントは、ペイロードに対する相対パスを使用して保存するか、ドキュメントデータ型の変数に格納できます。「ペイロードを基準とする」オプションを選択した場合、パスフィールドを空のままにすると、レコードのドキュメントは生成されません。このオプションは、「タイプ」ドロップダウンリストから「アダプティブフォーム」を選択した場合にのみ使用できます。

  • 次を使用してWebチャネルデータを保存： ペイロードに対する相対パスを使用してWebチャネルデータファイルを保存するか、Document、JSON、またはForm Data Modelデータ型の変数に保存します。このオプションは、「タイプ」ドロップダウンリストから「インタラクティブ通信エージェントUI」を選択した場合にのみ使用できます。

  • 次を使用してPDFドキュメントを保存： ペイロードに対する相対パスを使用してPDFドキュメントを保存するか、Documentデータ型の変数に保存します。このオプションは、「タイプ」ドロップダウンリストから「インタラクティブ通信エージェントUI」を選択した場合にのみ使用できます。

  • 次を使用してレイアウトテンプレートを保存： ペイロードを基準としたパスを使用してレイアウトテンプレートを保存するか、Documentデータ型の変数に格納します。レイアウトテンプレートは、Forms Designerを使用して作成したXDPファイルを参照します。 このオプションは、「タイプ」ドロップダウンリストから「インタラクティブ通信エージェントUI」を選択した場合にのみ使用できます。

• 担当者/割り当てオプション： タスクをユーザーに割り当てる方法を指定します。参加者選択スクリプトを使用してタスクを動的にユーザーまたはグループに割り当てることも、タスクを特定の AEM ユーザーまたはグループに割り当てることもできます。

• 参加者選択：​このオプションは、「割り当てオプション」フィールドで「ユーザーまたはグループに動的に割り当て」オプションを選択した場合に使用できます。ユーザーまたはグループを動的に選択するには、ECMAScript またはサービスを使用できます。詳しくは、ワークフローを動的にユーザーに割り当てる方法および Adobe Experience Manager のカスタム動的参加者ステップの作成を参照してください。

• 参加者：​このオプションは、参加者選択フィールドで「com.adobe.granite.workflow.core.process.RandomParticipantChooser​」オプションが選択されている場合に使用できます。​このフィールドでは、「RandomParticipantChooser」オプションのユーザーまたはグループを選択できます。

• 担当者： このフィールドは、参加者選択フィールドで com.adobe.fd.workspace.step.service. VariableParticipantChooserisが選択された場合に使 用で きます。このフィールドでは、String データ型の変数を選択して、担当者を定義できます。

• 引数：​このフィールドは、参加者選択フィールドで RandomParticipantChoose スクリプト以外のスクリプトが選択されている場合に使用できます。このフィールドでは、参加者選択フィールドで選択したスクリプトに渡すコンマ区切りの引数のリストを指定できます。

• ユーザーまたはグループ：​選択したユーザーまたはグループにタスクが割り当てられます。このオプションは、「割り当てオプション」フィールドで「特定のユーザーまたはグループに割り当て」オプションを選択した場合に使用できます。このフィールドには、ワークフローユーザーグループのすべてのユーザーとグループが一覧表示されます。
  「ユーザーまたはグループ」ドロップダウンメニューには、ログインユーザーおよびグループがアクセスできるリストが表示されます。ユーザー名の表示は、その特定のユーザーの crx-repository の users ノードに対するアクセス権限があるかどうかによって異なります。

• 通知メールを送信：電子メール通知を担当者に送信するには、このオプションを選択します。この通知は、タスクがユーザーまたはグループに割り当てられたときに送信されます。「受信者の電子メールアドレス」オプションを使用して、電子メールアドレスを取得するメカニズムを指定できます。

• 受信者の電子メールアドレス：電子メールアドレスは、変数に格納したり、リテラルを使用して永続的な電子メールアドレスを指定したり、担当者のプロファイルで指定したデフォルトの電子メールアドレスを使用したりできます。リテラルまたは変数を使用して、グループの電子メールアドレスを指定できます。変数オプションは、電子メールアドレスを動的に取得して使用する場合に便利です。「担当者のデフォルトの電子メールアドレスを使用する」オプションは、1 人の担当者に対してのみ使用できます。この場合、担当者のユーザープロファイルに保存されている電子メールアドレスが使用されます。

• HTML 電子メールテンプレート：​通知電子メールの電子メールテンプレートを選択します。テンプレートを編集するには、crx リポジトリーの /libs/fd/dashboard/templates/email/htmlEmailTemplate.txt にあるファイルを変更します。

• 委任を許可： AEM インボックスには、ログインユーザーが、割り当てられたワークフローを別のユーザーに委任するオプションが用意されています。同じグループ内または別のグループのワークフローユーザーに委任することができます。タスクが 1 人のユーザーに割り当てられていて、「担当者グループのメンバーへの委任を許可する」オプションが選択されている場合、そのタスクを別のユーザーまたはグループに委任することはできません。

• 共有設定： AEM Inboxには、インボックス内の1つまたはすべてのタスクを他のユーザーと共有するオプションが用意されています。

  • 「割り当て先によるインボックス​での明示的な共有を許可」オプションが選択されている場合、ユーザーはタスクをクリックして別のAEMユーザーと共有できます。
  • 「割り当て先がインボックス共有経由で共有を許可 」オプションを選択し、ユーザーが自分のインボックス項目を共有したり、他のユーザーが自分のインボックス項目にアクセスしたりできる場合、前述のオプションが有効なタスクのみが他のユーザーと共有されます。

• アクション/デフォルトのアクション： デフォルトでは、送信、保存、リセットの各アクションを使用できます。デフォルトのアクションはすべて、デフォルトで有効になっています。

• ルート変数：​ルート変数の名前。ルート変数は、ユーザーが AEM インボックスで選択したカスタムアクションを取得します。

• ルート：​タスクは様々なルートに分岐することができます。AEM インボックスで選択すると、ルートから値が返され、選択したルートに基づいてワークフローが分岐します。ルートは、文字列データ型の配列の変数に格納するか、リテラル​を選択して手動でルートを追加できます。

• タイトル:ルートのタイトルを指定します。タイトルは AEM インボックスに表示されます。

• Coral アイコン： Coral アイコンの HTML 属性を指定します。Adobe CoralUI ライブラリでは、多数のタッチファーストなアイコンを提供します。ルートのアイコンを選択して使用することができます。アイコンは、タイトルと共に AEM インボックスに表示されます。変数にルートを格納した場合、ルートにはデフォルトの「タグ」Coral アイコンが使用されます。

• 担当者がコメントを追加することを許可：タスクのコメントを有効にするには、このオプションを選択します。担当者は、タスクの送信時に AEM インボックス内からコメントを追加できます。

• 変数にコメントを保存： Stringデータ型の変数にコメントを保存します。このオプションは、「担当者がコメントを追加することを許可」チェックボックスを選択した場合にのみ表示されます。

• 担当者によるタスクへの添付ファイルの追加を許可：​タスクの添付ファイルを有効にするには、このオプションを選択します。担当者は、タスクの送信時に AEM インボックス内から添付ファイルを追加できます。

• 次を使用して出力タスクの添付ファイルを保存：添付ファイルフォルダーの場所を指定します。出力タスクの添付ファイルは、ペイロードに対する相対パスを使用するか、ドキュメントデータタイプの配列の変数に保存できます。このオプションは、「 タスクへの添付ファイルの追加を担当者に許可 」チェックボックスを選択し、 タイプ​ドロップから「 アダプティブフォーム 」、「 読み取り専用アダプティブフォーム 」、「 非インタラクティブPDFドキュメント 」を選択した場合にのみ —downリストを選択します。​

• カスタムメタデータを使用：​カスタムメタデータフィールドを有効にするには、このオプションを選択します。カスタムメタデータは電子メールテンプレートで使用されます。
• カスタムメタデータ：​電子メールテンプレートのカスタムメタデータを選択します。カスタムメタデータは、crx リポジトリーの apps/fd/dashboard/scripts/metadataScripts にあります。指定されたパスは crx リポジトリーに存在しません。このパスは、使用する前に管理者が作成します。また、カスタムメタデータ用のサービスを使用することもできます。また、WorkitemUserMetadataServiceインターフェイスを拡張して、カスタムメタデータを提供することもできます。
• 以前の手順のデータを表示:このオプションを選択すると、担当者は以前に割り当てられた担当者、タスクで既に実行されたアクション、タスクに追加されたコメント、完了したタスクのレコードのドキュメント（ある場合）を表示できます。
• 以降のステップのデータを表示する：​後続の担当者が実行したアクションと追加したコメントを現在の担当者が表示できるようにするには、このオプションを選択します。また、このオプションを選択すると、完了したタスクのレコードのドキュメント（使用可能な場合）を現在の担当者が表示できるようになります。
• データタイプの表示：​デフォルトで、担当者は、レコードのドキュメント、担当者、実行されたアクションに加え、前の担当者および後続の担当者が追加したコメントを表示することができます。「データタイプの表示」オプションを使用すると、担当者に表示されるデータタイプが制限されます。

電子メールを送信ステップ

電子メールのステップを使用して、レコードのドキュメント、アダプティブフォームのリンク、インタラクティブ通信のリンクまたは添付 PDF ドキュメントを含む電子メールを送信します。電子メールを送信ステップは、HTML 電子メールをサポートします。HTML 電子メールは、受信者の電子メールクライアントや画面サイズにレスポンシブに対応します。HTML電子メールテンプレートを使用して、電子メールの外観、カラースキーム、動作を定義できます。

電子メールステップは、Day CQ Mail Service を使用して電子メールを送信します。電子メールステップを使用する前に、電子メールサービスが設定されていることを確認してください。電子メールステップには、次のプロパティがあります。

タイトル：​ステップのタイトルは、ワークフローエディターでステップを識別するのに役立ちます。

説明：​説明は、共通の開発環境で作業する他のプロセス開発者にとって有用です。

電子メールの件名： 件名は、ワークフローメタデータから手動で指定して取得することも、変数に保存されている値から取得することもできます。次のいずれかのオプションを選択します。

• リテラル - 件名を手動で指定します。
• ワークフローメタデータから取得 - メタデータプロパティから件名を取得します。
• 変数 - 文字列データ型の変数に格納された値から件名を取得します。

HTML 電子メールテンプレート：​電子メール用の HTML テンプレートです。電子メールテンプレート内で変数を指定することができます。電子メールステップは、入力のため、テンプレートに含まれるすべての変数を抽出して表示します。

電子メールテンプレートメタデータ： 電子メールテンプレート変数の値は、ユーザー指定の値、オーサーまたはパブリッシュサーバー上のアセットのパス、画像、ワークフローメタデータのプロパティのいずれかです。

• リテラル：​指定する値が正確に分かっている場合は、このオプションを使用します。例えば、example@example.com と指定します。

• ワークフローメタデータ：​使用する値がワークフローメタデータプロパティに保存されている場合は、このオプションを使用します。このオプションを選択したら、「ワークフローメタデータ」オプションの下の空のテキストボックスにメタデータプロパティ名を入力します。例えば、emailAddress と指定します。

• アセットURL: インタラクティブ通信のWebリンクを電子メールに埋め込むには、このオプションを使用します。オプションを選択したら、埋め込むインタラクティブ通信を参照して選択します。 アセットは、オーサーサーバーまたはパブリッシュサーバーに置くことができます。

• 画像：​画像を電子メールに埋め込むには、このオプションを使用します。このオプションを選択したら、画像を参照して選択します。「画像」オプションは、電子メールテンプレートで使用できる画像タグ（<img src="*"/>）に対してのみ使用できます。

送信者の電子メールアドレス/受信者の電子メールアドレス： 電子メールアドレスを手動で指定するには「リテラル」オプションを選択しま ​​ ​​す。メタデータプロパティから電子メールアドレスを取得するには、「ワークフローから取得」メタデータオプションを選択します。「ワークフローメタデータから取得」オプションのメタデータプロパティ配列のリストを指定することもできます。「変数」オプションを選択して、文字列データ型の変数に格納されている値から電子メールアドレスを取得します。

添付ファイル： 指定された場所で使用可能なアセットが電子メールに添付されます。アセットのパスは、ペイロードに対する相対パスまたは絶対パスのどちらでもかまいません。一例として、[Payload_Directory]/attachments/ というパスを指定します。

「変数」オプションを選択して、ドキュメント、XML、JSON データ型の変数に格納された添付ファイルを取得します。

ファイル名：​電子メール添付ファイルの名前です。電子メールステップは、添付ファイルの元のファイル名を指定されたファイル名に変更します。この名前は、手動で指定することも、ワークフローメタデータのプロパティまたは変数から取得することもできます。指定する値が正確に分かっている場合は、「リテラル」オプションを使用します。「変数」オプションを使用して、文字列データ型の変数に格納された値からファイル名を取得します。使用する値がワークフローメタデータプロパティに保存されている場合は、「ワークフローメタデータから取得」オプションを使用します。

レコードのドキュメントを生成ステップ

フォームの入力時または送信時には、そのフォームを印刷物またはドキュメント形式で記録しておくことができます。これは、レコードのドキュメント（DoR）と呼ばれます。レコードのドキュメントを生成ステップを使用して、アダプティブフォームの（読み取り専用またはインタラクティブの）PDF バージョンを作成することができます。PDF バージョンには、アダプティブフォームのレイアウトと共にフォームに入力された情報が含まれます。

レコードのドキュメントステップには、次のプロパティがあります。

アダプティブフォームを使用:入力アダプティブフォームを検索する方法を指定します。ワークフローに送信されたアダプティブフォームを使用することも、絶対パスで使用することも、変数内のパスで使用することもできます。 文字列データ型の変数を使用して、「変数を選択して解決」フィールドのパスを指定できます。
1つのワークフローに複数のアダプティブフォームを関連付けることができます。 その結果、利用可能な入力メソッドを使用して、ランタイム上のアダプティブフォームを指定できます。

アダプティブフォームのパス：アダプティブフォームのパスを指定します。このフィールドは、「アダプティブフォームを使用」フィールドから「絶対パスで使用可能」オプションを選択した場合に使用できます。

次を使用してデータを入力： アダプティブフォームの入力データのパスを選択します。データは、ペイロードに対する相対的な場所に保持したり、データの絶対パスを指定したり、ドキュメント、JSON または XML データ型の変数に格納されたデータを取得したりできます。入力データは、レコードのドキュメントを作成するためにアダプティブフォームとマージされます。

「添付ファイルのパス」で、「 添付ファイルのパス」を選択します。これらの添付ファイルは「レコードのドキュメント」に含まれます。添付ファイルは、ペイロードに対する相対的な場所に保持したり、添付ファイルの絶対パスを指定したり、ドキュメントデータ型配列の変数に格納された添付ファイルを取得したりできます。

フォルダーのパスを指定すると、添付ファイルなど、そのフォルダー内で直接使用可能なすべてのファイルがレコードのドキュメントに添付されます。指定された添付ファイルのパスに直接存在するフォルダー内に使用できるファイルがある場合、そのファイルはレコードのドキュメントに添付ファイルとして含まれます。直接存在するフォルダー内にフォルダーがある場合、それらはスキップされます。

次のオプションを使用して、生成されたレコードのドキュメントを保存： レコードのドキュメントファイルを保持する場所を指定します。ペイロードフォルダーを上書きする、ペイロードディレクトリ内の場所にレコードのドキュメントを配置する、またはレコードのドキュメントをDocumentデータ型の変数に格納する、のいずれかを選択できます。

ロケール：​レコードのドキュメントの言語を指定します。ドロップダウンリストからロケールを選択する場合は「リテラル」を選択し、文字列データ型の変数に格納されている値からロケールを取得する場合は「変数」を選択します。ロケールの値を変数に格納する際は、ロケールコードを定義する必要があります。例えば、英語は en_US、フランス語は fr_FR と指定します。

フォームデータモデルサービスを呼び出しステップ

AEM Forms のデータ統合機能により、複数の異なるデータソースを設定して接続することができます。これらのデータソースには、データベース、Web サービス、REST サービス、OData サービス、CRM ソリューションがあります。AEM Forms のデータ統合を使用すると、様々なサービスを実行するフォームデータモデルを作成できます。例えば、構成されたデータベースに対して、データの取得、追加、更新を実行できます。データモデルサービスの呼び出し手順​を使用して、フォームデータモデル(FDM)を選択し、FDMのサービスを使用して、異なるデータソースに対してデータを取得、更新、または追加できます。

ステップのフィールドの入力について説明するために、次のデータベーステーブルと JSON ファイルを例として使用します。

サンプル CustomerDetails テーブル

サンプル JSON ファイル

  { 
    customer: { 
     firstName: "Sarah", 
     lastName:"Rose", 
     customerId: "1", 
     emailAddress:"srose@we.info" 
   }, 
    insurance: {
     customerId: "1", 
    policyType: "Premium,
    policyNumber: "Premium-521499",
    customerDetails: { 
     firstName: "Sarah",
     lastName: "Rose",
     customerId: "1",
     emailAddress: "srose@we.info" 
    }
   }
  }

フォームデータモデルサービスを呼び出しステップには、以下に一覧されたフィールドがあり、フォームデータモデルの操作に役立ちます。

• タイトル：​ステップのタイトルです。ワークフローエディターでステップを識別するのに役立ちます。

• 説明：​説明は、共通の開発環境で作業する他のプロセス開発者にとって有用です。

• フォームデータモデルのパス：​サーバー上のフォームデータモデルを参照して選択します。

• サービス：​選択したフォームデータモデルのサービスのリストです。

• サービスの入力／リテラル、変数またはワークフローメタデータおよび JSON ファイルを使用して入力データを指定：サービスには複数の引数を持たせることができます。ワークフローメタデータプロパティ、JSON オブジェクト、変数からサービス引数の値を取得するか、用意されたテキストボックスに直接値を入力するには、このオプションを選択します。

  • リテラル：​指定する値が正確に分かっている場合は、このオプションを使用します。例えば、srose@we.info と指定します。

  • 変数： 変数に保存された値を取得するには、オプションを使用します。

  • ワークフローメタデータから取得：​使用する値がワークフローメタデータプロパティに保存されている場合は、このオプションを使用します。例えば、emailAddress と指定します。

  • ペイロードとの関連:ペイロードに関連するパスに保存された添付ファイルを取得するには、「 」オプションを使用します。オプションを選択し、添付ファイルを含むフォルダー名を指定するか、テキストボックスに添付ファイル名を指定します。

    例えば、CRXリポジトリの「ペイロードに対する相対」フォルダーのattachment\attachment-folderの場所にファイル添付ファイルが含まれている場合、「ペイロードに対する相対」オプションを選択した後、テキストボックスでattachment\attachment-folderを指定します。

  • JSON ドット表記法：​使用する値が JSON ファイル内にある場合は、このオプションを使用します。例えば、insurance.customerDetails.emailAddress と指定します。「 JSONドット表記」オプションは、「入力JSONからの入力フィールドをマップ」オプションが選択されている場合にのみ使用できます。

  • 入力 JSON からのマップ入力フィールド： JSON ファイルのパスを指定して、その JSON ファイルから一部のサービスの引数の入力値を取得します。JSON ファイルのパスは、ペイロードとの相対パス、絶対パスにするか、JSON またはフォームデータモデル型の変数を使用して入力 JSON ドキュメントを選択できます。

• サービスの入力/変数またはJSONファイルを使用して入力データを指定： 絶対パス、ペイロードに対する相対パス、または変数に保存されたJSONファイルからすべての引数の値を取得するには、このオプションを選択します。

• 次を使用して入力 JSON ドキュメントを選択：すべてのサービス引数の値が含まれる JSON ファイル。JSON ファイルのパスは、ペイロードに対する相対パス​または​絶対パスのどちらでもかまいません。​また、JSON またはフォームデータモデルデータ型の変数を使用して、入力 JSON ドキュメントを取得することもできます。

• JSON ドット表記法：​指定した JSON ファイルのすべてのオブジェクトをサービス引数の入力として使用するには、フィールドを空のままにします。指定した JSON ファイルからサービス引数の入力として特定の JSON オブジェクトを読み取るには、JSON オブジェクトにドット表記法を指定します。例えば、この節の冒頭に一覧表示されている JSON に似た JSON を使用している場合は、insurance.customerDetails を指定して、顧客のすべての詳細をサービスへの入力として提供します。

• サービスの出力/出力値を変数またはメタデータにマップして書き込む： 出力値をcrx-repositoryのワークフローインスタンスメタデータノードのプロパティとして保存するには、このオプションを選択します。メタデータプロパティの名前を指定し、メタデータプロパティにマップされる対応するサービス出力属性を選択します。例えば、出力サービスが返す phone_number をワークフローメタデータの phone_number プロパティでマッピングします。同様に、Service output属性にマッピングする​オプションのプロパティを選択すると、Save the output to​オプションに対して、選択したプロパティのデータを格納できる変数のみが設定されます。

• サービスの出力/出力を変数またはJSONファイルに保存： 絶対パス、ペイロードに対する相対パス、または変数にJSONファイルの出力値を保存するには、このオプションを選択します。

• 次のオプションを使用して、出力JSONドキュメントを保存します。 出力JSONファイルを保存します。出力 JSON ファイルのパスは、ペイロードに対する相対パスまたは絶対パスのどちらでもかまいません。また、JSON またはフォームデータモデルデータ型の変数を使用して、出力 JSON ファイルを保存することもできます。

ドキュメントに署名ステップ

ドキュメントに署名ステップでは、Adobe Sign を使用してドキュメントに署名できます。ドキュメントへの署名手順には、次のプロパティがあります。

• 契約名：​契約のタイトルを指定します。契約名は、署名者に送信される電子メールの件名と本文の一部として使用されます。名前は文字列データ型の変数に格納するか、リテラル​を選択して手動で追加できます。

• ロケール：​電子メールと検証オプションの言語を指定します。ロケールは文字列データ型の変数に格納するか、リテラル​を選択して、使用可能なオプションのリストからロケールを選択できます。ロケールの値を変数に格納する際は、ロケールコードを定義する必要があります。例えば、英語は en_US、フランス語は fr_FR と指定します。

• Adobe Sign クラウド設定： Adobe Sign クラウド設定を選択します。AEM Forms用にAdobe Signを設定していない場合は、「 Adobe SignとAEM Formsの統合 」を参照してください。

• 署名するドキュメントの選択： ペイロードを基準とした場所からドキュメントを選択したり、ペイロードをドキュメントとして使用したり、ドキュメントの絶対パスを指定したり、Documentデータ型の変数に格納されたドキュメントを取得したりできます。

• 期限までの日数：「期限までの日数」フィールドに指定された日数の間にタスクのアクティビティがない場合、ドキュメントは期限切れとマークされます。日数は、ドキュメントが署名のためにユーザーに割り当てられた後にカウントされます。

• リマインダー電子メールの頻度：​リマインダー電子メールを日単位または週単位で送信できます。週のカウントは、ドキュメントが署名のためにユーザーに割り当てられた日から始まります。

• 署名プロセス：​ドキュメントへの署名を順次おこなうか並列でおこなうかを選択できます。順次署名する場合、ドキュメントは署名のために一度に 1 人の署名者に送信されます。最初の署名者がドキュメントの署名を完了すると、ドキュメントは 2 人目の署名者に送信され、それ以降も同様です。並列で署名する場合、複数の署名者が同時に 1 つのドキュメントに署名することができます。

• リダイレクト URL：​リダイレクト URL を指定します。ドキュメントへの署名が完了したら、担当者を URL にリダイレクトすることができます。通常、この URL には、感謝のメッセージやその後の手順が含まれています。

• ワークフローステージ： 1 つのワークフローに複数のステージを含めることができます。これらのステージは、AEM インボックスに表示されます。これらのステージは、モデルのプロパティ（サイドキック／ページ／ページのプロパティ／ステージ）で定義できます。

• 署名者を選択：​ドキュメントの署名者を選択する方法を指定します。ワークフローを動的にユーザーまたはグループに割り当てることも、手動で署名者の詳細を追加することもできます。

• 署名者を選択するためのスクリプトまたはサービス：​このオプションを使用できるのは、「署名者を選択」フィールドで「動的」オプションが選択されている場合のみです。ECMAScript またはサービスを指定して、ドキュメントの署名者と検証オプションを選択することができます。

• 署名者の詳細：​このオプションを使用できるのは、「署名者を選択」フィールドで「手動」オプションが選択されている場合のみです。電子メールアドレスを指定し、オプションの検証メカニズムを選択します。2 段階検証メカニズムを選択する前に、設定済みの Adobe Sign アカウントに対して対応する検証オプションが有効になっていることを確認してください。Stringデータ型の変数を使用して、Email、Country Code​および​Phone Number​フィールドの値を定義できます。 「国コード」および「電話番号」フィールドは、2段階の検証​ドロップダウンリストから「電話の検証」を選択した場合にのみ表示されます。

• ステータス変数： Adobe Sign対応のドキュメントでは、Stringデータ型の変数にドキュメントの署名ステータスが格納されます。ステータス変数の名前（adobeSignStatus）を指定します。インスタンスのステータス変数は、CRXDEの/etc/workflow/instances/<server>/<date-time>/<instance of workflow model>/workItems/<node>/metaDataに、変数のステータスを含むCRXDEで使用できます。

• 署名済みドキュメントを次のオプションで保存： 署名済みドキュメントを保持する場所を指定します。ペイロードファイルを上書きする、ペイロードディレクトリ内の場所に署名済みドキュメントを配置する、またはドキュメントタイプの変数に署名済みドキュメントを保存する、のいずれかを選択できます。

ドキュメントサービスのステップ

AEM ドキュメントサービスは、PDF ドキュメントを作成、アセンブルおよび保護するための一連のサービスです。AEM Formsでは、ドキュメントサービスごとに個別のAEM Workflowステップが提供されます。

他のAEM Formsワークフロー手順（「Assign Task」、「Send Email」、「Sign Document」など）と同様に、AEM Document Servicesのすべての手順で変数を使用できます。 変数の作成と管理について詳しくは、「AEM workflowsの変数」を参照してください。

ドキュメントのタイムスタンプを適用ステップ

ドキュメントにタイムスタンプを追加します。入力ドキュメントのパス、入力ドキュメントの名前、書き出されたデータの保存場所など、ドキュメントの詳細を指定します。既存のペイロードファイルを上書きする、ペイロードフォルダーの下にある別のファイルにデータを保存する、データの絶対パスを指定する、またはDocumentデータ型の変数にデータを保存する、などを選択できます。

画像に変換ステップ

PDFドキュメントを画像のリストに変換します。 サポートされている画像形式は、JPEG、JPEG2000、PNG および TIFF です。TIFF 画像への変換には、次の情報が当てはまります。

• 複数ページの TIFF ファイルが生成されます。
• 一部の注釈は TIFF 画像に含まれません。外観の生成に Acrobat を必要とする注釈は含まれません。

PDF/A に変換 ステップ

指定したオプションを使用して PDF ドキュメントを PDF/A 形式に変換します。PDF/A バージョンの Portable Document Format（PDF）は、ドキュメントのアーカイブおよび長期保存に特化しています。

PS に変換ステップ

PDF ドキュメントを PostScript に変換します。PostScript に変換する際に、この変換操作を使用して、変換元のドキュメントと、PostScript レベル 2 と 3 のどちらに変換するかを指定できます。PostScript ファイルに変換する PDF ドキュメントは、非インタラクティブである必要があります。

指定したタイプから PDF を作成 ステップ

入力ファイルから PDF ドキュメントを生成します。入力ドキュメントは、ペイロードに対する相対パス、絶対パス、ペイロード自体、またはDocumentデータ型の変数に格納できます。

URL／HTML／ZIP から PDF を作成ステップ

指定された URL、HTML および ZIP ファイルから PDF ドキュメントを生成します。

データを書き出し ステップ

PDF フォームまたは XDP ファイルからデータを書き出します。入力ドキュメントのファイルパスとデータの書き出し形式を入力する必要があります。データの書き出し形式のオプションは、「自動」、「XDP」および「XmlData」です。

PDF を指定したタイプに書き出し ステップ

PDF ドキュメントを選択した形式に変換します。

非インタラクティブ PDF を生成 ステップ

非インタラクティブ PDF を生成します。様々なカスタマイズオプションを提供します。

データを読み込みステップ

フォームデータを PDF フォームにマージします。フォームデータを PDF フォームに読み込むことができます。

DDX を呼び出し ステップ

入力ドキュメントの指定されたマップ上で DDX ファイルを実行し、操作された PDF ドキュメントを返します。

PDF を最適化ステップ

PDF ファイルは、サイズを小さくして最適化します。この変換の結果、PDF ファイルは元のバージョンよりも小さくなる可能性があります。また、この操作では、PDF ドキュメントが最適化パラメーターで指定された PDF バージョンに変換されます。

最適化の設定では、ファイルの最適化方法を指定します。設定の例を次に示します。

• ターゲットの PDF バージョン
• JavaScript アクションや埋め込みページサムネールなどのオブジェクトの破棄
• コメントや添付ファイルなどのユーザーデータの破棄
• 無効な設定や未使用の設定の破棄
• 非圧縮データの圧縮、またはより効率的な圧縮アルゴリズムの使用
• 埋め込まれたフォントの削除
• 透過値の設定

PDF フォームをレンダリング ステップ

フォームデザイナー（XDP）で作成したフォームを PDF フォームにレンダリングします。

ドキュメントの保護ステップ

ドキュメントの暗号化、署名および証明をおこないます。AEM Forms は、パスワードベースと証明書ベース両方の暗号化をサポートしています。ドキュメントに署名するための様々なアルゴリズムの中から選択することもできます。例えば、SHA-256 や SH-512 があります。また、このワークフローステップを使用して PDF ドキュメントを拡張することもできます。このワークフローステップには、バーコードのデコード、デジタル署名、PDF データの読み込みと書き出しなどのオプションを有効にするためのオプションが用意されています。

プリンターに送信ステップ

ドキュメントをプリンターに直接送信します。次の印刷アクセスメカニズムがサポートされています。

• 直接アクセス型プリンター：同じコンピューターにインストールされているプリンターは、直接アクセス型プリンターと呼ばれます。また、そのコンピューターはプリンターホストと呼ばれます。このタイプのプリンターには、コンピューターに直接接続されているローカルプリンターが該当します。
• 間接アクセス型プリンター：プリントサーバーにインストールされているプリンターには、他のコンピューターからアクセスできます。ネットワークプリンターへの接続には、Common UNIX® Printing System（CUPS）や Line Printer Daemon（LPD）プロトコルなどのテクノロジーを使用できます。間接アクセス型プリンタにアクセスするには、プリントサーバーのIPまたはホスト名を指定します。 このメカニズムを使用すると、ネットワークで LPD が実行されている場合はドキュメントを LPD URI に送信できます。このメカニズムにより、LPD が実行されているネットワークに接続されているどのプリンターにもドキュメントをルーティングすることができます。

印刷出力ステップの生成

この手順では、フォームデザインとデータファイルが指定されたPCL、PostScript、ZPL、IPL、TPCL、またはDPL出力が生成されます。 データファイルはフォームデザインとマージされ、印刷用にフォーマットされます。この手順で生成された出力は、プリンターに直接送信することも、ファイルとして保存することもできます。 フォームデザインまたはアプリケーションのデータを使用する場合は、この手順を使用することをお勧めします。 フォームデザインまたはフォームデザインがネットワーク、ローカルファイルシステム、またはHTTP上の場所にある場合は、「generatePrintedOutput」操作を使用します。

例えば、アプリケーションでフォームデザインをデータファイルとマージする必要があるとします。データには数百件のレコードがあります。さらに、ZPL をサポートしているプリンターに出力を送信する必要があります。フォームデザインと入力データはアプリケーション内にあります。「generatePrintedOutput」操作を使用して、レコードをフォームデザインとマージし、ZPL がサポートされるプリンターに出力を送信します。

「印刷出力を生成」ステップには、次のプロパティがあります。

Input プロパティ

• ​​を使用してテンプレートファイルを選択：テンプレートファイルのパスを指定します。テンプレートファイルは、ペイロードに対する相対パス、絶対パスで保存、またはDocumentデータ型の変数を使用して選択できます。 例えば、[Payload_Directory]/Workflow/data.xmlのように指定します。 パスがcrx-repositoryに存在しない場合は、管理者がパスを作成してから使用できます。 さらに、ペイロードを入力データファイルとして受け入れることもできます。

• ​​を使用してデータドキュメントを選択：入力データファイルのパスを指定します。入力データファイルは、ペイロードに対する相対パス、絶対パスで保存、またはDocumentデータ型の変数を使用して選択できます。 例えば、[Payload_Directory]/Workflow/data.xmlのように指定します。 パスがcrx-repositoryに存在しない場合は、管理者がパスを作成してから使用できます。

• プリンター形式:XDCファイルが指定されていない場合に、出力ストリームの生成に使用するページ記述言語を指定するPrint Format値。リテラル値を指定する場合、次のいずれかの値を選択します。

  • カスタムPCL:PCL用のカスタムXDCファイルを指定するには、オプションを使用します。
  • カスタムPostScript:PostScriptのカスタムXDCファイルを指定するには、「 」オプションを使用します。
  • カスタムZPL:ZPL用のカスタムXDCファイルを指定するには、オプションを使用します。
  • 汎用カラーPCL(5c):汎用カラーPCL(5c)を使用します。
  • 汎用PostScriptレベル3:汎用のPostScriptレベル3を使用します。
  • ZPL 300 DPI:ZPL 300 DPIを使用します。zpl300.xdc が使用されます。
  • ZPL 600 DPI:ZPL 600 DPIを使用します。zpl600.xdc ファイルが使用されます。
  • カスタムIPL:IPLのカスタムXDCファイルを指定するには、オプションを使用します。
  • IPL 300 DPI:IPL 300 DPIを使用します。ipl300.xdc が使用されます。
  • IPL 400 DPI:IPL 400 DPIを使用します。ipl400.xdc が使用されます。
  • カスタムTPCL:TPCL用のカスタムXDCファイルを指定するには、オプションを使用します。
  • TPCL 305 DPI:TPCL 300 DPIを使用します。tpcl305.xdc が使用されます。
  • PCL 600 DPI:TPCL 600 DPIを使用します。tpcl600.xdc が使用されます。
  • カスタムDPL:カスタムXDCファイルDPLを指定するには、「 」オプションを使用します。
  • DPL300DPI:DPL 300 DPIを使用します。dpl300.xdc が使用されます。
  • DPL406DPI:DPL 400 DPIを使用します。dpl406.xdc が使用されます。
  • DPL600DPI:DPL 600 DPIを使用します。dpl600.xdc が使用されます。

出力プロパティ

• ​​を使用して出力ドキュメントを保存：出力ファイルを保存する場所を指定します。出力ファイルは、ペイロードに関連する場所、変数、または出力ファイルを保存する絶対位置を指定できます。 パスがcrx-repositoryに存在しない場合は、管理者がパスを作成してから使用できます。

高度なプロパティ

• ​​を使用してコンテンツルートの場所を選択します。コンテンツルートは、フォームデザインで使用される相対アセットを取得するためのURI、絶対参照、またはリポジトリ内の場所を指定するstring値です。例えば、フォームデザインが …/myImage.gif のようにイメージを相対的に参照する場合、myImage.gif は repository:// に配置する必要があります。デフォルト値は repository:// で、これはリポジトリのルートレベルをポイントします。

  アプリケーションからアセットを選択するとき、コンテンツルート URI パスは正確な構造になっている必要があります。例えば、フォームを SampleApp というアプリケーションから選択し、SampleApp/1.0/forms/Test.xdp に配置する場合、コンテンツルート URI は repository://administrator@password/Applications/SampleApp/1.0/forms/ または repository:/Applications/SampleApp/1.0/forms/（認証機関情報が NULL の場合）と指定する必要があります。コンテンツルート URI をこの方式で指定すると、フォーム内で参照されているすべてのアセットのパスがこの URI を基準に解決されます。

• ​​を使用してXCIファイルを選択します。XCIファイルは、フォームデザイン要素に使用されるフォントやその他のプロパティの説明に使用されます。ペイロードに対するXCIファイルの相対パスを指定するか、絶対パスを指定するか、またはDocumentデータ型の変数を使用して保持できます。

• ロケール:PDFドキュメントの生成に使用する言語を指定します。リテラル値を指定する場合、リストから言語を選択するか、または次のいずれかの値を選択します。

  • サーバーのデフォルトを使用するには:（デフォルト） AEM Formsサーバー上で設定されているロケール設定を使用します。ロケール設定は、管理コンソールを使用して設定します。 （「Designer ヘルプ」を参照）。

  • カスタム値を使用するには:リテラルボックスにロケールコードを入力するか、ロケールコードを含む文字列変数を選択します。サポートされているすべてのロケールコードのリストについては、http://java.sun.com/j2se/1.5.0/docs/guide/intl/locale.doc.html を参照してください。

• コピー:出力用に生成するコピーの数を指定する整数値。デフォルト値は 1 です。

• 両面印刷:両面印刷と片面印刷のどちらを使用するかを指定するPagination値です。PostScriptおよびPCLをサポートするプリンターでは、この値を使用します。リテラル値を指定する場合は、次のいずれかの値を選択します。

  • Duplex Long Edge:両面印刷を行い、長辺のページ番号を使用して印刷します。
  • Duplex Short Edge:両面印刷を使用し、短辺のページ番号を使用して印刷します。
  • シンプレックス:片面印刷を使用します。