Forms 中心の AEM Workflows - ステップリファレンスを使用して、ビジネスプロセスを自動化します。 forms-centric-workflow-on-osgi-step-reference

バージョン
記事リンク
AEM 6.5
ここをクリックしてください
AEM as a Cloud Service
この記事

ワークフローモデルを使用します。 モデルは、一連の手順を定義して実行するのに役立ちます。ワークフローを一時的なものにするか、複数のリソースを使用するかなど、モデルのプロパティを定義することもできます。ビジネスロジックを達成するために、様々な AEM ワークフローステップをモデルに含めることができます

Forms 中心のステップ forms-workflow-steps

Forms 中心のワークフローステップは、AEM ワークフローで AEM Forms 固有の操作を実行します。これらのステップを使用すると、OSGi でアダプティブフォームをベースとした Forms 中心のワークフローを迅速に構築できます。これらのワークフローは、基本的なレビューワークフローおよび承認ワークフローの開発、ファイアウォール内およびファイアウォール間のビジネスプロセスの開発に使用できます。また、フォームのワークフローステップを使用して、次のようなことも行えます。

  • 登録プロセスを管理するためのビジネスプロセス、送信後のワークフローおよびバックエンドワークフローを作成する。

  • タスクを作成し、ユーザーまたはグループに割り当てる。

  • AEM ワークフローで Adobe Sign を使用して署名用のドキュメントを送信する。

  • オンデマンドまたはフォーム送信時にレコードのドキュメントを生成する。

  • ワークフローモデルを様々なデータソースに接続し、データを容易に保存および取得する。

  • メールステップを使用して、アクションの完了時やワークフローの開始時または完了時に、通知メールおよびその他の添付ファイルを送信する。

NOTE
ワークフローモデルが外部ストレージ用にマークされている場合、すべての Forms ワークフローステップで、変数オプションのみを選択して、データファイルと添付ファイルを保存または取得できます。

