翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# 技術的なよくある質問 — リードと機会
## リードと機会の送受信
**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: 結果ファイルはどのくらいの期間使用できますか？**
結果ファイルは妥当な期間使用できます。それらをすぐに取得して管理する必要があります。