次の方法で共有

Adobe Experience Manager (プレビュー)

  • リファレンス

Adobe Experience Manager 統合により、Adobe Experience Manager フォーム関連サービス (通信など) にアクセスすることができます。 この統合により、Adobe Experience Manager Forms を通してフォームが送信されたときにフローをトリガーすることもできます。

このコネクタは、次の製品および地域で利用可能です:

Service クラス 地域
Logic Apps 標準 以下を除くすべての Logic Apps 地域 :
     -   Azure 政府の地域
     -   Azure 中国の地域
     -   国防総省 (DoD)
Power Automate プレミアム 以下を除くすべての Power Automate 地域 :
     -   米国政府 (GCC)
     -   米国政府 (GCC High)
     -   21Vianet が運用する中国のクラウド
     -   国防総省 (DoD)
Power Apps プレミアム 以下を除くすべての Power Apps 地域 :
     -   米国政府 (GCC)
     -   米国政府 (GCC High)
     -   21 Vianet が運用する中国のクラウド
     -   米国国防総省 (DoD)
お問い合わせ先
件名 Adobe Experience Manager Forms
[URL] https://www.adobe.com/go/adobe-experience-manager-forms-community
メール aem-pa@adobe.com
Connector Metadata
発行者 Adobe
Web サイト https://business.adobe.com/products/experience-manager/forms/aem-forms.html
プライバシー ポリシー https://www.adobe.com/in/privacy/policy.html
カテゴリー 生産性; ビジネス管理

Adobe Experience Manager コネクタを使用して Adobe Experience Manager フォーム - 通信機能 にアクセスし、フォーム デザインと XML フォーム データに基づく PDF ドキュメントを作成したり、PostScript (PS)、プリンター コマンド言語 (PCL)、ゼブラ印刷言語 (ZPL)、およびその他のプリンター定義言語ドキュメントを作成したりできます。

前提条件

コネクタを使用するには、 Adobe Experience Manager Forms as a Cloud Service - Communication API へのライセンスとアクセスが必要です。

資格情報の入手方法

次のいくつかの手順で、Adobe Experience Manager を簡単に開始できます:

サービス資格情報を生成する

Adobe Experience Manager Developer Console を使用して、サービス資格情報を 生成 します。

接続をセットアップする

Adobe Experience Manager コネクタにサービス資格情報を追加します。 サービス資格情報 JSON から資格情報を取得し、これらの資格情報の詳細を 1 回限りの接続設定にコピーできます。

  • 組織 ID
  • Client ID
  • Client Secret
  • テクニカル アカウント ID
  • メタ スコープ
  • 秘密キー
  • AdobeIMS ホスト URL

AEM サーバーの場合は、 Adobe Experience Manager Cloud Service Author または Publish インスタンスの URL を指定します。 例: https://publish-pXXXX-eXXXXX.adobeaemcloud.com

コネクタの使用を開始する

コネクタは次の操作をサポートします。

テンプレートとメタ データから PDF ドキュメントを生成する

フォームデザインと XML フォームデータに基づいた PDF ドキュメントを作成できます。 ビジネス文書、明細書、請求処理レター、福利厚生通知、毎月の請求書、ウェルカム キットなど、ブランドが承認し、パーソナライズされ、標準化されたドキュメントを作成するのに役立ちます。

基本的なワークフローは、XML フォーム データとフォーム デザインを結合して PDF ドキュメントを作成することです。 Adobe Experience Manager フォーム デザイナー でテンプレートを作成できます。

操作の出力は、非インタラクティブな PDF ドキュメントです。 つまり、ユーザーはフォーム データを入力または変更できません。 次のパラメーターを指定して、操作のさまざまなオプションを構成できます。

