Salesforce 用 Acrobat Sign：トラブルシューティングガイド

最終更新日 : 2024年10月16日

Salesforce から契約書を送信できませんか？ Salesforce フィールドの更新時にデータマッピングのエラーが発生しましたか？

Salesforce 用 Adobe Acrobat Sign：トラブルシューティングガイドでは、Salesforce からの契約書の送信、データマッピング、またはステータスの自動更新に関する問題の解決に役立つように設計されています。次の手順を参照してください。

データマッピングエラーのトラブルシューティング
契約書の送信エラーのトラブルシューティング
ステータスの自動更新エラーのトラブルシューティング
拡張ドメインを有効にした後に発生する可能性のある問題のトラブルシューティング
Government Cloud 環境でのリードの検索に関する問題のトラブルシューティング
サポートに連絡する

データマッピングエラーのトラブルシューティング

Acrobat Sign データマッピングでは、Acrobat Sign 契約書が署名されたとき、または契約ワークフローの特定のステージに到達したときに Salesforce オブジェクトが更新されます。データマッピングは事前に設定されており、各データマッピングにデータマッピングルールが含まれています。また、データマッピングルールごとに、データソースと、更新する必要がある対象の Salesforce フィールドが定義されています。詳細については、Salesforce データマッピングを参照してください。

データマッピングで Salesforce フィールドの更新に失敗した場合は、次のトラブルシューティング手順を実行して、問題を特定および修正します。

次の手順を実行します。

Salesforce Lightning ページで、「Adobe Acrobat Sign 管理者」タブに移動します。

右パネルで、「ステータスの自動更新を有効にする」を選択します。

「この組織に対してステータスの自動更新が有効になっています」というメッセージが表示されることを確認します。

上記のメッセージが表示されない場合は、ログアウトしてシステム管理者としてもう一度ログインし、「有効にする」を選択します。

上記のメッセージが表示された場合は、手順 5 および 6 をスキップします。

表示される権限ダイアログで、電子メールアドレスをメモし、ユーザーが有効な Sign ライセンスを持っており、Salesforce のシステム管理者であることを確認します。

「許可」を選択します。「この組織に対してステータスの自動更新が有効になっています」というメッセージが表示されます。

ステータスの自動更新設定で使用している Salesforce ユーザーに、「Adobe Sign 統合ユーザー」権限セットを適用します。

設定後も、ステータスの自動更新ユーザーが Acrobat Sign および Salesforce でアクティブなままであることを確認します。

ステータスの自動更新ユーザー（通常は、統合の設定に使用した Sign アカウント管理者）と、送信者がデータマッピングで更新しようとしているオブジェクトにアクセスできることを確認します。

Salesforce の自動ステータス更新ユーザーの「ユーザーの詳細」ページに移動し、電子メールフィールドに有効な電子メールアドレスが入力されていることを確認します。

フィールドの値を確認するには、契約書リストビューにフィールドを追加して Developer Console または Workbench を使用します。

「Agreement」オブジェクトの「Data Mapping Result」フィールドに「Completed」または「Failed」の値があることを確認してください。値がない場合は、データマッピングが全くトリガーされなかったことを意味します。値が空で、「データマッピング」フィールドにユーザー ID が入力されている場合は、次のようにデータマッピングを再トリガーします。

契約書リストビューに「データマッピングをトリガー」チェックボックスフィールドを追加します。

「データマッピングをトリガー」列の下にある、影響を受ける契約書のセルをダブルクリックします。

チェックボックスをオンにします。

完了したら、Salesforce レコードが更新され、データマッピングが再トリガーされているかどうかを確認します。

データマッピングを再トリガーする別の方法としては、Developer Console、Workbench、または Apex を使用します。

次の操作を行います:

「契約書」オブジェクトで、更新しようとしている Salesforce オブジェクトのルックアップフィールドがあるかどうかを確認します。

影響を受ける契約レコードのルックアップフィールドに、更新しようとしている Salesforce レコードの ID が表示されていることを確認します。

表示されていない場合は、手順 3 に従ってルックアップフィールドを更新し、データマッピングを再トリガーします。今後、契約レコードのルックアップフィールドを動的に更新するには、「テンプレートの詳細」設定の「データを契約書フィールドにマッピング」セクションで契約テンプレートを使用します。詳細については、Salesforce 用 Adobe Acrobat Sign：マッピングおよびテンプレートガイドを参照し、「マッピングされるデータ」セクションの手順に従ってください。

