この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

登録の際の絞り込み条件の設定

チャネルに登録するときに、レコード項目を指定して絞り込み、PushTopic イベント通知の数を減らします。

次のように、登録 URI に追加する式で検索条件を指定します。

/topic/TopicName?<expression>

topicName は PushTopic 名で、<expression> は 1 つ以上の条件を含む式です。& 演算子を使用して条件を結合します。& 演算子のみがサポートされています。<expression> に次の構文を使用します。

?fieldA=valueA&fieldB=valueB&...

検索条件で使用される各項目を PushTopic クエリに含めます。& 演算子は論理 OR 演算子のように機能するため、いずれかの条件が true になるとレコードイベントが一致します。

例

次の登録では、業種が「Energy」 (エネルギー) または市区郡(納入先) が「San Francisco」 (サンフランシスコ) となっているレコードのイベント通知が返されます。

1/topic/MyTopic?Industry='Energy'&ShippingCity='San Francisco'

この登録の PushTopic クエリには、Industry 項目と ShippingCity 項目が含まれています。

検索条件に ID を使用する場合は、18 文字の ID 形式を使用します。15 文字の ID はサポートされていません。
empApi Lightning コンポーネントで共有 CometD セッションを使用する場合、同じ PushTopic へのすべての登録について同じ検索条件を指定する必要があります。最初の登録で使用していない検索条件は、以降の登録では使用できません。たとえば、/topic/MyTopic?Name='SomeName' を登録している場合、同じ CometD セッションを使用して /topic/MyTopic や /topic/MyTopic?Industry='Energy' を再登録できません。共有 CometD セッションは、empApi Lightning コンポーネントで作成した登録にのみ適用されます。empApi コンポーネントは、empApi の 2 番目のインスタンスを新しいタブで開いたとき、または同じ Salesforce ユーザーセッションの新しいブラウザーで開いたときに CometD セッションを共有します。

メモ