パラメーター 必須 (必要) Description
Template イエス テンプレートは、PDF ドキュメントの外観と動作を定義します。 API は、XDP および PDF ドキュメントの形式のテンプレートをサポートしています。 完全修飾パス、 Adobe Experience Manager リポジトリの参照パス、またはバイナリ ファイルを指定できます。
日付 イエス テンプレートとマージされるデータを含む XML ファイル。 完全修飾された HTTP の場所またはバイナリ ファイルを指定できます。
XCI 構成 番号 このサービスは、XCI 構成ファイルを使用して、PDF ドキュメントのさまざまなプロパティを構成します。 XCI パラメータは、テンプレートのタイプが XDP または XDP ベースの PDF ドキュメントである場合にのみ効果があります。 完全修飾パス、 Adobe Experience Manager リポジトリの参照パス、またはバイナリ ファイルを指定できます。
Locale 番号 PDF をレンダリングするロケール。
コンテンツ ルート 番号 テンプレート リソース (画像、フラグメントなど) の場所。 このパスは、テンプレートの場所に対する相対パスです。
PDF にタグを追加する 番号 タグ付きの PDF を作成するために指定し、スクリーン リーダーやその他の支援技術を使用するユーザー向けに PDF を最適化します。
PDF への埋め込みフォント 番号 フォントを埋め込むと、埋め込まれたフォントはすべてのデバイスで同じように見えますが、より大きな出力ファイルが生成されます。
PDF の線形化 (高速 Web ビュー) 番号 高速 Web ビュー用に PDF を最適化することを選択する
状態を保持する 番号 インタラクティブ PDF ドキュメントには、フォームを構成するさまざまな要素が含まれています。 これらの要素には、フィールド (データを受け入れまたは表示するため)、ボタン (イベントをトリガーするため)、およびスクリプト (特定のアクションを実行するためのコマンド) が含まれる場合があります。 ボタンをクリックすると、フィールドの状態を変更するイベントがトリガーされる場合があります。 たとえば、性別オプションを選択すると、フィールドの色やフォームの外観が変わる場合があります。 これは、フォームの状態を変更する手動イベントの例です。 このようなインタラクティブな PDF ドキュメントが Adobe Experience Manager Forms Communication 機能を使用してフラット化されると、フォームの状態は保持されません。 フォームがフラット化された後でもフォームの状態が確実に保持されるようにするには、ブール値 Retain state を True に設定して、フォームの状態を保存および保持します。
未署名の署名フィールドを保持する 番号 PDF ファイルをフラット化するときに、署名済みおよび未署名の署名フィールドを保持するかどうかを指定します
Adobe Acrobat Reader のバージョン 番号 PDF ドキュメントを開くために必要な Acrobat Reader の最小バージョンを指定します。 既定のバージョンは Adobe Acrobat 11 です。

PostScript (PS)、プリンター コマンド言語 (PCL)、ゼブラ印刷言語 (ZPL)、DPL (Datamax プログラミング言語)、IPL (Intermec プリンター言語)、または TPCL (TEC プリンター コマンド言語) ドキュメントをテンプレートまたはデータから生成し、XML データをマージします

PostScript (PS)、プリンター コマンド言語 (PCL)、ゼブラ印刷言語 (ZPL)、DPL (Datamax プログラミング言語)、IPL (Intermec プリンター言語)、または TPCL (TEC プリンター コマンド言語) ドキュメントを XDP フォーム デザインまたは PDF ドキュメントから作成するためにドキュメント生成 API を使用できます。 これらの API は、フォーム デザインをフォーム データとマージしてドキュメントを生成するのに役立ちます。 ドキュメントをファイルに保存し、 Power Automate を使用してプリンタに送信できます。 次のパラメーターを指定して、操作のさまざまなオプションを構成できます。

