翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# リード共有
<a name="custom-lead-sharing"></a>

## AWS 共有がリードする方法
<a name="how-aws-shares-leads"></a>

1. **増分エクスポート**: Amazon Web Services (AWS) は AWS、 が参照する新しいリード (および更新) を時間単位でエクスポートします。

1. **ファイルの作成**： AWS は、特定の形式に準拠したリードファイルを生成します。詳細なファイル仕様については、「」を参照してください[フィールド定義](resources.md#custom-field-definitions)。

1. **ファイルのアップロード**: リードファイルは `lead-outbound`フォルダにアップロードされます。

## からのリードの消費 AWS
<a name="consuming-leads-from-aws"></a>

からのリードを効果的に使用するには 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
<a name="sharing-updates-on-leads-with-aws"></a>

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 を超えることはできません。重複したファイルは処理されません。