アダプティブフォームでの DocuSign の使用

DocuSign は優れた電子サインソリューションです。契約の電子サインに使用できます。DocuSign をアダプティブフォームと統合することができます。電子サイン用のアダプティブフォームを複数の受信者に送信する場合に役立ちます。電子サインを使用すると、次のことができます。

完全に自動化された提案プロセス、見積りプロセス、契約プロセスを使用して、任意のデバイスで契約を締結する。
人事プロセスを短時間で完了し、従業員に対してデジタルエクスペリエンスを提供する。
契約のサイクルタイムを短縮し、ベンダーとの取引を早期に開始する。

AEM Forms as a Cloud Service には DocuSign 用のカスタム送信アクションが用意されています。この送信アクションは、DocuSign API を使用して電子サイン用のアダプティブフォームを送信する場合に役立ちます。

また、アドビの電子サインソリューションである Adobe Sign を使用して、アダプティブフォームに電子サインを行うこともできます。AEM Forms は、Adobe Sign とはるかに深く統合されており、連続署と並列署名、複数の認証方法、フォーム内署名機能など、一段ときめ細かい制御が可能です。詳しくは、アダプティブフォームでの Adobe Sign の使用を参照してください。

前提条件

DocuSign を AEM Forms と統合するには、以下が必要です。

DocuSign の開発者アカウント
DocuSign アプリケーション
DocuSign API アプリケーションの資格情報（クライアント ID およびクライアントの秘密鍵）
DocuSign 用のカスタム送信アクションと Cloud Service
（ローカル開発環境のみ）レコードのドキュメントのセットアップ

DocuSign 用のカスタム送信アクションと Cloud Service の設定

AEM Forms as a Cloud Service には DocuSign 用のカスタム送信アクションが用意されています。この送信アクションは、DocuSign API を使用して電子サイン用のアダプティブフォームを送信する場合に役立ちます。カスタム送信アクションのコードは、AEM Forms サンプルの公開 Git リポジトリで入手可能です。このコードは、AEM Forms 環境にそのままデプロイすることもできますし、組織の要件に従ってカスタマイズすることもできます。

標準のカスタム送信アクションと DocuSign Cloud Service を設定するには、次の手順を実行します。

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> タグの末尾に次のテキストを追加します。
```
<repository.location>maven_repository</repository.location>
```
2. <repositories> タグの末尾に次のテキストを追加します。
```
 <repository>
    <id>project-repository</id>
    <url>file://${project.basedir}/${repository.location}</url>
 </repository>
```
  <repositories> タグがない場合は、<properties> タグの下に作成します。
3. <dependencyManagement> タグの末尾に次のテキストを追加します。
```
 <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 ファイルで次の手順を実行します。

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

 <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>

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

 <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 と AEM Forms を統合します。

ツール （）／クラウドサービス／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 で設定する作業を完了します。

これで、DocuSign を使用するように AEM Forms 環境が設定されました。DocuSign 用に有効化するすべてのアダプティブフォームに、Cloud Service に使用する設定コンテナを追加してください。設定コンテナは、アダプティブフォームのプロパティから指定できます。