パラメーター 必須 (必要) Description
Template イエス テンプレートは、PDF ドキュメントの外観と動作を定義します。 API は、XDP および PDF ドキュメントの形式のテンプレートをサポートしています。 完全修飾パス、 Adobe Experience Manager リポジトリの参照パス、またはバイナリ ファイルを指定できます。
日付 イエス テンプレートとマージされるデータを含む XML ファイル。 完全修飾された HTTP の場所またはバイナリ ファイルを指定できます。
プリンター プロファイル イエス 使用する XDC ファイルを指定します。 XDC ファイルは、XML 形式のプリンター記述ファイルです。 Adobe Experience Manager Forms Communications 機能は、XDC ファイルを使用して、ドキュメントを PostScript、PCL、DPL、TPCL、ZPL などの形式に出力します。 XDC ファイルは、部数、両面プリンターを使用するかどうか、ステイプラ オプションなどの印刷オプションを指定するためにも使用されます。
出力の種類 イエス 操作の出力ファイルのタイプを指定します。 サポートされているオプションは、PostScript (PS)、プリンター コマンド言語 (PCL)、ゼブラ印刷言語 (ZPL)、DPL (Datamax プログラミング言語)、IPL (Intermec プリンター言語)、または TPCL (TEC プリンター コマンド言語) ドキュメントです。
XCI 構成 番号 使用する XCI ファイルを指定します。 XCI ファイルは、フォームのデザイン要素に使用されるフォントを記述するために使用されます。 完全修飾パス、 Adobe Experience Manager リポジトリの参照パス、またはバイナリ ファイルを指定できます。
Locale 番号 出力をレンダリングするロケール。
コンテンツ ルート 番号 テンプレート リソース (画像、フラグメントなど) の場所。このパスは、テンプレートの場所からの相対パスです。
コピーの数 番号 生成する出力ファイルのコピー数を指定します。
ページ区切り 番号 両面印刷か片面印刷かを指定します。 PostScript および PCL をサポートするプリンターは、この値を使用します。

一般的なエラーと解決策

エラー コード Description 解決策
403 禁止。 API 実行するためには forms-users グループのメンバーである必要があります。 技術アカウントを forms-users グループのメンバーにして、ユーザー (技術アカウント) とグループ (forms-users) の両方を公開します。
400 指定したテンプレートは無効です。 有効なテンプレートを指定して再試行します。 template パラメータの値が URL ではなくプレーン テキストの場合、データ xml 文字列をバイナリに変換します。 Microsoft Power Automate の binary() 式 を使用して変換を行うことができます。 JCR パスを使用する場合は、パスに crx:// プレフィックスを追加します。
400 指定されたデータは無効です。 有効なデータ ファイルで再試行します。 data パラメータの値が URL ではなくプレーン テキストの場合、データ xml 文字列をバイナリに変換します。 Microsoft Power Automate の binary() 式 を使用して変換を行うことができます。
400 指定された XCI 構成には、無効な値が含まれています。 構成ファイルを修正して、再試行します。 XCI configuration パラメータの値が URL ではなくプレーン テキストの場合、データ xml 文字列をバイナリに変換します。 Microsoft Power Automate の binary() 式 を使用して変換を行うことができます

接続を作成する

このコネクタは、次の認証タイプをサポートしています:
既定 接続を作成するためのパラメーター。 すべての地域 共有不可

既定

適用できるもの: すべての領域

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

件名 タイプ Description Required
AEM サーバー string AEM 作成者または公開インスタンスの URL を指定します。 True
組織 ID (org) string 組織 ID を指定します。 True
クライアント ID (clientId) string サービスの資格情報からクライアント ID を指定します。 True
クライアント シークレット (clientSecret) securestring サービスの資格情報からクライアント シークレットを指定します。 True
テクニカル アカウント ID (id) string AEM テクニカル アカウントの ID を指定します。 True
メタ スコープ (metascopes) string サービスの資格情報からメタ スコープを指定します。 True
秘密キー (privateKey) securestring 秘密キーを入力します。 サービスの資格情報に含まれています。 True
Adobe IMS ホスト URL (imsEndpoint) string Adobe Identity Management サービスのホスト URL を指定します。 True

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 100 60 秒

アクション

