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

# チュートリアル: Amazon EventBridge から Salesforce にイベントを送信する
<a name="eb-tutorial-salesforce"></a>

EventBridge を使用して、[https://www.salesforce.com/](https://www.salesforce.com/) などのサードパーティーサービスに[イベント](eb-events.md)を送信できます。

このチュートリアルでは、EventBridge コンソールを使用して、Salesforce への接続、Salesforce を指す [API 送信先](eb-api-destinations.md)、および Salesforce にイベントを送信する [ルール](eb-rules.md)を作成します。

**Topics**
+ [前提条件](#eb-sf-prereqs)
+ [ステップ 1: 接続を作成する](#eb-sf-create-connection)
+ [ステップ 2: API 送信先を作成する](#eb-dd-api-destination)
+ [ステップ 3: ルールを作成する](#eb-dd-create-rule)
+ [ステップ 4: ルールをテストする](#eb-dd-test-rule)
+ [ステップ 5: リソースをクリーンアップする](#cleanup)

## 前提条件
<a name="eb-sf-prereqs"></a>

このチュートリアルを完了するには、以下のリソースが必要です。
+ [Salesforce アカウント](https://login.salesforce.com/)。
+ [Salesforce コネクテッドアプリケーション](https://help.salesforce.com/s/articleView?id=sf.connected_app_create_basics.htm)。
+ [Salesforce セキュリティトークン](https://help.salesforce.com/s/articleView?id=sf.user_security_token.htm)。
+ [Salesforce カスタムプラットフォームイベント](https://developer.salesforce.com/docs/atlas.en-us.234.0.platform_events.meta/platform_events/platform_events_define.htm)。
+ EventBridge に対応した [Amazon Simple Storage Service (Amazon S3)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html) バケット。

## ステップ 1: 接続を作成する
<a name="eb-sf-create-connection"></a>

Salesforce にイベントを送信するには、まず、Salesforce API への接続を確立する必要があります。

**接続を作成するには**

1. Amazon EventBridge コンソールの [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/) を開いてください。

1. ナビゲーションペインで、[**API destinations**] (API 送信先) を選択します。

1. [**Connections (接続)**] タブを選択し、[**Create connection (接続の作成)**] を選択します。

1. 接続の名前と説明を入力します。例えば、名前として「**Salesforce**」、説明として「**Salesforce API Connection**」と入力します。

1. **[送信先タイプ]** として **[パートナー]** を、**[パートナー送信先]** として、ドロップダウンリストから Salesforce を選択します。

1. **[Authorization endpoint]** (認可エンドポイント) として、以下のいずれかを入力します。
   + 実稼働組織を使用している場合は、**https://*MyDomainName*.my.salesforce.com./services/oauth2/token** を入力します。
   + 拡張ドメインのないサンドボックスを使用している場合は、**https://*MyDomainName*--*SandboxName*.my. salesforce.com/services /oauth2/token** を入力します。
   + 拡張ドメインのあるサンドボックスを使用している場合は、**https://*MyDomainName*--* SandboxName*.sandbox.my.salesforce.com/services/oauth2/token** を入力します。

1. **[HTTP Method]** (HTTP メソッド) として、ドロップダウンリストから **[POST]** を選択します。

1. **[Client ID]** (クライアント ID) として、Salesforce コネクテッドアプリケーションのクライアント ID を入力します。

1. **[Client secret]** (クライアントシークレット) として、Salesforce コネクテッドアプリケーションのクライアントシークレットを入力します。

1. **[OAuth Http パラメータ]** に、次のキーと値のペアを入力します。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/eventbridge/latest/userguide/eb-tutorial-salesforce.html)

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

## ステップ 2: API 送信先を作成する
<a name="eb-dd-api-destination"></a>

接続を作成したので、次に API 送信先を作成して、ルールの[ターゲット](eb-targets.md)として使用します。

**API 送信先を作成するには**

1. Amazon EventBridge コンソールの [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/) を開いてください。

1. ナビゲーションペインで、[**API destinations**] (API 送信先) を選択します。

1. [**Create API destination**] (API 送信先の作成) を選択します。

1. API 送信先の名前と説明を入力します。この例では、名前には「**SalesforceAD**」、説明には「**Salesforce API Destination**」を入力します。

1. **[API destination endpoint]** (API 送信先エンドポイント) には、**https://*MyDomainName*.my.salesforce.com/services/data/v54.0/sobjects/*MyEvent\$1\$1e*** を入力します。ここで、**Myevent\$1\$1e** は、情報を送信するプラットフォームイベントです。

1. **[HTTP Method]** (HTTP メソッド) として、ドロップダウンリストから **[POST]** を選択します。

1. [**Invocation rate limit**] (呼び出しレート制限) には、「**300**」と入力します。

1. [**Connection**](接続) で、[**Use an existing connection**] (既存の接続を使用する) を選択し、手順 1 で作成した `Salesforce` 接続を選択します。

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

## ステップ 3: ルールを作成する
<a name="eb-dd-create-rule"></a>

次に、Amazon S3 オブジェクトが作成されたときにイベントを Salesforce に送信するルールを作成します。

**ルールを作成するには:**

1. Amazon EventBridge コンソール ([https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/)) を開きます。

1. ナビゲーションペインで **ルール]** を選択します。

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

1. ルールの名前と説明を入力します。この例では、名前には「**SalesforceRule**」、説明には「**Rule to send events to Salesforce for S3 object creation**」を入力します。

1. **[Event bus]** (イベントバス) として、**[default]** (デフォルト) を選択します。

1. **[ルールタイプ]** では、**[イベントパターンを持つルール]** を選択します。

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

1. **[Event source]** (イベントソース) では、**[Other]** (その他) を選択します。

1. **[Event pattern]** (イベントパターン) では、次のように入力します。

   ```
   {
     "source": ["aws.s3"]
   }
   ```

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

1. **[Target types]** (ターゲットタイプ) として、**[EventBridge API destination]** (EventBridge API 送信先) を選択します。

1. **[API destination]** (API 送信先) として、**[Use an existing API destination]** (既存の API 送信先を使用する) を選択し、ステップ 2 で作成した `SalesforceAD` 送信先を選択します。

1. **[Execution role]** (実行ロール) として、**[Create a new for role for this specific resource]** (この特定のリソースのための新しいロールを作成する) を選択します。

1. **[Additional settings]** (追加設定) では、以下を実行します。

   1. **ターゲット入力の設定**では、ドロップダウンリストから**[Input transformer]** (インプットトランスフォーマー) を選択します。

   1. **[Configure input transformer]** (インプットトランスフォーマーの設定) を選択します。

   1. **[Sample events]** (イベント例) では、以下を入力します。

      ```
      {
        "detail":[]
      }
      ```

   1. **[Target input transformer]** (ターゲットインプットトランスフォーマー) では、以下を実行します。

      1. **[Input Path]** (入力パス) では、以下を入力します。

         ```
         {"detail":"$.detail"}
         ```

      1. **[Input Template]** (入力テンプレート) では、以下を入力します。

         ```
         {"message": <detail>}
         ```

   1. **[Confirm]** (確認) を選択します。

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

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

1. ルールの詳細を確認し、**ルールの作成** を選択します。

## ステップ 4: ルールをテストする
<a name="eb-dd-test-rule"></a>

ルールをテストするには、EventBridge 対応バケットにファイルをアップロードして [Amazon S3 オブジェクト](https://docs.aws.amazon.com/AmazonS3/latest/userguide/upload-objects.html)を作成します。作成されたオブジェクトに関する情報は、Salesforce プラットフォームイベントに送信されます。

## ステップ 5: リソースをクリーンアップする
<a name="cleanup"></a>

このチュートリアル用に作成したリソースは、保存を希望しない限り、すぐに削除できます。使用しなくなった AWS リソースを削除することで、AWS アカウントに請求される料金が発生しないようにできます。

**EventBridge 接続を削除するには**

1. Eventbridge コンソールの [[API destination](https://console.aws.amazon.com/events/home#/apidestinations)] (API 送信先) ページを開きます。

1. [**Connections (接続)**] タブを選択します。

1. 作成した接続を選択します。

1. **[削除]** を選択します。

1. 接続の名前を入力し、[**Delete**] (削除) を選択します。

**EventBridge API の送信先を削除するには**

1. Eventbridge コンソールの [[API destination](https://console.aws.amazon.com/events/home#/apidestinations)] (API 送信先) ページを開きます。

1. 作成した API の送信先を選択します。

1. **[削除]** を選択します。

1. API 送信先の名前を入力し、[**Delete**] (削除) を選択します。

**EventBridge ルールを削除するには**

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

1. 作成したルールを選択します。

1. [**Delete**] (削除) を選択します。

1. [**Delete**] (削除) を選択します。