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

# ACE オブジェクトのマッピング
<a name="crm-connector-mapping"></a>

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 マッピングページの使用
<a name="mapping-page"></a>

AWS Partner Central には、**ACE マッピング**ページに移動する以下の方法があります。
+ アプリランチャーから、**AWS パートナー CRM コネクタ**を検索して選択します。
+ **ACE マッピングタブ**を選択します。

  —OR—

  **ガイド付きセットアップ**タブを選択し、**マップリードと機会**セクションで**開始**または**レビュー**を選択します。

**ACE マッピング**ページで、左側のナビゲーションペインを使用して、オポチュニティマッピングとリードマッピングを切り替えます。**オブジェクトセレクタ**を使用して、APN リードとオポチュニティをマッピングするソースオブジェクトを選択します。オブジェクトセレクタは、標準オポチュニティ、リードオブジェクト、カスタムオブジェクトのマッピングをサポートします。**マッピングビュー**フィルターと**タイプビュー**フィルターを使用して、マッピングされたフィールド、マッピングされていないフィールド、必須フィールド、およびオプションのフィールドを切り替えます。

**ACE マッピング**ページで、 オブジェクトの**AWS フィールド**列には、対応するターゲット APN フィールドが表示されます。**Salesforce フィールド**は、パートナーの組織内の選択したオブジェクトのソースフィールドです。**Salesforce フィールド**はフィルタリングされ、組織内で使用可能な該当するデータ型のみが表示され、対応する APN フィールドにマッピングされます。たとえば、APN のテキストフィールドは、パートナーの組織内のテキスト (文字列) フィールドにのみマッピングできます。

パートナーは、APN によってフィールドが更新されたくない場合に、マッピングされたフィールドのインバウンド更新を制御できます。これを行うには、**インバウンド更新の有効化**トグルを **False** に設定します。

one-to-oneマッピングでは、関連するソースフィールドを選択し、**保存**を選択します。

# マルチオブジェクトマッピング
<a name="multi-object-mappings"></a>

マルチオブジェクトマッピングを使用すると、パートナーは 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. **[保存]** を選択します。

# ピックリストマッピング
<a name="picklist-mapping"></a>

