翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# 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 に戻すことはできません。