チュートリアル: Amazon EventBridge から Salesforce にイベントを送信する - Amazon EventBridge
前提条件ステップ 1: 接続を作成するステップ 2: API 送信先を作成するステップ 3: ルールを作成するステップ 4: ルールをテストするステップ 5: リソースをクリーンアップする

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

チュートリアル: Amazon EventBridge から Salesforce にイベントを送信する

EventBridge を使用して、Salesforce などのサードパーティーサービスにイベントを送信できます。

このチュートリアルでは、EventBridge コンソールを使用して、Salesforce への接続、Salesforce を指す API 送信先、および Salesforce にイベントを送信する ルールを作成します。

前提条件

このチュートリアルを完了するには、以下のリソースが必要です。

ステップ 1: 接続を作成する

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

接続を作成するには

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

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

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

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

  5. [Destination type] (送信先タイプ) として、[Partners] (パートナー) を選択し、[Partner Destinations] (パートナー送信先) として、ドロップダウンリストから Salesforce を選択します。

  6. [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 を入力します。

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

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

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

  10. [OAuth Http パラメータ] に、次のキーと値のペアを入力します。

    キー 値

    grant_type

    client_credentials

  11. [Create] (作成) を選択します。

ステップ 2: API 送信先を作成する

接続を作成したので、次に API 送信先を作成して、ルールのターゲットとして使用します。

API 送信先を作成するには

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

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

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

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

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

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

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

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

  9. [Create] (作成) を選択します。

ステップ 3: ルールを作成する

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

ルールを作成するには:

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

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

  3. ルールの作成 を選択します。

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

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

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

  7. 次へ を選択します。

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

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

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

  10. [Next] を選択します。

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

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

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

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

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

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

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

      {
  "detail":[]
}

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

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

        {"detail":"$.detail"}

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

        {"message": <detail>}

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

  15. [Next] を選択します。

  16. [Next] を選択します。

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

ステップ 4: ルールをテストする

ルールをテストするには、EventBridge 対応バケットにファイルをアップロードして Amazon S3 オブジェクトを作成します。作成されたオブジェクトに関する情報は、Salesforce プラットフォームイベントに送信されます。

ステップ 5: リソースをクリーンアップする

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

EventBridge 接続を削除するには

  1. Eventbridge コンソールの [API destination] (API 送信先) ページを開きます。

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

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

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

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

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

  1. Eventbridge コンソールの [API destination] (API 送信先) ページを開きます。

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

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

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

EventBridge ルールを削除するには

  1. Eventbridge コンソールの [Rules] (ルール) ページを開きます。

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

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

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