ルックアップフィールドを更新する別の方法としては、Developer Console、Workbench、または Apex を使用します。

「データマッピングエラー」フィールドには、データマッピングのエラーが保存されます。フィールドの値を確認するには、契約書リストビューにフィールドを追加して Developer Console または Workbench を使用します。一般的なエラーと対応する解決手順を以下に示します。

エラー	Failed to map data field: System.DmlException Update failed. First exception on row 0 with id 00ZxxqwertasdmjVUAR; first error: STRING_TOO_LONG, Owner Title: data value too large: Adobe Acrobat Sign Adobe inc (max length=20): [Owner_Title__c] (echosign_dev1) 165
	解像度 : このエラーは、更新された文書のフォームフィールドのデータが、更新しようとしている Salesforce フィールドのサイズ制限を超えていることを意味します。解決策： Salesforce フィールドのフィールドサイズ（この例では Owner_Title__c）を増やしてから、データマッピングを再トリガーします。 Salesforce フィールドのサイズを増やすことができない場合は、受信者に契約書を再送信して、サイズ制限を超過しないデータを入力するように依頼します。
エラー	「契約書に設定されていない関連するオブジェクト参照にマッピングしようとしました：<更新しようとしている Salesforce オブジェクトのフィールドの API 名>」
	解像度 : このエラーは、契約書オブジェクトと更新しようとしている Salesforce オブジェクトとの間に接続が確立されていないことを意味します。上記の手順 4 を参照してください。
エラー	Failed to map data field: System.NullPointerException Attempt to de-reference a null object (echosign_dev1) 656
	解像度このエラーは、必要なオブジェクトにアクセスできなかったために、データマッピングが失敗したことを示します。このエラーを解決するには、次の手順を実行します。上記の手順 4 および 5 を確認します。契約書の送信者が、送信されたファイルにアクセスできることを確認します。問題がユーザー、プロファイル、または権限セットに固有のものであるかどうかを確認します。送信者に異なるプロファイルを適用し、問題が解決したかどうかを確認します。「Adobe Sign 管理者」権限セットを適用して、問題が解決したかどうかを確認します。プロファイルまたは権限セットを変更後に問題が解決する場合は、作業プロファイル／権限セットを送信者の元のプロファイル／権限セットと比較し、不足している権限を見つけます。契約レコードの「文書キー」フィールドに値があるかどうかを確認します。これを行うには、Developer Console を開いて、次の SOQL クエリ「Select echosign_dev1__Document_Key__c from echosign_dev1__SIGN_Agreement__c where id = ‘<enter agreement id>’」を実行します。文書キーをコピーします。次に、https://secure.echosign.com/public/login でアカウント管理者として Acrobat Sign にログインし、アカウント／API 情報に移動して、「REST API メソッドのドキュメント」を選択します。次に、「契約書」セクションと「GET /agreements/{agreementid}」セクションを展開して、次の詳細を入力します。右パネルから、「OAuth アクセストークン」を選択し、メッセージが表示されたら、Acrobat Sign アカウントの管理者資格情報を入力します。認証テキストボックスには、自動的に作成されるアクセストークンが表示されます。 x-api-user には、データマッピングに失敗した契約書の送信者の電子メールアドレスを email:caseyjones@jones.com の形式で入力します。 agreementId には、Salesforce からコピーした文書キーを貼り付けます。「Try it Out」を選択します。応答本文の詳細が、Salesforce の契約書の詳細（契約書名、送信者の詳細、受信者の詳細、作成日）と一致していることを確認します。

データマッピングおよび結合マッピングを使用した契約書の送信：シナリオ例

ユーザーの例：

John Smith

ユースケースの例：

John が実行したい操作：

契約テンプレートを使用して、「デモ 1」と呼ばれるカスタムオブジェクトから契約書を送信する。
「デモ 1」オブジェクトに関連付けられている「デモ 2」と呼ばれる別のカスタムオブジェクトから情報を取得して、契約書に転送する。
契約書に署名後、「デモ 2」オブジェクトレコードに情報を転送する。

ユースケースを達成するための手順：

