ドキュメント AEM AEM チュートリアル AEM Forms のチュートリアル

Assembler サービスを使用した XDP ステッチ

Last update: Thu Oct 10 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：
アセンブラー

作成対象：

経験者
開発者

この記事では、Assembler サービスを使用して XDP ドキュメントをステッチする機能を示すアセットを提供します。
address.xdp という XDP ドキュメントから address というサブフォームを master.xdp ドキュメントの address という挿入ポイントに挿入するために、以下の JSP コードを作成しました。結果の XDP は、AEM インストール環境のルートフォルダーに保存されました。

Assembler サービスは、PDF ドキュメントの操作を記述する有効な DDX ドキュメントに準拠しています。こちらの DDX のリファレンスドキュメントを参照してください。40 ページに XDP ステッチに関する情報があります。

    javax.servlet.http.Part ddxFile = request.getPart("xdpstitching.ddx");
    System.out.println("Got DDX");
    java.io.InputStream ddxIS = ddxFile.getInputStream();
    com.adobe.aemfd.docmanager.Document ddxDocument = new com.adobe.aemfd.docmanager.Document(ddxIS);
    javax.servlet.http.Part masterXdpPart = request.getPart("masterxdp.xdp");
    System.out.println("Got master xdp");
    java.io.InputStream masterXdpPartIS = masterXdpPart.getInputStream();
    com.adobe.aemfd.docmanager.Document masterXdpDocument = new com.adobe.aemfd.docmanager.Document(masterXdpPartIS);

    javax.servlet.http.Part fragmentXDPPart = request.getPart("fragment.xdp");
    System.out.println("Got fragment.xdp");
    java.io.InputStream fragmentXDPPartIS = fragmentXDPPart.getInputStream();
    com.adobe.aemfd.docmanager.Document fragmentXdpDocument = new com.adobe.aemfd.docmanager.Document(fragmentXDPPartIS);

    java.util.Map < String, Object > mapOfDocuments = new java.util.HashMap < String, Object > ();
    mapOfDocuments.put("master.xdp", masterXdpDocument);
    mapOfDocuments.put("address.xdp", fragmentXdpDocument);
    com.adobe.fd.assembler.service.AssemblerService assemblerService = sling.getService(com.adobe.fd.assembler.service.AssemblerService.class);
    if (assemblerService != null)
      System.out.println("Got assembler service");

    com.adobe.fd.assembler.client.AssemblerOptionSpec aoSpec = new com.adobe.fd.assembler.client.AssemblerOptionSpec();
    aoSpec.setFailOnError(true);

    com.adobe.fd.assembler.client.AssemblerResult assemblerResult = assemblerService.invoke(ddxDocument, mapOfDocuments, aoSpec);
    com.adobe.aemfd.docmanager.Document finalXDP = assemblerResult.getDocuments().get("stitched.xdp");
    finalXDP.copyToFile(new java.io.File("stitched.xdp"));

フラグメントを別の XDP に挿入する DDX ファイルを以下に示します。DDX は address.xdp のサブフォーム address を master.xdp の address という挿入ポイントに挿入します。stitched.xdp という名前のドキュメントが結果として生成され、ファイルシステムに保存されます。

<?xml version="1.0" encoding="UTF-8"?>
<DDX xmlns="http://ns.adobe.com/DDX/1.0/">
        <XDP result="stitched.xdp">
           <XDP source="master.xdp">
            <XDPContent insertionPoint="address" source="address.xdp" fragment="address"/>
         </XDP>
        </XDP>
</DDX>

この機能を AEM Server で動作させるには

XDP Stitching パッケージをローカルシステムにダウンロードします。
パッケージマネージャを使用して、このパッケージをアップロードしインストールします。
この zip ファイルの内容を展開すると、サンプル XDP ファイルと DDX ファイルが得られます。

パッケージのインストール後、Adobe Granite CSRF Filter で次の URL を許可リストに加える必要があります。

上記のパスを許可リストに加えるには、下記の手順に従ってください。
configMgr にログインします。
Adobe Granite CSRF フィルターを検索します。
「除外済み」セクションに次のパスを追加し、/content/AemFormsSamples/assemblerservice を保存します。
「Sling Referrer Filter」を検索します。
「Allow Empty」チェックボックスをオンにします（この設定はテスト目的でのみ使用してください）。
サンプルコードをテストする方法は多数あります。 Postman アプリを使用するのが最もすばやく簡単です。Postman を使用すると、サーバーに POST リクエストを送信できます。システムに Postman アプリをインストールします。
アプリを起動し次の URL を入力して、データ書き出し API をテストします。
http://localhost:4502/content/AemFormsSamples/assemblerservice.html

スクリーンショットに示したとおりに、入力パラメーターを指定します。前にダウンロードしたサンプルドキュメントを使用できます。
xdp-stitch-postman

NOTE

AEM Forms のインストールが完了していることを確認します。すべてのバンドルがアクティブ状態である必要があります。

recommendation-more-help

8de24117-1378-413c-a581-01e660b7163e