[統合]{class="badge positive"}

Adobe Sign ヘルパーメソッドの使用

[AEM Forms 6.5]{class="badge informative"}

特定のユースケースでは、AEM ワークフローを使用せずに署名用のドキュメントを送信することが必要になる場合があります。このような場合、この記事の説明に従って、サンプルバンドルで公開されているラッパーメソッドを使用すると非常に便利です。

サンプル OSGi バンドルのデプロイ

AEM OSGi web コンソール経由で OSGi バンドルをデプロイします。AEM OSGi web コンソールの設定マネージャーから、以下に示すように OSGi 設定を使用して API 統合キーと API ユーザーを指定します。

AdobeSignHelperMethods OSGi バンドルは Adobe Experience Manager（AEM）製品コードとして認識されないので、アドビサポートではサポートされません。

API に関するドキュメント

次は、OSGi バンドルで提供される AcrobatSignHelperMethods OSGi サービスを通じて使用できます。

getTransientDocumentID

String getTransientDocumentID(Document documentForSigning) throws IOException

契約書または web フォームの作成に使用されるドキュメントです。ドキュメントは、まず送信者によって Acrobat Sign にアップロードされます。これは、アップロード後 7 日間のみ使用できるので、一時的なドキュメント ​と呼ばれます。このメソッドは、com.adobe.aemfd.docmanager.Document を受け入れ、一時的なドキュメント ID を返します。

getAgreementID

String getAgreementId(String transientDocumentID, String email) throws ClientProtocolException, IOException

署名用の一時的なドキュメント ID を使用して、メールパラメーターで識別されるユーザーに署名用のドキュメントを送信します。

getWidgetID

String getWidgetID(String transientDocumentID)

ウィジェットは、ユーザーに複数回表示し、複数回署名できる再利用可能なテンプレートのようなものです。このメソッドを使用して、一時的なドキュメント ID を使用してウィジェット ID を取得します。

getWidgetURL

String getWidgetURL(String widgetId) throws ClientProtocolException, IOException

特定のウィジェット ID のウィジェット URL を取得します。このウィジェット URL は、ドキュメントへの署名を目的にユーザーに表示できます。

API の使用

AcrobatSignHelperMethods は OSGi サービスなので、Java コードで @Reference 注釈を使用して注釈を付ける必要があります。

...
// Import the AcrobatSignHelperMethods from the provided bundle
import com.acrobatsign.core.AcrobatSignHelperMethods;
...

@Component(service = { Example.class })
public class ExampleImpl implements Example {

 // Gain a reference to the provided AcrobatSignHelperMethods OSGi service
 @Reference
 com.acrobatsign.core.AcrobatSignHelperMethods acrobatSignHelperMethods;

 function void example() {
    ...
    // Use the AcrobatSignHelperMethods API methods in your code
    String transientDocumentId = acrobatSignHelperMethods.getTransientDocumentID(documentForSigning);

    String agreementId = acrobatSignHelperMethods.getAgreementId(transientDocumentID, "johndoe@example.com");
    ...
 }
}