Acrobat Sign の「契約書」オブジェクトで、「デモ 1」オブジェクトのルックアップフィールドを作成します。
「Demo 1」オブジェクトで、「Demo 2」オブジェクトの参照フィールドを作成します。
関連リストとの間で情報を取り込むまたはプッシュすることはできません。
次のように、データマッピングテンプレートを作成します。
1. 一意のテンプレート名を指定します。
2. 「フィールドマッピング」で、「選択したオブジェクト」を選択し、ドロップダウンメニューから「デモ 1」を選択します。
3. 読み込まれた 2 番目のドロップダウンから、「デモ 2 ID」を選択します。
4. 3 番目に読み込まれるドロップダウンで、「なし」のままにして「選択」を選びます。
5. 「どの Salesforce オブジェクトをアップデートしますか？」で、更新する必要のあるフィールド名を選択します。
6. データマッピングの設定を完了するには、マッピングおよびテンプレートガイドの「データマッピングを使用した Salesforce レコードへの署名者のデータとファイルの転送」セクションの手順に従います。
次のように、結合マッピングテンプレートを作成します。
1. 一意のテンプレート名を指定します。
2. 「フィールドマッピングを追加」を選択します。
3. 「ソース値」で、「選択したオブジェクト」を選択し、ドロップダウンメニューから「デモ 1」を選択します。
4. 読み込まれた 2 番目のドロップダウンから、「デモ 2 ID」を選択します。
5. 読み込まれる次のドロップダウンから、取得する必要がある値を含むフィールド名を選択し、「完了」を選択します。
6. 結合マッピングの設定を完了するには、マッピングおよびテンプレートガイドの「結合マッピングを使用した Salesforce データによる文書の作成」セクションの手順に従います。
「テンプレートワークフローの作成」の手順に従って、契約テンプレートを作成します。
上記で作成した契約テンプレートで、結合マッピングテンプレートとデータマッピングテンプレートが「データマッピング」セクションに含まれていることを確認します。
契約テンプレートの「テンプレートの詳細」セクションで、デモ 1 として Salesforce オブジェクトを選択します。
「データを契約書フィールドにマッピング」を選択してから、表示されるダイアログで次の操作を行います。
1. 「オブジェクトから選択」オプションを選択します。
2. 「ソースタイプ」で、「デモ 1 ID」を選択します。
3. 「ターゲット契約書」フィールドの下のルックアップフィールドで、「デモ 1」オブジェクトを選択します。
4. 「保存」を選択します。
契約テンプレートで、「保存」 を選択します。
マージマッピングとデータマッピングが有効になっている「Demo 1」オブジェクトにリンクされた契約テンプレートを作成します。
「デモ 1」オブジェクトレコードを開き、／編集ページを選択します。次に、左パネルの「カスタム管理」セクションから契約書パネルをドラッグ＆ドロップし、「保存」を選択します。
「アクティベーション」を選択して、必要に応じてレコードページを割り当てます。テストのために、「組織のデフォルトとして割り当て」を選択すると、すべてのユーザーに「契約書パネル」が表示されます。
「次へ」と「保存」を選択します。
「デモ 1」オブジェクトレコードに移動して、ページを更新します。追加した「契約書パネル」が表示されます。
「契約書を署名用に送信」を選択します。作成した契約テンプレートが表示されます。
契約テンプレートを選択し、画面の手順に従って契約書を送信します。契約書に「デモ 2」から結合されたデータが含まれていることを確認します。
契約書に署名します。契約書の値で更新された「デモ 2」レコードが表示されます。

Salesforce から契約書を送信できない場合のトラブルシューティング

Salesforce から契約書を送信できない場合は、次のトラブルシューティング手順を実行します。

サポートされているバージョンの Adobe Acrobat Sign を使用していることを確認します。サポートされるバージョンを参照してください。

送信者として、必要な権限があることを確認してください。
ユーザーに必要なアクセス権を付与する方法を参照してください。このガイドで説明されているオブジェクトやフィールドに加えて、送信者はワークフローで使用されているその他の Salesforce オブジェクトにアクセスできる必要があります。

Salesforceの「契約書」オブジェクトまたはその他の Acrobat Sign オブジェクトに、トリガー、ワークフロー、ルールなどのカスタマイズがあるかどうかを確認します。ある場合は、すべてのカスタマイゼーションを無効にして、テスト契約を送信して通過するかどうかを確認してください。
カスタマイゼーションを無効にした後に契約が正常に送信された場合は、ガイドラインについてデベロッパーガイドを参照してください。

メモ

カスタマイズのトラブルシューティングについてはサポートされていません。

次のいずれかの方法を使用して、契約書の送信中に発生したエラーのタイプを特定します。

Salesforce で影響を受ける契約レコードを開き、エラーメッセージが表示されている赤いバナーを確認します。このエラーは、根本原因を示しているはずです。
「契約書通知」オブジェクトの「エラーメッセージ」フィールドを確認します。
Developer Console を使用して確認し、次の SOQL クエリを実行します。

