翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# AWS Partner CRM コネクタに関するよくある質問
このセクションのトピックは、CRM 統合と AWS Partner CRM コネクタの使用に関するよくある質問への回答に役立ちます。
**注記**
このよくある質問の質問と回答は、Salesforce を使用することを前提としています。Salesforce の使用の詳細については、Salesforce の[ヘルプ](https://help.salesforce.com/s/)を参照してください。
**Topics**
+ [一般的な質問](#general-questions)
+ [セットアップの問題](#setup-issues)
+ [問題のマッピング](#mapping-issues)
+ [同期と検証の問題](#synchronization-validation)
## 一般的な質問
AWS Partner CRM コネクタの使用の詳細については、以下のセクションを展開してください。
### AWS Partner CRM コネクタの使用を開始するにはどうすればよいですか?
パートナー開発マネージャー (PDM) または AWS 連絡先にお問い合わせください。PDM は適格性を確認し、認証に必要な IAM ユーザーをセットアップし、ファイルを交換するために必要な Amazon S3 バケットをセットアップするためのリクエストを内部で送信します。Amazon S3 バケットにアクセスしたら、 ユーザーガイドの手順に従ってコネクタをインストールし、統合をセットアップできます。
すでに ACE AWS Partner 統合がある場合は、[Salesforce AppExchange からコネクタをインストール](install-connector.md)し、「」の手順に従います[Amazon S3 との統合による CRM のコネクタの設定](s3-config.md)。
### バージョン 3 に移行する理由
バージョン 3 では、オポチュニティをリアルタイムで更新できるため、スケジュールが不要になります。また、パートナーがリードとオポチュニティを承諾または拒否し、更新して、送信できる一連のボタンも用意されています AWS。バージョン 3 のインストールについては、このガイドの前[利用可能な機能は次のとおりです。](crm-connector-feature-list.md)半の「」を参照してください。
### コネクタの最新バージョンは何ですか?
バージョン 3.0.0。これは Salesforce App Exchange にあります。
### AWS Partner CRM コネクタのセットアップにはどれくらいのコストがかかりますか?
CRM コネクタは Salesforce App Exchange AWS Partner から無料で入手できます。以下の統合オプションが用意されています。
+ AWS サービス呼び出しが無料である Partner Central API ベースの統合。
+ Amazon S3 ベースの統合。Amazon S3 バケットのコストを AWS ホストして負担します。
**注記**
このオプションは、2024 年より前に Amazon S3 統合で CRM を作成した場合にのみ使用できます。
Amazon EventBridge は、イベントが AWS サービスから送信されるため、無料です。ただし、追加の処理のためにプライマリイベントリスナーから他のイベントバスにイベントを転送すると、 AWS アカウントに追加料金が発生することがあります。
CRM コネクタの詳細については、 AWS Partner 「」を参照してください[CRM コネクタの概要](connector-overview.md)。Eventbridge の詳細については、「*Amazon EventBridge ユーザーガイド*」の「[Amazon EventBridge とは](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html)」を参照してください。
### バージョン 3 にはどのような新機能がありますか?
AWS Partner CRM コネクタが提供する機能のリストについては、このガイドの前半の[Partner Central API の機能](crm-connector-feature-list.md#partner-central-api-features)「」を参照してください。
### ファイルの送受信に使用される Amazon S3 バケットにプログラムでアクセスできますか?
はい。[CRM 統合オンボーディング](https://partnercentral.awspartner.com/partnercentral2/s/acecrmintegration)リクエストから IAM ユーザーの `AccessKey`および `SecretAccessKey`認証情報を使用します。
統合を API ベースのアプローチに移植すると、ファイルは Amazon S3 バケットを使用して転送されなくなります。ただし、リードは引き続き Amazon S3 バケットベースの統合を使用して共有されます。
### Salesforce Lightning バージョンに移行していません。 AWS Partner CRM コネクタを引き続き使用できますか?
AWS Partner CRM コネクタは Salesforce Lightning バージョンで使用するように設計されているため、バージョン 2 は意図したとおりに機能しない場合があります。
### パッケージを本稼働システムで直接使用できますか?
サンドボックス環境で徹底的にテストした後にのみ、本稼働システムにパッケージをインストールすることをお勧めします。
### AWS Partner CRM コネクタの対象ユーザーは誰ですか?
AWS Partner CRM コネクタは、次のユーザーペルソナ向けに設計されています。
+ コネクタをセットアップする Salesforce 管理者または紹介管理者。
+ オポチュニティとリードを選択、受け入れ、更新する販売オペレーションユーザー。
### ACE 統合があります。コネクタに移動できますか?
はい。既存の ACE との統合がある AWS Partnerは、コネクタに移動できます。コネクタはバックエンドで同じ Amazon S3 バケットを使用するため、次の手順を実行します。
1. Amazon S3 バケットからカスタムアプリケーションまたはソリューションを切断します。
1. AWS アカウントにサインインして統合を設定します。Amazon S3 バケットへのアクセスが許可されている IAM ユーザーのシークレットキーとアクセスキーを取得または作成します。ユーザー名は次の形式に従う必要があります: `apn-ace-{partnerName}-AccessUser-prod`。詳細については、「 *AWS Identity and Access Management ユーザーガイド*[」の「IAM ユーザーのアクセスキーを管理する](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html#Using_CreateAccessKey)」を参照してください。
**注記**
AWS アカウントが見つからない場合は、[サポートリクエスト](https://docs.aws.amazon.com/awssupport/latest/user/case-management.html)を送信します。
1. Amazon S3 バケットを指すようにコネクタを設定するには、**Setup**、**Named Credentials**、**APN API 接続**を選択します。
1. コネクタでジョブをスケジュールする前に、Amazon S3 バケット内の既存のオブジェクトを削除する[サポートリクエスト](https://docs.aws.amazon.com/awssupport/latest/user/case-management.html)を送信します。
**重要**
統合を完了し、同期スケジュールを設定する前に、このステップを完了する必要があります。
1. ターゲットオブジェクトが既存のオブジェクトと異なる場合は、既存のリードと機会のデータバックフィルを実行します。詳細については、「CRM 統合 *Production setup and backfill guide*」を参照してください。
**注記**
統合スイッチオーバー中、すべてのユーザーが Amazon S3 バケットの `Outbound`フォルダ内のキューを更新します。統合がライブになると、ユーザー更新レコードが同期されます。
### AWS Partner CRM コネクタは Salesforce 組織で安全に使用できますか?
Salesforce アプリケーションは、Salesforce と内部 AWS セキュリティレビューを実施しました。Salesforce セキュリティレビュースキャンには、次の脅威が含まれます。
+ Salesforce オブジェクトクエリ言語 (SOQL) と SQL インジェクション
+ クロスサイトスクリプティング
+ 安全でない認証プロトコルとアクセスコントロールプロトコル
+ Salesforce プラットフォームに固有のレコード共有違反やその他の脆弱性
コードレビューでは、[Salesforce Code Analyzer](https://forcedotcom.github.io/sfdx-scanner/) を使用して Salesforce コードを検査します。Salesforce Code Analyzer は、PMD、ESLint、RetireJS など、複数のコード分析エンジンを使用します。一貫性のない命名からセキュリティの脆弱性まで、潜在的な問題が多数特定されます。
レビュープロセスの詳細については、Salesforce ドキュメントの[AppExchange セキュリティレビュー](https://developer.salesforce.com/docs/atlas.en-us.packagingGuide.meta/packagingGuide/security_review_overview.htm)」を参照してください。
**注記**
パートナーアプリケーションは、Salesforce Main Services Agreement で定義されている non-Salesforce.com アプリケーションです。詳細については、「Salesforce の[契約と条件](https://www.salesforce.com/company/legal/agreements/)」を参照してください。
ここに記載されているセキュリティ要件、または発生する可能性のあるパートナーアプリケーションのセキュリティレビューにかかわらず、Salesforce はパートナーアプリケーションの品質またはセキュリティについて保証せず、お客様はパートナーアプリケーションの品質、セキュリティ、機能を評価して、お客様のインストールと使用の妥当性と適切性を判断する責任を単独で負います。
内部セキュリティ監査の対象を具体的に共有することはできませんが、Salesforce アプリが接続する統合アーキテクチャのネイティブ AWS コンポーネントを対象としており、man-in-the-middle攻撃、分散型denial-of-service緩和、暗号化標準など、さまざまな脅威モデリングシナリオをカバーしています。詳細については、サポートリクエストを送信してください。
## セットアップの問題
AWS Partner CRM コネクタの設定に関する問題の修正については、以下のセクションを展開してください。
### AWS Partner CRM コネクタを使用するための前提条件は何ですか?
CRM コネクタを使用するための前提条件については、このガイドの前[統合の前提条件](crm-integration-setting-up.md)半の「」を参照してください。
### パッケージの名前付き認証情報を設定するにはどうすればよいですか?
このガイドの[名前付き認証情報の設定](guided-setup-apis.md#api-named-credentials)後半に記載されている手順に従います。
### バージョン 2 からバージョン 3 への移行にはどのような影響がありますか? 重大な変更はありますか?
CRM コネクタのバージョン 2 からバージョン 3 AWS Partner への移行は、すぐには影響しません。すべての機能は下位互換性があり、中断することなく動作します。
オポチュニティ管理のために、新機能を使用する予定がある場合は、販売プロセスの一部を変更する必要がある場合があります。以下の変更を評価し、移行計画を作成する必要があります。
+ バージョン 3 は、 とリアルタイムで機会を共有 AWS します。オポチュニティの送信先となるスケジュールを作成する必要がなくなりました AWS。パートナーの Salesforce インスタンスのオポチュニティ所有者は、手動でデータを に送信する必要があります AWS。Salesforce ユーザーには、オポチュニティをプッシュするためのアクセス許可が必要です AWS。
+ マルチオブジェクトマッピングを使用する場合は、Salesforce インスタンスの新しいオブジェクトからデータを取得して投稿するための移行計画が必要です。Salesforce 管理者は、1 つのオブジェクトにマッピングされたすべてのフィールドと、1 つのオブジェクトにマッピングされた別のオブジェクトのフィールドとのオブジェクトマッピングから移動した場合の結果に注意する必要があります。
### Amazon S3 接続 (非同期) から API ベースの接続 (同期) に移行する場合、追加のセットアップ手順はありますか?
はい。以下の項目を完了*する必要があります*。
+ 一般的な前提条件では、[AWS Partner Central と AWS Marketplace アカウントのリンク](link-pc-mkt-accounts.md)。
+ 新しい Partner Central APIs。詳細については、このガイドの前半の「[名前付き認証情報の設定](guided-setup-apis.md#api-named-credentials)」を参照してください。
### Salesforce Lightning バージョンに移動していません。CRM Connector AWS Partner を引き続き使用できますか?
いいえ。コネクタは Salesforce Lightning バージョンで使用するように設計されており、アプリはそれがないと意図したとおりに機能しない場合があります。
### Salesforce 環境のスケジュールされたジョブの制限に達しています。外部スケジューラを使用して との同期をトリガーできますか AWS?
NEED TO VALIDATE - AWS Partner CRM Connector は マネージドパッケージです。`InboundSyncScheduler` および `OutboundSyncScheduler`apex クラスに対して、サードパーティーアプリを使用してカスタムスケジュール呼び出しを作成できます。注 - 新しい API ベースの統合では、これらのクラスが機能しない場合があります。
## 問題のマッピング
AWS Partner CRM コネクタのオブジェクトマッピングの問題の修正については、必要に応じて以下のセクションを展開してください。
### マルチオブジェクトマッピングの仕組み
バージョン 3 の場合、パートナーはマッピング中に参照されるオブジェクトのフィールドを 1 レベル下を選択できます。たとえば、Salesforce 標準オポチュニティオブジェクトに、アカウントオブジェクトとカスタム AWS セールスオブジェクトを指す内部参照がある場合、標準オポチュニティを親オブジェクトとして選択し、アカウントとセールスオブジェクトからフィールドをマッピングできます。
### マッピングタブで複数のオブジェクトを選択できますか?
いいえ。代わりに、選択したオブジェクトから複数のフィールドをマッピングします。
### コネクタは、データをマーシャリングするために使用するオブジェクトをどのように追跡しますか?
バージョン 3 では、 `APNCrmUniqueIdentifier`フィールドを使用してマッピング用に単一の親オブジェクトを参照します。フィールドには AWS レコード ID が含まれます。親オブジェクトをクエリした後、他のすべての関連オブジェクトの値は、親オブジェクトからの参照リンクに基づいてマーシャリングまたはマーシャリング解除されます。
### 特定のフィールドのタイプフィールドはどこにありますか?
コネクタのバージョン 3 は、バージョン 2 データモデルで動作します。ペイロードの詳細については、GitHub の [AWS Partner CRM Integration Samples](https://github.com/aws-samples/partner-crm-integration-samples) を参照してください。
### マネージドパッケージは、標準の Salesforce オブジェクトで検証ルールを設定するのに役立ちますか?
いいえ。 パッケージには ACE カスタムオポチュニティオブジェクトが付属しています。これには、[標準の ACE ペイロード](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Outbound-Sample.json)に対して実行されるフィールドタイプと検証ルールが含まれます。検証ルールとフィールドは、標準オブジェクトの ACE カスタムオポチュニティオブジェクトからコピーできます。*検証が必要* - マルチオブジェクトマッピングでは、標準オポチュニティオブジェクト内に ACE オポチュニティオブジェクトへの参照を追加し、トリガーを使用してそれらのフィールドにデータをコピーして検証を開始できます。
### Sync with AWS フィールドのマッピングを編集できないのはなぜですか?
**Sync with AWS** チェックボックスは、次にスケジュールされたジョブの実行 AWS 時にリードまたはオポチュニティが と同期するかどうかを決定します。Partner **Central との同期**フィールドは、標準の機会とリードのアプリに含まれています。ターゲットオブジェクトがカスタムオブジェクトの場合は、**Sync with AWS** フィールドを各オブジェクトのカスタム非式ブールフィールドにマッピングする必要があります。
### の AWS フィールドの更新はどのように機能しますか?
Has **Updates for formula AWS** フィールドは、次のスケジュールされたジョブ AWS Partner でレコードが に送信されるかどうかを決定します。次の条件が true の場合、 **の更新 AWS**が **True** に設定されます。
+ レコード**の最終更新日**が**最終 APN 同期日より**後です。
+ **最終変更ユーザーは**、統合ジョブをスケジュールしたユーザーではありません。
### 必要な APN CRM Unique Identifier フィールドをマッピングできないのはなぜですか? メニューが使用できず、「マッピングする有効なフィールドがありません」というメッセージが表示されます。
**API** フィールドの長さと一致するには、18 文字の長さの**テキスト**データ型を使用する必要があります。
+ 設定: テキスト (18) (外部 ID) (一意の大文字と小文字を区別しない)
### Salesforce から へのアウトバウンドファイルプッシュに関するコネクタアプリケーションのトラブルシューティングチェックポイントは何ですか AWS Partner?
アプリは次のチェックポイントを使用します。
+ **と同期 AWS**するには、 との同期を確認する必要があります AWS。
+ と同期するには、 **への更新 AWS**を確認する必要があります AWS。
+ スケジューリングジョブを作成するユーザーペルソナは、リードまたはオポチュニティの作成と更新に使用するユーザーペルソナとは異なる必要があります。
+ 前のチェックが true であってもアウトバウンドバッチがまだ実行されない場合は、 AWS Partner 同期ログをチェックし、**アウトバウンド IDs**列を追加します。同期ログにプッシュするオポチュニティの ID が含まれていることを確認します。同期ログが **API 成功**状態でスタックしている場合は、同期ログレコードを削除して再試行してください。
**予想月別 AWS 収益**が `1041.67`の代わりに などの整数でない場合、データ型の`1041`不一致により処理エラーが発生します。これを解決するには、**API Success** 状態でスタックしている同期ログを削除し、次のジョブ実行前にデータを修正します。
### リードと機会を同期するようにフィルターとサブスクリプションを設定できますか? ステータスフィールドまたはステージフィールドにカスタムフィルターを追加できますか?
Salesforce では、数式フィールドを作成または更新して、特定の値のステータスまたはステージフィールドから依存関係を追加できます。たとえば、 **の Has Updates AWS** を **True** に設定できます。オポチュニティに含まれるフィールドをリファレンスとして使用できます。その方法例を次に示します。
```
IF(
OR(
AND
(
OR(LastModifiedDate > awsapn_Last_APN_Sync_Date_c,LastModifiedDate = awsapn_Last_APN_Sync_Date_c),
awsapn_Sync_with_Partner_Central_c,
NOT(ISNULL(awsapn_Last_APN_Sync_Date_c))
),
AND(ISNULL(awsapn_Last_APN_Sync_Date_c),awsapn_Sync_with_Partner_Central_c)
)
, true , false
)
```
### 必須フィールドをマッピングする必要がありますか?
はい。インバウンドまたはアウトバウンドの統合ジョブをスケジュールするには、すべての必須フィールドをマッピングする必要があります。
### ルックアップフィールドをマッピングできますか?
Partner Central に現在入力しているフィールドを確認して、最も関連性の高いフィールド (必須フィールドに加えて) を決定することをお勧めします。使用可能なフィールドとその目的のリストについては、Partner Central の [ACE CRM 開発キット](https://partnercentral.awspartner.com/partnercentral2/s/resources?Id=0698a00000D11JsAAJ)に含まれている*フィールド定義ガイド*を参照してください。
### レコードを派生フィールドで更新するか、マッピングプロセス中に作成する必要がありますか?
複雑なロジックと派生は、独自のビジネスロジックに基づいて Salesforce 組織で実行し、それに基づいてマッピングされたフィールドに入力する必要があります。
## 同期と検証の問題
AWS Partner CRM コネクタとの同期と検証の問題の修正については、必要に応じて以下のセクションを展開してください。
### STORAGE\$1LIMIT\$1EXCEEDED エラーの原因は何ですか?
この問題は、ストレージが制限された開発組織でコネクタをテストするときに発生します。これを修正するには、次のクエリを実行して、コンソールから同期ログをクリアします。
`Listawsapn_Sync_Log_c syncLogs = [SELECT Id FROM awsapn_Sync_Log_c WHERE Status IN ('API Success', 'Processed') LIMIT 4000]; delete syncLogs;`
同期ログの保持期間を設定して、保持期間より古い同期ログレコードを自動的にクリーンアップすることもできます。保持期間の設定の詳細については、「」を参照してください。
### AWS が参照するリードまたは機会は、カスタムオブジェクトに適用される検証に準拠していません。この問題を修正するにはどうすればよいですか?
一部のリードと AWS 起点の機会は、各フィールドの検証ルールに準拠していません。パートナーがそのような紹介を承諾または拒否できるようにするには、レコードを受け入れる前にデータを修正できます。データ検証に準拠していないオブジェクトを承諾または拒否するには、次の手順を実行します。
1. 失敗したレコードの同期ログの詳細に移動します。
1. **ペイロードの編集**を選択して JSON ビューにアクセスします。
1. 非準拠フィールドの値を更新します。
1. **ペイロードの保存** を選択して、次のジョブの同期用にレコードを設定します。
レコードが受け入れられた場合は、残りのフィールドを受信した後、ステップ 1～4 を再度実行する必要があります AWS。以降の同期では、修正された値が使用されます。別の方法として、Partner Central の ACE パイプラインマネージャーの値を修正することもできます。
### はどのくらいの頻度でリードと機会 AWS をアップロードしますか?
AWS は、リードとオポチュニティを 1 時間ごとに Amazon S3 バケットにアップロードします。その結果、統合によるデータ更新を必要とするアクションの同期には最大 1 時間かかる場合があります。
### マッピング画面を使用するときに setFieldLengthWarning メッセージが表示されるのはなぜですか?
オブジェクトマッピングを実行するユーザーが必須フィールドへの読み取りアクセス権を持っていない場合、次の警告が表示されます。
```
pe.setFieldLengthWarning()@ -
/modules/awsapn/fieldMappingRow.js:1:7831
set salesforceFields()@- /modules/awsapn/fieldMappingRow.js:1:5624
```
ソースフィールドとターゲットフィールドへのアクセス許可を持つシステム管理者ユーザー、または [APN 統合アクセス許可セット](crm-connector-pemissions-sets.md#integration-user)を持つユーザーを使用する必要があります。
### 同期ログのステータスフィールドと目的フィールドの意味は何ですか?
各同期ログレコードの状態とアクションを確認するには、「」の表を参照してください[ログの同期](crm-connector-sync-logs-and-reports.md#sync-logs)。
### 監査またはアーカイブを提供していますか?
同期ログオブジェクトは、すべてのインバウンドトランザクションとアウトバウンドトランザクションを追跡します。アプリ設定でログレコードの保持期間を指定することもできます。
### スロットリング例外が発生するのはなぜですか?
Partner Central APIs には、公平な使用を確保し、サービスの誤用を回避する[一連のクォータ](https://docs.aws.amazon.com/partner-central/latest/APIReference/quotas.html#understanding-and-managing-quotas)があります。クォータに達した後にレート制限が開始されると、スロットリング例外が表示されることがあります。毎日のクォータはローリング 24 時間サイクルでリセットされます。デフォルトのクォータが要件を満たしていない場合は、[Service Quotas ページ](https://console.aws.amazon.com/servicequotas/home?region=us-east-1#!/dashboard)を使用してクォータの引き上げをリクエストできます。
### 標準オポチュニティに Send to AWS ボタンが表示されない
**Send to AWS** ボタンは、**パートナー紹介**の機会タイプにのみ表示されます。