intra-mart Accel Platform Salesforce 連携セットアップガイド 初版 2016-08-01

7. Salesforce Streaming クライアント を利用する場合の準備

intra-mart Accel Platform で Salesforce Streaming クライアント を利用する為に必要な準備を行います。
本項の内容は Salesforce システム管理者向けの作業になります。
すでに準備が完了している項目は省略することが可能です。

注意

Salesforce Streaming クライアント は、WebSphere Application Server では利用できません。
WebSphere Application Server 環境では、Salesforce Streaming クライアント をインストールしないでください。

7.1. Salesforce のカスタムオブジェクトを利用したい場合

intra-mart Accel Platform から Salesforce Streaming クライアント を利用して、Salesforce のカスタムオブジェクトに対する操作を監視したい場合、カスタムオブジェクトに対して以下の設定を行います。
  1. 新規カスタムオブジェクトを作成する場合
    「新規カスタムオブジェクト」よりカスタムオブジェクトを登録する際、以下のチェックボックスをオンにしてください。
    • 「オブジェクトの分類」-「ストリーミング API アクセスを許可」

      ../../_images/streaming_01.png
  2. 既存のカスタムオブジェクトを利用する場合
    「カスタムオブジェクトの編集」より既存のカスタムオブジェクトに対して、以下のチェックボックスをオンにしてください。
    • 「オブジェクトの分類」-「ストリーミング API アクセスを許可」

      ../../_images/streaming_02.png

コラム

Salesforce の「カスタムオブジェクト」に関する詳細は Salesforce の以下のドキュメントを参照してください。

7.2. PushTopic の登録

Salesforce で PushTopic を登録します。
PushTopic は、Salesforce で発生したレコードイベント(作成、更新、削除、復元など)を通知する為の Salesforce オブジェクトです。
Salesforce に登録されている PushTopic を購読することで Salesforce で発生したレコードイベントの通知を受け取ることができます。
ここでは、 Workbench を利用して Salesforce の PushTopic にレコードを登録します。
  1. 以下のURLより Workbench にアクセスします。

  2. Workbench のログイン画面で以下の内容を選択して「Login with Salesforce」ボタンをクリックします。

    項目名
    Environment Production
    API Version 36.0
    I agree to the terms of service チェックオン
    ../../_images/streaming_03.png

    注意

    API Version は、36.0 以前を選択してください。
    37.0 以降を選択した場合、 Salesforce Streaming クライアント が正常に動作しない場合があります。
  3. Salesforce にサインインします。

    ../../_images/streaming_04.png
  4. サインイン完了後、Workbench で以下の内容を選択して、「Select」ボタンをクリックします。

    項目名
    Jump to Insert
    Object PushTopic
    ../../_images/streaming_05.png
  5. 次の画面で PushTopic の登録方法を選択します。
    今回は PushTopic に1レコードのみ登録しますので、デフォルト値のまま「Next」ボタンをクリックします。
    ../../_images/streaming_06.png
  6. 次の画面で PushTopic の登録内容を入力します。
    今回は、下記内容を入力して、「Confirm Insert」ボタンをクリックします。
    項目名 説明
    ApiVersion 36.0 Query を実行する Salesforce APIバージョン
    Description 取引先名の変更を通知する PushTopic 登録する PushTopic の説明
    IsActive true レコードが組織の上限にカウントされているかどうか
    Name ModifyAccontName PushTopic の名前
    NotifyForFields Referenced 通知を生成するために評価される項目
    NotifyForOperationCreate true 作成操作で通知を生成するかどうか
    NotifyForOperationDelete true 削除操作で通知を生成するかどうか
    NotifyForOperationUndelete false 復元操作で通知を生成するかどうか
    NotifyForOperationUpdate true 更新操作で通知を生成するかどうか
    Query SELECT Id, Name FROM Account
    監視対象のオブジェクトを特定する為の SOQL クエリ
    intra-mart Accel Platform は、このQueryで指定したオブジェクトに対するイベント通知を受け取ることになります。
    ../../_images/streaming_07.png

    コラム

    Salesforce の「PushTopic」に関する詳細は Salesforce の以下のドキュメントを参照してください。
  7. PushTopic の登録に成功すると Workbench が以下のように表示されます。
    ../../_images/streaming_08.png
  8. Workbench の画面上部メニューの「queries」-「Streaming Push Topics」より、「Streaming Push Topics」に遷移し、「Push Topic」のリスト内に登録した PushTopic が表示されていることを確認してください。

    ../../_images/streaming_09.png