ピックリストダイアログボックスでは、パートナーのピックリストフィールドと APN 間の制限付きマッピングと拡張マッピングが可能です。提供された**カスタム ****ACE オポチュニティオブジェクト を使用する場合、ACE マッピング**ページには Auto Map 関数もあります。オブジェクトの詳細については、このガイドの[標準 Salesforce オブジェクトまたはカスタムオブジェクトの使用](crm-connector-mapping.md#custom-ace-opportunity-object)後半の「」を参照してください。

パートナーのフィールド値と APN の間に完全一致が見つかった場合、それらの値は自動的にマッピングされます。拡張マッピングのオプションを使用すると、パートナーは単一の APN 値を複数のソースにマッピングし、追加のターゲットマッピングを設定し、デフォルトのマッピングを設定できます。

## 制限付きマッピング
<a name="limited-mapping"></a>

1. **ACE マッピング**ページで、ソースフィールドを選択し、**マップ値**を選択します。

   マッピングダイアログボックスが表示されます。

1. **ステップ 1: プライマリ APN 値**で、対応する ACE パイプラインマネージャーの自動**マップ**または Salesforce 値を選択し、**保存**を選択します。

1. 必要に応じてステップ 1 と 2 を繰り返して、すべての ACE パイプラインマネージャー値をマッピングします。

1. マッピングダイアログボックスを閉じるには、**閉じる**を選択します。

パートナーには、値マッピングが保存されたという確認メッセージが表示されます。

## 拡張マッピング
<a name="extended-mapping"></a>

1. 同じソース値が複数の APN 値にマッピングされている場合は、前述のようにマッピングを続行します。

1. **プライマリ APN 値**タブで、複数の APN 値に対して同じ値マッピングを選択します。

1. マッピングされていない値がパートナーの組織に存在する場合、**追加の APN 値**タブを使用すると、追加の値を APN にマッピングできます。これにより、パートナーは組織内のすべての適用可能な値が適切な APN 値にマッピングされます。

1. パートナーの組織内の 1 つの値が複数の APN 値にマッピングされている場合は、**セカンダリ APN 値**タブを使用してアウトバウンド統合のデフォルト値を設定します。

## ACE オブジェクトと Salesforce オブジェクトのマッピング
<a name="mapping-guidance"></a>

以下のセクションでは、ACE および Salesforce のカスタムオブジェクトをオブジェクトマップにマッピングする方法について説明します。

### ACE AWS オポチュニティカスタムオブジェクトの使用
<a name="ace-opportunity-custom-object"></a>

バージョン 2.0 以降の CRM コネクタには、ACE カスタムオポチュニティオブジェクトが含まれています。オブジェクトを使用して、Salesforce で AWS オポチュニティを管理できます。

**ACE マッピング**ページでカスタムオブジェクトを使用する場合、パートナーは Salesforce AWS フィールドにフィールドを自動的にマッピングできます。さらに、カスタムオポチュニティオブジェクトは新しい ACE データモデルと連携し、ユーザーが新しいオポチュニティを送信するのに役立つ検証がユーザーインターフェイスに組み込まれています。

カスタム ACE オポチュニティオブジェクトを使用するには、次の手順を実行します。

1. Salesforce で、**ACE マッピング**ページに移動し、左側のナビゲーションペインから**オポチュ**ニティを選択します。

1. **オブジェクトセレクタ**で、**ACE オポチュニティ **を選択します。

1. Salesforce フィールドを AWS フィールドにマッピングするには、**Auto Map ACE オブジェクト**ボタンを選択します。

### 標準 Salesforce オブジェクトまたはカスタムオブジェクトの使用
<a name="custom-ace-opportunity-object"></a>

パートナーは、Salesforce 標準オポチュニティオブジェクトまたは独自のカスタムオポチュニティオブジェクトを使用できます。ACE 同期の失敗を回避するには、カスタムオポチュニティオブジェクトに、関連するすべての ACE 必須フィールドまたは条件付き必須フィールドが含まれていることを確認します。マッピングされた AWS フィールドのデータ型は、カスタムオブジェクトで作成された Salesforce フィールドと同じデータ型である必要があります。データ型が一致しない場合、フィールドは ACE マッピング画面に表示されません。たとえば、テキストフィールド **customerCompanyName** は、標準またはカスタムオポチュニティオブジェクトのテキスト (文字列) フィールドにのみマッピングできます。必要なデータ型については、ACE オポチュニティフィールドを参照してください。

標準の Salesforce オブジェクトまたはカスタムオブジェクトを使用するには、次の手順を実行します。

1. **ACE マッピング**ページに移動し、左側のナビゲーションペインから**オポチュ**ニティを選択します。

1. **オブジェクトセレクタ**で、オブジェクトを選択します。

1. 対応するフィールドに対して必要な Salesforce AWS フィールドを選択してマッピングを完了し、**保存**を選択します。

**注記**  
Auto Map 機能は、ACE オポチュニティカスタムオブジェクトでのみ使用できます。

# ログとレポートの同期
<a name="crm-connector-sync-logs-and-reports"></a>

以下のトピックでは、 AWS Partner CRM コネクタアプリケーションで同期ログとレポートを使用する方法について説明します。トピックには、ログタイプとレポートタイプ、およびそれらに含まれるデータも一覧表示されます。

**Topics**
+ [ログの同期](#sync-logs)
+ [レポート](#reports)

## ログの同期
<a name="sync-logs"></a>

コネクタアプリの**同期ログ**タブには、インバウンドおよびアウトバウンドの APN 同期の同期レコードのステータスが表示されます。タブを使用して、正常な同期を検証し、同期エラーをトラブルシューティングします。

含まれているリストビューを使用して、**インバウンド**と**アウトバウンド**の同期ログを切り替えます。
+ **インバウンドオーケストレーション** – APN から利用可能なインバウンドレコードをチェックするジョブを示します。
+ **インバウンドオーケストレーションレコードの取得** – APN から保留中のインバウンドレコードを取得して処理するジョブを示します。
+ **アウトバウンドオーケストレーション** – が保留中のアウトバウンドトランザクションを組織から APN に送信するジョブを示します。

**同期ログ**レコードページには、同期ジョブのステータス、ペイロード内のレコード数、正常に処理されたレコード数、エラーが発生したレコード数が表示されます。

関連する**同期ログ**の詳細には、同期ジョブの一部として処理された個々のレコードの詳細と、個々のステータスが表示されます。以下の表では、各タイプのログファイルとその関連コンテンツについて説明します。

### ログタイプ
<a name="log-types"></a>


| **目的** | **定義** | 
| --- | --- | 
| アウトバウンドファイルの取得  | アウトバウンドジョブが頻度と、保留中の新しいレコードセットを同期する必要があるかどうかに基づいて実行されるときに作成されます AWS。ログは、レコードがアウトバウンド同期の次のフィルター仕様と一致する必要がある場合にのみ作成されます。 `Updates for AWS` `true`と `Last Sync Date` は null、 `Last Sync Date`は より前`Last Modified Date`、 `Last Modified By`は同期ジョブをスケジュールしたユーザーです。 | 
| インバウンドファイルの取得  | インバウンド同期スケジュールに基づいて作成されます。ログには、保留中のインバウンドトランザクションをチェックするコールアウトが一覧表示されます AWS。 | 
| インバウンドレコードの取得  | 親インバウンドファイル取得ジョブが保留中のインバウンドトランザクションを識別する場合にのみ作成されます AWS。ログには、オポチュニティレコードまたはリードレコード AWS を含む からのファイルの詳細が含まれます。 | 

### アウトバウンドファイルの取得結果
<a name="outbound-file-retrieval-results"></a>


| **[Direction]** (方向)  | **目的**  | **ステータス**  | **定義**  | 
| --- | --- | --- | --- | 
| から AWS  | インバウンドファイルの取得 | API Success  | バケットへのリスト呼び出しは成功し、処理する必要がある保留中のインバウンドレコードが確認されました。 | 
| から AWS  | インバウンドファイルの取得 | Error  | リスト呼び出しが失敗しました。通常、認証情報が無効であるか、アクセス許可の問題が原因です。 | 

### インバウンドファイルの取得結果
<a name="inbound-file-retrieval-results"></a>


| **[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  | 処理が成功し、マッピングされたオブジェクトに挿入されたレコード。 | 

## レポート
<a name="reports"></a>

 AWS Partner CRM コネクタパッケージには、組織と APN 間の同期のステータスを追跡できるレポートが含まれています。<a name="view-reports-synchronization"></a>

**同期用のレポートを表示するには**

1.  AWS Partner CRM コネクタアプリで、**レポート**タブを選択します。

1. **すべてのフォルダ**を選択し、CRM **AWS Partner コネクタ**を選択します。

使用可能なレポートは次のとおりです。
+ **インバウンド同期ログ** – `Error: Inbound` 日別の同期レコードの失敗。
+ **インバウンド同期ログ** – `Success: Inbound` 日別の同期レコードの成功。
+ **アウトバウンド同期ログ** – `Error: Outbound` 日別の同期レコードの失敗。
+ **アウトバウンド同期ログ** – `Success: Outbound` 日別の同期レコードの成功。
+ **同期の概要** – 日別のインバウンドおよびアウトバウンドの同期ジョブの概要。