タスクを割り当てステップ assign-task-step

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

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

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

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

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

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

  • 優先度:選択した優先度が AEM インボックスに表示されます。「高」、「中」、「低」の各オプションを使用できます。デフォルト値は「中」です。

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

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

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

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

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

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

  • タイプ: ワークフローの開始時に入力するドキュメントのタイプを選択します。アダプティブフォーム、読み取り専用のアダプティブフォームまたは非インタラクティブ PDF ドキュメントを選択できます。

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

  • アダプティブフォームのパス:アダプティブフォームのパスを指定します。ワークフローに送信済み、または絶対パスで使用可能なアダプティブフォームを使用できます。または、文字列データ型の変数に保存されたパスからアダプティブフォームを取得できます。

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

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

  • 埋め込み済み:以下のフィールドは、タスクへの入力として使用できます。

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

    • 次を使用して入力添付ファイルを選択:指定した場所にある添付ファイルは、タスクに関連付けられたフォームに添付されます。パスは、ペイロードを基準とした相対パスにすることも、ドキュメントの変数に格納された添付ファイルを取得することもできます。一例として、[Payload_Directory]/attachments/ というパスを指定します。ペイロードを基準にして添付ファイルを指定するか、ドキュメントタイプ(配列リスト/ドキュメント)変数を使用して、アダプティブフォームの入力添付ファイルを指定できます。

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

  • 送信済み情報:以下のフィールドは、タスクの出力先として使用できます。

    • 次を使用して出力データファイルを保存:データファイル(.json、.xml、.doc またはフォームデータモデル(FDM))を保存します。このデータファイルには、関連付けられたフォームを介して送信された情報が含まれます。ペイロードに対する相対パスを使用して出力データファイルを保存するか、ドキュメント、XML または JSON データ型の変数に保存できます。例えば、[Payload_Directory]/Workflow/data のように指定します。ここで、data はファイルです。
    • 次を使用して添付ファイルを保存:タスクに指定されたフォーム添付ファイルを保存します。ペイロードに対する相対パスを使用して添付ファイルを保存するか、ドキュメントデータタイプの配列リストの変数に保存できます。
    • 次を使用してレコードのドキュメントを保存:レコードのドキュメントファイルの保存先のパス。例えば、[Payload_Directory]/DocumentofRecord/credit-card.pdf のように指定します。レコードのドキュメントは、ペイロードに対する相対パスを使用して保存するか、ドキュメントデータ型の変数に格納できます。「ペイロードを基準とする」オプションを選択した場合、パスフィールドを空のままにすると、レコードのドキュメントは生成されません。このオプションは、「タイプ」ドロップダウンリストから「アダプティブフォーム」を選択した場合にのみ使用できます。
  • 割り当て先割り当てオプション:タスクをユーザーに割り当てる方法を指定します。参加者選択スクリプトを使用してタスクを動的にユーザーまたはグループに割り当てることも、タスクを特定の AEM ユーザーまたはグループに割り当てることもできます。

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

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

  • 担当者:このオプションは、「参加者選択」フィールドで「com.adobe.fd.workspace.step.service.VariableParticipantChooser」オプションが選択されている場合に使用できます。このフィールドでは、文字列データタイプの変数を選択することにより担当者を定義できます。

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

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

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

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

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

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

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

    • 担当者がインボックスで明示的に共有することを許可する」オプションが選択されている場合、ユーザーは AEM インボックスでタスクを選択し、別の AEM ユーザーと共有できます。
    • 担当者がインボックスの共有を使用して共有することを許可する option is selected and users share their Inbox items or allows other users to access their Inbox items」オプションを選択し、ユーザーがインボックス項目を共有したり、他のユーザーがインボックス項目にアクセスできるようにした場合、前述のオプションが有効になっているタスクのみが他のユーザーと共有されます。
    • 「担当者が「不在」設定を使用して委任することを許可する」が選択されている場合。担当者は、このタスクを他のユーザーに委任すると共に、その他の「不在」オプションも指定できます。不在タスクに割り当てられた新しいユーザーは、不在設定で指定されたユーザーに自動的に委任(割り当て)されます。

    これにより、不在時に割り当てられたタスクを作業できない場合に、他のユーザーが担当者のタスクを選択できるようになります。

  • アクションデフォルトのアクション:標準提供されている送信、保存およびリセットアクションを使用できます。デフォルトのアクションはすべて、デフォルトで有効になっています。

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

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

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

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

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

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

  • 担当者がタスクに添付ファイルを追加することを許可: タスクの添付ファイルを有効にするには、このオプションを選択します。担当者は、タスクの送信時に AEM インボックス内から添付ファイルを追加できます。添付ファイルの最大サイズ​ (最大ファイルサイズ) ​を制限することもできます。デフォルトサイズは 2 MB です。

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

  • カスタムメタデータを使用: カスタムメタデータフィールドを有効にするには、このオプションを選択します。カスタムメタデータはメールテンプレートで使用されます。

  • カスタムメタデータ: メールテンプレートのカスタムメタデータを選択します。カスタムメタデータは、crx リポジトリの apps/fd/dashboard/scripts/metadataScripts にあります。指定されたパスは crx リポジトリに存在しません。このパスは、使用する前に管理者が作成します。また、カスタムメタデータ用のサービスを使用することもできます。さらに、WorkitemUserMetadataService インターフェイスを拡張してカスタムメタデータを提供することもできます。

  • 前のステップのデータを表示します:以前の担当者、タスクに対して既に実行されたアクション、タスクに追加されたコメントおよび完了したタスクのレコードのドキュメント(使用可能な場合)を担当者が表示できるようにするには、このオプションを選択します。

  • 以降のステップのデータを表示します: 後続の担当者が実行したアクションと追加したコメントを現在の担当者が表示できるようにするには、このオプションを選択します。また、このオプションを選択すると、完了したタスクのレコードのドキュメント(使用可能な場合)を現在の担当者が表示できるようになります。

  • データタイプの表示:デフォルトで、担当者は、レコードのドキュメント、担当者、実行されたアクションに加え、前の担当者および後続の担当者が追加したコメントを表示することができます。「データタイプの表示」オプションを使用すると、担当者に表示されるデータタイプが制限されます。

NOTE
外部データストレージを使用するように AEM ワークフローモデルを設定する場合、「タスクを割り当て」ステップをドラフトとして保存するオプションと、「タスクを割り当て」ステップの履歴を取得するオプションは無効です。また、インボックスでは、保存するオプションは無効になっています。

PDF/A に変換ステップ convert-pdfa

PDF/A は、フォントを埋め込み、ファイルを解凍することで、ドキュメントのコンテンツを長期保存するためのアーカイブ形式です。その結果、通常、PDF/A ドキュメントは標準の PDF ドキュメントよりも大きくなります。AEM ワークフローの PDF/A に変換 ​ステップを使用して、PDF ドキュメントを PDF/A 形式に変換できます。

PDF/A に変換ステップには、次のプロパティがあります。

