アダプティブフォームでの DocuSign の使用 integrate-aem-forms-with-DocuSign

AEM Forms as a Cloud Service プロジェクトのクローンを作成 するか、AEM アーキタイプ 27 以降に基づいて Experience Manager Forms as a Cloud Service プロジェクトを作成します。AEM アーキタイプに基づいて Experience Manager Forms as a Cloud Service プロジェクトを作成するには：

コマンドプロンプトを開き、以下のコマンドを実行して Experience Manager Forms as a Cloud Service プロジェクトを作成します。

mvn -B archetype:generate -DarchetypeGroupId=com.adobe.aem -DarchetypeArtifactId=aem-project-archetype -DarchetypeVersion=27 -DaemVersion="cloud" -DappTitle="My Site" -DappId="mysite" -DgroupId="com.mysite" -DincludeForms="y"

また、上記のコマンドで appTitle、appId、groupId を変更し、環境に反映します。

aem-forms-samples リポジトリのクローンを作成します。このリポジトリには、DocuSign 用のカスタム送信アクションと、DocuSign サーバーに接続するための設定の詳細が含まれています。

手順 1 で作成した AEM Forms as a Cloud Service プロジェクトを任意の IDE で編集用に開きます。

[AEM Forms as a Cloud Service project]\pom.xml ファイルを編集用に開き、以下の変更を行います。

1. <properties> タグの末尾に次のテキストを追加します。

   code language-shell
   <repository.location>maven_repository</repository.location>

2. <repositories> タグの末尾に次のテキストを追加します。

   code language-shell
   <repository> <id>project-repository</id> <url>file://${project.basedir}/${repository.location}</url> </repository>

   <repositories> タグがない場合は、<properties> タグの下に作成します。

3. <dependencyManagement> タグの末尾に次のテキストを追加します。

   code language-shell
   <dependency> <groupId>com.adobe.aemforms.samples</groupId> <artifactId>forms.integration.docusign.all</artifactId> <type>zip</type> <version>1.0.0</version> </dependency>

Cloud Service プロジェクトフォルダーにある all/pom.xml ファイルで次の手順を実行します。

1. <embeddeds> タグの末尾に次のテキストを追加します。

   code language-shell
   <embedded> <groupId>com.adobe.aemforms.samples</groupId> <artifactId>forms.integration.docusign.all</artifactId> <type>zip</type> <target>/apps/moonlightprodprogram-vendor-packages/application/install</target> </embedded>

2. <dependencies> タグの末尾に次のテキストを追加します。

   code language-shell
   <dependency> <groupId>com.adobe.aemforms.samples</groupId> <artifactId>forms.integration.docusign.all</artifactId> <type>zip</type> </dependency>

コマンドプロンプトを開き、aem-forms-samples\forms-integration-docusign（手順 3 で作成したクローン）に移動して、次のコマンドを実行します。

mvn clean install -Dinstall.dir="<AEM Forms as a Cloud Service project path>/maven_repository"

<AEM Forms as a Cloud Service project path> は、上記の手順 1 で作成したフォルダーの名前を指します。

プロジェクトをローカル開発環境にデプロイします。以下のコマンドを使用して、ローカル開発環境にデプロイできます

mvn -PautoInstallPackage clean install

これらの手順を実行すると、アダプティブフォームの送信オプションのリストと、ローカル開発環境の DocuSign Cloud Service 設定に DocuSign 電子サインを使用して送信という新しいカスタム送信アクションが表示されます。

コードをコンパイルして AEM Forms as a Cloud Service 環境にデプロイします。

ツール （ ）／クラウドサービス／DocuSign に移動し、設定をホストするフォルダーを選択します。

設定ページで「作成」を選択して、AEM Forms 内に DocuSign の設定を作成します。

DocuSign 設定を作成 ​ページの「一般」タブで、設定の​ 名前 ​を指定して「次へ」を選択します。オプションで、「タイトル」も指定できます。

現在のブラウザーウィンドウの URL をメモ帳にコピーします。この URL は、後の手順で AEM Forms と DocuSign アプリケーションを設定する際に必要です。

以下の手順に従って、DocuSign アプリケーションの OAuth 設定を指定します。

1. ブラウザーウィンドウを開き、DocuSign 開発者アカウントにログインします。
2. AEM Forms 用に設定したアプリを開きます。
3. 上記の手順でコピーした URL を「リダイレクト URL」ボックスに追加して、「保存」をクリックします。
4. 統合キーと秘密鍵をメモしておきます。

DocuSign アプリケーションの OAuth 設定を指定しキーを取得するための手順について詳しくは、 アプリケーションの OAuth 設定の指定方法 に関する開発者ドキュメントを参照してください。

DocuSign 設定を作成 ​ページに戻ります。「設定」タブで、「OAuth URL」フィールドに以下のデフォルトの URL が表示されます。

