強化された変更イベントを受信する

メモ

日本語で受講されている方へ
このバッジの Trailhead ハンズオン Challenge は英語で受講していただく必要があります。英語の意味についてはかっこ内の翻訳をご参照ください。必ず英語の値をコピーして貼り付けてから、Trailhead Playground の言語を [English] に、ロケールを [United States] に切り替えてください。こちらの指示に従ってください。

翻訳版の Trailhead を活用する方法については、自分の言語の Trailhead バッジをご覧ください。

チャネルメンバーを追加し、取引先の通知を有効にして、強化された項目を追加しました。次は、変更イベントを受信して、そのイベントに強化された項目が含まれていることを確認します。

チャネルに登録するには、AppExchange のアプリケーションである Streaming Monitor アプリケーションを使用します。

AppExchange の Streaming Monitor をインストールする

Trailhead Playground 組織を使用している場合、Streaming Monitor アプリケーションの前提条件を満たしていることになるため、インストール手順を進めることができます。Trailhead Playground 組織を使用していない場合は、組織で Lightning Experience が有効になっていることを確認してください。詳細は、Salesforce ヘルプの「Lightning Experience が有効になっているかどうかの確認」を参照してください。

インストール手順

Trailhead Playground で、組織に [Install a Package (パッケージのインストール)] というタブが表示されている場合は、次の手順を実行します。

[Install a Package (パッケージのインストール)] タブをクリックします。
項目に04t1t000003Lgqiを貼り付けます。
[Install (インストール)] をクリックします。
[Install for Admins Only (管理者のみのインストール)] を選択し、[Install (インストール)] をクリックします。

[Install a Package (パッケージのインストール)] タブが表示されない場合は、アプリケーションランチャー () を開き、[Playground Starter] を見つけて手順に従ってください。

Playground Starter アプリケーションが表示されない場合は、こちらのパッケージのインストールリンクをクリックして、Trailhead ヘルプの「パッケージやアプリケーションをインストールして Trailhead Challenge を実行する」を参照してください。

パッケージのインストールが終了すると、確認ページが表示され、Playground に関連付けられているアドレスにメールが届きます。

Streaming Monitor AppExchange アプリケーションは、Salesforce Labs によって作成されました。このプロジェクトではサンプルツールとして使用されます。このツールは Salesforce Labs でサポートされていますが、Salesforce ではサポートされていません。Streaming Monitor はユーザーが貢献できる GitHub でオープンソースツールとしても入手可能です。または、カスタム Lightning アプリケーションで empApi Lightning コンポーネントを使用することもできます。外部クライアントでイベントを受信するには、オープンソースのコミュニティサポートツールである EMP コネクタを使用できます。EMP コネクタの詳細については、Trailhead モジュールの「変更データキャプチャの基礎」の「イベントチャネルへの登録」単元を参照してください。

Streaming Monitor を使用して最初の変更イベントを登録し、新しい取引先レコードを作成してからそのイベントを受信します。試しに最初の変更イベントを取得してみましょう。

カスタムチャネルに登録する

Streaming Monitor をインストールしたら起動して、カスタムチャネルに登録します。

アプリケーションランチャーをクリックして、検索ボックスに Streaming Monitor と入力します。[Streaming Monitor] を選択します。
Streaming Monitor アプリケーションの [Actions (アクション)] で、[Subscribe to a channel (チャネルの登録)] をクリックします。
[Event type (イベント種別)] で、[Custom Channel - Change event (カスタムチャネル - 変更イベント)] を選択します。
チャネルには、SalesEvents__chn を付加します。完全なチャネル名は /data/SalesEvents__chn となります。
[Subscribe (登録)] をクリックします。
登録の成功を確認するポップアップが表示されたら、閉じます。

Streaming Monitor アプリケーションを起動します。

「コンポーネントエラーが発生しました」というエラーメッセージが表示された場合は、ブラウザーのキャッシュをクリアします。必要に応じて、再度 Trailhead Playground にサインインしてください。

取引先レコードを作成する

アプリケーションランチャーをクリックして、検索ボックスに Accounts (取引先) と入力します。
[Accounts (取引先)] を右クリックして、新しいタブでリンクを開くことを選択します。
新しいタブのアプリケーションランチャーで、Accounts (取引先) を検索します。
次の値を使用して取引先を作成します。
1. Account Name (取引先名): Astro
2. Industry (業種): Apparel (衣料品)
3. External Account ID (外部アカウント ID): 123
4. Phone (電話): 4155551212
[Streaming Monitor] タブに切り替えます。タイムラインビューに新しいイベントがドットとして表示されます。
イベントメッセージを表示するには、受信したイベントを表すドットをクリックします。イベントペイロードは次の例のようになります。

{
  "LastModifiedDate": "2023-08-29T19:22:19Z",
  "External_Account_ID__c": "123",
  "Name": "Astro",
  "Industry": "Apparel",
  "Phone": "4155551212",
  "OwnerId": "0058b00000HpWcRAAV",
  "CreatedById": "0058b00000HpWcRAAV",
  "CleanStatus": "Pending",
  "ChangeEventHeader": {
    "commitNumber": 11658980597990,
    "commitUser": "0058b00000HpWcRAAV",
    "sequenceNumber": 1,
    "entityName": "Account",
    "changeType": "CREATE",
    "changedFields": [],
    "changeOrigin": "com/salesforce/api/soap/58.0;client=SfdcInternalAPI/",
    "transactionKey": "00006bed-29af-3dd6-128a-a534cde0836f",
    "commitTimestamp": 1693336939000,
    "recordIds": [
      "0018b00002Vlq7xAAB"
      ]
    },
  "CreatedDate": "2023-08-29T19:22:19Z",
  "LastModifiedById": "0058b00000HpWcRAAV"
}

Streaming Monitor で表示されるのは、イベントメッセージのペイロード部分のみです。イベント再生 ID とスキーマは簡潔にするために省略されています。

このイベントは作成操作を対象としているため、まだ追加項目で強化されていません。強化は更新と削除の操作で利用可能です。ただし、External_Account_ID__c と Industry 項目が含まれています。なぜでしょうか? この項目が存在するのは、強化された項目としてではなく、入力された新しい項目の一部として追加されたためです。