入力ドキュメント:入力ドキュメントは、ペイロードに対して相対的であり、絶対パスを持ち、ペイロードとして提供するか、ドキュメントデータタイプの変数に格納することができます。

変換オプション:このプロパティを使用して、PDF ドキュメントを PDF/A ドキュメントに変換するための設定を指定します。 このタブで使用できる様々なオプションを次に示します。

  • 互換性:出力 PDF/A ドキュメントが準拠しなければならない標準を指定します。PDF/A-1b、PDF/A-2b、PDF/A-3b など、様々な PDF 規格をサポートします。
  • 結果レベル:変換出力の結果レベルを PassFail、Summary または Detailed と指定します。
  • カラースペース:事前に定義されたカラースペースを、出力 PDF/A ファイルに使用できる S_RGB、COATED_FOGRA27、JAPAN_COLOR_COATED または SWOP と指定します。
  • オプションコンテンツ:指定した基準のセットを満たした場合にのみ、特定のグラフィックオブジェクトや注釈を出力 PDF/A ドキュメントに表示できるようにします。

出力ドキュメント:出力ファイルを保存する場所を指定します。出力ファイルは、ペイロードに関連する場所に保存でき、ペイロードがファイルの場合はペイロードを上書きするか、ドキュメントデータタイプの変数に保存できます。

「メールを送信」ステップ send-email-step

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

メールステップは、Day CQ Mail Service を使用してメールを送信します。メールステップを使用する前に、メールサービスが設定されていることを確認してください。メールは、デフォルトで HTTP および HTTPs プロトコルのみをサポートします。サポートチームに問い合わせて、メールの送信用のポートと、環境用の SMTP プロトコルを有効にします。この制限は、プラットフォームのセキュリティの向上に役立ちます。

メールステップには、次のプロパティがあります。

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

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

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

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

HTML メールテンプレート:メールの HTML テンプレート。変数はメールテンプレートで指定できます。メールステップは、入力のため、テンプレートに含まれるすべての変数を抽出して表示します。

メールテンプレートメタデータ:メールテンプレート変数の値は、ユーザー指定の値にすることも、オーサーサーバーまたはパブリッシュサーバー上のアセットのパスや、画像、ワークフローメタデータプロパティにすることもできます。

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

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

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

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

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

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

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

レコードのドキュメントを生成ステップ generate-document-of-record-step

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

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

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

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

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

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

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

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

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

DDX を呼び出しステップ invokeddx

Document Description XML(DDX) は、その要素がドキュメントの構築ブロックを表す宣言型のマークアップ言語です。この構築ブロックには、PDF ドキュメント、XDP ドキュメントおよびその他の要素(コメント、しおり、スタイルを設定したテキストなど)が含まれます。DDX は、1 つ以上の入力ドキュメントに適用して、1 つ以上の出力ドキュメントを生成することができる一連の操作を定義します。1 つの DDX を様々なソースドキュメントに使用できます。AEM ワークフローでは様々な操作(ドキュメントのアセンブリと分割、Acrobat と XFA Forms の作成と変更およびその他 DDX リファレンスドキュメント ​で説明される操作)を実行するために、DDX を呼び出しステップを使用することができます。

DDX を呼び出しステップには次のプロパティがあります。

入力ドキュメント:入力ドキュメントのプロパティを設定するために使用します。このタブで使用できる様々なオプションを次に示します。

  • 次を使用して DDX を指定:ペイロードに関連する入力ドキュメントを指定し、絶対パスを持ち、ペイロードとして提供するか、ドキュメントデータタイプの変数に格納できます。
  • ペイロードからマップを作成:ペイロードフォルダーの下のすべてのドキュメントを Assembler で API を呼び出すのための入力ドキュメントマップに追加します。各ドキュメントのノード名は、マップのキーとして使用されます。
  • 入力ドキュメントのマップ:オプションは、「追加」ボタンで複数のエントリを追加するために使用します。各エントリは、マップ内のドキュメントのキーとドキュメントのソースを表します。

環境オプション:このオプションは、呼び出し API の処理設定を設定するために使用します。 このタブで使用できる様々なオプションを次に示します。

  • 検証のみ:入力DDXの有効性をチェックします。
  • エラー時に失敗:エラーの場合に呼び出し API サービスが失敗するかどうか、エラーがあるかどうかを示すブーリアン値。デフォルトでは、この値は False に設定されています。
  • 最初のベイツ番号:自己増分する数を指定します。 この自己増分値は、連続する各ページに自動的に表示されます。
  • デフォルトのスタイル:出力ファイルのデフォルトのスタイルを設定します。
