Microsoft Azure Service Busコネクタ構成ガイド
Microsoft Azure Service Busは、アプリケーションとサービス間のクラウドメッセージングサービスです。この記事では、Customer Data Hubでのサービスの構成方法について説明します。
コネクタのアクション
| アクション名 | AudienceStream | EventStream |
|---|---|---|
| キューまたはトピックにイベントデータを送信 | ✗ | ✓ |
| キューまたはトピックに訪問データを送信 | ✓ | ✗ |
| キューまたはトピックにカスタマイズデータを送信 | ✓ | ✓ |
必要条件
- Microsoft Azureアカウント
- Service Bus共有アクセスポリシーの資格情報
- データを送信するキューまたはトピック
構成の構成
コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法の一般的な指示については、コネクタについての記事を参照してください。
ベンダーを構成するには、次の手順に従います：
-
Configureタブで、コネクタインスタンスにタイトルを提供します。
-
Service Bus Namespace、Shared Access Policy Name、およびKeyを入力します。詳細については、Namespace & Shared Access Policiesを参照してください。
-
提供された資格情報でAPI接続を確認するためにTest Connectionをクリックします。
共有アクセスポリシーは、Send、Listen、Manageの3種類の権限を主張できます。提供されたポリシーは少なくともSend権限を主張する必要があります。
アクション構成 - パラメータとオプション
Nextをクリックするか、Actionsタブに移動します。ここでアクションをトリガーする構成を行います。
このセクションでは、各アクションのパラメータとオプションの構成方法について説明します。
アクション - キューまたはトピックにイベントデータを送信
パラメータ
| パラメータ | 説明 |
|---|---|
| キューまたはトピック | (必須): このリストからキューまたはトピックのオプションを選択します。これらのオプションは、構成したポリシーにManage権限が付与されている場合にのみ利用可能です。権限が付与されていない場合、キュー/トピックをカスタム値として手動で入力する必要があります。 |
| ユーザープロパティ | Toドロップダウンでメッセージユーザープロパティに属性をマッピングします（カスタム値として入力）。 |
| ブローカープロパティ | Toドロップダウンで選択したメッセージブローカープロパティに属性をマッピングします。以下の利用可能なオプションを参照してください。 |
| 属性名を表示 | このボックスをチェックすると、メッセージペイロード内の各イベントデータ属性の名前が表示されます。 |
すべてのアクションは、メッセージユーザーとブローカープロパティをサポートしています。これらはキーと値のペアを使用してメッセージに関する有用で便利な情報を提供します。ただし、これらはHTTPヘッダーとして構成され、メッセージ本体内には存在しません。詳細については、Message User & Broker Propertiesを参照してください。
オプション - ブローカープロパティ
| オプション | 説明 |
|---|---|
| Content Type | メッセージ消費者のHTTPヘッダーContent-Typeを構成します |
| Correlation ID | 相関の一意の識別子 |
| Session ID | メッセージを特定の消費者にパーティション化してルーティングするために使用できます |
| Message ID | デフォルトの自動生成されたMessage IDを上書きします |
| Label | アプリケーションラベル |
| Reply To | メッセージ消費者への応答を送る場所を指定するために使用できます |
| Time to Live in Seconds | X秒後にメッセージを期限切れにします（キュー/トピックレベルを上書きします） |
| To | 送信先アドレス |
| Scheduled Enqueued Time | メッセージがエンキューされる予定の日時 |
| Reply to Session ID | Reply Toと同様ですが、応答のためのセッションをターゲットにします |
| Partition Key | パーティション化されたキューまたはトピックの一意の識別子 |
アクション - キューまたはトピックに訪問データを送信
パラメータ
| パラメータ | 説明 |
|---|---|
| キューまたはトピック | 必須。このリストからキューまたはトピックのオプションを選択します。これらのオプションは、構成したポリシーにManage権限が付与されている場合にのみ利用可能です。権限が付与されていない場合、キュー/トピックをカスタム値として手動で入力する必要があります。 |
| ユーザープロパティ | Toドロップダウンでメッセージユーザープロパティに属性をマッピングします（カスタム値として入力）。 |
| ブローカープロパティ | Toドロップダウンで選択したメッセージブローカープロパティに属性をマッピングします。利用可能なBroker Propertiesオプションを参照してください。 |
| 現在の訪問データを含める | このボックスをチェックすると、メッセージペイロードに現在の訪問データが含まれます。 |
| 属性名を表示 | このボックスをチェックすると、メッセージペイロード内の各訪問データ属性の名前が表示されます。 |
アクション - キューまたはトピックにカスタマイズデータを送信（高度）
パラメータ
| パラメータ | 説明 |
|---|---|
| キューまたはトピック | (必須): このリストからキューまたはトピックのオプションを選択します。これらのオプションは、構成したポリシーにManage権限が付与されている場合にのみ利用可能です。権限が付与されていない場合、キュー/トピックをカスタム値として手動で入力する必要があります。 |
| ユーザープロパティ | Toドロップダウンでメッセージユーザープロパティに属性をマッピングします（カスタム値として入力）。 |
| ブローカープロパティ | Toドロップダウンで選択したメッセージブローカープロパティに属性をマッピングします。利用可能なBroker Propertiesオプションを参照してください。 |
| メッセージデータ | (必須): カスタムメッセージ本体を構築します。属性を名前にマッピングしてシンプルな1レベルのJSON形式を作成するか、テンプレート名を参照して（二重中括弧で囲む）Custom Message Definitionオプションを選択します。 |
| テンプレート変数 | 属性をテンプレート変数名にマッピングします。テンプレート変数は、すべてのテンプレートの置換とレンダリングに利用可能です。詳細については、Template Variables Guideを参照してください。 |
| テンプレート | レンダリングするための1つ以上のテンプレートを提供します。通常、単一のテンプレートがメッセージデータの構築に使用されます。一般的な構文と拡張については、Templates Guideを参照してください。 |
必要に応じて、テンプレートはユーザーとブローカープロパティにも参照され、注入することができます。
ベンダードキュメンテーション
最終更新日 :: 2020年January月23日