[AEM Forms]{class="badge positive" title="AEM Formsに適用)。"}

AEM Forms API を使用した AFP 出力の生成

これはプレリリース機能で、プレリリースチャネルを通してアクセスできます。

Advanced Function Presentation (AFP)は、主に印刷目的で設計された高性能なドキュメント形式です。
このガイドでは、AEM Formsを使用してAFP出力を生成するために必要なすべての手順と設定について説明します。

AFP生成API

XDP テンプレートと入力データを使用して、AFP (Advanced Function Presentation)ファイルを生成します。

認証

ローカル環境には​BasicAuth (管理者資格情報)を使用するか、AEM Cloud インスタンスには​ OAuth サーバー間 ​認証を使用できます。

リクエスト

エンドポイント:
https://[publish-url].adobeaemcloud.com/adobe/forms/doc/v1/adobe/forms/doc/v1/generate/afp

ヘッダー

キー
Content-Type
application/pdf
Authorization
(Bearer Access token)

リクエスト本文

Content-Type: multipart/form-data

キー
必須
説明
template
ファイル/テキスト
はい
AFP生成用のテンプレートとして使用されるXDP ファイル (例:demo.xdp
data
ファイル/テキスト
いいえ
テンプレートと結合するデータファイル (XMLまたはJSON) (例:data.xml
options
テキスト
いいえ
AFP出力(解像度、ロケールなど)を制御するためのオプションを含むJSON文字列

options JSON (テキストフィールド):

{
  "pdfVersion": "1.7",
  "resolution": 300,
  "locale": "en-US",
  "embedFonts": true,
  "contentRoot": "/usr/tmp"
}

応答

コード
説明
200
操作が成功しました。 AFP ドキュメントストリームを返します。
400
不正なリクエスト。 リクエストペイロードの形式が正しくないか、必須フィールドが見つかりません。
500
内部サーバーエラー。 しばらくしてからもう一度お試しください。

Curl コマンド

curl --location 'http://<server>:<port>/adobe/forms/document/generate/afp' \
--header 'Authorization: Bearertoken <base64-encoded-credentials>' \
--form 'template=@"<path-to-template>.xdp"' \
--form 'data=@"<path-to-data-file>.xml"' \
--form 'options=<JSON-options-string>'

APIのテスト

.yaml ファイルをダウンロードしてPostmanにアップロードし、APIの機能を確認できます。

AFP Postman image

応答を保存し、保存したファイルをAFP リーダーで開いて表示できます。

IC ドキュメントを検索

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