テンプレートとデータから PDF を生成する (プレビュー)

PDF または XDP テンプレートから PDF ドキュメントを生成し、XML データをマージします。
テンプレートとデータから PS、PCL、ZPL、DPL、IPL、または TPCL ファイルを生成する (プレビュー)

PostScript (PS)、プリンター コマンド言語 (PCL)、ゼブラ印刷言語 (ZPL)、DPL (Datamax プログラミング言語)、IPL (Intermec プリンター言語)、または TPCL (TEC プリンター コマンド言語) ドキュメントを XDP ファイルまたは PDF ドキュメントから生成し、XML データをマージします。

テンプレートとデータから PDF を生成する (プレビュー)

操作 ID:
GeneratePDFOutput

PDF または XDP テンプレートから PDF ドキュメントを生成し、XML データをマージします。

パラメーター

名前 キー 必須 型 説明
Template
 template True binary

XDP または PDF テンプレートのバイナリ ファイルまたは場所を指定します。
日付
 data True binary

テンプレートとマージする XML データのバイナリ ファイルまたは場所を指定します。
XCI 構成
 xci binary

XCI 構成ファイルのバイナリ ファイルまたは場所を指定します。
Locale
 locale string

PDF ドキュメントのロケールを選択します。
コンテンツ ルート
 contentRoot string

テンプレートで使用される資産を取得するための URI、絶対参照、または場所を指定します。
PDF にタグを追加する
 isTagged boolean

タグ付きの PDF を作成し、スクリーン リーダーやその他の支援技術を使用するユーザー向けに PDF を最適化します。
PDF への埋め込みフォント
 embedFonts boolean

デバイスおよび画面を超えて一貫した外観のための PDF への埋め込みフォント
PDF の線形化 (高速 Web ビュー)
 linearizedPDF boolean

高速 Web ビュー用に PDF を最適化することを選択する
状態を保持する
 retainFormState boolean

フラット化した後にドキュメントの状態を保持することを選択します。
未署名の署名フィールドを保持する
 retainUnsignedSignatureFields boolean

未署名の署名フィールドを保持するか削除するかを選択する
Adobe Acrobat Reader のバージョン
 acrobatVersion string

PDF ドキュメントを開くために必要な Acrobat Reader の最小バージョンを選択します。

戻り値

返答
PDFResult

テンプレートとデータから PS、PCL、ZPL、DPL、IPL、または TPCL ファイルを生成する (プレビュー)

操作 ID:
GeneratePrintedOutput

PostScript (PS)、プリンター コマンド言語 (PCL)、ゼブラ印刷言語 (ZPL)、DPL (Datamax プログラミング言語)、IPL (Intermec プリンター言語)、または TPCL (TEC プリンター コマンド言語) ドキュメントを XDP ファイルまたは PDF ドキュメントから生成し、XML データをマージします。

パラメーター

名前 キー 必須 型 説明
Template
 template True binary

XDP または PDF テンプレートのバイナリ ファイルまたは場所を指定します。
日付
 data True binary

テンプレートとマージする XML データのバイナリ ファイルまたは場所を指定します。
XCI 構成
 xci binary

XCI 構成ファイルのバイナリ ファイルまたは場所を指定します。
Locale
 locale string

出力ファイルのロケールを選択します。
コンテンツ ルート
 contentRoot string

テンプレートで使用される資産を取得するための URI、絶対参照、または場所を指定します。
コピーの数
 copies integer

作成するコピーの数を指定します。
ページ区切り
 paginationOverride string

ページの片面または両面に印刷するオプションを設定します。
プリンター プロファイル
 xdcUri True string

プリンターの機能や用紙の種類など、プリンターの機能を記述した XDC ファイルを選択します。
出力の種類
 renderType True string

利用可能な出力の種類から選択します。

戻り値

返答
PrintedResult

定義

PDFResult

PDFOutput
binary

PrintedResult

PrintedOutput
binary