https://account-d.docusign.com/oauth/auth

「クライアント ID」（DocuSign 統合キー）と「クライアントの秘密鍵」（DocuSign 秘密鍵）を指定します。

「DocuSign に接続」を選択します。資格情報の入力画面が表示されたら、DocuSign アプリケーションの作成時に使用したユーザー名とパスワードを入力します。your developer account へのアクセスを確認するメッセージが表示されたら、「アクセスを許可」をクリックします。資格情報が正しい場合は、成功メッセージが表示されます。

「作成」を選択して、DocuSign 設定を作成します。

設定を選択し、「公開」をクリックします​ 。 ​これにより、対応するパブリッシュ環境に設定が複製されます。

開発者、ステージ、実稼働用のインスタンス（残っているいずれか）で上記の手順をすべて繰り返し、お使いの環境用に DocuSign を AEM Forms で設定する作業を完了します。

Adobe Experience Manager／Forms／フォームとドキュメント ​に移動します。

「作成」を選択して、「アダプティブフォーム」をクリックします。テンプレートのリストが表示されます。テンプレートを選択して、「次へ」をクリックします。

「基本」タブで次の操作を行います。

1. アダプティブフォームの​ 名前 ​と​ タイトル ​を指定します。

2. DocuSign を AEM Forms と統合するときに作成した 設定コンテナ を選択します。

設定コンテナには、お使いの環境用に設定された DocuSign クラウドサービスが含まれています。これらのサービスは、アダプティブフォームエディターで選択できます。

「フォームモデル」タブで、次のいずれかのオプションを選択します。

• カスタムフォームテンプレートがあり、そのフォームテンプレートに基づいてレコードのドキュメントが必要な場合は、「フォームテンプレートをレコードのドキュメントテンプレートとして関連付ける」オプションを選択し、「レコードのドキュメントテンプレート」を選択します。このオプションを使用すると、署名用に送信されたドキュメントには、関連付けられたフォームテンプレートに基づくフィールドのみが表示されます。アダプティブフォームのすべてのフィールドは表示されません。

• カスタムフォームテンプレートがない場合は、「レコードのドキュメントを生成」オプションを選択します。このオプションを使用すると、署名用に送信されたドキュメントにアダプティブフォームのすべてのフィールドが表示されます。

「作成」を選択します。 署名が有効なアダプティブフォームが作成されます。DocuSign フィールドをフォームに追加し、署名用に送信できます。

アダプティブフォームを編集モードで開きます。「コンテンツ」タブで「フォームコンテナ」を選択し、「 」をクリックします。

「送信」セクションの「送信アクション」ドロップダウンリストで、「DocuSign 電子サインを使用して送信」を選択します。

「アクション設定」セクションで「追加」を選択して受信者を追加し、その受信者のメールアドレスを指定します。「追加」を再度選択して、受信者をさらに追加します。

メールメッセージの件名を「メールの件名」フィールドに指定します。メールメッセージに添付ファイルを含める場合は、「添付ファイルを含める」を選択します。

「 」を選択して、プロパティを保存します。

Adobe Experience Manager／Forms／フォームとドキュメント ​に移動します。

アダプティブフォームを選択し、「プロパティ」を選択します。

「基本」タブで、DocuSign を AEM Forms と統合するときに作成した 設定コンテナ を選択します。

「フォームモデル」タブで、次のいずれかのオプションを選択します。

• カスタムフォームテンプレートがあり、そのフォームテンプレートに基づいてレコードのドキュメントが必要な場合は、「フォームテンプレートをレコードのドキュメントテンプレートとして関連付ける」オプションを選択し、「レコードのドキュメントテンプレート」を選択します。このオプションを使用すると、署名用に送信されたドキュメントには、関連付けられたフォームテンプレートに基づくフィールドのみが表示されます。アダプティブフォームのすべてのフィールドは表示されません。

• カスタムフォームテンプレートがない場合は、「レコードのドキュメントを生成」オプションを選択します。このオプションを使用すると、署名用に送信されたドキュメントにアダプティブフォームのすべてのフィールドが表示されます。

「保存して閉じる」を選択します。アダプティブフォームは DocuSign に対して有効になっています。これで、DocuSign フィールドをフォームに追加し、署名用に送信できます。

アダプティブフォームを編集モードで開きます。「コンテンツ」タブで「フォームコンテナ」を選択し、「 」をクリックします。

「送信」セクションの「送信アクション」ドロップダウンリストで、「DocuSign 電子サインを使用して送信」を選択します。

「アクション設定」セクションで「追加」を選択して受信者を追加し、その受信者のメールアドレスを指定します。「追加」を再度選択して、受信者をさらに追加します。

メールメッセージの件名を「メールの件名」フィールドに指定します。メールメッセージに添付ファイルを含める場合は、「添付ファイルを含める」を選択します。

「 」を選択して、プロパティを保存します。