NOTE
環境オプションは、HTTP API との同期が維持されます。

出力ドキュメント:出力ファイルを保存する場所を指定します。 このタブで使用できる様々なオプションを次に示します。

  • ペイロードでの出力ドキュメント保存:ペイロードフォルダーの下で出力ドキュメントを保存したり、ペイロードがファイルの場合はペイロードを上書きしたりします。
  • 出力ドキュメントのマップ:ドキュメントごとに 1 つのエントリを追加して、各ドキュメントファイルを保存する場所を明示的に指定します。各エントリは、ドキュメントと、その保存場所を表します。 出力ドキュメントが複数ある場合は、このオプションが使用されます。

フォームデータモデル(FDM)サービスの呼び出しステップ invoke-form-data-model-service-step

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

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

CustomerDetails テーブルの例

プロパティ
FirstName
Sarah
LastName
Rose
顧客 ID
1
メールアドレス
srose@we.info

サンプル 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"
    }
   }
  }

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

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

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

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

  • エラーと検証:このオプションを使用すると、エラーメッセージを取得し、データソースに取得して送信するデータの検証オプションを指定できます。これらの変更により、フォームデータモデル(FDM)サービスを呼び出しステップに渡されたデータが、データソースで定義されているデータ制約に従っていることを確認できます。詳しくは、入力データの自動検証を参照してください

  • 検証レベル:検証には、基本、完全、オフの 3 つのカテゴリがあります。

    • 完全:すべての制約が検証されます。
    • 基本:必須および NULL 許容の制約のみ
    • オフ:検証は行われません。
  • 失敗時にワークフローを終了:制約の検証に失敗すると、ワークフローは停止します。

  • エラーコードを変数内に格納:エラーコードは、文字列型の変数に格納できます。

  • エラーメッセージを変数内に格納:エラーメッセージは、文字列型の変数に格納できます。

  • エラーの詳細を変数内に格納:エラーの詳細は、JSON 型の変数に格納できます

  • サービス:選択したフォームデータモデル(FDM)が提供するサービスのリストです。

  • サービスの入力リテラル、変数またはワークフローメタデータおよび 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 またはフォームデータモデル(FDM)型の変数を使用して入力 JSON ドキュメントを選択できます。

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

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

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

  • サービスの出力マップして出力値を変数またはメタデータに書き込む: CRX リポジトリ内のワークフローインスタンスのメタデータノードのプロパティとして出力値を保存するには、このオプションを選択します。メタデータプロパティの名前を指定し、メタデータプロパティにマップされる対応するサービス出力属性を選択します。例えば、出力サービスが返す phone_number をワークフローメタデータの phone_number プロパティでマッピングします。同様に、出力は Long データ型の変数に格納できます。「マッピングする必要があるサービス出力属性」オプションのプロパティを選択すると、選択したプロパティのデータを保存できる変数のみが、「出力を次に保存」オプションに設定されます。

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

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

ドキュメントに署名ステップ sign-document-step

ドキュメントに署名ステップでは、Adobe Sign を使用してドキュメントに署名できます。Adobe Sign ワークフローステップを使用してアダプティブフォームに署名する場合、ワークフローステップの設定に応じて、フォームを順番に署名者に渡すか、すべての署名者に同時送信することができます。Adobe Sign が有効なアダプティブフォームは、すべての署名者が署名プロセスを完了した後にのみ、Experience Manager Forms サーバーに送信されます。

デフォルトでは、Adobe Sign スケジューラーサービスは、24 時間ごとに署名者の応答を確認(ポーリング)します。現在の環境に合わせて、このデフォルト値を変更することができます。

ドキュメントへの署名手順には、次のプロパティがあります。

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

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

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

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

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

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

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

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

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

  • 署名者を選択:ドキュメントの署名者を選択する方法を指定します。ワークフローを動的にユーザーまたはグループに割り当てることも、手動で署名者の詳細を追加することもできます。ドロップダウンで「手動」を選択すると、受信者の詳細(メール、役割、認証方法など)が追加されます。

    note note
    NOTE
    • 「役割」セクションで、受信者の役割として「署名者」、「承認者」、「同意者」、「認証済み受信者」、「フォーム入力者」および「委任者」を指定できます。
    • 「役割」オプションで「委任者」を選択した場合、委任者は署名タスクを別の受信者に割り当てることができます。
    • 次の認証方法を設定済みの場合: Adobe Sign設定に基づいて、電話による認証、ソーシャル ID に基づく認証、ナレッジベースの認証、政府機関の ID に基づく認証などの認証方法を選択します。
  • 署名者を選択するスクリプトまたはサービス:このオプションを使用できるのは、「署名者を選択」フィールドで「動的」オプションが選択されている場合のみです。ECMAScript またはサービスを指定して、ドキュメントの署名者と検証オプションを選択することができます。

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

  • 署名済みドキュメント:署名済みドキュメントのステータスを変数に保存できます。 電子署名監査証跡を追加して、よりセキュリティと合法性を確保するには、監査レポートを含めます。 変数フォルダーまたはペイロードフォルダーを使用して、署名済みドキュメントを保存できます。

    note note
    NOTE
    監査レポートは、署名済みドキュメントの最後のページに追加されます。