Select echosign_dev1__Error_Message__c from

echosign_dev1__Agreement_Notification__c where

echosign_dev1__Agreement__c = ‘<enter agreement id>

エラーと解決手順に関する次の表をご参照ください。

エラー	解決策
x-api-user ヘッダーで無効なユーザー ID または電子メールが指定されています。または有効な Adobe Acrobat Sign ユーザーアカウントがありません	これらのエラーは、送信者が有効な Acrobat Sign ライセンスを持っていないことを示しています。トラブルシューティングするには： Agreement レコードの「Sender Recorded」フィールドを確認して、契約の送信者を特定してください。「Sender Recorded」フィールドのユーザーが Salesforce で見つからない場合、Acrobat Sign パッケージは「Created By」フィールドを契約の「送信者」として使用します。 Salesforce の送信者のユーザーの詳細ページに移動し、「電子メール」フィールドに有効な電子メールアドレスとアクティブな Sign エンタープライズ版ライセンスが含まれていることを確認します。電子メールアドレスにアクティブな Sign エンタープライズ版ライセンスがあるかどうかを確認するには、次の手順に従います。管理者の資格情報を使用して、Acrobat Sign にログインします。アカウント／ユーザーの順に移動して、電子メールアドレスを検索します。ユーザーのステータスがアクティブである必要があります。ステータスが「アクティブ」でないユーザーは、契約書を送信できません。ユーザーがアクティブでない場合は、ユーザーを追加および管理する方法を参照して、「電子メールは使用されていますが、ユーザーのステータスが「アクティブ」ではありません」セクションの手順を参照してください。代理送信（SOB）を使用する場合は、「契約書」オブジェクトの「代理送信」フィールドをオンにして、電子メールアドレスを確認します。 Acrobat Sign にログインして、このユーザーの電子メールアドレスに有効な Sign ライセンスがあることを確認します。 SOB ユーザーの「ユーザーの詳細」ページで、「他のユーザーとして送信することを許可する」フィールドが有効になっていることを確認します。このフィールドは、デフォルトではユーザーオブジェクトページレイアウトに表示されない場合があります。上記の手順 2 に従って、ユーザー権限を確認します。ユーザーに必要なアクセス権を付与する方法を参照してください。
ファイル形式がサポートされていません	このエラーは、署名用に送信しようとしている文書がサポートされている形式ではない場合に発生します。 Acrobat Sign にアップロードする場合にサポートされているファイル形式を確認するには、Acrobat Sign の必要システム構成の「サポートされている文書形式」セクションを参照してください。
署名ボタンで不正なオブジェクト ID が使用されています	このエラーは、「代理送信」ボタンのテンプレート ID またはオブジェクトのマスター ID が無効な場合に発生します。正しいオブジェクト ID を入力してから、プロセスを再試行することをお勧めします。

ステータスの自動更新エラーのトラブルシューティング

契約が正しいステータスで更新されない場合は、次のトラブルシューティング手順を実行します。

Salesforce 用 Adobe Acrobat Sign：インストールガイドに記載されている前提条件およびインストール後の設定（必須）が実装されていることを確認します。

Salesforce Lightning ページで、Adobe Acrobat Sign 管理者／ステータスの自動更新を有効にするに移動して、「この組織に対してステータスの自動更新が有効になっています」というメッセージが表示されていることを確認します。

メッセージが表示されない場合は、次の手順を実行します。

ログアウトし、システム管理者としてもう一度ログインします。
Adobe Acrobat Sign 管理者／ステータスの自動更新を有効にするに移動して、「有効にする」を選択します。
表示される「Acrobat Sign へのアクセスを許可」ダイアログで、次の操作を行います。
1. ダイアログの下部にある電子メールアドレスをメモします。
2. このメールアドレスに有効な Sign ライセンスがあり、Salesforce のシステム管理者であることを確認します。
3. ユーザーに「Adobe Sign 統合ユーザー」権限セットが割り当てられていることを確認します。
4. 「許可」を選択します。

「この組織に対してステータスの自動更新が有効になっています」というメッセージが表示されます。

「契約書通知」オブジェクトの「エラーメッセージ」フィールドを確認します。フィールドの値を確認するには、Developer Console で以下の SOQL クエリを実行します。

