翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Salesforce の AWS Partner CRM コネクタとは何ですか？
このセクションのトピックでは、Salesforce を AWS AWS Partner Central および と統合するためのノーコードソリューションである Partner CRM コネクタをインストールして使用する方法について説明します AWS Marketplace。
**Topics**
+ [CRM コネクタの概要](connector-overview.md)
+ [利用可能な機能は次のとおりです。](crm-connector-feature-list.md)
+ [コネクタのインストール](install-connector.md)
+ [コネクタを最新バージョンにアップグレードする](upgrading-from-previous-versions.md)
+ [AWS Partner Central および AWS Marketplace イベントのリアルタイム通知の設定](set-up-real-time-notifications.md)
+ [ACE オブジェクトのマッピング](crm-connector-mapping.md)
+ [CRM コネクタの設定](configure-crm-connector.md)
+ [Salesforce での CRM コネクタの使用](using-the-connector.md)
+ [Amazon S3 統合での以前の CRM の使用](custom-integration-using-amazon-s3.md)
+ [ヘルプの利用](getting-help.md)
+ [AWS Partner CRM コネクタに関するよくある質問](crm-connector-faq.md)
+ [リリースノート](crm-connector-release-notes.md)
# CRM コネクタの概要
AWS Partner CRM コネクタを使用すると、Salesforce 組織を AWS Partner Central および と統合できます AWS Marketplace。統合により、ACE オポチュニティの双方向同期やオポチュニティへのオファーのアタッチなど、AWS Partner Central および AWS Marketplace タスクを Salesforce で完了できます。
CRM コネクタは無料で利用でき、コーディングは必要ありません。
以下のトピックでは、コネクタを使用するための概念とプロセスについて説明します。
**Topics**
+ [コネクタの利点](#connector-benefits)
+ [対象ユーザー](#connector-audience)
+ [インストールと使用の概要](#connector-process)
## コネクタの利点
AWS Partner CRM コネクタには、次の利点があります。
+ **AWS Partner Central 統合** – 機会管理を合理化しました。Salesforce を使用して、セールスや他のパートナーからオポチュ AWS ニティを送受信できます。コネクタを使用すると、 にリードを送信することもできます AWS。
**注記**
からのリードを受け取るパートナーは、 AWS 引き続き Amazon S3 統合を使用します。詳細については、以下を参照してください。
[Amazon S3 との統合による CRM のコネクタの設定](s3-config.md) このセクションの後半。
[Amazon S3 統合での以前の CRM の使用](custom-integration-using-amazon-s3.md) このガイドの後半。
+ **AWS Marketplace 統合** – Salesforce を使用して、プライベートオファーの管理、認可の再販、その他の AWS Marketplace タスクの完了を行います。
## 対象ユーザー
CRM コネクタは、次のグループで使用することを目的としています。
+ 共同販売プロセスの合理化を検討しているパートナー。
+ 製品を販売する独立系ソフトウェアベンダー (ISVs) AWS Marketplace。
+ AWS クライアントのエンゲージメントと機会を管理するコンサルティングパートナー。
## インストールと使用の概要
AWS Partner CRM コネクタをインストールして使用するプロセスは、以下の広範なステップに従います。
1. [統合の前提条件](crm-integration-setting-up.md) を完了します。
1. Salesforce AppExchange からコネクタをインストールします。インストール手順については[コネクタのインストール](install-connector.md)、このセクションの後半にある「」を参照してください。
1. AWS Partner Central AWS Marketplace、以前の Amazon S3 統合とデータを交換するようにコネクタを設定します。のトピック[CRM コネクタの設定](configure-crm-connector.md)では、統合のタイプごとにコネクタを設定する方法について説明します。
# 利用可能な機能は次のとおりです。
以下のトピックでは、AWS Partner CRM コネクタが提供する機能について説明します。機能は、 AWS Partner (APN) カスタマーエンゲージメントをサポートし、機会とリードを管理し、Salesforce を と統合します AWS Marketplace。ビジネスニーズと AWS エンゲージメントモデルに合わせて、必要に応じて機能の任意の組み合わせを有効にできます。
**Topics**
+ [Partner Central API の機能](#partner-central-api-features)
+ [Amazon S3 機能を備えた CRM](#apn-customer-engagements)
+ [AWS Marketplace features](#feature-list-aws-marketplace)
## Partner Central API の機能
AWS Partner Central API には以下の機能があります。
+ パートナーがオペレーションを高速化するために使用できる一連のボタン。
+ **と共有する AWS** – オポチュニティを作成して更新します。
+ **承認ステータス** – AWS 参照されたオポチュニティを承諾または拒否します。
+ **関連付けまたは関連付け解除** — オポチュニティライフサイクル全体で、オポチュニティをパートナーソリューション、 AWS 製品、 AWS Marketplace オファーに関連付けまたは関連付け解除します。
+ **割り当て** — Partner Central アカウントの別のユーザーにオポチュニティを再割り当てします。
+ コネクタでは、パートナーは**ソリューション提供**タブを使用して利用可能なソリューションのリストを表示できます。
+ パートナーは、**AWS Marketplace 通知**タブを使用して、Amazon EventBridge によって生成されたイベントを表示できます。イベントには、*作成されたオポ*チュニティ、*更新されたオポチュ*ニティ、エンゲージメントの招待*の承諾*、エンゲージメントの招待の*拒否が含まれます*。
**注記**
AWS Partner Central API の使用を開始するには、[AWS Partner Central API リファレンス](https://docs.aws.amazon.com/partner-central/latest/crm/aws-partner-crm-integration.html)を参照してください。
Amazon S3 と以前の CRM の統合から AWS Partner Central API に移行するには、先に進む[Amazon S3 との統合による CRM から Partner Central API へのアップグレード](upgrade-crm-api.md)前に「」を参照してください。
CRM コネクタを AWS Partner Central API と統合すると、次のようになります。
+ ACE オポチュニティレコードのほぼリアルタイムの双方向同期を有効にします。
+ Amazon S3 ベースの CRM 統合を置き換えます。 は以前の統合 AWS をサポートしていますが、2024 年に新しい統合の受け入れを停止しました。
+ から ACE リードを受け取るパートナーは、 AWS 引き続き Amazon S3 ベースの統合を使用します。
AWS Partner CRM コネクタをインストールしたら、AWS Partner Central API 統合で使用するように設定します。設定の詳細については、このセクションの[Partner Central API 統合のコネクタの設定](p-c-api-integration.md)後半の「」を参照してください。
カスタム AWS Partner Central API 統合の作成については、[AWS Partner Central API リファレンス](https://docs.aws.amazon.com/partner-central/latest/APIReference/aws-partner-central-api-reference-guide.html)を参照してください。
## Amazon S3 機能を備えた CRM
CRM コネクタは、以前の CRM と Amazon S3 の統合用に設定する際に、次の機能を提供します。
+ **AWSオリジンオポ**チュニティ – Salesforce では、販売とコセルオポチュニティを交換できます AWS 。 AWS セールスがソリューションの恩恵を受ける可能性のある顧客を特定すると、機会が得られます。
+ **パートナー起点の機会** – Salesforce では、他のパートナーと共同販売の機会を交換することができます。オポチュニティを作成し、関連する にリンクできます AWS のサービス。これにより、コラボレーション作業を合理化できます。
+ **AWS リードの紹介** – これにより、 が提供するサービスに適した AWS リードを から受け取ることができます。これらのリードは、ソリューションに関心を示す潜在的な顧客である可能性があります。
+ **ダッシュボード** – Salesforce での共同販売アクティビティの一元的な概要。コネクタの設定方法に応じて、これには機会とリードが含まれる場合があります。
CRM コネクタの設定の詳細については、このガイドの[CRM コネクタの設定](configure-crm-connector.md)後半の「」を参照してください。
## AWS Marketplace features
**複数の AWS Marketplace 販売者アカウント** – Salesforce では、 AWS Marketplace 販売者アカウント のプライベートオファー、再販認可、およびその他の 関数を管理できます。
**サポートされている AWS Marketplace 製品タイプ** – コネクタは次の製品タイプをサポートしています。
+ SaaS
+ AMI
+ コンテナ
**ダッシュボード** – Salesforce でのプライベートオファーの統合概要。
### 独立系ソフトウェアベンダー (ISV) の機能
CRM コネクタはISVs に次の機能を提供します。
**一般的な機能**
+ Salesforce で、 AWS Marketplace 製品リストを表示し、製品ポートフォリオとコセリングアクティビティを管理します。
+ Salesforce で、リストされた AWS Marketplace 製品のプライベートオファーを作成および管理します。サポートされているすべてのプライベートオファーに対して柔軟な支払いスケジュールを作成します。SaaS および契約サービスの場合は、将来の日付の契約を作成します。
+ プライベートオファーをインポートすることで、コネクタの導入プロセスを高速化します。
**プライベートオファー管理機能**
+ **作成/公開** – Salesforce を使用してプライベートオファーを公開します。
+ **下**書き – プライベートオファーを公開する前に下書きとして保存します。
+ **変更** – プライベートオファーの有効期限を変更します。
+ **キャンセル – **公開されたプライベートオファーを削除します。
+ **クローン** – 新しいオファーの開始点としてプライベートオファーのコピーを作成します。
**契約管理機能**
+ **表示** – Salesforce のアクセス AWS Marketplace 契約。
+ **インポート** – からコネクタ AWS Marketplace に契約をインポートします。
**契約ベースのオファーの機能**
+ **契約ベースのオファー** – 契約を使用して、ターゲットを絞った顧客オファーを作成します。これにより、見積りと購入のプロセスを簡素化できます。
**再販承認機能**
+ **作成/公開** – 再販認可を作成し、 AWS Marketplace チャネルパートナーが製品を再販できるようにします。
+ **ドラフト** – 再販売承認リクエストを送信する前に、レビュー用に保存します。
+ **非アクティブ化** – コネクタを使用して、不要になった再販認可を非アクティブ化します。
+ **クローン** – 再販認可をクローンして、新しい再販認可の作成を高速化します。
**チャネルパートナー機能**
AWS Marketplace チャネルパートナーとして登録した場合は、共有再販認可を使用して、チャネルパートナーに製品を再販するプロセスを簡素化できます。コネクタを使用すると、次のことができます。
+ Salesforce で共有再販認可を表示します。
+ プライベートオファーと同じ管理機能を使用します: **作成/公開**、**変更**、**キャンセル**、**クローン。**
# コネクタのインストール
以下の一連のステップでは、AWS Partner Customer Relationship Management (CRM) コネクタをインストールおよびアンインストールする方法について説明します。
**Topics**
+ [コネクタのインストール](#first-install)
+ [インストールの確認](#confirm-the-installation)
+ [コネクタのアンインストール](#uninstall-connector)
+ [Salesforce のガバナー制限について](#connector-limits)
## コネクタのインストール
次の手順では、Salesforce 組織に CRM コネクタをインストールする方法について説明します。コネクタを初めてインストールし、コネクタの新しいバージョンをインストールするには、次の手順に従います。
**注記**
これらのステップを完了するには、以下が必要です。
Salesforce の Enterprise、Professional、または Unlimited エディション。
Salesforce 組織への管理アクセス。
**新しいバージョンをインストールするには**
1. **AppExchange** に移動し、**AWS パートナー CRM Connector **を検索します。
—OR—
[ https://appexchange.salesforce.com/appxListingDetail?listingId=a0N4V00000IYf0nUAD ](https://appexchange.salesforce.com/appxListingDetail?listingId=a0N4V00000IYf0nUAD)に移動します。
1. **Get it now** を選択します。
1. **このパッケージをインストールする場所**ページで、**サンドボックスにインストール**を選択します。
1. **インストールの詳細の確認**ページで、**利用規約を読んだ**チェックボックスを選択し、**確認とインストール**を選択します。
1. Salesforce にサインインします。
**注記**
必ず正しいドメインにサインインしてください。必要に応じて、**カスタムドメインの使用**を選択し、正しいドメイン名を入力します。
1. Install **for Administrators Only **オプションを選択し、**Install **を選択します。
1. **「はい」を選択し、これらのサードパーティーのウェブサイトへのアクセスを許可****「続行**」を選択します。
## インストールの確認
パッケージのインストールを確認するには、**ホーム**、**アプリ**、**パッケージ**、**インストール済みパッケージ**を選択します。
コネクタの新しいバージョンがインストール済みパッケージのリストに表示されない場合は、「」の手順に従って サポート[ヘルプの利用](getting-help.md)にお問い合わせください。
**注記**
インストールを確認したら、「」に記載されているステップを完了[コネクタを最新バージョンにアップグレードする](upgrading-from-previous-versions.md)して、最新の機能をインストールします。
## コネクタのアンインストール
AWS Partner Customer Relationship Management (CRM) コネクタをアンインストールする前に、ユーザーの [ACE 統合アクセス許可セット](crm-connector-pemissions-sets.md)と[AWS Marketplace 統合アクセス許可セット](mkt-permissions-sets.md)をすべて削除します。
**コネクタをアンインストールするには**
1. Salesforce で、**ホーム**、**アプリ**、**パッケージ**、**インストール済みパッケージ**を選択します。
1. **アンインストール** を選択します。
## Salesforce のガバナー制限について
AWS Partner CRM Connector を実装するときは、Salesforce の制限、特に SOQL クエリの消費について注意してください。これらの制限は、カスタムビジネスロジックとシステム全体のパフォーマンスに大きな影響を与える可能性があります。Salesforce の公式ドキュメントで、クエリの最適化に関する制限とベストプラクティスを確認することをお勧めします。詳細なガイダンスについては、次の Salesforce リソースを参照してください。
+ *「Apex デベロッパーガイド*」の[「Salesforce" lImits overview](https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_gov_limits.htm)」
+ [SQLS と SOSL のベストプラクティス](https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_gov_limits.htm?q=SOSL+SOQL+best+practices+limits)
# コネクタを最新バージョンにアップグレードする
以下のトピックでは、 AWS Partner CRM コネクタを最新バージョンにアップグレードする方法について説明します。アップグレードには、ボタンの追加、ログの詳細の同期、およびオポチュニティレコードへの値のマッピングが含まれます。
**注記**
Amazon S3 統合のアップグレードについては、このガイドの[Amazon S3 との統合による CRM から Partner Central API へのアップグレード](upgrade-crm-api.md)後半の「」を参照してください。
**Topics**
+ [再販売承認のインポートボタンの追加](#add-resale-authorization)
+ [オファーのインポートボタンの追加](#import-offer-btn)
+ [契約のインポートボタンの追加](#import-agreements-btn)
+ [ACE オポチュニティレコードページへの同期ログの詳細の追加](#add-sync-log-details-ace)
+ [Closed Lost Reason ラベルへのマッピング値の追加](#map-closed-lost)
## 再販売承認のインポートボタンの追加
次の手順では、オポチュ**ニティの再販承認セクションに再販承認のインポート**ボタンを追加する方法について説明します。 ****ボタンを使用すると、再販認可をインポートできます AWS Marketplace。
**ボタンを追加するには**
1. システム管理者として Salesforce 組織にサインインします。
1. **Setup、Object Manager** を選択し、**Reale authorization** を選択します。
1. 左側のナビゲーションペインで、**表示ボタンのリストレイアウト**を選択します。
1. **編集** を選択してリストビューエディタを開きます。
1. **「カスタムボタン**」セクションの**「使用可能なボタン**」列で、「再**販売承認のインポート**」を選択します。
1. 右矢印ボタンを選択して、**選択したボタン**リストに**再販売承認のインポート**を追加します。
1. **[保存]** を選択します。
バージョン 2.2 以降にアップグレードしたら、次の操作を行います。
+ 製品情報が最新であることを確認するには、製品の更新タブで**製品を更新します**。
+ このセクションの手順に従って、バージョン 2.2 への移行を完了します。
## オファーのインポートボタンの追加
次の手順では、**オファーのインポート**ボタンを追加する方法について説明します。
**ボタンを追加するには**
1. システム管理者として Salesforce 組織にサインインします。
1. **Setup、Object Manager** を選択します。
1. **プライベートオファー**を選択します。
1. 左側のナビゲーションペインで、**表示ボタンのリストレイアウト**を選択し、**編集**を選択してリストビューエディタを開きます。
1. **「カスタムボタン**」セクションの**「使用可能なボタン**」列で、**「オファーのインポート**」を選択します。
1. 右矢印ボタンを選択して、**選択したボタン**リストに**インポートオファー**を追加します。
1. **[保存]** を選択します。
## 契約のインポートボタンの追加
次の手順では、**契約インポート**ボタンをオポチュニティレコードの**契約**セクションに追加する方法について説明します。
**ボタンを追加するには**
1. システム管理者として Salesforce 組織にサインインし、**Setup**、Object **Manager **を選択します。
1. **「契約**」を選択し、**「詳細**」セクションで**「編集**」を選択します。
1. **検索を許可する** を選択します。
1. **[保存]** を選択します。
1. 左側のナビゲーションペインで、**表示ボタンのリストレイアウト**を選択します。
1. **「カスタムボタン**」セクションの**「使用可能なボタン**」列で、**「契約のインポート**」を選択し、「右矢印」ボタンを選択して、**「選択したボタン**」リストに**インポート契約**を追加します。
1. **[保存]** を選択します。
## ACE オポチュニティレコードページへの同期ログの詳細の追加
次の手順では、ACE オポチュニティレコードページに同期ログの詳細を追加する方法について説明します。
**ログの詳細を追加するには**
1. システム管理者として Salesforce 組織にサインインします。
1. **Setup、Object Manager** を選択します。
1. **ACE オポチュニティ**を選択します。
1. 左側のナビゲーションペインで、**ACE オポチュニティレイアウト**を選択します。
1. **関連リスト**を選択します。
1. **同期ログの詳細**を選択して、ページレイアウトの**関連リスト**セクションに移動します。
1. **[保存]** を選択します。
1. **同期ログの詳細**の関連リストをカスタマイズし、**作成日**、**エラーメッセージ**、**ステータス**フィールドを**関連リストに追加します**。詳細については、Salesforce ヘルプの[「関連リストのカスタマイズ](https://help.salesforce.com/s/articleView?id=sf.customizing_related_lists.htm)」を参照してください。
1. **[保存]** を選択します。
**注記**
CRM コネクタのバージョン 2.2 では、ACE オポチュニティのパス AWSが提供されます。パスの表示については、Salesforce ヘルプの[「パスを有効にする](https://help.salesforce.com/s/articleView?id=sf.emergency_response_create_paths.htm)」を参照してください。
## Closed Lost Reason ラベルへのマッピング値の追加
次の手順では、ACE オポチュニティオブジェクトの **Closed Lost Reason** ラベルに自動フィールドマッピング値を追加する方法について説明します。
**マッピング値を追加するには**
1. システム管理者として Salesforce 組織にサインインします。
1. **ACE マッピングタブ**を選択します。
1. ナビゲーションバーで、**オポチュニティ**を選択します。
1. **オブジェクトセレクタ**で、**ACE オポチュ**ニティを選択します。
1. Closed **Lost Reason** ラベルで、**Edit Values** を選択します。
1. **Auto Map** を選択します。
1. [**次へ**] を選択します。
1. **[保存]** を選択します。
# AWS Partner Central および AWS Marketplace イベントのリアルタイム通知の設定
以下のトピックでは、 AWS Partner Central イベントと イベントのリアルタイム EventBridge 通知を設定する方法について説明します。 AWS Marketplace Salesforce で通知を設定するには、接続されたアプリを設定するか、 AWS CloudFormation テンプレートを使用できます。
**Topics**
+ [Salesforce 接続アプリケーションの設定](#configuring-salesforce-connected-app)
+ [AWS CloudFormation スタックを使用した通知の設定](#configuring-aws-components)
## Salesforce 接続アプリケーションの設定
次の手順では、Salesforce で接続されたアプリを設定する方法について説明します。送信先接続に OAuth 認証を使用するには、接続されたアプリを作成する必要があります。詳細については、このガイドの後半にある[通知コンポーネントを手動で作成する](#manual-creation-of-aws-components)「」を参照してください。
1. システム管理者として Salesforce 組織にサインインします。
1. Setup から****、**Quick Find** ボックスに「」と入力し**apps**、**App Manager** を選択します。
1. **Lightning Experience App Manager** ページで、 **新しい接続されたアプリ**を選択し、**接続されたアプリの作成**を選択し、**続行**を選択します。
**新しい接続されたアプリ**ページが表示されます。
1. 以下の操作を実行します。
1. **接続されたアプリケーション名** ボックスに、アプリケーションの名前を入力します。
1. **連絡先 E** メールボックスに、E メールアドレスを入力します。
1. (オプション) Salesforce ドキュメントの[「基本的な接続アプリケーション設定を構成する](https://help.salesforce.com/s/articleView?id=sf.connected_app_create_basics.htm)」の説明に従って、残りのフィールドに入力します。
1. **OAuth 設定を有効にする**チェックボックスを選択し、次の操作を行います。
1. **デバイスフローを有効にする**チェックボックスをオンにします。結果のコールバック URL は無視できます。
1. **「利用可能な OAuth スコープ****APIs 経由でユーザーデータを管理する**を選択し、**追加**ボタンを使用してスコープを選択したスコープのリストに移動します。
1. 次のチェックボックスをオンにします。
+ **サポートされている認可フローのコード交換 (PKCE) 拡張に証明キーを要求する**
+ **ウェブサーバーフローにシークレットを要求する**
+ **更新トークンフローにシークレットを要求する**
+ **クライアント認証情報フローを有効にする**
1. **クライアント認証情報フローの有効化**を選択した後に表示されるメッセージで、**OK** を選択します。
1. ページの下部までスクロールし、[**保存**] を選択します。
1. **Continue** を選択し、**Manage Consumer Details** を選択します。
**ID の検証**ページが表示され、システムは確認コードを連絡先の E メールアドレスに送信します。
1. 検証コードボックスに**検証コード**を入力し、**検証**を選択します。
接続されたアプリのページが表示されます。
1. **コンシューマーの詳細**で、コンシューマーキーとカスタマーシークレット**のコピー**ボタンを選択します。
1. Setup の******「Quick Find**」ボックスに「Apps」と入力し、**「Manage Connected Apps**」を選択し、先ほど作成した接続アプリを選択します。 ****
1. **ポリシーの編集**を選択し、次の操作を行います。
1. **許可されたユーザー** リストから、**すべてのユーザーが自己承認できる** を選択します。
1. **IP 緩和**リストから、**IP 制限の適用**を選択します。
1. **Run As** リストから、*実行ユーザー*、クライアント認証情報フローを割り当てるユーザーを選択します。Salesforce では、実行ユーザーがユーザーに代わってアクセストークンを返す必要があります。
1. **[保存]** を選択します。
## AWS CloudFormation スタックを使用した通知の設定
以下のトピックでは、 AWS CloudFormation テンプレートを使用してリアルタイムの EventBridge 通知を設定する方法について説明します。ステップは、CRM コネクタのバージョン 3.0 AWS Partner 以降にのみ適用されます。
AWS Partner CRM コネクタバージョン 3.0 以降では、 CloudFormation テンプレートを使用して Amazon EventBridge 統合の AWS コンポーネントを設定するか、コンポーネントを手動で作成できます。を使用するには CloudFormation、以下からテンプレートをダウンロードします。
**Topics**
+ [ドメイン URL の検索](#find-domain-url)
+ [CloudFormation スタックの使用](#downloading-templates)
+ [通知コンポーネントを手動で作成する](#manual-creation-of-aws-components)
+ [ルールの例](#example-rules)
### ドメイン URL の検索
CloudFormation テンプレートは、ドメイン URL を必須パラメータの 1 つとして使用します。
**URL を検索するには**
1. Salesforce にサインインします。
1. Setup ****セクションの **Quick Find** ボックスで、 と入力します**my domain**。
1. 左側のペインの**会社設定**で、**My Domain** リンクを選択します。
1. **現在のドメイン URL** ボックスにアドレスをコピーします。
**注記**
CloudFormation テンプレートに URL を入力するときは、https:// プレフィックスを使用する必要があります。
### CloudFormation スタックの使用
以下のトピックのステップでは、リアルタイム通知を設定する CloudFormation スタックを作成してデプロイする方法について説明します。
1. 次のテンプレートをダウンロードします。
**注記**
各テンプレートを個別にデプロイし、両方の同じステップに従います。
+ Partner Central API 統合: [https://servicecatalogconnector.s3.amazonaws.com/APIDestinationCFT\$1PCAPI.json](https://servicecatalogconnector.s3.amazonaws.com/APIDestinationCFT_PCAPI.json)
+ (オプション) AWS Marketplace 統合: [https://servicecatalogconnector.s3.amazonaws.com/APIDestinationCFT\$1AWSMP.json](https://servicecatalogconnector.s3.amazonaws.com/APIDestinationCFT_AWSMP.json)
1. AWS コンソールで、 AWS Marketplace 販売者アカウントにサインインし、**バージニア北**部で実行されていることを確認します。EventBridge は、そのリージョンでのみ動作します。
1. コンソールで を検索し**cloudformation**、 CloudFormation コンソールを開きます。
1. **スタック**ページで、**スタックの作成**を選択します。
1. **既存のテンプレートの選択**と**テンプレートファイルのアップロードの**ラジオボタンを選択します。
1. **ファイルの選択** を選択してダウンロードしたテンプレートを開き、次**へ** を選択します。
1. **スタックの詳細の指定** ページで、次のように入力します。
+ **スタック名** – スタックの名前を入力します。
+ **クライアント ID** – 接続されたアプリケーションの作成時にメモしたコンシューマーキーを入力します。
+ **クライアントシーク**レット – 接続されたアプリの作成時にメモしたコンシューマーシークレットを入力します。
+ **ドメイン URL** – 次の形式を使用します。 **https://*domain\$1URL*.**
完了したら、[**次へ**] を選択します。
1. **スタックオプションの設定**ページで、末尾までスクロールし、**IAM リソースを作成する AWS CloudFormation 可能性がある I acknowledge **チェックボックスを選択し、**Next** を選択します。
1. [**Submit**] を選択してください。
正常にデプロイされると、テンプレートは API 送信先、接続、イベントルール、デッドレターキューを作成します。
### 通知コンポーネントを手動で作成する
次の手順では、EventBridge 通知のコンポーネントを手動で作成する方法について説明します。
**Topics**
+ [Amazon EventBridge API の送信先と接続を作成する](#manual-destination-connection)
+ [EventBridge ルールを作成して API 送信先に接続する](#create-connect-ev-rule)
+ [変更セットイベントの作成](#change-set-events)
+ [オファーリリースイベントの作成](#offer-released-events)
+ [オポチュニティイベントの作成](#opportunity-events)
+ [イベントのタイプ](#types-of-events)
+ [イベントの例](#example-event)
#### Amazon EventBridge API の送信先と接続を作成する
EventBridge で API 送信先と接続を作成するには、新しい接続を使用する API 送信先を作成します。この場合、API 送信先は Salesforce への REST API 呼び出しで、イベントを公開し直します。接続には、API コールの認証情報が含まれます。接続は、いくつかの認可方法を受け入れます。
**前提条件**
API 送信先接続に OAuth 認可を使用するには、Salesforce で接続されたアプリケーションを作成します。これを行うには、Salesforce ドキュメントの[OAuth 2.0 クライアント認証情報フローの接続アプリケーションを設定する](https://help.salesforce.com/s/articleView?id=sf.connected_app_client_credentials_setup.htm)」のステップに従います。API 送信先接続には、接続されたアプリのコンシューマーキーとシークレットを使用します。
EventBridge コンソールで API 送信先を作成するには:
+ *「Amazon EventBridge * [ユーザーガイド」の「API 送信先を作成する](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-api-destinations.html#eb-api-destination-create)」の手順に従います。
+ Salesforce に固有の設定をセットアップします。
Salesforce の**「My Domain**」ページの**「Setup**」で、組織のドメイン名を書き留めます。これを使用して、EventBridge コンソールで API の送信先と接続を設定します。以下では、その手順を説明します。
**送信先と接続を作成するには**
1. [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/) で EventBridge コンソールを開き、左側のナビゲーションペインで **API 送信先**を選択します。
1. **API 送信先**テーブルまで下にスクロールし、**API 送信先の作成**を選択します。
**API 送信先の作成**ページが表示されます。
1. 次の情報を入力します。
1. API 送信先**の名前**。最大 64 文字の大文字または小文字、数字、ドット (.)、ダッシュ (-)、またはアンダースコア (\$1) を使用できます。
この名前は、現在のリージョンのアカウントで一意であることが必要です。
1. (オプション) API 送信先**の説明**を入力します。
1. **API 送信先エンドポイント**の場合は、次の URL を使用します: **https://*my-salesforce-domain-name*.my.salesforce.com/services/data/v58.0/sobjects/*event-api-name***。
1. **[HTTP メソッド]** で、**[POST]** を選択します。
1. **接続設定**で、**新しい接続の作成**を選択し、次の操作を行います。
1. 名前とオプションの説明を入力します。
1. **送信先タイプ**で、**その他**を選択します。
1. **OAuth クライアント認証情報**を選択します。
1. **認可エンドポイント**の場合は、事前入力されたエンドポイントを受け入れます。
—OR—
本番稼働用組織を使用する場合は、入力されたエンドポイントを次の URL に置き換えます。
**https://*my-salesforce-domain-name*.my.salesforce.com/services/oauth2/token**
1. **[HTTP メソッド]** で、**[POST]** を選択します。
1. **クライアント ID** には、Salesforce の接続されたアプリのコンシューマーキーを入力します。
1. **クライアントシーク**レットには、Salesforce の接続されたアプリからコンシューマーシークレットを入力します。
1. 次の OAuth 値を追加します。
+ **パラメータ**: 本文フィールド
+ **キー**: grant\$1type
+ **値**: client\$1credentials
1. **[作成]** を選択します。
**注記**
Salesforce 組織が API アクセスに多要素認証を使用している場合、ユーザーは Salesforce APIs にアクセスするには 2 番目の認証チャレンジを完了する必要があります。詳細については、Salesforce ドキュメントの[「API アクセスの多要素認証サインイン要件を設定する](https://help.salesforce.com/s/articleView?id=sf.security_require_2fa_api.htm&language=en_US&type=5)」を参照してください。
API 送信先を作成したら、ターゲットを送信先として使用するルールを作成できます。
#### EventBridge ルールを作成して API 送信先に接続する
EventBridge ルールは、イベントバスから API 送信先にイベントをルーティングします。これにより、REST 呼び出しを実行してイベントを Salesforce に発行し直します。
EventBridge ルールの詳細については、[「Amazon EventBridge ユーザーガイド」の「イベントに対応する Amazon EventBridge ルールの作成](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html)」を参照してください。 * EventBridge *
#### 変更セットイベントの作成
次の手順では、変更セットイベントを作成する方法について説明します。
1. [Amazon EventBridge](https://docs.aws.amazon.com/marketplace/latest/userguide/seller-eventbridge.html#events-changesets) で、 **ルール**を選択します。
1. リストから、目的のイベントバスを選択します。
1. **** セクションで、**ルールの作成** を選択します。
1. ルールの名前を入力し、次 **へ**を選択します。
1. **イベントパターン**で、**カスタムパターン (JSON エディタ)** を選択し、次のフィルターを入力します。詳細タイプの任意の組み合わせを使用できます。
```
{
"source": [
"aws.marketplacecatalog"
],
"detail-type": [
"Change Set Succeeded",
"Change Set Failed",
"Change Set Cancelled"
]
}
```
イベントパターンマッチングの詳細については、 ドキュメントの[「Amazon EventBridge イベントパターンでのコンテンツフィルタリング](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns-content-based-filtering.html) AWS 」を参照してください。
1. [**次へ**] を選択します。
1. **ターゲットの選択**で、**ターゲット 1 **で **EventBridge API の送信先**を選択します。
1. リストから、先ほど作成した API 送信先を選択します。
1. **[追加の設定]** を展開します。
1. **ターゲット入力の設定** で、**入力トランスフォーマー**を選択し、**入力トランスフォーマーを設定します**。これにより、元のイベントの詳細セクションの Salesforce イベントフィールドのみが送信されます。
入力パスは次の条件を満たす必要があります。
```
{
"Name": "$.detail-type",
"awsapn__Account_Number__c": "$.account",
"awsapn__EntityId__c": "$.detail.ChangeSetId"
}
```
テンプレートは次の条件を満たす必要があります。
```
{
"Name": Name,
"awsapn__Account_Number__c": awsapn__Account_Number__c,
"awsapn__EntityId__c": awsapn__EntityId__c
}
```
1. **次へ**、次**へ** を選択します。
1. ルールを確認し、**ルールの作成**を選択します。
**注記**
API 送信先のトラブルシューティングを行うには、Amazon SQS コンソールを使用してデッドレターキューをターゲットに追加します。キューは、配信できなかったメッセージとエラーを受け取ります。Amazon SQS コンソールから、キュー内のメッセージをポーリングしてエラーを検出できます。詳細については、[「Amazon SQS ユーザーガイド」の「デッドレターキューを使用して EventBridge で未配信のイベントを処理する](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rule-dlq.html)」および「Amazon SQS でのメッセージの受信と削除」を参照してください。 [ Amazon SQS](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-using-receive-delete-message.html) *Amazon SQS *
#### オファーリリースイベントの作成
次の手順では、オファーリリースイベントを作成する方法について説明します。
1. [Amazon EventBridge](https://docs.aws.amazon.com/marketplace/latest/userguide/seller-eventbridge.html#events-changesets) コンソールで、 **ルール**を選択します。
1. リストから目的のイベントバスを選択します。
1. **** セクションで、**ルールの作成** を選択します。
1. ルールの名前を入力し、次 **へ**を選択します。
1. **イベントパターン**でカスタム**パターン (JSON エディタ)** を選択し、次のフィルターを入力します。
```
{
"source": [
"aws.marketplacecatalog"
],
"detail-type": [
"Offer Released"
]
}
```
イベントパターンマッチングの詳細については、[「Amazon EventBridge ユーザーガイド」の「Amazon EventBridge イベントパターンでのコンテンツフィルタリング](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns-content-based-filtering.html)」を参照してください。 EventBridge
1. [**次へ**] を選択します。
1. **ターゲットの選択**で、**ターゲット 1 **で **EventBridge API 送信先**を選択し、リストを開き、先ほど作成した API 送信先を選択します。
1. **[追加の設定]** を展開します。
1. **Configure Target Input** Select **Input Transformer** で、**Configure Input Tansformer** を選択します。このステップでは、最上位の Amazon イベントフィールドが Salesforce に送信されないようにします。元のイベントの詳細セクションの Salesforce イベントフィールドを含む部分のみが送信されます。
次の入力パスを使用します。
```
{
"Name":"$.detail-type",
"awsapn__Account_Number__c":"$.account",
"awsapn__EntityId__c":"$.detail.offer.id",
"awsapn__Manufacturer_Account_Id__c":"$.detail.manufacturer.accountId",
"awsapn__Product_Id__c":"$.detail.product.id",
"awsapn__Seller_Account_Id__c":"$.detail.sellerOfRecord.accountId"
}
```
以下のテンプレートを使用してください。
```
{
"Name": Name,
"awsapn__Account_Number__c": awsapn__Account_Number__c,
"awsapn__EntityId__c": awsapn__EntityId__c,
"awsapn__Seller_Account_Id__c": awsapn__Seller_Account_Id__c,
"awsapn__Manufacturer_Account_Id__c": awsapn__Manufacturer_Account_Id__c,
"awsapn__Product_Id__c": awsapn__Product_Id__c
}
```
1. **Next** を選択し、次に **Next** を選択します。
1. ルールを確認し、 **ルールの作成**を選択します。
**注記**
API 送信先の実行のトラブルシューティングに役立つように、Amazon SQS デッドレターキューをターゲットに追加します。キューは、エラーとともに配信できなかったメッセージを受信します。その後、メッセージをポーリングしてエラーを表示できます。詳細については、 AWS ドキュメントの[「イベント再試行ポリシー」および「デッドレターキューの使用](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rule-dlq.html)」および[「メッセージの受信と削除 (コンソール)](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-using-receive-delete-message.html)」を参照してください。
#### オポチュニティイベントの作成
オポチュニティイベントは、オポチュニティのステータスまたは詳細の変更に関するリアルタイムの通知を提供します。
[AWS SDKs](https://docs.aws.amazon.com/partner-central/latest/selling-api/opportunity-events.html#aws-eventbridge) を使用して EventBridge ルールをプログラムで作成および管理することもできます。
#### イベントのタイプ
次のリストは、パートナーがオポチュニティを使用する際に生成されるイベントタイプを示しています。リンクをクリックすると、各イベントの API ドキュメントが表示されます。
+ オ[ポチュニティの作成:](https://docs.aws.amazon.com/partner-central/latest/selling-api/selling-api-events.html#opportunity-created) – 新しいオポチュニティが作成されるとトリガーされます。
+ [オポチュニティの更新](https://docs.aws.amazon.com/partner-central/latest/selling-api/selling-api-events.html#opportunity-updated) – オポチュニティが更新されるとトリガーされます。
+ [エンゲージメント招待の作成 – ](https://docs.aws.amazon.com/partner-central/latest/selling-api/selling-api-events.html#invitation-created)オポチュニティの作成時にトリガーされます。
+ [エンゲージメントの招待の承諾 – ](https://docs.aws.amazon.com/partner-central/latest/selling-api/selling-api-events.html#invitation-accepted)パートナーが AWS エンゲージメントの招待を受け入れ、機会に対する とのコラボレーションへの関心を確認する AWS と トリガーされます。
+ [エンゲージメントの招待が拒否されました – ](https://docs.aws.amazon.com/partner-central/latest/selling-api/selling-api-events.html#invitation-rejected)オポチュニティが拒否されるとトリガーされます。
#### イベントの例
```
{
"version": "1",
"id": ""d1example-0c9c-4655-15bf-c5exampleb08",
"source": "aws.partnercentral-selling",
"detail-type": "Opportunity Created",
"time": ""2023-10-28T13:31:05Z",
"region": ""us-east-1",
"account": ""123456789123",
"detail": {
"schemaVersion": "1",
"catalog": "AWS",
"opportunity": {
"identifier": ""O1234567",
"url": "Partner Central Opportunity Page URL"
}
}
}
```
### ルールの例
次の表は、前のセクションにリストされたイベントで使用できる EventBridge ルールの例を示しています。ルールはイベントバスから API 送信先にイベントをルーティングします。これにより、REST 呼び出しを実行してイベントを Salesforce に発行します。
| イベントタイプ | 例 |
| --- | --- |
| **作成されたオポチュニティ** | {
"source": ["aws.partnercentral-selling"],
"detail-type": ["Opportunity Created"],
"detail": {
"catalog": ["AWS"]
}
} |
| **オポチュニティの更新** | {
"source": ["aws.partnercentral-selling"],
"detail-type": ["Opportunity Updated"],
"detail": {
"catalog": ["AWS"]
}
} |
| **エンゲージメントの招待が作成されました** | {
"source": ["aws.partnercentral-selling"],
"detail-type": ["Engagement Invitation Created"],
"detail": {
"catalog": ["AWS"]
}
} |
| **エンゲージメントの招待が承諾されました** | {
"source": ["aws.partnercentral-selling"],
"detail-type": ["Engagement Invitation Accepted"],
"detail": {
"catalog": ["AWS"]
}
} |
| **エンゲージメントの招待が拒否されました** | {
"source": ["aws.partnercentral-selling"],
"detail-type": ["Engagement Invitation Rejected"],
"detail": {
"catalog": ["AWS"]
}
} |
| **すべてのイベント** | {
"source": ["aws.partnercentral-selling"],
"detail": {
"catalog": ["AWS"]
}
} |
# ACE オブジェクトのマッピング
CRM コネクタは **ACE マッピング**ページを提供します。このページでは、Salesforce 組織と AWS Partner Network (APN) の間でオブジェクトとフィールドをマッピングできます。
以下のセクションでは、オブジェクトマッピングを作成する方法について説明します。
**Topics**
+ [ACE マッピングページの使用](mapping-page.md)
+ [マルチオブジェクトマッピング](multi-object-mappings.md)
+ [ピックリストマッピング](picklist-mapping.md)
+ [ACE オブジェクトと Salesforce オブジェクトのマッピング](#mapping-guidance)
+ [ログとレポートの同期](crm-connector-sync-logs-and-reports.md)
# ACE マッピングページの使用
AWS Partner Central には、**ACE マッピング**ページに移動する以下の方法があります。
+ アプリランチャーから、**AWS パートナー CRM コネクタ**を検索して選択します。
+ **ACE マッピングタブ**を選択します。
—OR—
**ガイド付きセットアップ**タブを選択し、**マップリードと機会**セクションで**開始**または**レビュー**を選択します。
**ACE マッピング**ページで、左側のナビゲーションペインを使用して、オポチュニティマッピングとリードマッピングを切り替えます。**オブジェクトセレクタ**を使用して、APN リードとオポチュニティをマッピングするソースオブジェクトを選択します。オブジェクトセレクタは、標準オポチュニティ、リードオブジェクト、カスタムオブジェクトのマッピングをサポートします。**マッピングビュー**フィルターと**タイプビュー**フィルターを使用して、マッピングされたフィールド、マッピングされていないフィールド、必須フィールド、およびオプションのフィールドを切り替えます。
**ACE マッピング**ページで、 オブジェクトの**AWS フィールド**列には、対応するターゲット APN フィールドが表示されます。**Salesforce フィールド**は、パートナーの組織内の選択したオブジェクトのソースフィールドです。**Salesforce フィールド**はフィルタリングされ、組織内で使用可能な該当するデータ型のみが表示され、対応する APN フィールドにマッピングされます。たとえば、APN のテキストフィールドは、パートナーの組織内のテキスト (文字列) フィールドにのみマッピングできます。
パートナーは、APN によってフィールドが更新されたくない場合に、マッピングされたフィールドのインバウンド更新を制御できます。これを行うには、**インバウンド更新の有効化**トグルを **False** に設定します。
one-to-oneマッピングでは、関連するソースフィールドを選択し、**保存**を選択します。
# マルチオブジェクトマッピング
マルチオブジェクトマッピングを使用すると、パートナーは AWS フィールドをオポチュニティやリードなどのプライマリソースオブジェクト、およびプライマリソースに関連する Salesforce オブジェクトにマッピングできます。
**注記**
マルチオブジェクトマッピングを使用する場合は、次の点に注意してください。
Salesforce オブジェクトをオポチュニティ`Account`オブジェクトとのmulti-object-mappingに使用する場合は、オポチュニティを受信するように [ACE カスタム設定](guided-setup-apis.md#api-sys-config-settings)`Default Account`で を設定する必要があります。
オポチュニティを受け取るときに、選択したオブジェクト以外の`Opportunity`オブジェクトにマッピングする場合は、関連するオブジェクトをオポチュニティレコードにリンクする必要があります。
たとえば、初めて AWS 紹介を受け取る場合、ACE カスタム設定`Default Account`で を設定*しない限り*、挿入されたオポチュニティにはマッピングされたオブジェクトの関連 IDs はありません。デフォルトのアカウントを設定すると、紹介には選択したオポチュニティまたはアカウントオブジェクトの IDs が含まれます。それ以外の場合、マッピングされたフィールド値は挿入されません。その場合は、関連するオブジェクト ID を追加する機会を変更し、**同期 AWS**を選択する必要があります。が Salesforce にオポチュニティを AWS プッシュバックすると、マッピングされたオブジェクトのフィールドは更新されます。これは、オブジェクトの関連 ID への参照があるためです。
カスタム設定で**デフォルトアカウントのクローン**オプションを選択します。これにより AWS 、 は必要に応じて、特にアカウントフィールドをプライマリオブジェクトにマッピングする場合に、デフォルトのアカウントのクローンを作成できます。
**関連するオブジェクトをマッピングするには**
1. Salesforce で、**ACE マッピング**タブに移動し、オポチュニティまたはリードを選択します。
1. **オブジェクト**セレクタから、ソースオブジェクトを選択します。
**Salesforce フィールド**列が表示され、関連するオブジェクトを含むフィールドの末尾に **>** 記号が表示されます。
1. **>** 記号を選択して、そのフィールドの関連オブジェクトのリストを展開します。
1. フィールドにマッピングする AWS フィールドを選択します。
1. **[保存]** を選択します。
# ピックリストマッピング
ピックリストダイアログボックスでは、パートナーのピックリストフィールドと APN 間の制限付きマッピングと拡張マッピングが可能です。提供された**カスタム ****ACE オポチュニティオブジェクト を使用する場合、ACE マッピング**ページには Auto Map 関数もあります。オブジェクトの詳細については、このガイドの[標準 Salesforce オブジェクトまたはカスタムオブジェクトの使用](crm-connector-mapping.md#custom-ace-opportunity-object)後半の「」を参照してください。
パートナーのフィールド値と APN の間に完全一致が見つかった場合、それらの値は自動的にマッピングされます。拡張マッピングのオプションを使用すると、パートナーは単一の APN 値を複数のソースにマッピングし、追加のターゲットマッピングを設定し、デフォルトのマッピングを設定できます。
## 制限付きマッピング
1. **ACE マッピング**ページで、ソースフィールドを選択し、**マップ値**を選択します。
マッピングダイアログボックスが表示されます。
1. **ステップ 1: プライマリ APN 値**で、対応する ACE パイプラインマネージャーの自動**マップ**または Salesforce 値を選択し、**保存**を選択します。
1. 必要に応じてステップ 1 と 2 を繰り返して、すべての ACE パイプラインマネージャー値をマッピングします。
1. マッピングダイアログボックスを閉じるには、**閉じる**を選択します。
パートナーには、値マッピングが保存されたという確認メッセージが表示されます。
## 拡張マッピング
1. 同じソース値が複数の APN 値にマッピングされている場合は、前述のようにマッピングを続行します。
1. **プライマリ APN 値**タブで、複数の APN 値に対して同じ値マッピングを選択します。
1. マッピングされていない値がパートナーの組織に存在する場合、**追加の APN 値**タブを使用すると、追加の値を APN にマッピングできます。これにより、パートナーは組織内のすべての適用可能な値が適切な APN 値にマッピングされます。
1. パートナーの組織内の 1 つの値が複数の APN 値にマッピングされている場合は、**セカンダリ APN 値**タブを使用してアウトバウンド統合のデフォルト値を設定します。
## ACE オブジェクトと Salesforce オブジェクトのマッピング
以下のセクションでは、ACE および Salesforce のカスタムオブジェクトをオブジェクトマップにマッピングする方法について説明します。
### ACE AWS オポチュニティカスタムオブジェクトの使用
バージョン 2.0 以降の CRM コネクタには、ACE カスタムオポチュニティオブジェクトが含まれています。オブジェクトを使用して、Salesforce で AWS オポチュニティを管理できます。
**ACE マッピング**ページでカスタムオブジェクトを使用する場合、パートナーは Salesforce AWS フィールドにフィールドを自動的にマッピングできます。さらに、カスタムオポチュニティオブジェクトは新しい ACE データモデルと連携し、ユーザーが新しいオポチュニティを送信するのに役立つ検証がユーザーインターフェイスに組み込まれています。
カスタム ACE オポチュニティオブジェクトを使用するには、次の手順を実行します。
1. Salesforce で、**ACE マッピング**ページに移動し、左側のナビゲーションペインから**オポチュ**ニティを選択します。
1. **オブジェクトセレクタ**で、**ACE オポチュニティ **を選択します。
1. Salesforce フィールドを AWS フィールドにマッピングするには、**Auto Map ACE オブジェクト**ボタンを選択します。
### 標準 Salesforce オブジェクトまたはカスタムオブジェクトの使用
パートナーは、Salesforce 標準オポチュニティオブジェクトまたは独自のカスタムオポチュニティオブジェクトを使用できます。ACE 同期の失敗を回避するには、カスタムオポチュニティオブジェクトに、関連するすべての ACE 必須フィールドまたは条件付き必須フィールドが含まれていることを確認します。マッピングされた AWS フィールドのデータ型は、カスタムオブジェクトで作成された Salesforce フィールドと同じデータ型である必要があります。データ型が一致しない場合、フィールドは ACE マッピング画面に表示されません。たとえば、テキストフィールド **customerCompanyName** は、標準またはカスタムオポチュニティオブジェクトのテキスト (文字列) フィールドにのみマッピングできます。必要なデータ型については、ACE オポチュニティフィールドを参照してください。
標準の Salesforce オブジェクトまたはカスタムオブジェクトを使用するには、次の手順を実行します。
1. **ACE マッピング**ページに移動し、左側のナビゲーションペインから**オポチュ**ニティを選択します。
1. **オブジェクトセレクタ**で、オブジェクトを選択します。
1. 対応するフィールドに対して必要な Salesforce AWS フィールドを選択してマッピングを完了し、**保存**を選択します。
**注記**
Auto Map 機能は、ACE オポチュニティカスタムオブジェクトでのみ使用できます。
# ログとレポートの同期
以下のトピックでは、 AWS Partner CRM コネクタアプリケーションで同期ログとレポートを使用する方法について説明します。トピックには、ログタイプとレポートタイプ、およびそれらに含まれるデータも一覧表示されます。
**Topics**
+ [ログの同期](#sync-logs)
+ [レポート](#reports)
## ログの同期
コネクタアプリの**同期ログ**タブには、インバウンドおよびアウトバウンドの APN 同期の同期レコードのステータスが表示されます。タブを使用して、正常な同期を検証し、同期エラーをトラブルシューティングします。
含まれているリストビューを使用して、**インバウンド**と**アウトバウンド**の同期ログを切り替えます。
+ **インバウンドオーケストレーション** – APN から利用可能なインバウンドレコードをチェックするジョブを示します。
+ **インバウンドオーケストレーションレコードの取得** – APN から保留中のインバウンドレコードを取得して処理するジョブを示します。
+ **アウトバウンドオーケストレーション** – が保留中のアウトバウンドトランザクションを組織から APN に送信するジョブを示します。
**同期ログ**レコードページには、同期ジョブのステータス、ペイロード内のレコード数、正常に処理されたレコード数、エラーが発生したレコード数が表示されます。
関連する**同期ログ**の詳細には、同期ジョブの一部として処理された個々のレコードの詳細と、個々のステータスが表示されます。以下の表では、各タイプのログファイルとその関連コンテンツについて説明します。
### ログタイプ
| **目的** | **定義** |
| --- | --- |
| アウトバウンドファイルの取得 | アウトバウンドジョブが頻度と、保留中の新しいレコードセットを同期する必要があるかどうかに基づいて実行されるときに作成されます AWS。ログは、レコードがアウトバウンド同期の次のフィルター仕様と一致する必要がある場合にのみ作成されます。 `Updates for AWS` `true`と `Last Sync Date` は null、 `Last Sync Date`は より前`Last Modified Date`、 `Last Modified By`は同期ジョブをスケジュールしたユーザーです。 |
| インバウンドファイルの取得 | インバウンド同期スケジュールに基づいて作成されます。ログには、保留中のインバウンドトランザクションをチェックするコールアウトが一覧表示されます AWS。 |
| インバウンドレコードの取得 | 親インバウンドファイル取得ジョブが保留中のインバウンドトランザクションを識別する場合にのみ作成されます AWS。ログには、オポチュニティレコードまたはリードレコード AWS を含む からのファイルの詳細が含まれます。 |
### アウトバウンドファイルの取得結果
| **[Direction]** (方向) | **目的** | **ステータス** | **定義** |
| --- | --- | --- | --- |
| から AWS | インバウンドファイルの取得 | API Success | バケットへのリスト呼び出しは成功し、処理する必要がある保留中のインバウンドレコードが確認されました。 |
| から AWS | インバウンドファイルの取得 | Error | リスト呼び出しが失敗しました。通常、認証情報が無効であるか、アクセス許可の問題が原因です。 |
### インバウンドファイルの取得結果
| **[Direction]** (方向) | **目的** | **ステータス** | **定義** |
| --- | --- | --- | --- |
| から AWS | インバウンドレコードの取得 | API success | 1 つ以上のファイルが存在し、処理を待機している場合、 Inbound File Retrievalオペレーションからリストされたファイルを取得するためのget呼び出しが行われました。 |
| から AWS | インバウンドレコードの取得 | Partial | ファイルは取得されましたが、一部のレコードの処理に失敗しました。同期ログを確認して、障害のトラブルシューティングを行います。 |
| から AWS | インバウンドレコードの取得 | Error | 次のいずれかの理由により、すべてのレコードの処理に失敗しました。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/partner-central/latest/crm/crm-connector-sync-logs-and-reports.html) |
| から AWS | インバウンドレコードの取得 | API success | 1 つ以上のファイルが存在し、処理を待っている場合、 Inbound File Retrieval オペレーションからリストされたファイルを取得するためのget呼び出しが行われます。 |
| から AWS | インバウンドレコードの取得 | Partial | ファイルは取得されましたが、一部のレコードの処理に失敗しました。同期ログを確認して、障害のトラブルシューティングを行います。 |
| から AWS | インバウンドレコードの取得 | Error | 次のいずれかの理由により、すべてのレコードの処理に失敗しました。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/partner-central/latest/crm/crm-connector-sync-logs-and-reports.html) |
| から AWS | インバウンドレコードの取得 | Processed | 処理が成功し、マッピングされたオブジェクトに挿入されたレコード。 |
## レポート
AWS Partner CRM コネクタパッケージには、組織と APN 間の同期のステータスを追跡できるレポートが含まれています。
**同期用のレポートを表示するには**
1. AWS Partner CRM コネクタアプリで、**レポート**タブを選択します。
1. **すべてのフォルダ**を選択し、CRM **AWS Partner コネクタ**を選択します。
使用可能なレポートは次のとおりです。
+ **インバウンド同期ログ** – `Error: Inbound` 日別の同期レコードの失敗。
+ **インバウンド同期ログ** – `Success: Inbound` 日別の同期レコードの成功。
+ **アウトバウンド同期ログ** – `Error: Outbound` 日別の同期レコードの失敗。
+ **アウトバウンド同期ログ** – `Success: Outbound` 日別の同期レコードの成功。
+ **同期の概要** – 日別のインバウンドおよびアウトバウンドの同期ジョブの概要。
# CRM コネクタの設定
**注記**
このセクションのトピックでは、 AWS Partner Central 統合、 AWS Marketplace 統合、またはその両方の前提条件を満たしていることを前提としています。詳細については、このガイドの[開始方法](crm-integration-getting-started.md)「 [統合の前提条件](crm-integration-setting-up.md)以前」を参照してください。
コネクタをインストールしたら、次のタイプの CRM 統合と AWS サービスと連携するようにコネクタを設定します。
+ AWS Partner Central API 統合
+ Amazon S3 との統合を含む CRM。ただし、2024 年より前に統合を作成した場合に限ります。
+ AWS Marketplace
設定により、Partner Central および で Salesforce を使用できます AWS Marketplace。以下のトピックでは、CRM コネクタを設定する方法について説明します。
**Topics**
+ [ガイド付きセットアップの使用](use-guided-setup.md)
+ [Partner Central API 統合のコネクタの設定](p-c-api-integration.md)
+ [のコネクタの設定 AWS Marketplace](aws-marketplace-integration.md)
+ [CRM コネクタアクセス許可セットのペルソナ](permission-sets.md)
# ガイド付きセットアップの使用
Salesforce を常に使用して CRM コネクタを設定し、**ガイド付きセットアップ**タブから開始します。次の手順では、タブを開始する方法について説明します。
**タブを開始するには**
1. システム管理者として Salesforce にサインインします。
1. アプリランチャーから、**AWS パートナー CRM コネクタ**を検索して選択します。
1. **AWS ガイド付きセットアップ**タブを選択します。
# Partner Central API 統合のコネクタの設定
以下のセクションでは、 AWS Partner Central APIs で使用する CRM コネクタを設定する方法について説明します。
Salesforce でオポチュニティを作成および管理するには、Partner Central API 統合で使用する CRM コネクタを設定します。
**注記**
リードを管理するには、以前の CRM と Amazon S3 の統合が必要です。詳細については、このガイドの[Amazon S3 との統合による CRM のコネクタの設定](s3-config.md)後半の「」を参照してください。
**Topics**
+ [接続認証の詳細の入力](#config-p-c-apis)
+ [システム設定の入力](#p-c-api-system-settings)
+ [接続をテストする](#p-c-apis-testing)
+ [フローテンプレートの使用](flow-templates.md)
## 接続認証の詳細の入力
パートナーは、Partner Central セールスエンドポイントへの接続に必要な詳細を入力して統合プロセスを開始します。リストされた順序で各ステップのセットに従い、次のセットに進む前に各セットを完了します。
**接続認証の詳細を入力するには**
1. Salesforce で、**AWS ガイド付きセットアップ**タブを開きます。このタブを開く方法については、このガイドの前[ガイド付きセットアップの使用](use-guided-setup.md)半の「」を参照してください。
1. **ステップ 1: AWS 接続認証の詳細**を展開し、**開始を選択します。**
1. **名前付き認証情報**ページで、**前の「新規**」を選択します。
1. **新しい名前付き認証情報**フォームに、次の表の値を入力します。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/partner-central/latest/crm/p-c-api-integration.html)
1. **[保存]** を選択します。
1. **AWSガイド付きセットアップ**ページに戻ります。**認証の詳細**セクションで、認証情報**の確認**と確認を選択します。
## システム設定の入力
次の手順では、統合の正しいシステム設定を入力する方法について説明します。
1. Salesforce で、**AWS ガイド付きセットアップ**タブを開きます。このタブを開く方法については、このガイドの前[ガイド付きセットアップの使用](use-guided-setup.md)半の「」を参照してください。
1. **ステップ 2: システム設定**を展開し、**開始を選択します。**
1. **AWS パートナー CRM コネクタ設定**を見つけ、**管理**を選択します。
1. **新規** を選択し、次の表の値を入力します。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/partner-central/latest/crm/p-c-api-integration.html)
1. **[保存]** を選択します。
1. **AWS ガイド付きセットアップ**ページに戻ります。**認証の詳細**セクションで、認証情報**の確認**と確認を選択します。
## 接続をテストする
接続をテストする前に、上記のすべてのステップを完了していることを確認してください。
**AWS Partner Central API 接続をテストするには**
1. **ステップ 4: Partner Central API 統合の設定をテスト**する を展開します。
1. **[テスト]** を選択します。
接続が成功すると、確認メッセージが表示されます。
# フローテンプレートの使用
フローテンプレートは、AWS Partner Central API 統合方法を使用して Salesforce を AWS Partner Central と統合する事前構築済みの Salesforce フローです。これらのテンプレートには、データ同期、フィールドマッピング、エラー処理設定が含まれます。
## 利用可能なテンプレート
**統合 Standard-ACE オポチュニティ同期フローテンプレート**
Unified Standard-ACE 機会同期フローテンプレートは、Salesforce Standard 機会フィールドを ACE 機会フィールドにマッピングし、状態と国の形式を変換して、エントリの重複を防ぎます。これには、必須フィールドのデフォルト値が含まれます。
+ 収益、終了日、次のステップは、Salesforce と AWS Partner Central の間で同期されます。
+ デフォルトでは、「Create ACE」がオポチュニティの説明に追加されると、同期がトリガーされます。このトリガーメカニズムは、チェックボックスまたはボタンを使用して変更できます。
+ このテンプレートは、ビジネス要件とフィールドマッピングに沿ったフローを開発するための基盤を提供します。
+ このテンプレートは AWS Partner Central API 統合専用であり、他の統合方法と互換性がありません。
Salesforce Flow Builder で「Unified Standard-ACE Opportunity Sync Flow Template」を検索して、このテンプレートを見つけます。
**前提条件**
このテンプレートには、アクティブな AWS Partner Central API 統合が必要です。Salesforce と両方のシステムの設定済みフィールドで適切なアクセス許可が必要です。Salesforce Flow と AWS Partner Central API に精通しておくことをお勧めします。
**テンプレートへのアクセス**
フローテンプレートを見つけるには：
1. Salesforce 組織で、**Setup** を選択します。
1. **フロー**を検索します。
1. フローページで、「Unified Standard-ACE Opportunity Sync Flow」テンプレートを検索します。
テンプレートのコピーを作成して、要件に合わせてカスタマイズします。本番環境にデプロイする前に、サンドボックス環境で変更をテストします。
**主な特徴**
テンプレートには、標準オポチュニティオブジェクトと ACE オポチュニティオブジェクト間のフィールドマッピング、州と国の形式変換、重複エントリの防止が含まれます。必須フィールドのカスタムトリガーとデフォルト値処理を設定できます。
**実装に関する考慮事項**
+ フローテンプレートをカスタマイズするときは、ベストプラクティスに従ってください。
+ 変更をテストし、既存のプロセスへの影響を検討します。
+ 一般的なカスタマイズには、カスタムフィールドの追加やトリガーメカニズムの調整が含まれます。
+ 本番環境にデプロイする前に、サンドボックス環境で徹底的にテストします。
+ 大量のデータや複雑なビジネスロジックを扱うときは、パフォーマンスへの影響を考慮してください。
# のコネクタの設定 AWS Marketplace
**注記**
このセクションのトピックでは、 AWS Partner Central 統合、 AWS Marketplace 統合、またはその両方の前提条件を満たしていることを前提としています。詳細については、このガイドの[開始方法](crm-integration-getting-started.md)「 [統合の前提条件](crm-integration-setting-up.md)以前」を参照してください。
複数の AWS 販売者アカウントに接続し、Salesforce を複数の AWS Marketplace 関数と統合するように CRM コネクタを設定できます。以下のトピックでは、 で使用するコネクタを設定する方法について説明します AWS Marketplace。
詳細については AWS Marketplace、「 *AWS Marketplace ユーザーガイド*」の[「What is AWS Marketplace？](https://docs.aws.amazon.com/marketplace/latest/userguide/what-is-marketplace.html)」を参照してください。CRM コネクタがサポートする AWS Marketplace 機能の詳細については、「」を参照してください[AWS Marketplace features](crm-connector-feature-list.md#feature-list-aws-marketplace)。
**注記**
Salesforce の**AWS ガイド付きセットアップ**タブを使用して、次のタスクを完了します。このタブの使用については、このガイドの前[ガイド付きセットアップの使用](use-guided-setup.md)半の「」を参照してください。
**Topics**
+ [AWS 販売者のアカウントのオンボーディング](onboard-seller-account.md)
+ [システム設定の入力](mkt-system-config.md)
+ [カスタム設定の入力](mkt-custom-settings.md)
# AWS 販売者のアカウントのオンボーディング
以下の手順では、 AWS セラーアカウントを CRM コネクタにオンボードする方法について説明します。
1. Salesforce の[ガイド付きセットアップタブ](use-guided-setup.md)で、**ステップ 1: AWS Marketplace 管理ポータル (AMMP) へのアクセスをセットアップ**し、**開始を選択します。**
1. **名前付き認証情報**ページで、**前の「新規**」を選択します。
1. **新しい名前付き認証情報**フォームに、次の表の値を入力します。
**注記**
*unique\$1account\$1prefix* には、 SellerA SellerB などのアカウントの記述子 AWS を使用します。例えば、**AWS\$1SELLER\$1CATALOG\$1sellerA**。 AWS 販売者アカウントに関連する名前付き認証情報には、常に同じプレフィックスを使用してください。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/partner-central/latest/crm/onboard-seller-account.html)
1. **[保存]** を選択します。
1. **AWSガイド付きセットアップ**ページに戻ります。**認証の詳細**セクションで、認証情報**の確認**と確認を選択します。
次の表にリストされている**名前付き認証情報**のタイプごとに、上記のステップを繰り返します。以下の表の値を使用して、上記の**ステップ 3 **の対応する値を置き換えます。
| **名前付き認証情報ラベル** | **名前付き認証情報名** | **API エンドポイント** | **AWS リージョン** | **AWS service** |
| --- | --- | --- | --- | --- |
| AWS SELLER Amazon S3 | AWS\$1SELLER\$1S3\$1unique\$1account\$1prefix | [https://s3.amazonaws.com/](https://s3.amazonaws.com/) | us-east-1 | s3 |
| AWS 販売者 AWS STS | AWS\$1SELLER\$1STS\$1unique\$1account\$1prefix | [https://sts.us-east-1.amazonaws.com/](https://sts.us-east-1.amazonaws.com/) | us-east-1 | sts |
| AWS 販売者 Amazon SQS | AWS\$1SELLER\$1SQS\$1unique\$1account\$1prefix | [https://sqs.us-east-1.amazonaws.com/](https://sqs.us-east-1.amazonaws.com/) | us-east-1 | sqs |
| AWS SELLER 契約 | AWS\$1SELLER\$1AGREEMENT\$1unique\$1account\$1prefix | [https://agreement-marketplace.us-east-1.amazonaws.com/](https://agreement-marketplace.us-east-1.amazonaws.com/) | us-east-1 | aws-marketplace |
統合に追加する AWS AWS Marketplace Seller アカウントごとに上記のステップを繰り返します。
名前付き認証情報をオンボーディングしたら、**AWS パートナー CRM コネクタアプリ**の**AWS アカウント**タブに移動し、次のセクションの手順を完了します。
# システム設定の入力
AWS 販売者アカウントをオンボーディングしたら、いくつかのシステム設定を入力します。以下の手順に従ってください。
1. Salesforce の[ガイド付きセットアップタブ](use-guided-setup.md)で、**ステップ 2: システム設定を完了**し、**レビューを選択します。**
1. **カスタム設定**ページで、**AWS Marketplace 統合設定**を見つけ、**管理を選択します。**
1. **編集**を選択して**デフォルトの組織レベル****値**を追加し、次の表から必要な値を入力します。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/partner-central/latest/crm/mkt-system-config.html)
1. **[保存]** を選択します。
# カスタム設定の入力
システム設定を入力したら、カスタム EULAs のアップロードと保存に使用される Amazon S3 バケットの設定を入力します。
1. Salesforce の[ガイド付きセットアップタブ](use-guided-setup.md)で、**カスタム設定**ページに戻り、**S3 バケット設定**を見つけ、**管理**を選択します。
1. **[New]** (新規作成) を選択します。
1. 以下の設定の値を入力します。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/partner-central/latest/crm/mkt-custom-settings.html)
1. **[保存]** を選択します。
1. 設定された販売 AWS 者アカウントごとに、ステップ 2～4 を繰り返して Amazon S3 設定を追加します。
# CRM コネクタアクセス許可セットのペルソナ
AWS Partner CRM コネクタをインストールして設定したら、さまざまなツールや機能へのアクセスを提供する設定とアクセス許可のコレクションである*アクセス許可セット*内の 1 つ以上のペルソナに Salesforce ユーザーを割り当てます。以下のトピックでは、使用可能なペルソナを一覧表示して説明します。
Salesforce ユーザーをアクセス許可セットに割り当てる方法の詳細については、Salesforce ヘルプの[「アクセス許可セットの割り当ての管理](https://help.salesforce.com/s/articleView?id=platform.perm_sets_manage_assignments.htm)」を参照してください。
**Topics**
+ [AWS Partner Network アクセス許可セット](crm-connector-pemissions-sets.md)
+ [AWS Marketplace アクセス許可セット](mkt-permissions-sets.md)
+ [CRM コネクタタブとアクセス許可セット](permission-set-table.md)
# AWS Partner Network アクセス許可セット
CRM コネクタは、次のプライマリ AWS Partner Network ペルソナをサポートしています。
**Topics**
+ [ビジネス管理者 (APN ビジネス管理者）](#business-administrator)
+ [統合ユーザー (APN 統合ユーザー）](#integration-user)
+ [ビジネスユーザー (APN ビジネスユーザー）](#business-user)
+ [レポートを表示するアクセス許可の付与](#report-permissions)
+ [フローユーザーのアクティブ化](#activate-flow-user)
## ビジネス管理者 (APN ビジネス管理者）
+ システム管理者またはビジネス管理者に を割り当てて、レコードのセットアップとマッピングを設定します。
+ Salesforce CRM AWS Partner Network 管理アプリへのフルアクセスを許可します。
+ フィールドマッピングを作成、表示、編集できます。
+ すべての同期ログの詳細レコードを表示できます。
+ ユーザーが統合をスケジュールすることを許可せず、設定のみを許可します。
+ Salesforce のコアセットアップアクセスを提供しません。
+ Salesforce の一部の設定では、追加のアクセスが必要です。具体的には、 がユーザーに提供 AWS Partner する必要がある名前付き認証情報とカスタム設定です。ただし、パートナーはこのアクセス許可セットを Salesforce システム管理者プロファイルとペアリングし、アプリケーションの設定に必要なすべてのアクセス許可を有効にすることができます。名前付き認証情報の詳細については、「」を参照してください。 [名前付き認証情報を設定する](set-up-api-credentials.md)
## 統合ユーザー (APN 統合ユーザー）
+ 統合の処理を担当するシステムユーザーに を割り当てます。
+ 統合をスケジュールするには、Salesforce システム管理者がこのユーザーとしてサインインし、システム統合スケジュールを呼び出します。
+ 管理者がマッピングを設定し、統合スケジュールを呼び出すことを許可します。
+ 統合を実行するユーザーにこのアクセス許可が設定されていない場合、統合が中断される可能性があります。
+ このアクセス許可セットに加えて、統合を処理するように指定されたユーザーは、マッピングされたすべてのフィールドへのフィールドレベルのアクセス権を持っている必要があります。そうでない場合、マッピングは割り当てられたとおりに同期されません。
+ アウトバウンドジョブは、統合ユーザーコンテキストで行われた更新を無視して競合を回避するように設計されており、インバウンド統合中に更新された同じレコードがアウトバウンド統合に送信されるようにフラグが付けられます。
## ビジネスユーザー (APN ビジネスユーザー）
+ 機会に関連する同期ログの詳細を表示したいビジネスユーザーに を割り当てます。これにより、データが正しく同期されていない場合にエンドユーザーのトラブルシューティングが可能になります。
+ 同期ログレコードを可視化せず、 オブジェクトとフィールドへのアクセスのみを許可します。
+ 同期ログレコードには機密性の高いオポチュニティ情報が含まれているため、プライベートに設定することをお勧めします。
+ プライベートモデルを設定すると、APN ビジネスユーザーは、パートナー Salesforce 管理者がユーザーとのレコード共有を設定している場合、レコードにのみアクセスできます。
## レポートを表示するアクセス許可の付与
ユーザーが AWS Partner CRM コネクタの**ホーム**タブでレポートを表示できるようにするには、管理者は次のアクセス許可を付与する必要があります。
+ レポートの作成とカスタマイズ
+ レポートの編集
+ パブリックフォルダでのレポートの管理
+ レポートの実行
+ パブリックフォルダでレポートを表示する
詳細については、Salesforce ヘルプの「レポート[とダッシュボードへのアクセス権をユーザーに付与する](https://help.salesforce.com/s/articleView?id=sfdo.PMM_Folder_Sharing_Reports_Dash.htm)」を参照してください。
## フローユーザーのアクティブ化
ユーザーをフローユーザーとしてアクティブ化すると、フローを実行し、ACE オポチュニティの**プライベートオファーリンク**ボタンを使用できます。
1. システム管理者にフローユーザーを割り当てるアクセス許可があることを確認します。詳細については、Salesforce ヘルプの[「実行フローのアクセス許可の追加](https://help.salesforce.com/s/articleView?id=sf.wcc_setup_add_run_flows_perms.htm)」を参照してください。
1. **Setup**, **Users** を選択します。
1. ユーザーを選択します。
1. **フローユーザー**を選択します。
# AWS Marketplace アクセス許可セット
CRM コネクタは、次のプライマリ AWS Partner ペルソナをサポートしています。パートナーは、アプリケーションに含まれる対応するアクセス許可セットを Salesforce ユーザーに付与することで、ペルソナを有効にします。
**Topics**
+ [AWS Marketplace 管理者](#aws-marketplace-administrator)
+ [AWS Marketplace ユーザー](#aws-marketplace-user)
+ [AWS チャネルパートナーユーザー](#aws-channel-partner-user)
## AWS Marketplace 管理者
このペルソナをシステムまたはビジネス管理者に割り当てて、設定を実行し、スケジュールを管理します。このペルソナは、Salesforce コネクタの AWS Marketplace 統合へのフルアクセスを提供します。
このペルソナは以下を実行できます。
+ AWS Marketplace 統合に関連するすべてのオブジェクトのレコードの読み取り、書き込み、および表示を行います。
+ AWS Marketplace 同期ログレコードをすべて表示します。
+ AWS Marketplace エンティティに関連するスケジュールを作成します。
**注記**
Salesforce の特定の設定には、特に がユーザーに提供する必要がある認証情報とカスタム設定という名前 AWS Partnerの追加アクセスが必要です。ただし、パートナーがこのアクセス許可セットを Salesforce システム管理者プロファイルとペアにすると、アプリケーションを完全に設定するために必要なすべてのアクセス許可が機能します。
## AWS Marketplace ユーザー
このペルソナを、プライベートオファーと再販認可を作成および管理するユーザーに割り当てます。
AWS Marketplace ユーザーは以下を実行できます。
+ AWS Marketplace の製品、オファー、再販認可を同期します。
+ 有効期限を変更し、オファーをキャンセルしてクローンし、認可を再販売します。
+ AWS Marketplace ダッシュボードにアクセスします。
## AWS チャネルパートナーユーザー
AWS チャネルパートナーユーザーは、以下を実行できます。
+ 独立系ソフトウェアベンダー (ISV) 販売者が作成した利用可能な共有再販認可を表示します。
+ 共有再販認可から AWS チャネルパートナーのプライベートオファーを表示および作成します。
# CRM コネクタタブとアクセス許可セット
Salesforce で CRM コネクタアプリケーションを使用すると、一連のタブが表示されます。表示されるタブは、アクセス許可の設定によって異なります。次の表に、コネクタアプリによって提供されるタブと、各タブの使用が許可されているアクセス許可セットを示します。
| **コネクタアプリタブ** | **アクセス許可セット** |
| --- | --- |
| **AWS ガイド付きセットアップ** | APN ビジネス管理者 APN 統合ユーザー APN ビジネスユーザー ? AWS Marketplace 管理者 |
| **レポート** | APN ビジネスユーザー AWS Marketplace ユーザー (AWS Marketplace ISV) AWS チャネルパートナーユーザー |
| **ACE マッピング** | APN ビジネス管理者 APN ビジネスユーザー ? |
| **スケジュール** | APN ビジネス管理者 APN 統合ユーザー AWS Marketplace ユーザー (AWS Marketplace ISV) |
| **ACE 同期ログ** | APN ビジネス管理者 APN 統合ユーザー APN ビジネスユーザー |
| **ACE リード** | APN ビジネス管理者 ? -> 使用可能 APN 統合ユーザー ? APN ビジネスユーザー |
| **ACE の機会** | APN ビジネス管理者 -> 使用可能 APN 統合ユーザー ? APN ビジネスユーザー |
| **ソリューションの提供** | APN ビジネス管理者 APN ビジネスユーザー |
| **AWS アカウント** | AWS Marketplace 管理者 AWS Marketplace ユーザー (AWS Marketplace ISV) AWS チャネルパートナーユーザー |
| **製品** | AWS Marketplace 管理者 AWS Marketplace ユーザー (AWS Marketplace ISV) |
| **プライベートオファー** | AWS Marketplace 管理者 ? -> 使用可能 AWS Marketplace ユーザー (AWS Marketplace ISV) AWS チャネルパートナーユーザー |
| **再販承認** | AWS Marketplace 管理者 ? -> 使用可能 AWS Marketplace ユーザー (AWS Marketplace ISV) AWS チャネルパートナーユーザー |
| **再販売承認の共有** | AWS Marketplace 管理者 ? -> 使用可能 AWS チャネルパートナーユーザー |
| **Marketplace 同期ログ** | AWS Marketplace 管理者 AWS Marketplace ユーザー (AWS Marketplace ISV) AWS チャネルパートナーユーザー |
| **契約** | AWS Marketplace ユーザー (AWS Marketplace ISV) AWS チャネルパートナーユーザー |
| **AWS Marketplace 通知** | APN ビジネス管理者 APN ビジネスユーザー AWS Marketplace 管理者 AWS Marketplace ユーザー (AWS Marketplace ISV) AWS チャネルパートナーユーザー |
| **フィールドマッピング** | APN ビジネス管理者 APN 統合ユーザー ? |
| **オファーディメンション** | AWS Marketplace 管理者 ? AWS Marketplace ユーザー (AWS Marketplace ISV) AWS チャネルパートナーユーザー |
| **支払いスケジュール** | AWS Marketplace 管理者 ? AWS Marketplace ユーザー (AWS Marketplace ISV) AWS チャネルパートナーユーザー |
| **製品ディメンション** | AWS Marketplace 管理者 ? AWS Marketplace ユーザー (AWS Marketplace ISV) |
| **ログ** | APN ビジネス管理者 APN ビジネスユーザー |
# Salesforce での CRM コネクタの使用
以下のトピックでは、Salesforce と CRM コネクタを使用してカスタマーエンゲージメントを管理する方法と、プライベートオファーや再販認可などの AWS Marketplace アクティビティを管理する方法について説明します。トピックでは、AWS Partner Central と のコネクタが設定されていることを前提としています AWS Marketplace。
**Topics**
+ [ACE の機会の管理](manage-ace-opportunities.md)
+ [Partner Central API 統合でのオポチュニティの管理](manage-aws-opportunities.md)
+ [Amazon S3 との統合による CRM でのオポチュニティの管理](manage-s3-opportunities.md)
+ [AWS Marketplace アクティビティの管理](crm-manage-marketplace.md)
# ACE の機会の管理
以下のトピックでは、CRM コネクタを使用して AWS Partner ACE の機会を管理する方法について説明します。
**Topics**
+ [パートナー起点の機会の作成](create-partner-opportunity.md)
+ [オポチュニティレコードの表示](viewing-opportunities.md)
+ [オポチュニティのステージの更新](update-opportunity-stage.md)
+ [オポチュニティのクローン作成](clone-opportunity.md)
# パートナー起点の機会の作成
次のステップでは、パートナー主導の機会を作成する方法について説明します。
1. セールスユーザーとして Salesforce 組織にサインインします。
1. **アプリランチャー**を選択し、**AWS パートナー CRM コネクタ**を検索して選択します。
1. **ACE Opportunities** タブを開きます。
1. **[New]** (新規作成) を選択します。
1. フィールドに入力します。必ずすべての必須フィールドに入力してください。
1. **[保存]** を選択します。
1. 準備ができたら、オポチュニティレコードページで、**共有 AWS**を選択してオポチュニティを送信します AWS。
# オポチュニティレコードの表示
次の手順では、CRM コネクタアプリでオポチュニティレコードを表示する方法について説明します。
1. セールスユーザーとして Salesforce 組織にサインインします。
1. **アプリランチャー**から、**AWS パートナー CRM コネクタ**を検索して選択します。
1. **ACE Opportunities** タブを開きます。
1. ACE **オポチュニティ名を選択してオポチュニティ**を表示します。
# オポチュニティのステージの更新
次の手順では、オポチュニティのステージを更新する方法について説明します。
1. セールスユーザーとして Salesforce 組織にサインインします。
1. **アプリランチャー**を選択し、**AWS パートナー CRM コネクタ**を検索して選択します。
1. **ACE オポチュニティ**タブで、オポチュニティレコードを開きます。
1. 次のいずれかを行います:
**ステージパス**で、必要なステージを選択します。
—OR—
**Stage** フィールドに、必要なステージを入力します。
—OR—
**ステージを完了としてマーク**を選択します。
1. **[保存]** を選択します。
# オポチュニティのクローン作成
クローンを作成すると、既存のオポチュニティの詳細を含む新しいオポチュニティを作成できます。以下では、その手順を説明します。
1. セールスユーザーとして Salesforce 組織にサインインします。
1. **アプリランチャー**を選択し、**AWS パートナー CRM コネクタ**を検索して選択します。
1. **ACE オポチュニティ**タブで、オポチュニティレコードを開きます。
1. **クローン**ボタンを選択します。
1. **APN CRM の一意の識別子**値を削除し、必要に応じて他のフィールドを更新します。
1. **[保存]** を選択します。
# Partner Central API 統合でのオポチュニティの管理
以下のトピックでは、Partner Central API 統合に固有のタスクを完了する方法について説明します。
**Topics**
+ [AWS 発信された機会の承諾または拒否](accept-reject-aws-opportunity.md)
+ [他のユーザーにオポチュニティを割り当てる](assign-opportunity.md)
+ [オポチュニティの関連付けまたは関連付け解除](associate-disassociate-opportunity.md)
+ [複数の機会を受け入れる](accepting-multiple-opportunities.md)
+ [複数の機会の割り当て](assigning-multiple-opportunities.md)
# AWS 発信された機会の承諾または拒否
次の手順では、 AWS セールスから発生するオポチュニティを承諾または拒否する方法について説明します。
1. オポチュニティレコードを開きます。
1. **承認ステータス**ボタンを選択します。
1. Partner **acceptance status** フィールド。**「承諾**」または**「拒否**」を選択します。
**拒否**を選択した場合は、**拒否理由**リストを開き、理由を選択します。
1. **[保存]** を選択します。
# 他のユーザーにオポチュニティを割り当てる
次の手順では、Partner Central アカウントの他のユーザーにオポチュニティを割り当てる方法について説明します。
**重要**
AWSオリジンオポチュニティは、承諾された後にのみ割り当てることができます。
1. オポチュニティレコードを開きます。
1. **割り当て**ボタンを選択します。
1. **「機会の割り当て**」ダイアログボックスで、すべてのフィールドに入力します。
1. **[保存]** を選択します。
# オポチュニティの関連付けまたは関連付け解除
次のステップでは、パートナーソリューション、 AWS 製品、または AWS Marketplace オファーからオポチュニティを関連付けたり関連付けを解除したりする方法を説明します。オポチュニティのライフサイクル中はいつでも、オポチュニティの関連付けと関連付け解除を行うことができます。
**オポチュニティを関連付けるには**
1. オポチュニティレコードを開きます。
1. **関連付けまたは関連付け解除**ボタンを選択します。
1. **機会の関連付けまたは関連付けの解除**ダイアログボックスで、必要な**ソリューション (複数可)**、**AWS 製品 (複数可)**、**AWS Marketplace オファー (複数可)** を選択するか、**その他**に値を入力します
1. **[保存]** を選択します。
**オポチュニティの関連付けを解除するには**
1. オポチュニティレコードを開きます。
1. **関連付けまたは関連付け解除**ボタンを選択します。
1. 削除する**ソリューション (複数可)**、**AWS 製品 (複数可)**、または** AWS Marketplace オファー (複数可) **の横にある **X** を選択します。
1. **[保存]** を選択します。
# 複数の機会を受け入れる
一括承諾機能を使用して、複数の AWSオリジンオポチュニティを同時に承諾できます。この機能は、機会を受け入れるプロセスを合理化し、手動作業を減らします。
1. Partner AWS CRM Connector で、**ACE Opportunities** タブを開きます。
1. 最初の列のチェックボックスをオンにして、受け入れる機会を選択します。
1. 右上の**「機会を受け入れる**」ボタンを選択します。ボタンが表示されない場合は、下矢印を選択し、**「機会を受け入れる**」を選択します。
1. **機会の承諾**ページで、承諾されていない機会のみが選択されます。
1. 選択したオポチュニティを確認し、**オポチュニティを受け入れる**を選択します。
1. 次の画面には、機会の受け入れジョブの進行状況が表示されます。
1. 完了すると、**Accept Opportunities **画面には、処理された項目の数とエラーが表示されます。
1. **Close** を選択して、**ACE Opportunities** タブに戻ります。
# 複数の機会の割り当て
一括割り当て機能を使用して、Partner Central アカウントの他のユーザーに複数のオポチュニティを同時に割り当てることができます。この機能は、機会を割り当てるプロセスを合理化し、手動作業を減らします。
**重要**
オポチュニティをユーザーに割り当てる前に、オポチュニティを と共有する必要があります AWS。と共有されていない機会 AWS は処理に失敗するか、割り当てウィザード中にチェックが解除されます。
1. Partner AWS CRM Connector で、**ACE Opportunities** タブを開きます。
1. 最初の列のチェックボックスをオンにして、割り当てる機会を選択します。
1. 右上の**「機会の割り当て**」ボタンを選択します。ボタンが表示されない場合は、下矢印を選択し、**「機会の割り当て**」を選択します。
1. **機会の割り当て**ページで、**名**、**姓**、**E** メール、**役職**の必須フィールドを入力します。
1. **選択済みオポチュニティ**では、 と共有されているオポチュニティのみが選択 AWS されます。と共有されていない機会は選択解除 AWS されます。
1. 選択したオポチュニティを確認し、**選択したオポチュニティの割り当て**を選択します。
1. 次の画面には、機会の割り当てジョブの進行状況が表示されます。
1. 完了すると、**「機会の割り当て**」画面には、処理された項目の数とエラーが表示されます。
1. **Close** を選択して、**ACE Opportunities** タブに戻ります。
# Amazon S3 との統合による CRM でのオポチュニティの管理
以下のトピックでは、Amazon S3 統合で CRM コネクタを CRM で使用する方法について説明します。
**Topics**
+ [Salesforce へのソリューションのインポート](import-solutions-tab.md)
+ [AWSオリジンオポチュニティの承諾または拒否](accept-reject-opportunities.md)
+ [機会とリードデータの同期](send-receive-opportunities-leads.md)
+ [AWS Marketplace プライベートオファーを ACE の機会にリンクする](link-private-offer-to-opportunity.md)
+ [ACE オポチュニティの同期ログ詳細レコードの表示](view-ace-details.md)
# Salesforce へのソリューションのインポート
パートナーソリューションは、 AWS パートナーが作成して提供するソフトウェア製品またはコンサルティングプラクティスです。これらは、お客様が特定のビジネス上の課題を解決したり、 AWS サービスを使用して特定の目標を達成したりするのに役立つように設計されています。詳細については、*AWS Partner Central Builder Guide* [の「ソリューションの作成](https://docs.aws.amazon.com/partner-central/latest/builder-guide/creating-a-solution.html)」を参照してください。
次の手順では、 Partner Central ソリューションを Salesforce にインポートする方法について説明します。その後、ソリューションを機会に関連付けることができます。
**ソリューションをインポートするには**
1. セールスユーザーとして Salesforce にサインインします。
1. **アプリランチャー**を選択し、**AWS パートナー CRM コネクタ**を検索して選択します。
1. Solution **Offerings** タブを開きます。
1. **ソリューションの更新**ボタンを選択します。
1. **続行** を選択して、 Partner Central からソリューションをインポートすることを確認します。
# AWSオリジンオポチュニティの承諾または拒否
次の手順では、APN Amazon S3 統合でオポチュニティを承諾または拒否する方法について説明します。
1. オポチュニティレコードを開きます。
1. **パートナー承諾ステータス**リストを開き、**承諾または****拒否**を選択します。
**拒否** を選択した場合は、**拒否理由**リストを開き、理由を選択します。
1. **[保存]** を選択します。
# 機会とリードデータの同期
オポチュニティまたはリードを APN と同期するには、**Partner Central との同期**フィールドを **True** に設定する必要があります。統合の追加フィールドには、**最後の APN 同期日**と **APN フィールドとの同期対象**が含まれます。標準の機会とリードには、それらのフィールドが含まれます。ただし、ソースオブジェクトがカスタムに設定されている場合、 は対応するオブジェクトのフィールドを作成してマッピングする必要があります。
+ **Partner Central との同期** – 標準の機会とリードのアプリに含まれています。カスタムオブジェクトにマッピングする場合は、このフィールドを作成してブール値としてマッピングする必要があります。
+ **APN との最後の同期日** – レコードが APN に正常に送信されたか、APN から受信された最後の時刻を示します。このフィールドは、レコードが APN に正常に送信されたとき、または APN から更新が受信されたときに自動設定されます。
+ **APN と同期する資格** – 次のスケジュールされたジョブでレコードを APN に送信する対象かどうかを決定する数式フィールド。レコードが最後にアウトバウンドスケジュールが実行されてから変更され、 AWS パートナーの組織の指定された統合ユーザー以外のユーザーによって更新されたかどうかに基づいて計算されます。
# AWS Marketplace プライベートオファーを ACE の機会にリンクする
プライベートオファーは、Salesforce の AWS 配信された ACE オポチュニティレコードページから直接リンクできます。
1. Salesforce 組織にサインインします。
1. **App Launcher** で、**AWS パートナー CRM コネクタ**を選択します。
1. **ACE Opportunities** タブを選択します。
1. ACE オポチュニティレコードを選択します。
1. **プライベートオファーのリンク**を選択します。
1. **オファー ID ルックアップ**で、プライベートオファーを選択します。
1. **[保存]** を選択します。
# ACE オポチュニティの同期ログ詳細レコードの表示
ACE オポチュニティレコードの**関連**セクションで AWS、配信された ACE オポチュニティの同期ログの詳細を表示できます。
**注記**
これらのステップは、 AWS配信された ACE オポチュニティオブジェクトにのみ適用されます。Salesforce 組織内の標準オブジェクトまたはカスタムオブジェクトにマッピングする場合、ACE **同期ログセクションで同期ログ**の詳細を表示できます。
1. Salesforce 組織にサインインします。
1. **App Launcher** で、**AWS パートナー CRM コネクタ**を選択します。
1. **ACE オポチュニティ**セクションで、ACE オポチュニティレコードを選択します。
1. **関連**セクションには、**同期ログ名**、**ステータス**、**エラーメッセージ**、**作成日**などの詳細が表示されます。
# AWS Marketplace アクティビティの管理
以下のトピックでは、CRM コネクタを使用して Salesforce 内から AWS Marketplace アクティビティを管理する方法について説明します。
**Topics**
+ [Salesforce と AWS Marketplace 製品の同期](crm-sync-salesforce.md)
+ [プライベートオファーの管理](crm-manage-private-offers.md)
+ [AWS Marketplace 契約の管理](crm-manage-agreements.md)
+ [AWS Marketplace 再販認可の管理](crm-resale-authorizations.md)
# Salesforce と AWS Marketplace 製品の同期
AWS Marketplace 製品を操作する前に、まず Salesforce と同期する必要があります。同期することで、最新の製品の詳細を確認できます。
**同期するには**
1. システム管理者として Salesforce にサインインします。
1. **アプリランチャー**を選択し、**AWS パートナー CRM コネクタ**を検索して選択します。
1. **製品**タブを選択し、**製品の更新**を選択します。
1. プロンプト **から製品のリストを取得するには AWS Marketplace**、**続行**を選択します。
同期プロセスが完了したら、コネクタアプリを使用して**プライベートオファー**と**再販認可**を作成および管理できます。以下のセクションでは、その方法について説明します。
# プライベートオファーの管理
以下のトピックでは、Salesforce を使用して AWS Marketplace 製品のプライベートオファーを作成および管理する方法を説明します。トピックには、プライベートオファーの作成、変更、追跡、柔軟な支払いスケジュールの作成、将来の日付の契約の作成、プライベートオファーのライフサイクル全体の管理が含まれます。
**Topics**
+ [プライベートオファーへのアクセス](#crm-view-private-offers)
+ [プライベートオファーの作成](#crm-create-private-offer)
## プライベートオファーへのアクセス
Salesforce 内から AWS Marketplace プライベートオファーを作成および管理するには、 **AWS Partner CRM コネクタ**の**プライベートオファー**タブを使用します。次の手順では、タブを開始する方法について説明します。
1. AWS Marketplace ユーザーとして Salesforce 組織にサインインします。
1. アプリランチャーから、**AWS パートナー CRM コネクタ**を検索して選択します。
1. **プライベートオファー**タブを選択します。
## プライベートオファーの作成
以下のトピックでは、Salesforce 内から AWS Marketplace プライベートオファーを作成する方法について説明します。詳細については、各セクションを展開してください。
### プライベートオファーを作成する手順
**注記**
プライベートオファーを作成すると、動的フィールドは、選択した製品と、作成プロセスを進める際の選択内容に基づいて表示されます。
次の手順では、プライベートオファーを作成する方法について説明します。を完了する必要があります[プライベートオファーの必須フィールド](#private-offer-required-fields)。必要に応じて、選択した製品のタイプに応じて、柔軟な支払いスケジュールと将来の日付の契約を作成できます。また、オファーをドラフトとして保存したり、購入者アカウントに公開したりできます。
1. **プライベートオファー**タブで、**新規** を選択します。
1. **オファーの作成**ページで、少なくとも次のセクション[プライベートオファーの必須フィールド](#private-offer-required-fields)に記載されている を完了します。
1. 以下の一部またはすべてを実行します。
+ **柔軟な支払いスケジュールを作成するには**
1. **「製品と購入者**」セクションで、**「固定ユニットの有効化」を選択し、購入者がこの製品に対して分割払いで支払うことを許可します**。
1. 支払い**スケジュールセクションで支払い**を設定します。
+ **将来の日付の契約を作成するには**
1. **サービスの長さ**セクションで、**将来の日付から新しいオファー**を選択します。
1. **サービス開始日**と**サービス終了日** (必要な場合) を入力します。
1. **オファーの作成**を選択して、購入者にオファーを公開します。
—OR—
下**書きとして保存** を選択して、オファーを後で購入者にリリースせずに完了する下書きとして保存します。
### プライベートオファーの必須フィールド
AWS Marketplace プライベートオファーを作成するには、オプションを含め、次のリストのフィールドに入力する必要があります。
**製品と購入者**
**ISV** – セルフ
**製品** – コネクタを介して同期された製品のリストから選択します。
**購入者アカウント** – 独自の販売者テストアカウントを入力して、統合を検証します。
**ご利用の詳細**
**オファー名** – カスタム名を入力します。
**オファーの説明** – カスタムオファーの説明を入力します。
**サービスの長さまたは契約期間**
**新しいオファー**を選択し、12 か月などのサービスレントを選択します。
**オファーディメンション**
提供する使用権限タイプを選択します。
選択したディメンションのオファーレートを に追加するか、既存のレートを更新します。
いずれかのディメンションレートが 0 USD に設定されているオファーを送信するには、**ゼロドルの料金を有効にする**を選択します。
**エンドユーザーライセンス契約 (EULA)**
**標準契約または AWS Marketplace****カスタム EULA **を選択します。
**カスタム EULA** を選択した場合は、 AWS 販売者アカウントのオンボーディング時にカスタム EULA を保存するように Amazon S3 バケットを設定する必要があります。詳細については、[「Amazon Simple Storage Service ユーザーガイド」の「最初の Amazon S3 バケットの作成](https://docs.aws.amazon.com/AmazonS3/latest/userguide/GetStartedWithS3.html#creating-bucket)」を参照してください。 **
**更新**
**このオファーは、同じ基盤となる製品の既存の顧客と既存の有料サブスクリプションを更新することを目的としていますか? で**、**はい** または **いい**え を選択します。
**有効期限情報**
オファーの有効期限を入力します。サブスクリプションタイプの製品の場合は、サブスクリプション終了日を入力します。
### オファーのステータスの表示と更新
1. **プライベートオファー**タブを開きます。
1. **プライベートオファー**リストから、**プライベートオファー名**を選択します。
1. **オファーステータスの更新**を選択します。オファーのステータスがページの下部に表示されます。使用可能な値: **PREPARING**、**APPLYING**、**SUCCEEDED**、または **FAILED**。
**注記**
ステータスが **SUCCEEDED** に変わるまでに最大 2 時間かかる場合があります。
### オファーの有効期限の変更
1. **プライベートオファー**タブを開きます。
1. **プライベートオファー**リストから、**プライベートオファー名**を選択します。
1. **有効期限/検証の変更**を選択します。
1. 新しい**オファーの有効期限を選択します。**
1. 選択内容を保存するには、**有効期限/有効性の変更**を選択します。
### プライベートオファーの有効期限の変更
プライベートオファーをキャンセルすると、新規顧客はそのオファーをサブスクライブできなくなります。既存のサブスクリプションをご利用のお客様は、オファー期間が終了するまでサブスクライブされたままになります。
1. **プライベートオファー**タブを開きます。
1. **プライベートオファー**リストから、**プライベートオファー名**を選択します。
1. **オファーのキャンセル**を選択し、**オファーのキャンセル**を再度選択してキャンセルを確認します。
### プライベートオファーの URL のコピー
1. **プライベートオファー**タブを開きます。
1. **プライベートオファー**リストから、**プライベートオファー名**を選択します。
1. ページの下部にある**オファーステータス**セクションを見つけます。
1. **URL のコピー**を選択します。
### プライベートオファーのクローン作成
プライベートオファーのクローンを作成すると、クローンされたオファーのデータを含む新しいオファーが作成されます。コネクタの「販売**者アカウントを購入者リストに追加**」設定を有効にすると、コネクタは販売 AWS 者アカウント番号を**購入者アカウント**リストに自動的に挿入します。これにより、販売者は購入者の視点からプライベートオファーを参照できます。
1. **プライベートオファー**タブを開きます。
1. **プライベートオファー**リストから、**プライベートオファー名**を選択します。
1. **オファーのクローンを選択します。**
1. 必要に応じて、クローンされた**オファーのオファーの詳細**セクションを編集します。
1. 必要に応じて、EULA を再アップロードします。
1. **オファーの作成**を選択します。
### FPS ユーティリティを使用して支払いスケジュールを入力する
AWS Marketplace プライベートオファーを作成するときは、FPS ユーティリティを使用して、固定コストと同等の支払いギャップで支払いスケジュールを設定します。
**FPS を使用するには**
1. **Payment Schedule** タブで **Yes **を選択して、固定コストと等しい支払いギャップで支払いスケジュールを生成します。
1. 15、30、90、または 365 日**の支払い頻度**を選択します。
1. **残りのオプション**を選択します。最初の支払いに不均等な支払いの残りを配置するには、**Frontload** を選択します。残りを最後の支払いに配置するには、**バックエンド**を選択します。
1. **カレンダーオプション**で、支払い頻度に週末日を含めるように設定するには、**カレンダー日**を選択します。週末の日を含めないようにするには、**営業日**を選択します。
1. 支払い金額 (すべての支払いの合計）、支払い開始日 (初回支払い）、おおよその支払い終了日を入力します。
1. **スケジュールの生成**を選択します。
1. 必要に応じて、支払い金額と請求書の日付を確認して編集します。
# AWS Marketplace 契約の管理
以下のトピックでは、 AWS 販売者とチャネルパートナーが CRM コネクタを使用して契約にアクセスし、契約の詳細を表示する方法について説明します。
**Topics**
+ [](#crm-refresh-agreements)
##
ベストプラクティスとして、他のアクションを実行する前に契約リストを更新してください。
**契約を更新するには**
1. AWS Marketplace ユーザーとして Salesforce 組織にサインインします。
1. **App Launcher** を選択し、**AWS パートナー CRM コネクタ**を検索して選択します。
1. **契約**タブを選択します。
1. **契約の更新**を選択します。
1. **契約の更新**ダイアログボックスで、**続行**を選択します。
システムはすべてのプライベートオファーの契約を同期し、**契約**タブに表示されます。
### 契約ベースのオファーの作成
AWS Marketplace 販売者およびチャネルパートナーは、契約ベースのオファーを作成し、それらを使用して既存の契約に基づいて新しいプライベートオファーを生成できます。契約ベースのオファーには、特定の制限があります。詳細については、「 *AWS Marketplace ユーザーガイド*」の[「 での契約の修正 AWS Marketplace](marketplace/latest/userguide/private-offers-upgrades-and-renewals.html)」を参照してください。
**注記**
ベストプラクティスとして、契約ベースのオファーを作成する前に、**共有再販承認**タブのデータを更新します。
**契約ベースのオファーを作成するには**
1. AWS Marketplace ユーザーとして Salesforce 組織にサインインします。
1. App Launcher から、**AWS パートナー CRM コネクタ**を検索して選択します。
1. **契約**タブを選択します。
1. **契約**リストで、契約名を選択します。
1. **契約ベースのオファーの作成**を選択します。
1. **オファーの作成フォームで**、必須フィールドに入力します。
1. **オファーの作成** を選択します。
# AWS Marketplace 再販認可の管理
ISV として、パートナー CRM Connector を使用して Salesforce 内で直接再販承認を作成することで、 AWS チャネル AWS パートナーに製品の再販を許可できます。コネクタを使用すると、製品ディメンションごとに固定レートを指定でき、 AWS チャネルパートナーの卸売価格が作成されます。その後、チャネルパートナーは購入者のプライベートオファーを作成するときに卸売価格をマークアップできます。コネクタを使用すると、作成や変更から非アクティブ化やクローン作成まで、再販認可のライフサイクル全体を管理できるため、Salesforce を離れることなくチャネルパートナー関係のあらゆる側面を処理できます。
**Topics**
+ [再販承認タブの使用](#crm-resale-auth-tab)
+ [AWS Marketplace 再販承認の作成](#crm-resale-auth-creation-steps)
+ [再販承認の必須フィールド](#crm-required-resale-fields)
+ [再販認可の無効化](#crm-deactivate-resale-auth)
+ [再販認可のクローン作成](#crm-clone-resale-auth)
+ [再販承認ステータスの表示と更新](#crm-view-refresh-auth-status)
## 再販承認タブの使用
Partner AWS CRM コネクタの**再販認可**タブを使用して、再販認可を作成および管理します。
**タブを開始するには**
1. AWS Marketplace ユーザーとして Salesforce 組織にサインインします。
1. **アプリランチャー**を選択し、**AWS パートナー CRM コネクタ**を検索して選択します。
1. **再販承認**タブを選択します。
## AWS Marketplace 再販承認の作成
**注記**
再販承認を作成すると、選択した製品と作成プロセス中に行った選択に基づいて動的フィールドが表示されます。
次の手順では、 AWS Marketplace 再販認可を作成する方法を説明します。選択した製品の種類に基づいて、柔軟な支払いスケジュールと将来の日付の契約を作成するオプションがあります。再販認可を作成してチャネルパートナーに公開することも、認可をリリースせずにドラフトとして保存することもできます。
1. **再販承認**タブで、**新規** を選択します。
1. **「再販認可の作成**」ページで、必須フィールドに入力します。
1. （オプション) 柔軟な支払いスケジュールを作成する
1. **「製品と購入者**」セクションで、**「固定ユニットの有効化」を選択し、購入者がこの製品に対して分割払いで支払うことを許可します**。
1. 支払い**スケジュールセクションで支払い**を設定します。
1. **「再販認可の作成**」を選択して、オファーをチャネルパートナーに公開します。
—OR—
**下書きとして保存**を選択して、後でチャネルパートナーにリリースせずにオファーを完了します。
## 再販承認の必須フィールド
以下のフィールドと、ここに記載されているオプションを入力する必要があります。
**製品と購入者**
**製品** — CRM コネクタを介して同期された利用可能な製品のリストから選択します。
**購入者アカウント**
オファーの対象となる購入者アカウントのカンマ区切りリスト。
**再販承認の詳細**
**再販承認名** – 名前を入力します
**説明** – 説明を入力します ( AWS チャネルパートナーが表示可能）
**リセラーアカウント** – リセラーの 12 桁の AWS アカウント番号を入力します。
**再販承認名**
名前を入力します。
**説明**
説明を入力します ( AWS チャネルパートナーが表示可能）。
**リセラーアカウント**
リセラーの 12 桁の AWS アカウント番号を入力します。
**契約期間 (該当する場合）**
**スタンダード**
**カスタム期間** – このオプションを選択すると、**カスタムサービスの長さ**を入力します。
**製品の料金 (該当する場合）**
+ 選択肢には、**使用状況モデル**または**契約モデル**が含まれます。
+ **契約モデル**の場合、**購入者と製品**セクションで FPS を有効にできます。
**法的用語**
+ 購入者の** AWS 「マーケットプレイスの標準契約**」または**「エンドユーザーライセンス契約のカスタム EULA**」を選択します。
+ 必要に応じて、 ** AWS Marketplace のリセラー契約**または**リセラー契約のカスタム契約**を選択します。
+ **カスタム EULA (購入者）** および**カスタム契約 (リセラー) **の場合は、カスタム EULA を保存するように販売者アカウントの Amazon Simple Storage Service バケットが設定されていることを確認します。
**製品ディメンション**
選択したディメンションにオファーレートとユニットを追加または更新します。
**ゼロドルの料金を有効に**して、いずれかのディメンションレートが **0 USD** に設定されている再販認可を作成することを選択します。
**再販承認期間**
**期間タイプ**を選択し、必要に応じて**再販承認の有効期限**の詳細を入力します。
**更新**
**「このオファーは、同じ基盤となる製品の既存の顧客と既存の有料サブスクリプションを更新することを目的としていますか？**」で、**「はい**」または**「いい**え」を選択し、必要な詳細を入力します。
## 再販認可の無効化
1. **再販承認**タブで、**新規** を選択します。
1. **再販認可名** で、非アクティブ化する認可の名前を選択します。
1. **再販承認の無効化**を選択します。
1. **再販承認ステータスの更新**を選択します。
非アクティブ化が成功すると、認可ステータスは**「制限**付き」に変わります。
## 再販認可のクローン作成
既存の認可の詳細を変更する必要がある場合は、再販認可のクローンを作成します。たとえば、パートナーに別の EULA を提供する必要がある場合は、認可のクローンを作成します。
**再販認可のクローンを作成するには**
1. **再販承認**タブから、**新規** を選択します。
1. 再販認可のリストから、**再販認可名**を選択します。
1. **再販売承認のクローン**を選択する
1. クローンされた**認可の再販認可の詳細**セクションを確認して編集します。複製された認可でカスタム EULA またはカスタム契約 (再販契約) を使用する場合は、法的条件を再アップロードする必要があります。
1. **「再販認可の作成**」を選択します。
## 再販承認ステータスの表示と更新
1. **再販認可**タブで、**新規** を選択します。
1. **再販認可**リストから、**再販認可名**を選択します。
1. **再販承認ステータスの更新**を選択します。
1. [**Proceed (進む)**] を選択して続行します。
1. 再販承認ステータスが **SUCCEEDED **に変わるまで、ステップ 5 と 6 を繰り返します。
**再販売承認ステータスの更新**ボタンを再度選択するまでに 30 秒かかります。これにより、各更新リクエストが完全に処理され、レコードの重複を防ぐことでデータの整合性が維持されます。
# Amazon S3 統合での以前の CRM の使用
**重要**
AWS Partner Central は、2024 年にこのタイプの統合に対する新しいリクエストの受け入れを停止しました。このセクションは、Amazon S3 を使用するパートナーにのみ適用されます。
新しいカスタム CRM 統合を開始するには、[AWS Partner Central API リファレンス](https://docs.aws.amazon.com/partner-central/latest/APIReference/aws-partner-central-api-reference-guide.html)を参照してください。
**Topics**
+ [Amazon S3 との統合による CRM から Partner Central API へのアップグレード](upgrade-crm-api.md)
+ [Amazon S3 との統合による CRM のコネクタの設定](s3-config.md)
+ [統合リソース](resources.md)
+ [リード共有](custom-lead-sharing.md)
+ [機会の共有](custom-opportunity-sharing.md)
+ [フィールドマッピング](custom-field-mapping.md)
+ [同期スケジュールの作成](crm-connector-scheduling.md)
+ [ベストプラクティス](best-practices.md)
+ [クォータ](quotas.md)
+ [バージョン履歴](version-history.md)
+ [よくある質問](faqs.md)
# Amazon S3 との統合による CRM から Partner Central API へのアップグレード
**注記**
このセクションのトピックでは、 AWS Partner Central 統合、 AWS Marketplace 統合、またはその両方の前提条件を満たしていることを前提としています。詳細については、このガイドの[統合の前提条件](crm-integration-setting-up.md)「」および[開始方法](crm-integration-getting-started.md)「」を参照してください。
以下のセクションのステップでは、以前の CRM と Amazon S3 の統合から AWS Partner Central API にアップグレードする方法について説明します。アップグレードすると、統合ユーザーの必要性や同期スケジュールの設定など、いくつかの ACE 要件が不要になります。
**Topics**
+ [アップグレード機能](api-upgrade-features.md)
+ [名前付き認証情報を設定する](set-up-api-credentials.md)
+ [オポチュニティの稲妻レコードページに承認ステータスボタンを追加する](add-approval-status-button.md)
+ [残りのボタンを追加する](add-remaining-buttons.md)
+ [ソリューションサービスタブを更新する](refresh-the-solutions-from-the-solution-offerings-tab.md)
# アップグレード機能
アップグレードには以下の機能があります。
+ Salesforce で ACE 統合ユーザーアクセス許可セットが不要になりました。
+ Salesforce で ACE の機会のスケジュールを作成する必要がなくなりました。
+ Partner Central API には、**オポチュニティの Lightning Record** ページで次のアクションを有効にする一連のボタンも用意されています。
+ **承認ステータス** – AWS 紹介されたオポチュニティを承諾または拒否します。
**注記**
このボタンは、**パートナー承認ステータス**リストを置き換えます。ボタンを使用して AWS、オリジンオポチュニティを受け入れる必要があります。
+ **と共有する AWS** – 機会を作成および更新します。
+ **関連付けまたは関連付け解除** — オポチュニティライフサイクル全体で、オポチュニティをパートナーソリューション、 AWS 製品、 AWS Marketplace オファーに関連付けまたは関連付け解除します。
+ **割り当て** — Partner Central アカウントの別のユーザーにオポチュニティを再割り当てします。
ボタンは、名前付き認証情報を設定した後に追加します。以下のトピックでは、これらのタスクを完了する方法について説明します。
# 名前付き認証情報を設定する
Partner Central API にアップグレードするには、まず名前付き認証情報を設定します。CRM コネクタは、Salesforce 組織の認証情報を使用して Partner Central で認証します。
**認証情報を設定するには**
1. システム管理者として Salesforce にサインインします。
1. **「名前付き認証情報**」で、**前の「新規**」を選択します。
1. **新しい名前付き認証情報**フォームに、次の表の値を入力します。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/partner-central/latest/crm/set-up-api-credentials.html)
1. **[保存]** を選択します。
1. **AWSガイド付きセットアップ**ページに戻ります。**認証の詳細**セクションで、認証情報**の確認**と確認を選択します。
# オポチュニティの稲妻レコードページに承認ステータスボタンを追加する
次の手順では、Opporuntiy Lightning Record ページに**承認ステータス**ボタンを追加する方法について説明します。ボタンを使用すると、承認プロセスを進める機会のステータスを確認できます。
**ボタンを追加するには**
1. システム管理者として Salesforce 組織にサインインします。
1. **オポチュニティの Lightning Record **ページ に移動します。
1. 強調表示されたパネルを選択して、プロパティペインを開きます。
1. **今すぐアップグレード**を選択します。
1. **既存のアクションを移行**を選択し、アクションをアップグレードするページレイアウトを選択します。
—OR—
最初から開始し、手動でアクションを追加します。
1. **アクション**リストから、**承認ステータス**を選択します。
1. **[保存]** を選択します。
**注記**
ステップ 4 と 5 は 1 回だけ完了する必要があります。
**承認ステータス**ボタンは、 AWS「オ**ポチュニティの稲妻レコード**」ページにのみ表示され、参照されるオポチュニティが表示されます。
# 残りのボタンを追加する
次の手順にリストされているボタンの一部またはすべてを追加できます。
**ボタンを追加するには**
1. システム管理者として Salesforce 組織にサインインします。
1. **オポチュニティの Lightning レコードページ** に移動します。
1. 強調表示されたパネルを選択して、プロパティペインを開きます。
1. **アクションから割り当て**を選択し、以下の項目の一部またはすべてを選択します。
+ **と共有する AWS**
+ **関連付けまたは関連付け解除**
+ **割り当て**
各ボタンの動作の詳細については、このガイドの前半の[アップグレード機能](api-upgrade-features.md)「」を参照してください。
1. **[保存]** を選択します。
# ソリューションサービスタブを更新する
次の手順では、**ソリューションサービス**タブのデータを更新する方法について説明します。
1. システム管理者として Salesforce 組織にサインインします。
1. Solution **Offerings** タブに移動します。
1. **ソリューションの更新**を選択します。
# Amazon S3 との統合による CRM のコネクタの設定
**重要**
2024 年以降、AWS Partner Central では、この統合タイプを新しいユーザーが使用できなくなります。
**注記**
このセクションのトピックでは、 AWS Partner Central 統合、 AWS Marketplace 統合、またはその両方の前提条件を満たしていることを前提としています。詳細については、このガイドの[開始方法](crm-integration-getting-started.md)「 [統合の前提条件](crm-integration-setting-up.md)以前」を参照してください。
非推奨の CRM と Amazon S3 の統合では、Amazon S3 バケットを使用してリードとオポチュニティを転送します。機会を作成および管理するには、前のセクションで示した Partner Central API 統合を使用することをお勧めします。ただし、コネクタを使用して Salesforce でリードを管理する場合は、この設定を使用できます。
**Topics**
+ [接続認証の詳細の入力](#apn-s3-authentication-details)
+ [システム設定の入力](#apn-s3-config-settings)
+ [接続をテストする](#apn-s3-testing)
+ [オポチュニティとリードの送受信](#sending-receiving-opportunities-leads)
+ [本番稼働チェックリスト](ace-production-checklist.md)
+ [AWS Partner CRM コネクタを新しいデータモデルにアップグレードする](connector-upgrade-plan.md)
+ [カスタム ACE オポチュニティと ACE リードオブジェクトを使用したサンドボックステスト](custom-ace-opportunity.md)
+ [AWS Marketplace プライベートオファーを ACE の機会にリンクする](#linking-private-offers-to-ace)
## 接続認証の詳細の入力
パートナーは、Amazon S3 エンドポイントへの接続に必要な詳細を入力して統合プロセスを開始します。リストされた順序で各ステップのセットに従い、次のセットに進む前に各セットを完了します。
以下のタスクは、**AWS ガイド付きセットアップ**タブから実行されます。タブの使用については、このガイドの前[ガイド付きセットアップの使用](use-guided-setup.md)半の「」を参照してください。
**認証の詳細を入力するには**
1. Salesforce で、**AWS ガイド付きセットアップ**タブを開きます。このタブを開く方法については、このガイドの前[ガイド付きセットアップの使用](use-guided-setup.md)半の「」を参照してください。
1. **ステップ 1: AWS 接続認証の詳細**を展開し、**開始を選択します。**
1. **名前付き認証情報**ページで、**前の「新規**」を選択します。
1. **新しい名前付き認証情報**フォームに、次の表の値を入力します。
| **フィールド** | **値** |
| --- | --- |
| ラベル | APN API 接続 |
| [URL] | [https://s3.us-west-2.amazonaws.com](https://s3.us-west-2.amazonaws.com) |
| ID タイプ | 名前付きプリンシパル |
| 認証プロトコル | AWS 署名バージョン 4 |
| AWS アクセスキー ID | Cloud-Ops は、前提条件のステップで ID を提供します。 |
| AWS シークレットアクセスキー | Cloud-Ops は、前提条件のステップでアクセスキーを提供します。 |
| AWS リージョン | us-west-2 |
| AWS service | s3 |
| 認可ヘッダーを生成する | checked |
| HTTP ヘッダーでマージフィールドを許可する | チェックなし |
| HTTP 本文のマージフィールドを許可する | チェックなし |
1. **[保存]** を選択します。
1. **AWSガイド付きセットアップ**ページに戻ります。**認証の詳細**セクションで、認証情報**の確認**と確認を選択します。
1. **AWSガイド付きセットアップ**ページを開いたままにして、次のステップに進みます。
## システム設定の入力
次の手順では、統合の正しいシステム設定を入力する方法について説明します。
1. **ステップ 2: システム設定**を展開し、**開始を選択します。**
1. **AWS パートナー CRM コネクタ設定**を見つけ、**管理**を選択します。
1. New を選択し****、次の表から必要な値を入力します。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/partner-central/latest/crm/s3-config.html)
1. **[保存]** を選択します。
1. **AWSガイド付きセットアップ**ページに戻ります。**認証の詳細**セクションで、認証情報**の確認**と確認を選択します。
## 接続をテストする
接続をテストする前に、前のセクションの手順を完了してください。
**接続をテストするには**
1. **ステップ 3: APN API の設定をテスト**する を展開します。
1. **[テスト]** を選択します。
接続が成功すると、確認メッセージが表示されます。
## オポチュニティとリードの送受信
Partner Central と同期することで、機会とリードを送受信できます。オポチュニティまたはリードを同期するには、**Partner Central との同期**フィールドを **True** に設定する必要があります。統合のその他のキーフィールドには、**最後の APN 同期日**と **APN と同期する資格**フィールドが含まれます。
これらのフィールドは、標準の機会とリードに含まれます。ただし、カスタムソースオブジェクト用に作成してマッピングする必要があります。
+ **Partner Central との同期** – 標準の機会とリードのアプリに含まれています。がカスタムオブジェクトにマッピングすること AWS Partner を選択した場合、カスタムブールフィールドを作成し、オポチュニティマッピングとリードマッピングでそれぞれマッピングする必要があります。
+ **APN との最後の同期日** – レコードが APN との間で最後に正常に送受信された時刻を示します。このフィールドは、レコードが APN に正常に送信されたとき、または APN から更新が受信されたときに自動設定されます。
+ **APN と同期する資格** – レコードが次のスケジュールされたジョブで APN に送信される対象かどうかを決定する数式フィールド。レコードが最後にアウトバウンドスケジュールが実行されてから変更され、 AWS Partnerの組織の指定された統合ユーザー以外のユーザーによって更新されたかどうかに基づいて計算されます。
# 本番稼働チェックリスト
AWS Partner CRM コネクタの本稼働インストールを完了するには、次の手順に従います。
1. CRM 統合の[オンボーディングプロセス](https://docs.aws.amazon.com/partner-central/latest/crm/crm-integration-getting-started.html)を完了したことを確認します。このプロセスの[ステージ 6](https://docs.aws.amazon.com/partner-central/latest/crm/stage-6-production-approval.html) では、本番環境を設定し、データ移行を実行して、統合を通じて機会を管理し、リードできるようにします。
1. CRM コネクタをインストールして設定します。詳細については、[コネクタのインストール](install-connector.md) を参照してください。
1. 次のいずれかのマッピングオプションを選択して、機会とリードオブジェクトをマッピングします。リファレンスについては、GitHub の[この必須フィールド](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv)のリストを参照してください。
+ CRM コネクタに付属の AWS ACE AWS Partner オポチュニティカスタムオブジェクトを使用して、オポチュニティをログに記録し、共有します AWS。このオプションを使用すると、 AWS フィールドを Salesforce フィールドに自動的にマッピングできます。
+ 標準の Salesforce オブジェクトを使用して、必須フィールドをマッピングします AWS 。
+ ACE カスタムオポチュニティオブジェクトを使用します。まず、ACE オポチュニティオブジェクトの中間テーブルを入力するワークフローを作成し、Salesforce フィールドを にマッピングします AWS。
1. マッピングオプションの詳細とガイダンスについては、「」を参照してください[ACE オブジェクトのマッピング](crm-connector-mapping.md)。
1. (オプション) Network と Salesforce 間の AWS Partner インバウンドおよびアウトバウンドの同期スケジュールを設定します。詳細については、「[同期スケジュールの作成](crm-connector-scheduling.md)」を参照してください。
1. 本番環境でパートナー主導の機会を検証するには、Partner Central アカウントの Partner Central Operations (PCO) に[サポートケース](https://docs.aws.amazon.com/partner-central/latest/crm/crm-integration-faq.html#troubleshooting)を提出してください。このプロセスでは、ダミーオポチュニティを作成し、それを と同期して AWS、 がオポチュニティ AWS を受け取ったことを確認するようにサポートエージェントに AWS 依頼します。テストの最後に、 AWS サポートエージェントにオポチュニティリクエストを拒否するよう依頼し、ユーザー側から削除できるようにします。
1. (オプション) データバックフィルを実行します。このプロセスにより、今後の更新時に AWS 、オリジンオリジンオポチュニティの紹介とパートナーオリジンオポチュニティの紹介の両方を特定できます。詳細については、CRM オンボーディングプロセスの[「ステージ 6: 本番稼働承認](https://docs.aws.amazon.com/partner-central/latest/crm/stage-6-production-approval.html)」を参照してください。
1. 本番統合をアクティブ化して、Amazon S3 バケットを介したファイルの交換を許可します。詳細については、[「ステージ 7: 起動](https://docs.aws.amazon.com/partner-central/latest/crm/stage-7-launch.html)」を参照してください。
# AWS Partner CRM コネクタを新しいデータモデルにアップグレードする
**重要**
本番環境をアップグレードする前に、サンドボックス Salesforce 組織で新しいデータモデルのアップグレードをテストして承認します。新しいデータモデルと古いモデルと新しいモデル間の変更については、GitHub の次の [aws-samples/partner-crm-integration-samples](https://github.com/aws-samples/partner-crm-integration-samples/tree/main/opportunity-samples) を参照してください。
**Opportunity-FieldsAndStandardValues-DiffWithPrevVersion-V14.3.xlsx**
**機会フィールド.xlsx**
**オポチュニティ\$1-\$1StandardValues.xlsx**
## 前提条件
+ ACE CRM 統合の新しいデータモデルガイドラインにはフィールド定義を使用し、必要なオープンオポチュニティを移行して新しいデータモデルに移行します。
+ カスタムオブジェクトまたは標準オブジェクト (マッピングで使用されるオブジェクト) の列を追加または削除します。
+ CRM コネクタのバージョン 2.0 AWS Partner 以降を使用していることを確認します。
**新しいデータモデルにアップグレードするには**
1. システム管理者として Salesforce 組織にサインインします。
1. アクティブなスケジュールをすべて無効にします。
1. **Setup**、**Custom Settings**、**AWS Partner CRM Connector Settings** を選択し、バージョンを **2.0** 以降に更新します。
**注記**
バージョン 2.0 以降では、**バージョン** フィールドは必須です。このフィールドは、パートナーが CRM 統合とやり取りするために使用するペイロードバージョンを指定します。パートナーがバージョン 2.0 に移行する場合、その仕様を完全に採用する必要があります。以前のバージョンに戻すことはできません。
1. **ACE マッピング**タブを選択します。
1. すべての必須フィールドマッピングと詳細を作成、レビュー、更新します。サンドボックステストでは、カスタム ACE オポチュニティと ACE リードオブジェクトを使用して、新しいデータモデル機能をテストします。詳細については、[カスタム ACE オポチュニティと ACE リードオブジェクトを使用したサンドボックステスト](custom-ace-opportunity.md) を参照してください。
1. 機会とリードのスケジュールを有効にします。
1. ACE 同期ログで同期エラーを確認し、修正を加えます。
1. 同期された機会とリードを確認して、データ変換が正確であることを確認します。または、ACE の機会とリードを確認して、新しいデータモデルの変更が正確にキャプチャされていることを確認します。
1. 製品のデプロイプロセスに従って、変更を本稼働 Salesforce 環境に移行します。
**注記**
サポートが必要な場合は、「」を参照してください[ヘルプの利用](getting-help.md)。
# カスタム ACE オポチュニティと ACE リードオブジェクトを使用したサンドボックステスト
**注記**
既存の CRM コネクタユーザーの場合は、「」を参照してください[AWS Partner CRM コネクタを新しいデータモデルにアップグレードする](connector-upgrade-plan.md)。
1. システム管理者として Salesforce 組織にサインインします。
1. **セットアップ**、**カスタム設定**、**AWS Partner CRM コネクタ設定**を選択し、バージョンを **2** に更新します。
1. **ACE マッピング**タブを選択します。
1. **オポチュニティ**については、**ACE オポチュニティ**カスタムオブジェクトにマッピングします。
1. **Auto Map ACE オブジェクト**を選択します。
**注記**
サンドボックステスト用にコネクタからカスタム ACE オポチュニティと ACE リードオブジェクトを使用する CRM コネクタの新しいバージョンにアップグレードする場合は、Auto Map ACE `Field Mapping Details` オブジェクト機能を使用する前に、データベースから使用可能なレコード`Field Mappings`とオブジェクトを手動で削除することをお勧めします。これを行う必要があるのは 1 回だけです。
1. ピックリストとマルチピックリストのフィールドマッピングとフィールドマッピング値を確認します。
1. 機会とリードのスケジュールを有効にします。
1. ACE 同期ログで同期エラーを確認し、必要な修正を加えます。
1. 同期された機会とリードを確認して、データ変換が正確であることを確認します。または、ACE の機会とリードを確認して、新しいデータモデルの変更が正確にキャプチャされていることを確認します。
## ACE オポチュニティの同期ログ詳細レコードの表示
ACE オポチュニティレコードの**関連**タブで AWS、配信された ACE オポチュニティの同期ログの詳細を表示できます。
**注記**
これらのステップは、 AWS配信された ACE オポチュニティオブジェクトにのみ適用されます。Salesforce 組織内の標準オブジェクトまたはカスタムオブジェクトにマッピングする場合、ACE **同期ログタブで同期ログ**の詳細を表示できます。
1. Salesforce 組織にサインインします。
1. **App Launcher** で、**AWS Partner CRM コネクタ**を選択します。
1. **ACE Opportunities** タブを選択します。
1. ACE オポチュニティレコードを選択します。
1. **関連**タブを選択すると、**同期ログ名**、**ステータス**、**エラーメッセージ**、**作成日**などの詳細が表示されます。
## AWS Marketplace プライベートオファーを ACE の機会にリンクする
プライベートオファーは、 AWS 配信された ACE オポチュニティレコードページから直接リンクできます。
1. Salesforce 組織にサインインします。
1. **App Launcher** で、**AWS Partner CRM コネクタ**を選択します。
1. **ACE Opportunities** タブを選択します。
1. ACE オポチュニティレコードを選択します。
1. **プライベートオファーのリンク**を選択します。
1. **オファー ID ルックアップ**で、プライベートオファーを選択します。
1. **[保存]** を選択します。
# 統合リソース
AWS には、カスタム統合の作成に役立つ以下のリソースが用意されています。
**Topics**
+ [フィールド定義](#custom-field-definitions)
+ [標準値](#standard-values)
+ [インバウンドファイルの例](#sample-inbound-files)
+ [アウトバウンドファイルの例](#sample-outbound-files)
+ [サンプル処理結果](#sample-processed-results)
+ [サンプルテストケース](#sample-test-cases)
+ [サンプルコードスニペット](#sample-code-snippets)
## フィールド定義
以下のセクションのリンクには、すべてのフィールドが一覧表示され、それらのデータ型、使用状況、および適用される制約またはフォーマットルールが説明されています。これらは、パートナーと がデータ AWS を交換するときに、正しくフォーマットされ、理解されるようにするためのリファレンスとして機能します。
次のリンクから GitHub に移動します。
+ [機会](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv)
+ [リード](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Leads-Fields.csv)
## 標準値
これらのリストは、さまざまなフィールドの標準値と列挙の概要を示しています。これらは、交換されるデータの一貫性を維持し、両者が使用される値を共通に理解するのに役立ちます。
次のリンクから GitHub に移動します。
+ [機会](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity_-_StandardValues.csv)
+ [リード](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead_-_StandardValues.csv)
## インバウンドファイルの例
次のサンプルファイルは、パートナーから に送信されたファイルの JSON ペイロードの構造を示しています AWS。
次のリンクから GitHub に移動します。
+ [機会](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Create-Inbound-Sample.json)
+ [リード](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Update-Inbound-Sample.json)
## アウトバウンドファイルの例
次のサンプルファイルは、 からパートナー AWS に送信されるファイルの JSON ペイロードの構造を示しています。
次のリンクから GitHub に移動します。
+ [機会](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Outbound-Sample.json)
+ [リード](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Outbound-Sample.json)
## サンプル処理結果
次のファイルは、 がパートナーから送信されたペイロード AWS を処理した後の一般的な結果を示しています。
次のリンクから GitHub に移動します。
+ [機会](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results-Success-Sample.json)
+ [リード](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-Sample.json)
## サンプルテストケース
次のリンクから GitHub に移動します。
+ [機会](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity%20-%20Testing%20Scenarios.xlsx)
+ [リード](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead%20-%20Testing%20Scenarios.xlsx)
## サンプルコードスニペット
次のリンクから GitHub に移動します。
+ [ace\$1read\$1s3.py](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/ace_read_s3.py)
+ [Apex\$1Sample\$1REST\$1API\$1Code.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_Sample_REST_API_Code.cls)
+ [S3\$1Authentication.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls)
+ [Sample\$1AceOutboundBatch.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls)
+ [SFDC apex s3 sample.txt](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/SFDC_apex_s3_sample.txt)
+ [Apex\$1get\$1files\$1from\$1s3\$1ace\$1partner\$1test.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_get_files_from_s3_ace_partner_test.cls)
+ [s3\$1ace\$1partner\$1test.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/s3_ace_partner_test.cls)
# リード共有
## AWS 共有がリードする方法
1. **増分エクスポート**: Amazon Web Services (AWS) は AWS、 が参照する新しいリード (および更新) を時間単位でエクスポートします。
1. **ファイルの作成**： AWS は、特定の形式に準拠したリードファイルを生成します。詳細なファイル仕様については、「」を参照してください[フィールド定義](resources.md#custom-field-definitions)。
1. **ファイルのアップロード**: リードファイルは `lead-outbound`フォルダにアップロードされます。
## からのリードの消費 AWS
からのリードを効果的に使用するには AWS、次の機能とのカスタム統合を構築します。
1. **ファイルの取得**：
+ スケジュールされたジョブを使用して、選択した間隔で`lead-outbound`フォルダを定期的にスキャンします。
+ 処理するリードファイルを取得します。
1. **データ変換とマッピング**：
+ 各ファイルの内容を読み終わったら、データを変換し、顧客関係管理 (CRM) システムのリードレコードにマッピングします。
+ フィールドマッピングのガイダンスについては、「」を参照してください[フィールドマッピング](custom-field-mapping.md)。
1. **リード識別**：
+ `partnerCrmLeadId` または を使用して、各リードを一意に識別します`apnCrmUniqueIdentifier`。
+ `partnerCrmLeadId` が空白で、 `apnCrmUniqueIdentifier` が存在する場合、リードは AWS Partner Network (APN) カスタマーエンゲージメント (ACE) からの新しい紹介です。
+ 両方の識別子が存在する場合、レコードは ACE からの更新として扱われます。
1. **リード取り込み**：
+ CRM システムで新しいリードを取り込むか、既存のリードを更新します。
1. **ファイル管理**：
+ 各リードと完全なファイルデータを正常に処理したら、アウトバウンドフォルダからファイルを削除します。
+ 各ファイルは `lead-outbound-archive`フォルダに自動的にアーカイブされます。
**統合とコードリファレンス**：
+ Amazon Simple Storage Service (Amazon S3) バケットにアップロードされたファイルを読み取るには、 を使用する AWS Lambda か、CRM システムから直接読み取ることができます。
+ Lambda および Salesforce REST API の以下のサンプルコードを使用して、CRM レコードを検証および更新します。
+ **ファイルを検証するための Lambda**: [ace\$1read\$1s3.py](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/ace_read_s3.py)。
+ **Salesforce REST API**: [Apex\$1Sample\$1REST\$1API\$1Code.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_Sample_REST_API_Code.cls)。
+ Salesforce 以外の CRM システムを使用する場合は、データを更新するためにシステム固有のコードを指定する必要があります。
## リードの更新を と共有する AWS
1. **リードを特定する**: 共有する更新があるリードを見つけます AWS。
1. **データ変換**: 「」で説明されているように、データを AWS 形式に変換します[フィールド定義](resources.md#custom-field-definitions)。
1. **ファイルの作成**：
+ JSON 形式でリードファイルを生成します。
+ 各ファイルにタイムスタンプを追加し、すべてのファイル名が一意であることを確認し、 の形式に従います`{name}_MMDDYYYY24HHMMSS.json`。
1. **認証とアップロード**：
+ ACE Amazon S3 バケットに対して認証します。
+ ファイルを `lead-inbound`フォルダにアップロードします。と共有されているすべてのファイルは AWS 、 `lead-inbound-archive`フォルダに自動的にアーカイブされます。
+ S3 にファイルをアップロードするときは、バケット所有者にフルアクセスを提供するようにしてください。
```
aws s3 cp example.jpg s3://awsexamplebucket --acl bucket-owner-full-control
```
[「Results Sample file.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-Sample.json)」でこのコマンドを実行した結果の例を参照してください。
1. **ファイル処理**：
+ 受信時に、 はファイル AWS を自動的に処理します。
+ 処理の結果は、Amazon S3 バケットの `lead-inbound-processed-results`フォルダにアップロードされます。これには、成功とエラーのステータス、および各リードのエラーメッセージが含まれます。
+ これらの処理された結果は、 `lead-inbound-processed-results-archive`フォルダにもアーカイブされます。
+ 詳細については、「」を参照してください[技術的なよくある質問 — リードと機会](technical-faq-leads-and-opps.md)。
1. **レスポンス処理**：
+ これらのレスポンスを消費し、誤ったレコードを確認し、エラーを修正して、データを ACE に再送信するロジックを開発する必要があります。
+ サンプルエラーは、「よくある質問」セクションと「トラブルシューティング」セクションで確認できます。
+ CRM から Amazon S3 にファイルをアップロードするには：
+ AWS 署名のバージョンを参照します。
+ HTTPS リクエストを使用してファイルをアップロードします。
+ 参考までに、次のファイルを使用して Amazon S3 バケットにファイルをアップロードします。
+ **S3 バケットを認証**する場合: [S3\$1Authentication.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls)
+ **S3 バケットにファイルをアップロードする場合**: [Sample\$1AceOutboundBatch.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls)
+ **注：** ファイルは 1 MB を超えることはできません。重複したファイルは処理されません。
# 機会の共有
## が機会 AWS を共有する方法
1. **増分エクスポート**: Amazon Web Services (AWS) は AWS、 が参照する新しい機会 (および更新) を時間単位でエクスポートします。
1. **ファイルの作成**： AWS は、特定の形式に準拠したオポチュニティファイルを生成します。詳細なファイル仕様については、[「オポチュニティフィールドの定義](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv)」を参照してください。
1. **ファイルのアップロード**: オポチュニティファイルは `opportunity-outbound`フォルダにアップロードされます。
## からのオポチュニティの消費 AWS
から効果的に機会を利用するには AWS、これらの機能とのカスタム統合を構築する必要があります。
1. **ファイルの取得**：
+ スケジュールされたジョブを使用して、選択した間隔で`opportunity-outbound`フォルダを定期的にスキャンします。
+ 処理するオポチュニティファイルを取得します。
1. **データ変換とマッピング**：
+ 各ファイルの内容を読み終わったら、データを変換し、顧客関係管理 (CRM) システムのオポチュニティレコードにマッピングします。
+ フィールドマッピングのガイダンスについては、「」を参照してください[フィールドマッピング](custom-field-mapping.md)。
1. **機会の特定**：
+ `partnerCrmOpportunityId` または を使用して、各オポチュニティを一意に識別します`apnCrmUniqueIdentifier`。
+ `partnerCrmOpportunityId` が空白で、 `apnCrmUniqueIdentifier` が存在する場合、オポチュニティは AWS Partner Network (APN) カスタマーエンゲージメント (ACE) からの新しい紹介です。
+ 両方の識別子が存在する場合、レコードは ACE からの更新として扱われます。
1. **機会の取り込み**: CRM システムで新しい機会を取り込むか、既存の機会を更新します。
1. **ファイル管理**：
+ 各オポチュニティと完全なファイルデータを正常に処理したら、アウトバウンドフォルダからファイルを削除します。
+ 各ファイルは `opportunity-outbound-archive`フォルダに自動的にアーカイブされます。
**統合とコードリファレンス**：
+ Amazon Simple Storage Service (Amazon S3) バケットにアップロードされたファイルを読み取るには、 を使用する AWS Lambda か、CRM システムから直接読み取ることができます。
+ Lambda および Salesforce REST API の以下のサンプルコードを使用して、CRM レコードを検証および更新します。
+ **ファイルを検証するための Lambda**: [ace\$1read\$1s3.py](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/ace_read_s3.py)。
+ **Salesforce REST API**: [Apex\$1Sample\$1REST\$1API\$1Code.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_Sample_REST_API_Code.cls)。
+ Salesforce 以外の CRM システムを使用する場合は、データを更新するためにシステム固有のコードを指定する必要があります。
## 機会の更新を と共有する AWS
1. **機会を特定する**: と共有する更新の機会を見つけます AWS。
1. **データ変換**: 「」で説明されているように、データを AWS 形式に変換します[フィールド定義](resources.md#custom-field-definitions)。
1. **ファイルの作成**：
+ JSON 形式でオポチュニティファイルを生成します。
+ 各ファイルにタイムスタンプを追加し、すべてのファイル名が一意であることを確認し、 の形式に従います`{name}_MMDDYYYY24HHMMSS.json`。
1. **認証とアップロード**：
+ ACE Amazon S3 バケットに対して認証します。
+ ファイルを `opportunity-inbound`フォルダにアップロードします。と共有されているすべてのファイルは AWS 、 `opportunity-inbound-archive`フォルダに自動的にアーカイブされます。
+ S3 にファイルをアップロードするときは、バケット所有者にフルアクセスを提供するようにしてください。
```
aws s3 cp example.jpg s3://awsexamplebucket --acl bucket-owner-full-control
```
[「オポチュニティ結果成功サンプル.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results-Success-Sample.json)」でこのコマンドを実行した結果の例を参照してください。
1. **ファイル処理**：
+ 受信時に、 はファイル AWS を自動的に処理します。
+ 処理の結果は、Amazon S3 バケットの `lead-inbound-processed-results`フォルダにアップロードされます。これには、成功とエラーのステータス、および各オポチュニティのエラーメッセージが含まれます。
+ これらの処理された結果は、 `opportunity-inbound-processed-results-archive`フォルダにもアーカイブされます。
+ 詳細については、「」を参照してください[技術的なよくある質問 — リードと機会](technical-faq-leads-and-opps.md)。
1. **レスポンス処理**：
+ これらのレスポンスを消費し、誤ったレコードを確認し、エラーを修正して、データを ACE に再送信するロジックを開発する必要があります。
+ サンプルエラーについては、「よくある質問」セクションと「トラブルシューティング」セクションを参照してください。
+ CRM から Amazon S3 にファイルをアップロードするには：
+ AWS 署名のバージョンを参照します。
+ HTTPS リクエストを使用してファイルをアップロードします。
+ 参考までに、次のファイルを使用して Amazon S3 バケットにファイルをアップロードします。
+ **S3 バケットを認証**する場合: [S3\$1Authentication.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls)
+ **S3 バケットにファイルをアップロードする場合**: [Sample\$1AceOutboundBatch.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls)
+ **注：** ファイルは 1 MB を超えることはできません。重複したファイルは処理されません。
# フィールドマッピング
フィールドマッピングは、パートナーがカスタマーリレーションシップ管理 (CRM) システムのフィールドを Amazon Web Services () で定義されているフィールドと整合させる統合プロセスで不可欠なステップですAWS。これにより、両者がデータを正確に交換して理解できるようになります。以下に示しているのは、このプロセスに役立つガイドラインです。
## 必須フィールドマッピング
+ 各必須フィールドを CRM システムの対応するフィールドにマッピングします。すべての必須フィールドがマッピングされていることを確認するときは、データ交換を成功させるために不可欠です。詳細については、[フィールド定義](resources.md#custom-field-definitions) を参照してください。
+ [機会](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv)
+ [リード](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Leads-Fields.csv)
## オプションフィールドの処理
+ 統合プロセスにおけるオプションフィールドの役割を理解します。ビジネス要件に基づいてこれらのフィールドをマッピングするかどうかを決定し、マッピングを解除することによる潜在的な影響に注意してください。
## 値の配置
+ CRM の各フィールド値を、 で指定されている必須 AWS Partner Network (APN) カスタマーエンゲージメント (ACE) リスト値に合わせます[フィールド定義](resources.md#custom-field-definitions)。これは、データの一貫性と整合性を維持するために重要です。
## データ型と形式の検証
+ CRM システム内のフィールドのデータ型と形式が、 AWS *フィールド定義*で指定されたものと一致していることを確認します。データ破損を防ぎ、シームレスな統合を確保するためには、データ型と形式の一貫性を維持することが不可欠です。
## フィールドの長さと制限
+ フィールドの長さの制限およびその他の制限に注意してください。CRM システムからのデータが、切り捨てられたりエラーを発生させたり AWS することなく、 の対応するフィールドに収まることを確認します。
## データ型と形式の検証
+ CRM システムのフィールドデータ型と形式が、 で指定されたものと一致していることを確認します[フィールド定義](resources.md#custom-field-definitions)。データの破損を防ぎ、データ型と形式の整合性とシームレスに統合することが重要です。
## 定期的なレビューと更新
+ CRM システムまたは AWS 要件の変更に対応するため、フィールドマッピングを定期的に確認および更新します。このプロアクティブアプローチにより、継続的なデータ交換の精度と効率が確保されます。
## フィールドマッピングドキュメント
+ 包括的なフィールドマッピングドキュメントを維持します。このプラクティスは、トラブルシューティング、将来の更新、システム間でのデータ転送方法の明確化に役立ちます。
## テストと検証
+ 徹底的なフィールドマッピングテストを実施して、データが正確に転送および変換されていることを検証します。データの整合性を確保するために、不一致や問題があればすぐに対処してください。
## 不要な上書きの処理
+ AWS データが特定の CRM フィールドを上書きしないようにするには、次の点を考慮してください。
+ 保護するデータのカスタム CRM フィールドを作成します。
+ このカスタムフィールドを販売担当者によってレビューしてもらう。
+ カスタムフィールドが承認されたら、それをオポチュニティレコードとパイプラインに追加します。
+ これは、 `MRR`や などのフィールド`Stage`、特に製品が起動したことを示すフィールドで特に重要です。
## ダウンストリーム依存関係の管理
+ データ交換に依存するダウンストリームの依存関係がシステムにある場合は、次の点を考慮してください。
+ AWS データに対応するために CRM に新しいフィールドを作成します。
+ 必要に応じてビジネスプロセスを再調整して、シームレスな統合とデータフローを確保します。
# 同期スケジュールの作成
**注記**
このセクションのトピックでは、 AWS Partner Central 統合、 AWS Marketplace 統合、またはその両方の前提条件を満たしていることを前提としています。詳細については、このガイドの[統合の前提条件](crm-integration-setting-up.md)「」および[開始方法](crm-integration-getting-started.md)「」を参照してください。
Salesforce と AWS Partner Central の間でインバウンドおよびアウトバウンドの同期スケジュールを作成できます。以下のセクションのステップでは、その方法について説明します。
**Topics**
+ [前提条件](#scheduling-prerequisites)
+ [スケジュールの作成](#creating-a-schedule)
+ [スケジュールされたジョブの非アクティブ化](#deactivating-a-scheduled-job)
+ [すべてのスケジュールの表示](#viewing-all-schedules)
## 前提条件
同期スケジュールを作成する前に、必ず以下を完了してください。
+ 少なくとも 1 つのオブジェクト、オポチュニティ、またはリードにすべての必須フィールドを[マッピング](crm-connector-mapping.md)します。
+ Salesforce で[システム統合ユーザー](#system-integration-user)を作成します。
### システム統合ユーザーの作成
同期スケジュールを作成する前に、Salesforce を使用して APN 統合アクセス許可を持つシステム統合ユーザーを作成する必要があります。同期スケジュールを作成するには、システム統合ユーザーとして Salesforce にサインインする必要があります。APN 統合ユーザーのアクセス許可なしでスケジュールを作成すると、APN 統合が中断される可能性があります。
**システム統合ユーザーを作成するには**
1. システム管理者として Salesforce 組織にサインインします。
1. Salesforce 組織にユーザーを作成します。Salesforce 組織内の必要なオブジェクトにアクセスできるユーザーにプロファイルを割り当てます。詳細については、[「単一のユーザーを追加する](https://help.salesforce.com/s/articleView?id=sf.adding_new_users.htm)」を参照してください。
1. **APN 統合ユーザーの**アクセス許可セットをユーザーに割り当てます。詳細については、[「ユーザーに権限セットを割り当てる](https://help.salesforce.com/s/articleView?id=sf.assign_permission_set_to_user.htm)」を参照してください。
## スケジュールの作成
[前提条件](#scheduling-prerequisites)を完了したら、Salesforce と APN 間の同期スケジュールを作成できます。
**APN との同期スケジュールを作成するには**
1. システム統合ユーザーのアクセス許可を持つユーザーとして Salesforce にサインインします。
1. **スケジュール**タブで、**新規** を選択します。
1. スケジュールするオブジェクトを選択します。リードと機会、または 1 つのオブジェクトのスケジュールを設定できます。
1. スケジュールの頻度を、最低 5 分ごとから最大 1 日 1 回まで選択します。
1. [**スケジュール**] を選択します。
**注記**
オブジェクトごとに一度にアクティブにできるスケジュールは 1 つだけです。同じオブジェクトの新しいスケジュールを作成すると、既存のスケジュールが非アクティブ化されます。
スケジュールの作成時にインバウンド統合を無効にするには、**インバウンド統合を無効にする、スケジュール**を選択します。
APN 統合ユーザーのアクセス許可なしでスケジュールを作成すると、APN 統合が中断される可能性があります。
## スケジュールされたジョブの非アクティブ化
1. **スケジュールページで**、**すべてのジョブを非アクティブ化**を選択してアクティブなスケジュールをオフにします。
1. 確認画面を進み、同期スケジュールを非アクティブ化します。
## すべてのスケジュールの表示
**スケジュール**タブで、リストビューフィルターを使用して、**アクティブ**、**非アクティブ**、および**すべての同期**スケジュールを切り替えます。
# ベストプラクティス
これらのベストプラクティスを使用して、カスタム統合の開発とメンテナンスを最適化します。
## 一般的なベストプラクティス
1. (APN) カスタマーエンゲージメント AWS Partner Network (ACE) 送信フォームの必須フィールドであるため、すべての*必須フィールド*をマッピングします。
1. 現在の ACE Pipeline Manager ユーザーに接続して、プロセスがどのようになるかを理解します。独自のプロセス/フィールドの使用をキャプチャして、エクスペリエンスに組み込むことができます。
1. Amazon Web Services (AWS) が報告する販売ステージ (ステージ、ターゲット終了日、予想される月別 AWS 収益、次のステップなど) 用に個別の販売パイプラインステージを作成することを検討してください。ステージ定義が異なる場合、販売ステージが上書きされる場合があります。個別のセールスステージを作成すると、パイプラインを適切に管理できますが、何が予測されているかは可視化 AWS できます。
1. パートナーから紹介された機会については、更新を受け入れる前に ACE チームが承認/拒否する必要があります。
1. AWS 紹介されたオポチュニティの場合、パートナーはオポチュニティを受け入れるか拒否する必要があります。
## データ交換プロトコル
1. **入力規則**: 複数選択のピックリストエントリをセミコロンで区切り、スペースを省略します。
1. **詳細に注意: **フィールド名と値は大文字と小文字が区別されるため、精度を維持します。
1. **削除手順**: 選択したフィールド`null`の値を送信して、フィールドの削除を実行します。
1. **同期**: 同期プロセスは 1 時間ごとに動作するため、データリフレクションに遅延が発生する可能性があります。への更新は、顧客関係管理 (CRM) に反映されるまでに最大 1 AWS 時間かかる AWS 場合があります。1 時間に複数のドキュメントを送信しないでください。
## フィールド固有のベストプラクティス
1. **インバウンド変更**: データの整合性を保護するには、`stage`、、 などのフィールドの変更を無効にします`closedDate``closedLostReason`。ローカル Salesforce AWS 値に影響を与えずに値を追跡するには、、`awsStage`、 `awsCloseDate`の読み取り専用フィールドを使用します`awsClosedLostReason`。
1. **カスタマーマッピングと検証**: CRM AWS マッピングにとって重要なため、カスタマーウェブサイトの精度を確保します。顧客名と組み合わせて、優れた CRM アカウントマッピングを実現します。
1. **プロジェクトの説明の明確**さ: お客様の課題とソリューションの連携について詳しく説明した明確な説明を提供します。 はこれ AWS を使用して機会を検証します。
1. **プロビジョニング**: (オプション) エンドユーザーの問い合わせの詳細をプロビジョニングすると、 AWS はリードとキャンペーンを追跡できます。これにより、資金判断が強化されます。
## その他のベストプラクティス
1. 最新のペイロードフィールド定義ガイドラインに従ってください。
1. サンドボックスバケットの名前付けの一貫性を指定された形式に維持します。
1. 本番バケットに推奨される命名パターンを使用します。
1. ライブデプロイの前にサンドボックス環境テストを優先します。
1. AWS とパートナー CRMs。
1. アウトバウンド Amazon Simple Storage Service (Amazon S3) フォルダ内のファイルを後処理して削除します。オリジナルはアーカイブに残ります。
1. エラーを防ぐには、ソースでフィールドレベルの検証を設定します。
# クォータ
## Amazon Web Services へのインバウンドファイル (AWS）
| Operation | [制限] |
| --- | --- |
| 最大機会 | ファイルあたり 500 |
| 最大ファイルサイズ | 1 MB |
| 同期の頻度 | ほぼリアルタイム |
| 送信されたファイルの最大数 | 24 時間あたり 10,000 |
## パートナーへのアウトバウンドファイル
| Operation | [制限] |
| --- | --- |
| 最大ファイルサイズ | 5 MB |
| 同期の頻度 | 毎時 |
# バージョン履歴
現在のフィールドバージョン: 14 (2023 年 11 月 15 日）
次の表は、2020 年以降のリードと機会のカスタム統合フィールドの重要な変更点を示しています。今後の更新の通知を受け取るには、RSS フィードにサブスクライブします。
| 変更 | バージョン | 日付 |
| --- | --- | --- |
| Amazon S3 クォータを更新する | 14 | 1/17/2024 |
| **統合オポチュニティフィールドの変更：** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/partner-central/latest/crm/version-history.html) | 14 | 11/15/2023 |
| **統合オポチュニティフィールドの変更：** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/partner-central/latest/crm/version-history.html) | 13 | 03/29/2023 |
| **統合機会フィールドの変更：** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/partner-central/latest/crm/version-history.html) **オポチュニティの標準値の変更：** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/partner-central/latest/crm/version-history.html) | 12 | 09/01/2022 |
| **統合オポチュニティフィールドの変更：** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/partner-central/latest/crm/version-history.html) **オポチュニティフィールドの標準値の変更：** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/partner-central/latest/crm/version-history.html) | 11 | 03/21/2022 |
| **統合オポチュニティフィールドの変更：** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/partner-central/latest/crm/version-history.html) **オポチュニティの標準値の変更：** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/partner-central/latest/crm/version-history.html) | 10 | 01/26/2022 |
| **リードフィールドの標準値の変更：** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/partner-central/latest/crm/version-history.html) **統合リードフィールドの変更：** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/partner-central/latest/crm/version-history.html) **統合オポチュニティフィールドの変更：** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/partner-central/latest/crm/version-history.html) | 9 | 9/16/2021 |
| Closed Lost 理由コードを更新する | 8 | 6/24/2021 |
# よくある質問
これらの一般的な質問と回答を使用して、カスタム統合を支援します。
**Topics**
+ [一般的なよくある質問](general-faq.md)
+ [技術的なよくある質問 — フィールド](technical-faq-fields.md)
+ [技術的なよくある質問 — Amazon S3](technical-faq-s3.md)
+ [技術的なよくある質問 — リードと機会](technical-faq-leads-and-opps.md)
+ [技術に関するよくある質問 — バージョニングと下位互換性](technical-faq-versioning.md)
# 一般的なよくある質問
## 統合の仕組み
**Q: ファイルの送受信に使用される Amazon Simple Storage Service (Amazon S3) バケットにアクセスできますか？**
はい。パートナーは、バケットにアクセスできる AWS Identity and Access Management (IAM) のシークレット/アクセスキーを使用して Amazon S3 バケットにプログラムでアクセスできます。これらのバケットは Amazon Web Services () の独自のアカウントにあるため、パートナーは Amazon S3 バケットにコンソールでアクセスできません。AWS
**Q: パートナーの開発者にはどのようなスキルセットが必要ですか？**
パートナーの開発者は、顧客関係管理 (CRM) システムと Amazon S3 に精通している必要があります。
**Q: サンプルコードファイルには完全なコードが含まれていますか、またはパートナーがコードを記述する必要がありますか？**
パートナーは、提供されたサンプルコードファイルに基づいてコードを記述する必要があります。
**Q: パートナーが Python、Golang、またはその他の言語でソリューションを開発する場合、 AWS Partner Network (APN) カスタマーエンゲージメント (ACE) は、この統合のためにそれらの言語でソフトウェア開発キット (SDK) を提供しますか？**
いいえ。
**Q: Amazon S3 バケットから内部 ACE への同期プロセスは何ですか？**
バッチプロセスは 1 時間ごとに実行され、ファイルを取得し、情報を同期します。 AWS セールスチームがレコードに対して行う更新は、パートナーのバケットに送信されるまでに最大 1 時間かかる場合があります。パートナーは更新に関する E メール通知をすぐに受け取ることができますが、 の更新が 1 時間遅れ AWS る場合があります。
**Q: ACE によるリードファイルとオポチュニティファイルのアップロードの頻度はどのくらいですか？**
ACE はリードとオポチュニティのデータを 1 時間ごとに送信します。
**Q: ACE 用のサンドボックス環境はありますか？**
はい。ACE にはサンドボックス環境がありますが、セキュリティ上の理由からパートナーにアクセスすることはできません。新しい機会やリードをバケットにプッシュする場合は、Partner Central でサポートケースを作成します。
**Q: パートナーの CRM と APN 全体で識別子を維持するにはどうすればよいですか？**
パートナーに柔軟性を提供するために、システム内で 2 セットの識別子を使用します。
1. `apnCrmUniqueIdentifier`：この識別子 AWS を管理します。機会`OXXXXXX`の場合は で始まり、リード`LXXXXXX`の場合は で始まります。
1. `PartnerCrmUniqueIdentifier`/`partnerCrmLeadId`: パートナーは、CRM 内で、それぞれ機会とリードでこの識別子を管理します。パートナーは、CRM に更新をトレースする新しい機会を取り込みながら、この識別子を追加する必要があります。
`apnCrmUniqueIdentifier` または なしでオポチュニティが送信されると`partnerCrmUniqueIdentifier`、 はそれを新しいオポチュニティとして AWS 扱い、オポチュニティ`apnCrmUniqueIdentifier`に新しい を割り当てます。
`apnCrmUniqueIdentifier` または でオポチュニティが送信されると`partnerCrmUniqueIdentifier`、 はそれを更新アクションとして AWS 扱い、ペイロードデータで既存のオポチュニティを更新します。
**Q: 両方のシステムで重複するレコードが作成されないようにするにはどうすればよいですか？**
パートナー CRM 側から、ACE に送信されるレコードごとに一意の識別子が必要です。これは と呼ばれます`partnerCrmUniqueIdentifier`。同様に、ACE はレコードごとに一意の識別子も保持します。これは と呼ばれます`apnCrmUniqueIdentifier`。データが送信されると、ACE とパートナーの両方にこれらの 2 つのフィールドを含める必要があります。これは、レコードが新しいオポチュニティ (空白の場合) か既存のオポチュニティ (入力されている場合) かを識別するのに役立ちます。
# 技術的なよくある質問 — フィールド
**Q: 統合は CSV 形式をサポートしていますか？**
いいえ。統合は JSON ファイル形式のみを受け入れます。
**Q: アウトバウンドフォルダからファイルを削除する必要があるのはいつですか？**
ファイルを正常に処理した後にのみ削除します。
**Q: アウトバウンドフォルダからファイルを誤って削除した場合、元のファイルはどこにありますか？**
ファイルは `opportunity-outbound-archive`および `lead-outbound-archive`フォルダにあります。
**Q: 開発中のサポートについてはどうすればよいですか？**
開発中のサポートについては、 Partner Central の AWS Partner Network (APN) サポートにお問い合わせください。
**Q: `opportunityOwnerName`と の違いは何ですか`opportunityOwnerEmail`？**
+ `opportunityOwnerName`: パートナー組織内のオポチュニティ所有者の名前。これは Partner Central ユーザーである必要があります。
+ `opportunityOwnerEmail`: パートナー組織内のオポチュニティ所有者の E メール。これは Partner Central ユーザーである必要があります。指定しない場合、オポチュニティは Partner Central Alliance Lead を所有者として作成されます。
**Q: すべての日付フィールド (`targetCloseDate`、`lastModifiedDate`、、`createdDate``acceptBy`) のタイムゾーンは何ですか？**
日付フィールドのタイムゾーンはグリニッジ標準時 (GMT) です。
**Q: インバウンド JSON ファイルはバージョン管理されていますか？**
いいえ。Amazon Web Services (AWS) はファイルのバージョニングをサポートしていません。APN Customer Engagement (ACE) は、受信直後にファイルを処理し、処理が成功するとファイルを削除します。同じファイル名を再度受け取ると、拒否されます。
**Q: Amazon Simple Storage Service (Amazon S3) JSON ファイル内のどのフィールドが、特定のリードとオポチュニティの作成日と最新の更新日を示していますか？**
`createdDate` および `lastModifiedDate`。
**Q: オポチュニティが新規か既存かを判断するにはどうすればよいですか？**
フィールド`PartnerCrmUniqueIdentifier`は、パートナーに要求する各オポチュニティの一意の識別子です。この識別子は、パートナーのシステムのソース CRM で定義する必要があります。これを使用して、オポチュニティが存在するかどうかを判断します AWS。存在する場合は、共有情報でオポチュニティを更新します。そうでない場合は、新しいオポチュニティを作成します。
パートナーにデータを送信するときは、 `PartnerCrmUniqueIdentifier`と の両方が含まれます`apnCrmUniqueIdentifier`。によって共有されたオポチュニティ AWS が初めて送信される場合は、 の値が表示されません`PartnerCrmUniqueIdentifier`。これにより、ACE から機会を新しいものとして扱うことができます。CRM に取り込んだら、 `PartnerCrmUniqueIdentifier`と の両方を使用して更新を返送します`apnCrmUniqueIdentifier`。
**Q: Amazon S3 に複数のアウトバウンドおよび結果 JSON ファイルを含めることは可能ですか？**
はい。アウトバウンドフォルダにさらにファイルを生成する場合があります。同様に、ファイルをインバウンドフォルダに送信すると、ファイルは処理され、結果ファイルは結果フォルダに保持されます。処理後に結果ファイルにタグを付けるか、削除する必要があります。
**Q: アウトバウンドファイルには複数のレコードが含まれていますか？**
はい。アウトバウンドファイルには、複数のレコードを含めることができます。
**Q: 20 件のインバウンドオポチュニティがオポチュニティセクションの 1 つの入力 JSON ファイルで送信され、オポチュニティの 1 つが APN 標準に準拠していない場合、どうなりますか？**
形式が正しくない場合、その場合でもファイル全体が拒否されます。形式が正しいが、1 つのオポチュニティしか処理できない場合、結果ファイルには、失敗したオポチュニティのエラーメッセージとともに、20 のすべてのオポチュニティとそのステータスが含まれます。
**Q: JSON ファイルが正常に処理されたかどうかを検証する主要な属性は何ですか？**
これらは、JSON ファイルが正常に処理されたかどうかを理解するのに役立つ主要な属性です。
```
{
"inboundApiResults": [
{
"warnings": null, // no warnings
"partnerCrmUniqueIdentifier": "XXXX", //uniqueId from Partner side
"isSuccess": true, // file successfully processed
"errors": null, //no errors reported
"apnCrmUniqueIdentifier": "OXXXX" //uniqueId from AWS side
}
]
}
```
**Q: 無効な JSON を送信するとどうなりますか？**
このエラーレスポンスは`[{input JSON}]`「 は」タイプではありません`object`。
**Q: 1 つのインバウンド JSON ファイルに含めることができるリード/オポチュニティレコードの数はいくつですか？**
1 つのファイルには最大 50 個のレコードを含めることができます。
# 技術的なよくある質問 — Amazon S3
**Q: Amazon Simple Storage Service (Amazon S3) REST API ドキュメントはどこで入手できますか？**
詳細については、[Amazon S3 REST API の概要](https://docs.aws.amazon.com/AmazonS3/latest/API/Welcome.html)」を参照してください。
**Q: Amazon S3 バケットにアクセスするために認証するための Amazon Web Services AWS Key Management Service （AWS KMS) キーの詳細を取得するにはどうすればよいですか? Amazon S3 **
AWS Partner Network (APN) は、キー名を含むポリシーを共有します。
**Q: Salesforce.com (SFDC) から Amazon S3 を認証するにはどうすればよいですか？**
サンプルコードファイル [S3\$1Authentication.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls) を使用して、SFDC から Amazon S3 を認証します。
**Q: Software Development Kit (SDK) AWS から S3 にファイルをアップロードするにはどうすればよいですか？**
次の AWS CLI コマンドを使用して、ファイルを S3 にアップロードします。
```
aws s3 cp example.json s3://awsexamplebucket/opportunity- inbound/filename.json --acl bucket-owner-full-control
```
サンプルコードファイル [Sample\$1AceOutboundBatch.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls) には、SFDC からデータファイルをアップロードするコードが含まれています。
**Q: Amazon S3 バケットを所有しているのは誰ですか？**
AWS は Amazon S3 バケットを所有および管理します。 AWS Identity and Access Management (IAM) ユーザーを使用して、独自の Amazon S3 バケットにプログラムでアクセスできます。
**Q: ファイルを受信および送信するための個別のフォルダまたはバケットはありますか？**
ファイルを受信および送信するための異なるフォルダを持つバケットが 1 つあります。フォルダの詳細については、 ユーザーガイドを参照してください。
**Q: を使用して Amazon S3 バケットにアクセスする必要がありますか AWS Lambda、または顧客関係管理 (CRM) システムを使用して直接アクセスできますか？**
どちらの方法でもアクセスできます。
**Q: Amazon S3 バケットは保護または暗号化されていますか？**
はい。Amazon S3 が提供するデフォルトの暗号化メカニズムを有効にします。
**Q: Amazon S3 バケットをリッスンする Amazon Simple Notification Service (Amazon SNS) を有効にして、定期的にポーリングするのではなく、イベントに対してのみアクションを実行できますか？**
いいえ。現在、APN カスタマーエンゲージメント (ACE) はこの機能をサポートしていません。
**Q: どのフォルダにアクセスできますか? 各フォルダの目的は何ですか？**
Amazon S3 フォルダのリストは、 にあります[統合の前提条件](crm-integration-setting-up.md)。
# 技術的なよくある質問 — リードと機会
## リードと機会の送受信
**Q: ファイル命名規則はありますか？**
各ファイル名は一意である必要があります。ファイル名は にすることをお勧めします`PartnerProvided FileName+{timestamp}.json`。
**Q: 結果の構造は何ですか？**
結果のサンプルファイル (成功とエラー) は、次の場所からダウンロードできます。
+ [リード結果の成功 Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-Sample.json)
+ [機会の結果 Success Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results-Success-Sample.json)
+ [Errors Sample.json を含むリード結果](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results_With-Errors-Sample.json)
+ [Errors Sample.json による機会の結果](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results_With-Errors-Sample.json)
**Q: 結果の命名規則は何ですか？**
`PartnerProvidedFileName_result.json`
**Q: 同じ名前の 2 番目の JSON ファイルを送信するとどうなりますか？**
ファイルは処理されず、ファイルはアーカイブフォルダに移動されます。
**Q: インバウンドファイルのサイズ制限はどのくらいですか？**
インバウンドファイルのサイズ制限は 1MB です。
**Q: 1 つの JSON ファイルにバッチ処理できる機会とリードの最大数はありますか？**
1MB の制限を考慮すると、ファイルごとに 1 つのオポチュニティまたはリードを持つことをお勧めします。
**Q: アクセス拒否エラーメッセージが表示されるため、ファイルをアップロードできません。どうすればよいですか?**
パートナーは、2 つの理由で*アクセス拒否*メッセージを受け取ります。
1. ファイルを `outbound`フォルダではなく `inbound`フォルダにアップロードしました。ファイルを `inbound`フォルダにアップロードします。
1. アクセスコントロールリスト (ACL) を指定する必要があります。データファイルをアップロードするには、次の Amazon Web Services (AWS) CLI コマンドを使用します。
```
aws s3 cp example.json s3://awsexamplebucket --acl bucket-owner-full-control
```
**Q: `.pdf`、、`.docx`または 以外の拡張子を持つファイルがアップロードされた場合`.json`はどうなりますか？**
ファイルを拒否し、理由の詳細を含む`*.error.json`ファイルを生成します。
**Q: 本番環境でデータ問題エラーメッセージが表示されたらどうすればよいですか？**
1. パートナーのカスタマーリレーションシップ管理 (CRM) システムでデータを修正する必要がある場合は、データを修正した後、修正したファイルを Amazon Simple Storage Service (Amazon S3) に送信します。
1. データに明確化が必要な場合は、 Partner Development Manager (PDM) にお問い合わせください。
1. その他のテクニカルサポートについては、APN ポータルで AWS Partner Network (APN) サポートケースを提出してください。
**Q: 結果ファイルはどこにありますか。また、どのくらいの期間利用できますか。**
結果ファイルは `lead-inbound-results`および `opportunity-inbound-results`フォルダにあります。削除されるまで使用できます。プルが成功したら、ファイルを削除できます。
**Q: 削除した後に結果ファイルを見つける必要がある場合、どこで見つけることができますか？**
結果ファイルは、 `lead-inbound-results-archive/YYYY/MM/DD`および `opportunity-inbound-results-archive/YYYY/MM/DD`フォルダにあります。
**Q: ファイルの APN 処理に障害が発生した場合、どのように通知されますか？**
APN には、処理エラーを追跡するために Sev2 チケットを自動的に作成するアラームがあります。これらを確認して解決し、パートナーに伝えます。
**Q: オポチュニティの開始後はどのフィールドを更新できますか？**
以下のフィールドは、独立系ソフトウェアベンダー (ISV) Accelerate パートナーのみが更新できます。
+ `isThisForMarketplace`
+ `isNetNewBusinessForCompany`
+ `deliveryModel`
+ `awsFieldEngagement`
+ `additionalComments`
**Q: *編集できないレコード*エラーが表示されました。これはどういう意味ですか？**
新しいパートナーから紹介されたオポチュニティを送信すると、検証プロセスが実行され、APN カスタマーエンゲージメント (ACE) チームが承認または拒否する必要があります。オポチュニティがレビュー中であり、まだ検証されていない間は、レコードを更新できず、このエラーが表示されます。
**Q: 自分の側でアクティビティがない場合 (例: ファイルを処理していない、またはインバウンドオポチュニティを送信していない場合) はどうなりますか？**
お客様が情報を送信しない場合、または当社が提供するファイルを処理していない場合、現在、お客様に警告するメカニズムはありません。システムをモニタリングして、情報が APN に流れていることを確認することをお勧めします。
**Q: JSON の結果は、新規/更新されたインバウンドオポチュニティ/リードの送信後、どのくらい早く結果フォルダで利用できますか？**
処理はほぼリアルタイムです。ファイルは 5 分以内に届きます。
**Q: APN 標準の形式/長さ制限に準拠していないインバウンドオポチュニティ CRM を送信する場合、システムはそれをどのように処理しますか？ エラーレポートが生成されますか？**
ファイルがフィールド定義形式でない場合、APN の結果ファイルはファイルを呼び出します。
**Q: 起動時に AWS アカウント ID がありません。どうすればよいですか？**
ACE プロセスでは、 はワークロードが完了し、請求が開始された`Launched`ことを意味します。これには AWS アカウント ID が必要です。詳細については、[「ACE プログラムに関するFAQs](https://partnercentral.awspartner.com/partnercentral2/s/resources?Id=0690h000003xjjXAAQ)」を参照してください。
**Q: ユーザー受け入れテスト (UAT) の後、本番環境への移行中に履歴データをどのように処理する必要がありますか？**
デフォルトでは、ACE で更新が発生すると、それらの機会が Amazon S3 バケットに送信されます。処理したくない履歴データの場合は、システムで処理したくないものの抽出`X0001, X0002….X000N`で などのダミー値を `partnerCrmUniqueIdentifier` に提供する必要があります。これらの識別子を認識し、それに応じて処理するためのコードを記述する必要があります。残りの機会は正しい`partnerCrmUniqueIdentifier`値を提供します。これにより、システムで処理するものと処理しないものを完全に制御できます。
**Q: アウトバウンドファイルには複数のレコードが含まれていますか？**
はい。アウトバウンドファイルには、複数のレコードを含めることができます。
**Q: データが一部のフィールドで *Accept to view* を送信するのはなぜですか？**
AWS 参照されたオポチュニティまたはリードの場合、オポチュニティまたはリードが受け入れられるまで、すべての PII フィールドは*「Accept to view*」というラベルでマスクされます。承認されると、次の同期サイクルですべてのデータフィールドを受け取ります。
**Q: 新しい AWS 紹介された機会またはリードが初めて同期された場合はどうすればよいですか？**
新しいオポチュニティまたはリードを初めて同期する場合は、追加のデータ (顧客の連絡先など) を取得するために、そのオポチュニティまたはリードを承認または拒否する必要があります。
## 機会/リーダーの作成と更新
**Q: 統合を通じて ACE に新しい*パートナー紹介 (発信）* の機会を取り込むにはどうすればよいですか？**
統合を通じて ACE で新しいオポチュニティを作成するには、定義された JSON 形式の必要なオポチュニティ情報を `opportunity-inbound`フォルダに取り込む必要があります。 はこの情報 AWS を処理し、ACE で新しいオポチュニティを作成し、 `opportunity-inbound-processed-results`フォルダで成功/失敗した作成オペレーションの結果を共有します。
**Q: 統合では、新しいオポチュニティの送信と更新はどのように区別されますか？**
各オポチュニティ`PartnerCrmUniqueIdentifier`の フィールドは、必須の一意の識別子です。この識別子は、システムソース CRM で定義する必要があります。 AWS はこれを使用して、ACE にオポチュニティがすでに存在するかどうかを判断します。ACE で利用可能な場合は、共有された情報を使用してオポチュニティを更新しますが、ACE で利用できない場合は、共有された情報を使用して新しいオポチュニティを作成します。
**Q: 統合を通じて更新機能をすでに実装している場合は、統合を使用して新しい機会を送信 (作成) するために何をする必要がありますか？**
既存の統合に次の変更を加える必要があります。
1. `opportunity-inbound` フォルダに新しい作成機会の取り込みを開始します。同じフォルダに更新を提供します。
1. 作成に必要な必須フィールドが、共有されたオポチュニティ JSON で使用可能であることを確認します。
1. 新しいオポチュニティごとに、ACE/Partner Central に存在しない一意の `PartnerCrmUniqueIdentifier` があることを確認します。重要な運用開始のベストプラクティスは、更新を受信したときに重複を作成しないように、ACE の既存のデータを CRM `PartnerCrmUniqueIdentifier`の各 にマッピングして更新することです。サポートが必要な場合は、ACE にお問い合わせください。
**Q: 本番稼働プロセスの一環として、ACE の既存のオポチュニティを で更新するにはどうすればよいですか`PartnerCrmUniqueIdentifier`？**
ACE チームは、本番稼働開始の準備に役立つすべてのオープンオポチュニティのリストを提供します。ACE のこれらの既存のオポチュニティをそれぞれの にマッピングし`PartnerCrmUniqueIdentifier`、更新されたファイルを ACE に返して AWS CRM に統合する必要があります。
提供される機会 AWS のサブセットのみを同期することを選択した場合は、処理したくない機会 AWS の更新をバイパスするロジックを開発する必要があります。このアプローチは、オンボーディング後の将来の機会にも適用する必要があります。両方の CRMs 間で調整が必要な機会`partnerCrmUniqueIdentifier`には、関連付けられた を指定する必要があります。さらに、更新しない機会 (例: クローズドロストオポチュニティまたはクローズドウォンオポチュニティのマーク) を指定して、更新から除外する必要があります。が AWS 共有し、受け入れるすべてのオープン/アクティブオポチュニティに が割り当てられることが重要です`partnerCrmUniqueIdentifier`。
**Q: オポチュニティまたはリードの特定のフィールドのみを更新できますか？**
はい。更新が必要なフィールドと必要な識別子のみを指定できます。
**Q: *ApnCrmUniqueIdentifier* を変更することは可能です**か？
いいえ。この識別子は に対して一定であり AWS 、各オポチュニティを一意に識別します。
**Q: *partnerCrmUniqueIdentifier* が正しくない場合はどうなりますか**？
間違った識別子を指定すると、新しいオポチュニティが作成されます。データの重複を避けるために精度を確保します。
**Q: が AWS 送信した機会を更新できますか？**
はい。送信されたオポチュニティ AWS は、正しい を使用して更新できます`partnerCrmUniqueIdentifier`。
**Q: 送信された機会の結果はどのくらいで期待できますか？**
処理はほぼリアルタイムで、結果は通常数分以内に `opportunity-inbound-processed-results`フォルダで確認できます。
**Q: 送信されたオポチュニティの処理エラーがある場合はどうすればよいですか？**
結果ファイルでエラーの詳細を確認し、問題に対処し、ACE サポートチームからさらに支援を求めます。
**Q: 統合を通じてオポチュニティを削除できますか？**
いいえ。直接削除はサポートされていません。オポチュニティを更新して、*クローズ*ステータスを反映することができます。
**Q: *レコードの編集不可*エラーとはどういう意味ですか？**
このエラーは、ACE レビューでオポチュニティを更新しようとすると発生します。これらの機会は、検証されるまで編集できません。
**Q: 更新や新しい機会を送信しない場合はどうなりますか？**
統合を通じて更新や新しいオポチュニティを送信しない場合、新しいデータは受信および処理されません。
**Q: 結果ファイルはどのくらいの期間使用できますか？**
結果ファイルは妥当な期間使用できます。それらをすぐに取得して管理する必要があります。
# 技術に関するよくある質問 — バージョニングと下位互換性
**Q: アマゾン ウェブ サービス (AWS) データ交換のペイロードとは？**
ペイロードは、JSON でフォーマットされた構造化されたデータであり、 へのインバウンド AWS または からのアウトバウンドに送信されます AWS。この JSON 構造の各キーは*フィールド*と呼ばれ、各フィールドには関連する*値があります。*
**Q: ペイロードのバージョンはどのように決定されますか？**
ペイロードバージョンは、ペイロード自体の `version`フィールド内で指定されます。フィールド定義 v13 に準拠するペイロードはペイロードバージョン 1.0 と見なされ、フィールド定義 v14 以降で定義された形式に従うペイロードはペイロードバージョン 2.0 と呼ばれます。
**Q: このコンテキストでの下位互換性とはどういう意味ですか？また、どのように処理されますか？**
下位互換性により、新しいペイロードバージョンで新しいフィールドと必須フィールドが導入されても、既存の機会が失敗することがなくなります。 は、新しいバージョンで必要なフィールドにデフォルト値を自動的に割り当てることで、これ AWS を維持します。（ AWS Partner Network APN) カスタマーエンゲージメント (ACE) UI で、カスタマーリレーションシップ管理 (CRM) 統合を通じて明示的に指定していない値が表示される場合があります。各フィールドの詳細と条件は、フィールドの説明またはフィールドに関する追加の詳細で説明されています。
**Q: 下位互換性は永続的な機能ですか？**
いいえ。下位互換性は期限付きであり、今後の変更を計画して実装するための柔軟性を提供するように設計されています。指定されたカットオフ日を超えて動作しなくなります。これは、より広範なローンチの一環として、年後半に発表される予定です。
**Q: バージョン 2.0 でペイロードの送信を開始するとどうなりますか？**
バージョン 2.0 でペイロードを送信すると、システムは必要なすべての変更が実装されていることを前提としており、新しいペイロードバージョンの検証はそれ以降のすべての変更に適用されます。バージョン 1.0 とバージョン 2.0 のペイロードの間に機能は部分的に実装しないことが重要です。
**Q: バージョン 2.0 に更新した後、ペイロードバージョン 1.0 に戻すことはできますか？**
いいえ。ペイロードバージョン 2.0 への移行は一方向のプロセスです。バージョン 2.0 に更新すると、ペイロードのバージョン 1.0 に戻すことはできません。
# ヘルプの利用
CRM 統合に関するヘルプについては、 AWS Partner Central でサポートケースを送信してください。
**ケースを送信するには**
1. Central にサインインします[AWS Partner](https://partnercentral.awspartner.com/APNLogin)。
1. 上部のメニューから、**サポート**、**サポートへのお問い合わせ**を選択します。
1. [AWS Partner サポート](https://partnercentral.awspartner.com/partnercentral2/s/support)ページで、**新しいケースを開く**を選択します。
1. **新しいサポートケースを開く**ページで、**CRM 統合**を選択します。
1. フォームに入力し、**送信**を選択します。
# 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** ボタンは、**パートナー紹介**の機会タイプにのみ表示されます。
# リリースノート
このセクションでは、 AWS Partner Customer Relationship Management (CRM) Connector for Salesforce のリリース履歴を示します。
**Topics**
+ [バージョン 3.16 (2026 年 2 月 26 日)](#3.16)
+ [バージョン 3.15 (2026 年 2 月 6 日)](#3.15)
+ [バージョン 3.14 (2025 年 12 月 17 日)](#3.14)
+ [バージョン 3.13 (2025 年 10 月 30 日)](#3.13)
+ [バージョン 3.12 (2025 年 9 月 16 日)](#3.12)
+ [バージョン 3.11 (2025 年 9 月 10 日)](#3.11)
+ [バージョン 3.10 (2025 年 8 月 6 日)](#3.10)
+ [バージョン 3.8 (2025 年 4 月 17 日)](#3.8)
+ [バージョン 3.6 (2025 年 3 月 18 日)](#3.6)
+ [バージョン 3.5 (2025 年 1 月 22 日)](#3.5)
+ [バージョン 3.1 (2024 年 12 月 2 日)](#3.1)
+ [バージョン 3.0 (2024 年 11 月 14 日)](#version-3.0-november-14-2024)
+ [バージョン 2.2 (2024 年 4 月 24 日)](#2.2)
+ [バージョン 2.1 (2024 年 4 月 18 日)](#2.1)
+ [バージョン 2.0 (2023 年 11 月 29 日)](#2.0)
+ [バージョン 1.7 (2022 年 10 月 12 日)](#1.7)
+ [バージョン 1.6 (2023 年 1 月 13 日)](#1.6)
+ [バージョン 1.5 (2023 年 1 月 13 日)](#1.5)
+ [バージョン 1.4 (2022 年 12 月 7 日)](#1.4)
## バージョン 3.16 (2026 年 2 月 26 日)
AWS Partner CRM Connector バージョン 3.16 には、次の機能と改善点が含まれています。
### バグ修正
+ オポチュニティの作成中にソリューションフィールドが保持されない問題を修正しました。バージョン 3.15 では、パートナーがソリューションフィールドが入力されてオポチュニティを作成したときに、ソリューションは AWS Partner Central でオポチュニティに関連付けられていませんでした。コネクタは、CreateOpportunity API コールと AssociateOpportunity API コールを適切に連鎖させて、オポチュニティの作成中にソリューションが正しく関連付けられるようにするようになりました。
+ **APN Business Admin** アクセス許可セットで**ソースオポチュ**ニティフィールドの編集アクセス許可が欠落していたアクセス許可のギャップを修正しました。バージョン 3.10 で 用に追加されたこのフィールドには`Unified Standard-ACE Opportunity Sync Flow`、適切な読み取りおよび編集アクセスが可能になり、ビジネス管理者は標準オポチュニティレコードから ACE オポチュニティレコードを作成するオートメーションを使用できるようになりました。
+ 郵便番号システムがない国 (アラブ首長国連邦、香港、ボネールなど) を含め、郵便番号がすべての国の必須フィールドとして誤って適用される問題を修正しました。郵便番号フィールドはオプションになりました。AWS Partner Central API 仕様に準拠し、パートナーは郵便番号を使用しない国の顧客に機会を作成できるようになりました。
## バージョン 3.15 (2026 年 2 月 6 日)
AWS Partner CRM Connector バージョン 3.15 には、次の機能と改善点が含まれています。
### AWS Partner Central API
**自動 AWS データ共有の機能強化**
+ との自動レコード同期を強化し AWS 、オポチュニティの作成と更新の両方でシームレスに機能
+ データ共有の`Sync ACE Opportunity to Partner Central API`フローが不要
** AWS 機能からの更新**
+ イベントを必要とせずに AWS Partner Central から直接オポチュニティデータを更新する機能を追加
+ パートナーは、**ACE オポチュニティ**ページレイアウトのボタンを使用して、AWS Partner Central から最新の更新をオンデマンドで取得できます。
+ Salesforce と AWS Partner Central 間のデータ整合性を確保します
### バグ修正
+ Industry ****フィールドで指定された「その他」の機会が AWS Partner Central に同期するときに API ペイロードに含まれず、ドラフトステータスのままになる問題を修正しました。
+ 通貨フィールドと収益フィールドの科学的表記の書式設定の問題を修正し、大きな金額の API 検証が失敗する原因となっていた
## バージョン 3.14 (2025 年 12 月 17 日)
AWS Partner CRM Connector バージョン 3.14 には、次の機能と改善点が含まれています。
### AWS Partner Central API
**オポチュニティデータのバックフィル**
+ AWS Partner Central から Salesforce への既存のすべての機会について、パートナーがコネクタインターフェイスから直接データ同期を開始できるようにする専用**バックフィル**機能を追加しました。
+ ステージやその他のフィルタリングオプションに基づくオポチュニティ選択のユーザー定義基準を実装
**機会の関連付けの強化**
+ 4 フィールドアプローチを、一貫した動作を持つ 3 つの明確で検索可能なフィールドにまとめました。
+ **ソリューション**、**AWS 製品**、**AWS Marketplace オファー**の先行入力機能を備えた検索可能なドロップダウンフィールドを実装
+ 正しい API 識別子を維持しながらフレンドリ名 (AWS Amplify など) を表示するように AWS Products ****フィールドを改善
**作成時のオポチュニティ所有者の割り当て**
+ CreateOpportunity API を使用してオポチュニティの作成中にオポチュニティ所有者を設定するサポートを追加
+ BusinessTitle 「OpportunityOwner」との OpportunityTeam メンバーの適切なマッピングを実装しました OpportunityOwner
### バグ修正
+ 名、姓、または電話番号が指定されている場合にのみペイロードを AWS と共有するための OpportunityTeamMember E メール検証の検証の問題を修正しました
+ 選択したピックリスト値を正しく共有するように国家安全保障フィールドロジックを更新
+ Partner Account Manager フィールドのツールヒントを更新
## バージョン 3.13 (2025 年 10 月 30 日)
AWS Partner CRM Connector バージョン 3.13 には、次の機能と改善点が含まれています。
### AWS Partner Central API
**一括承認と一括割り当ての機会**
+ 複数の ACE オポチュニティを同時に**受け入れ**たり**割り当て**たりする機能を追加し、オポチュニティ管理の効率を改善
**オポチュニティ同期ログ**
+ AWS Partner Central API 統合のユーザーは、ACE オポチュニティオブジェクト内で対応する同期ログを直接表示できるようになりました。この機能は、各オポチュニティの同期プロセスを可視化します。
### バグ修正
+ データ型の不一致により、オポチュニティの送信中に Customer DUNS number フィールド (`customerDuns`) が拒否される問題を解決しました
+ 同期ログの詳細でエラーメッセージフィールド (`awsapn__Error_Message__c`) のサイズを 32KB から 128KB に増やし、エラーメッセージの切り捨てを防ぎ、大量の同期エラー中の Apex ジョブ処理の中断を回避
+ 郵便番号が無効な形式の場合、オポチュニティは送信済みと表示されるが、ドラフトステータスのままになる問題を修正しました。コネクタに非同期 API 検証エラーが表示されるようになり、パートナーは AWS に送信する前に郵便番号のフォーマットを修正できるようになりました。
+ ソリューション提供フィールドで指定された「その他」の機会が、送信済みに進む代わりにドラフトステータスのままになる問題を解決しました。コネクタは「その他」ソリューション値を適切に処理し、API レスポンスを正しく解析して、ACE 検証プロセスを通じて機会を進めることができるようになりました。パートナーは、他のソリューションの説明フィールドに「その他」がある場合でも、有効なソリューションを関連付けることができるようになりました。
## バージョン 3.12 (2025 年 9 月 16 日)
AWS Partner CRM Connector バージョン 3.12 には、次の機能と改善点が含まれています。
### バグ修正
+ `Unified_Standard_ACE_Sync` フローテンプレートをアクティブ状態ではなく**ドラフト**状態に設定します。一部のお客様は、フローテンプレートがアクティブ状態でインストールエラーが発生していました。
## バージョン 3.11 (2025 年 9 月 10 日)
AWS Partner CRM Connector バージョン 3.11 には、次の機能と改善点が含まれています。
### AWS Partner Central API
**高度なログ記録**
+ AWS Partner Central API 統合とオポチュニティ同期プロセスの詳細なログ記録機能を拡張
+ オポチュニティ同期プロセスのトラブルシューティング情報を追加しました
### バグ修正
+ Solution Offered フィールドからsolutions/offers/services関連付けを解除できない問題を修正しました
+ AWS Partner Central から同期できるソリューションリストの最大数が 50 から 100 に増加
+ ソリューションが「削除」状態の場合のソリューションサービスのソリューションの可視性の問題を修正しました
+ AWS Partner Central で変更が行われたときに Salesforce に重複する機会が表示される問題を解決しました
+ ACE オブジェクトの AWS Partner Success Manager フィールドと AWS ISV Success Manager フィールドにフルネームが表示されるようになりました
## バージョン 3.10 (2025 年 8 月 6 日)
AWS Partner CRM Connector バージョン 3.10 には、次の機能と改善点が含まれています。
### AWS Partner Central API
**自動 AWS データ共有**
+ AWS Partner Central カスタム設定で** AWS 統合との共有を有効にする**設定
+ 更新が発生した AWS ときの との自動レコード同期
+ ボタンクリック**による手動共有 AWS**が不要
+ レコード更新 AWS 時の へのシームレスなデータフロー
**エンティティの関連付けの簡素化**
+ **関連付け**または関連付け**解除**をクリックせずに、それぞれのフィールドにオファーと製品を関連付ける組み込み機能
+ 選択に基づくバックエンド API コールの自動処理
**招待管理の合理化**
+ **パートナー承認ステータスフィールドドロップダウンから直接招待を承諾**/拒否する
+ 選択に基づくバックエンド API コールの自動処理
**自動化の改善 - 新しい統合スタンダード ACE オポチュニティ同期フローテンプレート**
+ 標準の Salesforce オポチュニティと ACE オポチュニティ間の自動同期を有効にします
+ CRM コネクタを使用する際の共同販売の機会共有をサポート
+ 標準オポチュニティフィールドの事前設定済みフィールドマッピングが含まれます
+ ACE 機会の作成と更新の両方を処理します
+ 自動状態/国マッピングとデフォルト値処理機能
## バージョン 3.8 (2025 年 4 月 17 日)
AWS Partner CRM Connector バージョン 3.8 には、以下の機能と改善点が含まれています。
### バグ修正
+ 同期後のオポチュニティで **APN CRM ID** が更新されない問題を修正しました。
+ 販売者が 50 を超える製品を出品している Marketplace 製品を更新しようとする問題を修正しました。
+ ACE オブジェクトの AWS Sales Rep フィールドと AWS Account Manager フィールドでフルネームが表示されない問題を修正しました。
## バージョン 3.6 (2025 年 3 月 18 日)
AWS Partner CRM Connector バージョン 3.6 には、次の機能と改善点が含まれています。
### AWS Marketplace
+ Software as a Service (SaaS) pay-as-you-goの小数点以下 8 桁 (3 桁から増加) のサポートが追加されました。これは料金基準と一致しています AWS Marketplace 。
### バグ修正
+ パートナーは Partner Central で直接オポチュニティを作成できるようになりました。これらの機会は、CRM コネクタを介してパートナーの Salesforce AWS Partner 組織と自動的に同期されます。これにより、紹介プロセスが改善され、パートナーと 間のコラボレーションが強化されます AWS。
+ SaaS 収益認識プログラム (SRRP) フィールドが更新されると、 との機会同期が失敗`NUMBER_VALUE`し、文字列に変換できない問題を修正しました。
+ APN 同期中にパートナー機会として AWS 紹介が誤って処理されないように、データ共有の問題を解決しました。
+ 許可された`ReviewStatus`フィールドを更新した後、承認されたオポチュニティのフィールドが null に変更される問題を修正しました。
+ 大規模なデータボリュームに対応し`Next Step History`、同期の失敗を防ぐために、 の新しいフィールドマッピングを実装しました。
+ ACE オポチュニティレコードの `APN CRM Unique Identifier`フィールドに適切な更新ロジックを実装することで、ACE オポチュニティアクティベーションフローの問題を解決しました。
+ ユーザーエクスペリエンスを向上させるために、ガイド付きセットアップ手順を更新および修正しました。
**注記**
バージョン 3.6 にアップグレードする場合は、**ACE マッピング**タブの `Next Step History`フィールドをマッピングする必要があります。
## バージョン 3.5 (2025 年 1 月 22 日)
AWS Partner CRM Connector バージョン 3.5 には、次の機能と改善点が含まれています。
### AWS Partner Central API
+ **カスタム設定**、**AWS Partner CRM コネクタ設定**の **PC API サンドボックス有効チェックボックスを使用してサンドボックス**カタログを有効にできるようになりました。
+ 製品カタログを更新しました。
### AWS Marketplace
+ CRM コネクタの外部で作成された再販認可の詳細をインポートできるようになりました。
+ 該当する場合、最大 8 個の小数点を表示するサポートが追加されました。
### バグ修正
+ CRM コネクタバージョン 3.1 の新しいインストール、エラーメッセージ との同期失敗レポートに関する問題を修正しました`Field Level Security error on field: awspn_Campaign name_new_c`。
+ AWS Markeplace 製品名が重複してアップサートが失敗する問題を修正しました。
+ **ACE アクセス許可セットのデフォルトビューとして ACE オポチュニティ**タブを設定できない問題を修正しました。
## バージョン 3.1 (2024 年 12 月 2 日)
AWS Partner CRM Connector バージョン 3.1 には、次の機能と改善点が含まれています。
### バグ修正
+ AWS Partner Central API の本番稼働用 URL を修正しました。
+ エンゲージメント招待ペイロードの変更に関する問題を修正しました。
## バージョン 3.0 (2024 年 11 月 14 日)
AWS パートナー CRM コネクタ 3.0 には、次の機能と改善点が含まれています。
### 主要機能
**マルチオブジェクトマッピング**
+ パートナーは、ルックアップやマスター詳細の関係など、複数の Salesforce オブジェクトのフィールドを APN オポチュニティとリードスキーマにマッピングできるようになりました。
+ ルックアップフィールドの展開可能なビューなど、マッピングフィールドの UI が改善されました。
+ 1 つのマッピングで最大 2 レベルのオブジェクト関係をサポート。
### ACE CRM 統合機能
**AWS Partner Central API サポート**
+ AWS Partner Central 統合には ACE 統合ユーザーは必要ありません
+ Salesforce と AWS Partner Network (APN) 間のインバウンドおよびアウトバウンドの同期スケジュールが不要になりました。
+ AWS パートナー CRM コネクタは同期エラーを処理します。
**AWS Partner Central API による AWS オポチュニティ発生 (AO) とパートナー起算オポチュニティのサポート**
+ パートナーは、**Share with AWS** ボタンを使用して、オポチュニティを作成および更新できます。
+ パートナーは、**承認ステータス**ボタンを使用して、 AWS 参照された機会を承認または拒否できます。
+ パートナーは、**Associate ボタンまたは Disassociate** ボタンを使用して、オポチュニティライフサイクルを通じて、パートナーソリューション、 AWS 製品、 AWS マーケットプレイスオファーにオポチュニティを関連付けたり関連付けを解除したりできます。
+ パートナーは、**割り当て**ボタンを使用して、Partner Central アカウントの他のユーザーにオポチュニティを再割り当てできます。
+ パートナーは、**ソリューション提供**タブを使用して、利用可能なソリューションのリストを表示できます。
+ パートナーは、**作成されたオポチュニティ**、**更新されたオポチュ**ニティ、**作成されたエンゲージメントの招待**など、 **AWS Marketplace 通知**タブでイベントを表示できます。
+ 機会用に 3 つの新しいフィールドが追加されました。
+ `Opportunity Engagement Invitation ARN`
+ `Opportunity Type`
+ `Visibility`
### バグ修正
+ コネクタがインバウンドデータを受信すると、オポチュニティに関連付けられたアカウントをカスタム設定で提供されたデフォルトアカウントに上書きし、内部 Salesforce の競合と検証エラーが発生する問題を修正しました。
+ 無効な`SalesActivity`フィールド値が であるため、コネクタがインバウンドおよびアウトバウンドの同期ログでエラーが発生する問題を修正しました`Finalized Deployment Needs`。
+ 共有再販認可を更新しようとする問題を修正しました。
## バージョン 2.2 (2024 年 4 月 24 日)
AWS パートナー CRM コネクタバージョン 2.2 には、以下の機能と改善点が含まれています。
### 主要機能
非レガシー製品をサポートするために、既存の再販承認機能を強化しました。
## バージョン 2.1 (2024 年 4 月 18 日)
AWS パートナー CRM コネクタバージョン 2.1 には、次の機能と改善点が含まれています。
### 主要機能
チャネルパートナーは、共有再販認可の同期スケジュールを作成できます。
### AWS Marketplace ISV 販売者とチャネルパートナーの統合
+ 対象製品のリリースされたオファーの使用期間を変更できます。
+ プライベートオファーの将来の日付の契約 (FDA) のサポート。
+ CRM コネクタの外部で作成されたプライベートオファーの詳細をインポートできます。
+ プライベートオファーと再販承認をドラフトとして保存できます。
+ プライベートオファーとパブリックオファーの契約を取得して表示できます。
+ SaaS 契約製品と消費アカウントを持つ SaaS 契約製品の複数の販売者アカウントで契約ベースのオファーを作成できます。
### ACE CRM 統合
+ AWS 配信された ACE オポチュニティオブジェクトの Salesforce Lightning レコードフォームを強化しました。
+ AWS 配信された ACE オポチュニティオブジェクトで、オポチュニティごとに同期ログの詳細レコードを表示できます。
+ 利用可能な AWS Marketplace プライベートオファーを、 AWS 配信された ACE オポチュニティオブジェクトのオポチュニティにリンクできます。
## バージョン 2.0 (2023 年 11 月 29 日)
### 主要機能
+ ACE CRM 統合と AWS Marketplace Seller 統合機能の両方に対応する、モジュール化されたアプリケーションと単一の SF AppExchange アプリ
### APN Customer Engagements (ACE) の統合
+ ACE CRM 統合による新しいデータモデル (v14) のサポート。
+ ACE オポチュニティ用のカスタムオブジェクトを作成し、カスタムオポチュニティオブジェクトの新しいデータモデル検証との ACE CRM 統合で定義されたすべての属性/値を含むリードを作成します。
+ 新しい ACE カスタムオブジェクトのワンクリック自動マッピング機能により、オポチュニティとリードのインストール済みカスタムオブジェクトとのマッピングを迅速に行うことができます。
+ 欠落している属性を機会にマッピングするための修正。
+ マッピングに標準 AWS オポチュニティを使用する場合に、オポチュニティをアカウントに関連付けるための修正。
### AWS Marketplace 統合
+ ISV 販売者として:
+ 使用可能な MP 製品を Salesforce 組織に同期します。
+ SaaS、AMI、コンテナ製品で ISV プライベートオファーを作成、表示、管理します。
+ プライベートオファーをキャンセルおよび変更します。
+ プライベートオファーをクローンして新しいオファーを作成します。
+ SaaS、AMI、コンテナ製品で再販認可を作成します。
+ 再販認可をキャンセルおよび変更します。
+ 再販認可のクローンを作成します。
+ 購入者がプライベートオファーをサブスクライブすると、通知を受け取ります。
+ コネクタを介して作成されたプライベートオファーと共有再販認可のダッシュボードを表示します。
+ AWS チャネルパートナーとして:
+ ISV 販売者が作成した共有再販認可を同期して表示します。
+ 共有再販認可から SaaS、AMI、コンテナ製品の AWS チャネルパートナーのプライベートオファーを作成および管理します。
## バージョン 1.7 (2022 年 10 月 12 日)
### 変更ログ
[**ユーザーインターフェイス**]
+ AWS Partner Network レビューコメントのオプションフィールドをマッピング画面に追加します。
+ ヘルプセクションを**ガイド付きセットアップ**ページに移動します。
**バグ修正**
+ 部分的な障害ケースで、誤ったペイロードが`synclog`詳細なソースレコードで表示されていた問題を修正しました。
+ 組織内のターゲットオブジェクトに基づいて自動的に修正されるように、パートナーが ACE でパートナー CRM の一意の識別子を既に更新している問題を修正しました。
+ 最初の作成リクエストの送信後にまだ承認されていない機会の更新の送信を停止する問題を修正しました AWS Partner。これは、オポチュニティが承認済みステータスにないために AWS Partner 、 から検証エラーレスポンスが返されないようにするためです。
**既知の問題**
該当なし。
## バージョン 1.6 (2023 年 1 月 13 日)
### 変更ログ
[**ユーザーインターフェイス**]
+ コンポーネントを追加して、パートナーが AWS Partner Central を通じてサポートケースを提起できるようにします。これは、アプリの**ガイド付きセットアップ**ページで確認できます。
+ 管理者は、インバウンドペイロードで受信したデータを修正して、誤ったピックリスト値を修正して処理できます。
**同期ログのクリーンアップ**
古い同期ログレコードは、アプリケーションのカスタム設定の**同期ログ保持**に基づいて自動的にクリーンアップされます。この機能を使用すると、パートナーはインバウンドおよびアウトバウンドの同期ログレコードを保持する期間を設定できます。
**バグ修正**
+ マッピングされていないピックリスト値がインバウンドペイロードに存在する場合は、検証メッセージを更新して、正しくない値を示します。
+ アプリケーションカスタム設定で設定された再試行回数と再試行日数を利用するようにアウトバウンドジョブフィルターを更新し、再試行回数を超えるまで、データが修正されたらトランザクションを自動再試行します。
**既知の問題**
該当なし。
## バージョン 1.5 (2023 年 1 月 13 日)
### 変更ログ
[**ユーザーインターフェイス**]
+ スケジューリングモーダルのラベルを更新します。
+ スケジューリング画面の検証エラーメッセージを更新して、スケジューリングの失敗に関するコンテキストをユーザーに提供します。
+ すべてのリファレンスのアプリケーションのタイトルをAWS Partner 「CRM コネクタ」で更新します。
+ **オポチュニティ/リード**ページ
+ Update **Eligible to Sync with APN** フィールドラベルを **Has Updates for AWS** に更新します。
+ Partner **Central フィールドラベルとの同期**を更新して **と同期 AWS**します。
+ **ガイド付きセットアップ**ページ
+ **Enter Authentication details** フィールドラベルを更新して **APN AWS 接続を設定します**。
+ **SPMS** フィールドラベルを**パートナー ID** に更新します。
+ **マップ APN AWS** フィールドを **Salesforce** フィールドに更新します。
+ **マッピング**ページ
+ **ACE パイプラインマネージャー**フィールドを **AWS** フィールドに更新します。
+ 更新 **APN 更新を有効にする** フィールドを更新して**、インバウンド更新を有効にする **フィールドを有効にします。
+ **同期ログ**ページ
+ 「APN」への参照をAWS「」 (方向) に置き換えます。
+ 次の同期ログの目的フィールドラベルを更新します。**インバウンドオーケストレーション**から**インバウンドファイルの取得**、**インバウンドオーケストレーション — レコードの取得から****インバウンドレコードの取得**、アウトバウンド**ファイルの取得へのアウトバウンド****オーケストレーション**。
**即時同期**
管理者は、追加されたクイックアクションを使用して、1 つのレコードに対して特定のアウトバウンド同期を開始できます。クイックアクション **Send to AWS** が標準オポチュニティとリードオブジェクトに追加されました。スケジュールされたジョブの外部で 1 つのレコードの同期をすぐに呼び出すオプションを提供するために、統合された標準オブジェクトまたはカスタムオブジェクトに追加できます。
**バグ修正**
+ 誤った FLS 例外エラーを示す同期ログの問題を修正しました。
+ `campaignMemberStatus` フィールドがマッピングされている場合の Lead オブジェクトの問題を修正しました。
+ マッピング時に フィールド`awsFieldEngagement`と `awsAccountId`フィールドがアウトバウンドマッピングから除外されていたマッピングの問題を修正しました。
+ バンドルされたダッシュボードを動的ダッシュボードから静的ダッシュボードに更新して、インストールされた組織の動的ダッシュボードの制限を使用しないようにします。
**既知の問題**
該当なし。
## バージョン 1.4 (2022 年 12 月 7 日)
### 変更ログ
[**ユーザーインターフェイス**]
+ 同期ログのインターフェイスを簡素化します。
+ モーダルをマッピングするためのインターフェイスを簡素化します。
+ 確認モーダルを追加して、**マッピング**画面でボタンをリセットします。
+ すべてのフィールドが完了するまで、ピックリストマッピングの**次**へオプションを無効にします。
+ マッピングモーダルのタブタイトルにヘルプテキストを追加します。
+ **APN CRM Administration **から **AWS Partner CRM コネクタ**にアプリラベルを更新します。
**レポートとダッシュボード**
同期ログのステータスを追跡するための新しいレポートとダッシュボードを追加します。
**フローテンプレート**
同期ログエラー時にビジネス管理者へのカスタムプッシュ通知を設定するためのフローテンプレートをパッケージに追加します。
**バグ修正**
+ マッピングでの UTC による日付オフセットの問題を修正しました。
+ 再処理のために部分的に処理された同期ログが選択された場合、エラーが発生した場合、同期ログのステータスは**エラー**に変わりません。
+ 標準オポチュニティとリードに関する適格な`to sync`計算式を更新します。
+ 読み取り専用フィールドを非表示にします。
+ をロードスピナーに更新します。
+ モーダル字幕のラベルを更新します。
+ マッピングモーダル`apnValues_ on _tab3`に保持します。
+ **編集**オプションを更新して、ユーザーを現在のページに移動します。
+ `read-only` モードの場合を除き、タブの選択を無効にします。
+ オプションの場合は`field required`エラーを無効にします。
+ モーダルチェックマークを緑色に変更します。
+ マッピングタブのコンポーネントとユーティリティを追加します。
+ 同期ログ用に新しいダッシュボードとダッシュボードフォルダを追加します。
+ 廃止されたカスタムレポートタブのアクセス許可を削除します。
**既知の問題**
リードオブジェクト`CampaignMemberStatus`で をマッピングする際のエラー。現在、 はリード AWS Partnerをマッピングするときに、この必須ではないフィールドのマッピングをスキップできます。修正は次のバージョンになります。