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 を生成する (プレビュー)
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 ファイルを生成する (プレビュー)
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 |
利用可能な出力の種類から選択します。 |
戻り値
定義
PDFResult
- PDFOutput
- binary
PrintedResult
- PrintedOutput
- binary