SELECT Id, echosign_dev1__Agreement_Event_Type__c, echosign_dev1__Agreement_Status__c, echosign_dev1__Document_Key__c, echosign_dev1__Error_Message__c, echosign_dev1__Notification_Type__c, echosign_dev1__Status__c FROM echosign_dev1__Agreement_Notification__c where echosign_dev1__Agreement__c='<agreementId>'

契約が Salesforce 環境外で作成されたプッシュ通知契約の場合は、Salesforce 用 Adobe Acrobat Sign：大容量文書およびプッシュ通知契約サービスガイドを必ず参照してください。

設定／カスタム設定／Adobe Sign 契約書の更新設定／管理／新規（または編集）を選択します。表示されるページで、「契約書のステータスを更新」チェックボックス（「デフォルトの組織レベル値」の下）が有効になっていることを確認します。

「契約書」タブに移動して、更新に失敗したすべての契約書を選択し、右上隅から「契約書を更新」を選択します。

これらの契約書のステータスが更新されるかどうかを確認します。今すぐ更新する場合は、新しいテスト契約書で問題が再発するかどうかを確認します。再発する場合は、次のトラブルシューティング手順に進みます。

再発しない場合は、1 回限りの問題だった可能性があります。問題が再発する場合は、このトラブルシューティングガイドを参照することをお勧めします。

Salesforceの「契約書」オブジェクトまたはその他の Acrobat Sign オブジェクトに、トリガー、ワークフロー、ルールなどのカスタマイズがあるかどうかを確認します。

ある場合は、すべてのカスタマイズを無効にして、通常の手順に従ってテスト契約書を送信し、正常に送信されるかどうかを確認します。ステータスが「下書き」から「署名用に送信」に変わります。

カスタマイズを無効にした後に契約書のステータスが「署名用に送信」に変わった場合は、ガイドライン用デベロッパーガイドを参照してください。

ステータスが更新されない場合は、カスタマイズを無効にした状態で「契約書」タブからテスト契約書を直接送信し、正常に送信されるかどうかを確認します。それでもステータスが変わらない場合は、上記の手順 1 と 2 を確認してください。

メモ

カスタマイズのトラブルシューティングについてはサポートされていません。

Acrobat Sign オブジェクト
添付ファイルを追加	ファイルマッピング	データを契約フィールドにマッピング
フォームフィールドテンプレートを追加	フォームフィールドの読み込み	結合マッピング
受信者を追加	フォームフィールド子マッピング	mutex
契約	フォームフィールド子マッピングのエントリ	オブジェクトマッピング
契約イベント	フォームフィールドマッピング	受信者
契約テンプレート	フォームフィールドマッピングのエントリ	署名済み契約
データマッピング	グループマッピング	トリガー
フィールドマッピング	ライブラリテンプレート	ユーザー同期結果
契約タイプ

拡張ドメインを有効にした後に発生する可能性のある問題のトラブルシューティング

すべての組織で、Salesforce の拡張ドメインがデフォルトで有効になりました。これは、Salesforce 用 Acrobat Sign パッケージには影響しません。ただし、サイトを大きなファイルのダウンロード用に設定して契約書をプッシュした場合、拡張ドメインが有効になっていると問題が発生し、サイト URL が変更されたり、契約書が破損したりします。

契約書をスムーズに機能させるために、お客様は、大きなファイルダウンロードについて、更新されたサイト URL を反映するようにカスタム設定を更新する必要があります。

契約書の転送のコールバック URL を更新するには、お客様は、サポートに問い合わせ、必要な情報を入力する必要があります。詳しくは、Acrobat Sign アカウント用に個々のサービスを設定する方法を参照してください。

Government Cloud 環境でのリードの検索に関する問題のトラブルシューティング

Salesforce 用 Acrobat Sign では、受信者タイプとしてリードを選択した場合に、リードを検索して契約書の受信者として追加できます。ただし、Government Cloud ユーザーが、リード、取引先担当者、ユーザーを作成しても、検索フィールドで見つからない場合は、Salesforce 組織管理者は次の解決手順に従うことができます。

設定／オブジェクトマネージャーを選択し、「リード」を検索します。
左パネルから「フィールドと関係」を選択します。
すべての必須フィールド（「名前」、「電子メール」、「モバイル」など）で、ユーザーがアクセスできるかどうかを確認します。次の手順に従います。
1. 確認するフィールドを選択します。例えば、「モバイル」を選択します。
2. フィールドアクセスを有効にするすべてのユーザーに、「表示」チェックボックスを選択します。
3. 「保存」を選択します。