

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

# Amazon EventBridgeで Salesforce からイベントを受信する
<a name="eb-saas-salesforce"></a>

Amazon EventBridge を使用して、次の方法で Salesforce から[イベント](eb-events.md)を受信できます。
+ Salesforce's のイベントバスリレー機能を使用して、EventBridge パートナーイベントバスでイベントを直接受信する。
+ データソースとして Salesforce を使用する [Amazon AppFlow](https://aws.amazon.com/appflow/) でフローを設定する。そうすると、Amazon AppFlow は[パートナーイベントバス](eb-saas.md)を使用して Salesforce イベントを EventBridge に送信します。

API 送信先を使用して Salesforce にイベント情報を送信できます。イベントは、Salesforce に送信されると、[フロー](https://help.salesforce.com/s/articleView?id=flow.htm)または [Apex トリガー](https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_triggers.htm)で処理できます。Salesforce API 送信先のセットアップの詳細については、「[チュートリアル: Amazon EventBridge から Salesforce にイベントを送信する](eb-tutorial-salesforce.md)」を参照してください。

**Topics**
+ [イベントバスリレーを使用して Salesforce からイベントを受信する](#eb-saas-salesforce-relay)
+ [Amazon AppFlow を使用して Salesforce からイベントを受信する](#eb-saas-salesforce-appflow)

## イベントバスリレーを使用して Salesforce からイベントを受信する
<a name="eb-saas-salesforce-relay"></a>

### ステップ 1: Salesforce イベントバスリレーと EventBridge パートナーイベントソースをセットアップする
<a name="eb-set-up-relay"></a>

Salesforce でイベントリレー設定を作成する場合、Salesforce は、EventBridge で保留状態でパートナーイベントソースを作成します。

**Salesforce イベントバスリレーを設定するには**

1. [REST API ツールをセットアップします](https://resources.docs.salesforce.com/rel1/doc/en-us/static/pdf/Salesforce_Event_Bus_Relay_Pilot.pdf#h.z63eim1tqkm3)

1. [(オプション) プラットフォームイベントを定義します](https://resources.docs.salesforce.com/rel1/doc/en-us/static/pdf/Salesforce_Event_Bus_Relay_Pilot.pdf#h.2m5t2i52o23m)

1. [カスタムプラットフォームイベントのチャンネルを作成します](https://resources.docs.salesforce.com/rel1/doc/en-us/static/pdf/Salesforce_Event_Bus_Relay_Pilot.pdf#h.s0spl5puf9d0)

1. [カスタムプラットフォームイベントを関連付けるチャンネルメンバーを作成します](https://resources.docs.salesforce.com/rel1/doc/en-us/static/pdf/Salesforce_Event_Bus_Relay_Pilot.pdf#h.rdhi4awp8cvv)

1. [名前付きの認証情報を作成します](https://resources.docs.salesforce.com/rel1/doc/en-us/static/pdf/Salesforce_Event_Bus_Relay_Pilot.pdf#h.etec44jyv3og)

1. [イベントリレー設定を作成します](https://resources.docs.salesforce.com/rel1/doc/en-us/static/pdf/Salesforce_Event_Bus_Relay_Pilot.pdf#h.43rfyeehz0w5)

### ステップ 2: EventBridge コンソールで Salesforce パートナーイベントソースを有効化し、イベントリレーを開始する
<a name="eb-salesforce-activate-source"></a>

1. EventBridge コンソールで、[[Partner event sources](https://console.aws.amazon.com/events/home?#/partners)] (パートナーイベントソース) ページを開きます。

1. ステップ 1 で作成した Salesforce パートナーイベントソースを選択します。

1. [**Associate with event bus**] (イベントバスと関連付ける) を選択します。

1. パートナーイベントバスの名前を検証します。

1. [**Associate**] (関連付ける) を選択します。

1. [イベントリレーを開始します](https://resources.docs.salesforce.com/rel1/doc/en-us/static/pdf/Salesforce_Event_Bus_Relay_Pilot.pdf#h.t01b3xp87vhu)

イベントバスリレーをセットアップして開始し、パートナーイベントソースを設定したため、[イベントに反応する EventBridge ルール](eb-create-rule-visual.md)を作成して、データをフィルタリングして[ターゲット](eb-targets.md)に送信できます。

## Amazon AppFlow を使用して Salesforce からイベントを受信する
<a name="eb-saas-salesforce-appflow"></a>

Amazon AppFlow は、Salesforce からのイベントを EventBridge イベントエンベロープでカプセル化します。以下の例は、EventBridge パートナーイベントバスによって受信される Salesforce イベントを示しています。

```
{
    "version": "0",
    "id": "5c42b99e-e005-43b3-c744-07990c50d2cc",
    "detail-type": "AccountChangeEvent",
    "source": "aws.partner/appflow.test/salesforce.com/364228160620/CustomSF-Source-Final",
    "account": "000000000",
    "time": "2020-08-20T18:25:51Z",
    "region": "us-west-2",
    "resources": [],
    "detail": {
        "ChangeEventHeader": {
            "commitNumber": 248197218874,
            "commitUser": "0056g000003XW7AAAW",
            "sequenceNumber": 1,
            "entityName": "Account",
            "changeType": "UPDATE",
            "changedFields": [
                "LastModifiedDate",
                "Region__c"
            ],
            "changeOrigin": "com/salesforce/api/soap/49.0;client=SfdcInternalAPI/",
            "transactionKey": "000035af-b239-0581-9f14-461e4187de11",
            "commitTimestamp": 1597947935000,
            "recordIds": [
                "0016g00000MLhLeAAL"
            ]
        },
        "LastModifiedDate": "2020-08-20T18:25:35.000Z",
        "Region__c": "America"
    }
}
```

### ステップ 1: Salesforce をパートナーイベントソースとして使用するように Amazon AppFlow を設定する
<a name="eb-configure-appflow"></a>

EventBridge にイベントを送信するには、まず Salesforce をパートナーイベントソースとして使用するように Amazon AppFlow を設定する必要があります。

1. [Amazon AppFlow コンソール](https://console.aws.amazon.com/appflow/)で、[**Create flow**] (フローの作成) を選択します。

1. [**Flow details**] (フローの詳細) セクションで、[**Flow name**] (フロー名) にフローの名前を入力します。

1. (オプション) フローの説明を入力して、[**Next**] (次へ) を選択します。

1. **[ソースの詳細]** で **[ソース名]** ドロップダウンから *Salesforce* を選択し、**[接続]** を選択して新しい接続を作成します。

1. **[Salesforce への接続]** ダイアログボックスで、Salesforce 環境として **[本番稼働用]** または **[サンドボックス]** を選択します。

1. [**Connection name**] (接続名) フィールドに接続の一意の名前を入力し、[**Continue**] (続行) を選択します。

1. [Salesforce] ダイアログボックスで、以下の操作を実行します。

   1. Salesforce サインイン認証情報を入力して、Salesforce にログインします。

   1. Amazon AppFlow が処理するデータの種類として、Salesforce イベントを選択します。

1. [**Choose Salesforce event**]( イベントの選択) ドロップダウンで、EventBridge に送信するイベントのタイプを選択します。

1. 送信先として [**Amazon EventBridge**] を選択します。

1. [**Create new partner event source**] (パートナーイベントソースの作成) を選択します。

1. (オプション) パートナーイベントソースの一意のサフィックスを指定します。

1. [**Generate partner event source**] (パートナーイベントソースの生成) を選択します。

1. 1 MB を超えるイベントペイロードファイルを保存する Amazon S3 バケットを選択します。

1. [**Flow trigger**] (フロートリガー) セクションで、[**Run flow on event**] (イベントでフローを実行) が選択されていることを確認します。この設定により、新しい Salesforce イベントが発生するとフローが実行されるようになります。

1. [**次へ**] を選択します。

1. フィールドマッピングとして、[**Map all fields directly**] (すべてのフィールドを直接マッピング) を選択します。あるいは、[**Source field name**] (ソースフィールド名) リストから対象となるフィールドを選択することもできます。

   フィールドマッピングの詳細については、「[データフィールドのマッピング](https://docs.aws.amazon.com//appflow/latest/userguide/getting-started.html#map-fields)」を参照してください。

1. [**次へ**] を選択します。

1. (オプション) Amazon AppFlow でデータフィールドのフィルターを設定します。

1. [**次へ**] を選択します。

1. 設定を確認し、[**Create**] (作成) を選択します。

フローが設定されると、Amazon AppFlow はアカウントのパートナーイベントバスに関連付ける必要がある新しいパートナーイベントソースを作成します。

### ステップ 2: Salesforce イベントを受信する EventBridge を設定する
<a name="eb-salesforce-events"></a>

このセクションの指示に従う前に、EventBridge を送信先として Salesforce イベントからトリガーされる Amazon AppFlow フローが設定されていることを確認してください。

**Salesforce イベントを受信する EventBridge を設定するには**

1. EventBridge コンソールで、[[Partner event sources](https://console.aws.amazon.com/events/home?#/partners)] (パートナーイベントソース) ページを開きます。

1. ステップ 1 で作成した Salesforce パートナーイベントソースを選択します。

1. [**Associate with event bus**] (イベントバスと関連付ける) を選択します。

1. パートナーイベントバスの名前を検証します。

1. [**Associate**] (関連付ける) を選択します。

1. Amazon AppFlow コンソールで、作成したフローを開き、[**Activate flow**] (フローのアクティブ化) を選択します。

1. Eventbridge コンソールで [[Rules](https://console.aws.amazon.com/events/home?#/rules)] (ルール) ページを開きます。

1. [**‬Create rule‭**‬] を選択します。

1. ルールの一意の名前を入力します。

1. [**Define pattern**] (パターンの定義) セクションで [**Event pattern**] (イベントパターン) を選択します。

1. [**Event matching pattern**] (イベント照合パターン) で、[**Pre-defined pattern by service**] (サービスごとの事前定義パターン) を選択します。

1. [**Service provider section**] (サービスプロバイダー) で [**All Events**] (すべてのイベント) を選択します。

1. [**Select event bus**] (イベントバスの選択) で [**Custom or partner event bus**] (カスタムまたはパートナーイベントバス) を選択します。

1. Amazon AppFlow パートナーイベントソースに関連付けたイベントバスを選択します。

1. **ターゲットの選択** で、ルールの実行時に実行する AWS サービスを選択します。1 つのルールに、最大 5 つのターゲットを設定できます。

1. **[作成]** を選択します。

ターゲットサービスは、アカウントに設定されたすべての Salesforce イベントを受信します。イベントをフィルタリングする、または一部のイベントを別のターゲットに送信するには、[イベントパターンによるコンテンツベースのフィルタリング](eb-create-pattern.md#eb-event-patterns-content-based-filtering)を使用できます。

**注記**  
1 MB を超えるイベントの場合、Amazon AppFlow はイベント全体を EventBridge に送信しません。かわりに Amazon AppFlow は、イベントをお客様のアカウントの S3 バケットに配置し、Amazon S3 バケットへのポインタを持つイベントを EventBridge に送信します。このポインタを使用して、バケットから完全なイベントを取得することができます。