Salesforce Lightning ページで、「Adobe Acrobat Sign 管理者」タブに移動します。
最終更新日 :
2024年11月4日
- Adobe Acrobat Sign の統合
- 新機能
- 製品バージョンとライフサイクル
- Salesforce 向け Acrobat Sign
- Microsoft 向け Acrobat Sign
- Microsoft 365 向け Acrobat Sign
- Outlook 向け Acrobat Sign
- Word/PowerPoint 向け Acrobat Sign
- Teams 向け Acrobat Sign
- Microsoft PowerApps および Power Automate 向け Acrobat Sign
- Acrobat Sign Connector for Microsoft Search
- Microsoft Dynamics 向け Acrobat Sign
- Microsoft SharePoint 向け Acrobat Sign
- Microsoft 365 向け Acrobat Sign
- ServiceNow 向け Acrobat Sign
- HR ServiceNow 向け Acrobat Sign
- SAP SuccessFactors 向け Acrobat Sign
- Acrobat Sign for Workday
- NetSuite 向け Acrobat Sign
- SugarCRM 向け Acrobat Sign
- VeevaVault 向け Acrobat Sign
- Coupa BSM Suite 向け Acrobat Sign
- Zapier 向け Acrobat Sign
- Acrobat Sign 開発者向けドキュメント
Salesforce から契約書を送信できませんか？Salesforce フィールドの更新時にデータマッピングのエラーが発生しましたか？
Salesforce 用 Adobe Acrobat Sign：トラブルシューティングガイドでは、Salesforce からの契約書の送信、データマッピング、またはステータスの自動更新に関する問題の解決に役立つように設計されています。次の手順を参照してください。
Acrobat Sign データマッピングでは、Acrobat Sign 契約書が署名されたとき、または契約ワークフローの特定のステージに到達したときに Salesforce オブジェクトが更新されます。データマッピングは事前に設定されており、各データマッピングにデータマッピングルールが含まれています。また、データマッピングルールごとに、データソースと、更新する必要がある対象の Salesforce フィールドが定義されています。詳細については、Salesforce データマッピングを参照してください。
データマッピングで Salesforce フィールドの更新に失敗した場合は、次のトラブルシューティング手順を実行して、問題を特定および修正します。
次の手順を実行します。
-
ステータスの自動更新ユーザー（通常は、統合の設定に使用した Sign アカウント管理者）と、送信者がデータマッピングで更新しようとしているオブジェクトにアクセスできることを確認します。
フィールドの値を確認するには、契約書リストビューにフィールドを追加して Developer Console または Workbench を使用します。
契約書オブジェクトの「Data Mapping Result」フィールドの値が「Completed」または「Failed」のいずれかであることを確認します。値がない場合は、データマッピングがトリガーされなかったことを意味します。値が空で、「データマッピング」フィールドにユーザー ID が入力されている場合は、次のようにデータマッピングを再トリガーします。
「データマッピングエラー」フィールドには、データマッピングのエラーが保存されます。フィールドの値を確認するには、契約書リストビューにフィールドを追加して 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 オブジェクトのフィールドの API 名>」 |
解決策: このエラーは、契約書オブジェクトと更新しようとしている Salesforce オブジェクトとの間に接続が確立されていないことを意味します。上記の手順 4 を参照してください。 |
|
| エラー |
Failed to map data field: System.NullPointerException Attempt to de-reference a null object (echosign_dev1) 656 |
解決策 このエラーは、必要なオブジェクトにアクセスできなかったために、データマッピングが失敗したことを示します。このエラーを解決するには、次の手順を実行します。
|
ユーザーの例：
John Smith
ユースケースの例：
John が実行したい操作：
- 契約テンプレートを使用して、「デモ 1」と呼ばれるカスタムオブジェクトから契約書を送信する。
- 「デモ 1」オブジェクトに関連付けられている「デモ 2」と呼ばれる別のカスタムオブジェクトから情報を取得して、契約書に転送する。
- 契約書に署名後、「デモ 2」オブジェクトレコードに情報を転送する。
ユースケースを達成するための手順：
- Acrobat Sign の「契約書」オブジェクトで、「デモ 1」オブジェクトのルックアップフィールドを作成します。
- 「デモ 1」オブジェクトで、「デモ 2」オブジェクトのルックアップフィールドを作成します。
関連リスト間での情報の取得または転送はできません。 - 次のように、データマッピングテンプレートを作成します。
- 一意のテンプレート名を指定します。
- 「フィールドマッピング」で、「選択したオブジェクト」を選択し、ドロップダウンメニューから「デモ 1」を選択します。
- 読み込まれた 2 番目のドロップダウンから、「デモ 2 ID」を選択します。
- 3 番目に読み込まれるドロップダウンで、「なし」のままにして「選択」を選びます。
- 「どの Salesforce オブジェクトをアップデートしますか？」で、更新する必要のあるフィールド名を選択します。
- データマッピングの設定を完了するには、マッピングおよびテンプレートガイドの「データマッピングを使用した Salesforce レコードへの署名者のデータとファイルの転送」セクションの手順に従います。
- 次のように、結合マッピングテンプレートを作成します。
- 一意のテンプレート名を指定します。
- 「フィールドマッピングを追加」を選択します。
- 「ソース値」で、「選択したオブジェクト」を選択し、ドロップダウンメニューから「デモ 1」を選択します。
- 読み込まれた 2 番目のドロップダウンから、「デモ 2 ID」を選択します。
- 読み込まれる次のドロップダウンから、取得する必要がある値を含むフィールド名を選択し、「完了」を選択します。
- 結合マッピングの設定を完了するには、マッピングおよびテンプレートガイドの「結合マッピングを使用した Salesforce データによる文書の作成」セクションの手順に従います。
- 「テンプレートワークフローの作成」の手順に従って、契約テンプレートを作成します。
- 上記で作成した契約テンプレートで、結合マッピングテンプレートとデータマッピングテンプレートが「データマッピング」セクションに含まれていることを確認します。
- 契約テンプレートの「テンプレートの詳細」セクションで、デモ 1 として Salesforce オブジェクトを選択します。
- 「データを契約書フィールドにマッピング」を選択してから、表示されるダイアログで次の操作を行います。
- 「オブジェクトから選択」オプションを選択します。
- 「ソースタイプ」で、「デモ 1 ID」を選択します。
- 「ターゲット契約書」フィールドの下のルックアップフィールドで、「デモ 1」オブジェクトを選択します。
- 「保存」を選択します。
- 契約テンプレートで、「保存」を選択します。
結合マッピングとデータマッピングが有効になっている、「デモ 1」オブジェクトにリンクされた契約テンプレートが作成されます。 - 「デモ 1」オブジェクトレコードを開き、
／編集ページを選択します。次に、左パネルの「カスタム管理」セクションから契約書パネルをドラッグ＆ドロップし、「保存」を選択します。 - 「アクティベーション」を選択して、必要に応じてレコードページを割り当てます。テストのために、「組織のデフォルトとして割り当て」を選択すると、すべてのユーザーに「契約書パネル」が表示されます。
- 「次へ」と「保存」を選択します。
- 「デモ 1」オブジェクトレコードに移動して、ページを更新します。追加した「契約書パネル」が表示されます。
- 「契約書を署名用に送信」を選択します。作成した契約テンプレートが表示されます。
- 契約テンプレートを選択し、画面の手順に従って契約書を送信します。契約書に「デモ 2」から結合されたデータが含まれていることを確認します。
- 契約書に署名します。契約書の値で更新された「デモ 2」レコードが表示されます。
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 ライセンスを持っていないことを示しています。トラブルシューティングするには：
- 契約レコードの「送信者を記録しました」フィールドを確認して、契約書の送信者を特定します。
Salesforce で「送信者を記録しました」フィールドのユーザーが見つからない場合は、Acrobat Sign パッケージでは、契約書の「送信者」として「作成者」フィールドを使用します。 - 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 へのアクセスを許可」ダイアログで、次の操作を行います。
- ダイアログの下部にある電子メールアドレスをメモします。
- このメールアドレスに有効な Sign ライセンスがあり、Salesforce のシステム管理者であることを確認します。
- ユーザーに「Adobe Sign 統合ユーザー」権限セットが割り当てられていることを確認します。
- 「許可」を選択します。
「この組織に対してステータスの自動更新が有効になっています」というメッセージが表示されます。
-
「契約書通知」オブジェクトの「エラーメッセージ」フィールドを確認します。フィールドの値を確認するには、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：大容量文書およびプッシュ通知契約サービスガイドを必ず参照してください。
-
Salesforceの「契約書」オブジェクトまたはその他の Acrobat Sign オブジェクトに、トリガー、ワークフロー、ルールなどのカスタマイズがあるかどうかを確認します。
ある場合は、すべてのカスタマイズを無効にして、通常の手順に従ってテスト契約書を送信し、正常に送信されるかどうかを確認します。ステータスが「下書き」から「署名用に送信」に変わります。
カスタマイズを無効にした後に契約書のステータスが「署名用に送信」に変わった場合は、ガイドライン用デベロッパーガイドを参照してください。
ステータスが更新されない場合は、カスタマイズを無効にした状態で「契約書」タブからテスト契約書を直接送信し、正常に送信されるかどうかを確認します。それでもステータスが変わらない場合は、上記の手順 1 と 2 を確認してください。
注意：カスタマイズのトラブルシューティングについてはサポートされていません。
Acrobat Sign オブジェクト 添付ファイルを追加 ファイルマッピング データを契約フィールドにマッピング フォームフィールドテンプレートを追加 フォームフィールドの読み込み 結合マッピング 受信者を追加 フォームフィールド子マッピング mutex 契約 フォームフィールド子マッピングのエントリ オブジェクトマッピング 契約イベント フォームフィールドマッピング 受信者 契約テンプレート フォームフィールドマッピングのエントリ 署名済み契約 データマッピング グループマッピング トリガー フィールドマッピング ライブラリテンプレート ユーザー同期結果 契約タイプ
すべての組織で、Salesforce の拡張ドメインがデフォルトで有効になりました。これは、Salesforce 用 Acrobat Sign パッケージには影響しません。 ただし、サイトを大きなファイルのダウンロード用に設定して契約書をプッシュした場合、拡張ドメインが有効になっていると問題が発生し、サイト URL が変更されたり、契約書が破損したりします。
契約書をスムーズに機能させるために、お客様は、大きなファイルダウンロードについて、更新されたサイト URL を反映するようにカスタム設定を更新する必要があります。
契約書の転送のコールバック URL を更新するには、お客様は、サポートに問い合わせ、必要な情報を入力する必要があります。詳しくは、Acrobat Sign アカウント用に個々のサービスを設定する方法を参照してください。
Salesforce 用 Acrobat Sign では、受信者タイプとしてリードを選択した場合に、リードを検索して契約書の受信者として追加できます。ただし、Government Cloud ユーザーが、リード、取引先担当者、ユーザーを作成しても、検索フィールドで見つからない場合は、Salesforce 組織管理者は次の解決手順に従うことができます。
- 設定／オブジェクトマネージャーを選択し、「リード」を検索します。
- 左パネルから「フィールドと関係」を選択します。
- すべての必須フィールド（「名前」、「電子メール」、「モバイル」など）で、ユーザーがアクセスできるかどうかを確認します。次の手順に従います。
- 確認するフィールドを選択します。例えば、「モバイル」を選択します。
- フィールドアクセスを有効にするすべてのユーザーに、「表示」チェックボックスを選択します。
- 「保存」を選択します。
上記のトラブルシューティング手順を実行しても問題が解決しない場合は、サポートに連絡し、次の詳細をお知らせください。
- 問題の説明
- 統合の設定に使用した Acrobat Sign アカウント管理者の電子メールアドレス
- ステータスの自動更新に使用した Acrobat Sign アカウント管理者の電子メールアドレス
- Salesforce にインストールされている Acrobat Sign パッケージのバージョン
- Salesforce 組織 ID
- 影響を受ける契約書の Salesforce レコード ID
- 影響を受けたユーザーの電子メールアドレス
- 問題が一貫して再現可能か、断続的、または一回限りのものかどうかの確認
- 最後の発生日：<認識している最後の発生の日付／時間／タイムゾーン>
- 問題の再現手順
- 予期される動作：<手順を実行した場合に予想される動作を説明してください>
- トラブルシューティングのメモ：<このドキュメントを参照してこれまでに実行したトラブルシューティングの詳細を説明してください>