印刷出力ステップを生成 generatePrintedOutput

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

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

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

Input プロパティ

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

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

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

    • カラー PCL:PCL 用の XDC ファイルを指定するには、このオプションを使用します。
    • Generic PostScript:PostScript の汎用 XDC ファイルを指定するには、このオプションを使用します。
    • ZPL 300 DPI:ZPL 300 DPI を使用します。 zpl300.xdc が使用されます。
    • ZPL 600 DPI:ZPL 600 DPI を使用します。 zpl600.xdc ファイルが使用されます。
    • IPL 300 DPI:IPL 300 DPI を使用します。 ipl300.xdc が使用されます。
    • IPL 400 DPI:IPL 400 DPI を使用します。 ipl400.xdc ファイルが使用されます。
    • TPCL 600 DPI:TPCL 600 DPI を使用します。 tpcl600.xdc ファイルが使用されます。
    • PostScript Plain:PostScript のプレーンテキスト XDC ファイルを指定するには、このオプションを使用します。
    • DPL300DPI:DPL 300 DPI を使用します。 dpl300.xdc が使用されます。
    • DPL400DPI:DPL 400 DPI を使用します。 dpl400.xdc が使用されます。
    • DPL600DPI:DPL 600 DPI を使用します。 dpl600.xdc が使用されます。
    • HP_PCL_5e:複数の Canon デバイスをサポートするには、このオプションを使用します。

出力プロパティ

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

詳細プロパティ

  • 次を使用してコンテンツルートの場所を選択:コンテンツルートは、フォームデザインで使用される相対アセットを取得するための、リポジトリ内の URI、絶対参照、または場所を指定する文字列値です。 例えば、フォームデザインが ../myImage.gif のように画像を相対的に参照する場合、myImage.gifrepository:// に配置する必要があります。デフォルト値は 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 ファイルは、ペイロードに対する相対パス、絶対パス、またはドキュメントデータタイプの変数を使用して保持できます。

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

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

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

  • Copies:出力の作成部数を指定する整数値。デフォルト値は 1 です。

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

    • Duplex Long Edge:両面印刷を使用し、長辺のページネーションを使用して印刷します。
    • Duplex Short Edge:両面印刷を使用し、短辺のページネーションを使用して印刷します。
    • Simplex:片面印刷を使用します。

非インタラクティブ PDF 出力手順の生成 generatePDFdocuments

  1. サイドキックの「Forms Workflow」タブの下にある、「非インタラクティブ PDF 出力を生成」ワークフローをドラッグします。
  2. 追加したワークフローステップをダブルクリックして、コンポーネントを編集します。
  3. 編集コンポーネントダイアログでは、入力ドキュメント、出力ドキュメントおよびその他のパラメーターを設定して、OK をクリックします。

入力ドキュメント input-documents-3

  • テンプレートファイル:XDP テンプレートの場所を指定します。このフィールドは必須です。

  • データドキュメント:テンプレートとマージする必要があるデータ xml の場所を指定します。

出力ドキュメント output-document

出力ドキュメント:生成された PDF フォームの名前を指定します。

追加のパラメーター additional-parameters-1

  • コンテンツルート:入力 XDP テンプレートで使用されるフラグメントまたは画像が保存されるリポジトリ内のフォルダーのパスを指定します。
  • ロケール:生成された PDF フォームのデフォルトのロケールを指定します。
  • Acrobat のバージョン:生成された PDF フォームのターゲットの Acrobat バージョンを指定します。
  • **** Linearized PDF:Web表示のために生成されたPDFフォームを最適化するかどうかを指定します。
  • タグ付き PDF:生成された PDF をアクセシビリティ対応にするかどうかを指定します。
  • XCI ドキュメント:XCI ファイルへのパスを指定します。

関連トピック see-also

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab