Dataphin は、Alibaba Cloud 音声サービスとカスタム音声サービスメッセージチャンネルの設定をサポートしています。このトピックでは、音声メッセージングチャンネルの設定方法について説明します。
使用方法
メッセージ送信チャンネルは、グローバル（インスタンスレベル）または各テナントレベルで設定できます。組織の要件に応じて設定してください。
メッセージチャンネルがシャットダウンされている場合、設定済みのアラートメッセージは送信されません。アラートメッセージが確実に配信されるように、電話メッセージチャンネルを有効にしてください。
権限に関する説明
メタデータウェアハウス テナント スーパー管理者およびシステム管理者（インスタンスレベル）は、メッセージチャンネルを編集する権限を持っています。
テナントレベルでは、スーパー管理者とシステム管理者はメッセージチャンネルを編集できますが、他のユーザーは表示のみ可能です。
カスタム音声サービスの設定
Dataphin ホームページで、[管理センター] > [システム設定] を選択します。
左側のメニューバーで、[システム設定] > [メッセージチャンネル] を選択します。
[メッセージチャンネル設定] ページで、[電話] タブをクリックします。
[チャンネル設定] で [カスタム] を選択した後、[音声サービス設定] 領域で次のパラメーターを設定します。
情報送信設定
パラメーター
説明
情報送信 URL
情報が送信される URL です。
リクエストメソッド
システムでは、リクエストメソッドとして [POST] または [GET] を選択できます。
説明POST の場合は、[ヘッダー]、[パラメーター]、および [本文] のリクエストパラメーターを設定できます。
GET の場合は、[ヘッダー] と [パラメーター] のリクエストパラメーターのみを設定できます。
リクエストパラメーター設定
[ヘッダー]: [ヘッダー] パラメーターを設定するには、[+ 新規] ボタンをクリックします。
[キー]: 一意のカスタムキー値を入力します。
[値]: 定数および組み込みパラメーターを含む、カスタム入力がサポートされています。詳細については、「参照ドキュメント」をご参照ください。
[タイプ]: ドロップダウンボックスから [文字列]、[倍精度浮動小数点数]、[長整数]、または [ブール値] を選択します。
[パラメーターの暗号化]: デフォルトではオフになっています。有効にすると、パラメーター値が ****** と表示されます。
重要パラメーターの暗号化は、ヘッダーと本文の定数値に使用できます。変数値は暗号化できません。
暗号化は、Dataphin の編集およびストレージにおける機密性向上のためのものです。チャンネルとのインターフェース中は、プレーンテキストで送信されます。暗号化された送信が必要な場合は、設定に暗号化テキストを使用し、チャンネル アプリケーション処理中に復号化します。
[パラメーター]: [パラメーター] を設定するには、[+ 新規] ボタンをクリックします。
[キー]: 一意のカスタムキー値を入力します。
[値]: [値] を選択します。定数および組み込みパラメーターを含む、カスタム入力がサポートされています。詳細については、「参照ドキュメント」をご参照ください。
[アクション]: [アクション] 列の
アイコンをクリックして、[パラメーター] パラメーターを編集します。[アクション] 列の 
アイコンをクリックして、[パラメーター] パラメーターを削除します。
[本文]: [本文] パラメーターを設定するには、[+ 新規] ボタンをクリックします。
[キー]: 一意のカスタムキー値を入力します。
[値]: 定数および組み込みパラメーターを含む、カスタム入力がサポートされています。詳細については、「参照ドキュメント」をご参照ください。
[タイプ]: ドロップダウンボックスから [文字列]、[倍精度浮動小数点数]、[長整数]、[ブール値]、または [JSON] を選択します。
[パラメーターの暗号化]: デフォルトではオフになっています。有効にすると、パラメーター値が ****** と表示されます。
[アクション]: [アクション] 列の
アイコンをクリックして、[本文] パラメーターを編集します。[アクション] 列の アイコンをクリックして、[本文] パラメーターを削除します。
[テスト]: [テスト] をクリックし、[テストリクエストの送信] ダイアログボックスでテストパラメーターを設定してから、[テスト開始] をクリックします。
[リクエスト] テキストボックスにリクエストの詳細が表示されます。
アイコンをクリックして詳細をコピーします。リクエスト本文は、POST リクエストの場合にのみ表示されます。[レスポンス] テキストボックスにレスポンスの詳細が表示されます。
アイコンをクリックして詳細をコピーします。
説明テスト中にヘッダーに含まれるパラメーターの設定値を入力します。
送信結果分析
システムは、[HTTP 状態コード] と [HTTP 状態コードと応答結果] に基づく分析をサポートしています。
[HTTP 状態コードの解釈]: 2xx 範囲の状態コードは、送信が成功したことを示します。
[HTTP 状態コードと応答結果に基づく]: 送信条件のカスタム設定が可能です。
クエリ結果分析
[キー]: ドロップダウンボックスからキー値を選択するか、カスタムキー値を入力します。
[値]: カスタム値を入力します。
説明状態コードが 2xx で、送信成功条件が満たされている場合、成功とみなされます。
2xx 以外の状態コードは、失敗とみなされます。
状態コードが 2xx だが、送信失敗条件が満たされている場合、失敗とみなされます。
その他の条件下では、送信は処理中とみなされ、成功または失敗が確定するまでポーリングが続行されます。
${response.key} を使用して、レスポンスからキー値を取得できます。
結果クエリ設定
パラメーター
説明
結果クエリ
デフォルトでは [無効] です。[有効] にすることもできます。
[無効]: 無効の場合、タスクは送信完了時に成功とみなされます。
[有効]: 有効の場合、送信完了後、結果がポーリングされ、アラートセンターに表示されます。
結果クエリ URL
結果クエリ用の URL アドレスです。
リクエストメソッド
システムは [POST] または [GET] メソッドをサポートしています。
説明POST の場合は、[ヘッダー]、[パラメーター]、および [本文] を設定できます。
GET の場合は、[ヘッダー] と [パラメーター] を設定できます。
リクエストパラメーター設定
[ヘッダー]: [+ 新規] をクリックして、[ヘッダー] パラメーターを設定します。
[キー]: 一意のカスタムキー値を入力します。
[値]: 定数および組み込みパラメーターを含む、カスタム入力がサポートされています。詳細については、「参照ドキュメント」をご参照ください。
[タイプ]: [文字列]、[倍精度浮動小数点数]、[長整数]、または [ブール値] から選択します。
[パラメーターの暗号化]: デフォルトでは無効になっています。有効にすると、パラメーター値が ****** と表示されます。
[パラメーター]: [+ 新規] をクリックして、[パラメーター] パラメーターを設定します。
[キー]: 一意のカスタムキー値を入力します。
[値]: [値] を選択します。定数および組み込みパラメーターを含む、カスタム入力がサポートされています。詳細については、「参照ドキュメント」をご参照ください。
[アクション]: [アクション] 列の
アイコンをクリックして、[パラメーター] パラメーターを編集します。[アクション] 列の アイコンをクリックして、[パラメーター] パラメーターを削除します。
[本文]: [+ 新規] をクリックして、[本文] パラメーターを設定します。
[キー]: 一意のカスタムキー値を入力します。
[値]: 定数および組み込みパラメーターを含む、カスタム入力がサポートされています。詳細については、「参照ドキュメント」をご参照ください。
[タイプ]: [文字列]、[倍精度浮動小数点数]、[長整数]、[ブール値]、または [JSON] から選択します。
[パラメーターの暗号化]: デフォルトでは無効になっています。有効にすると、パラメーター値が ****** と表示されます。
[アクション]: [アクション] 列の
アイコンをクリックして、[本文] パラメーターを編集します。[アクション] 列の アイコンをクリックして、[本文] パラメーターを削除します。
[テスト]: [テスト] をクリックし、[テストリクエストの送信] ダイアログボックスでテストパラメーターを設定してから、[テスト開始] をクリックします。
[リクエスト] テキストボックスにリクエストの詳細が表示されます。
アイコンをクリックしてリクエストの詳細をコピーします。リクエスト本文は、POST メソッドの場合にのみ表示されます。[レスポンス] テキストボックスにレスポンスの詳細が表示されます。
アイコンをクリックしてレスポンスの詳細をコピーします。
説明ヘッダーにパラメーターが含まれている場合は、テスト中に設定値を入力します。
クエリ結果分析
[キー]: キー値のリストから選択するか、カスタムキーを入力します。
[値]: カスタム値を入力します。
説明状態コードが 2xx で、送信成功の条件が満たされている場合、送信は成功として認識されます。
状態コードが 2xx でない場合、送信は失敗として認識されます。
状態コードが 2xx だが、送信失敗の条件が満たされている場合、送信は失敗として認識されます。
その他の場合、送信は処理中とみなされ、最終的な成功または失敗が確定するまでポーリングが続行されます。
レスポンスからキー値を取得するには、${response.key} を使用します。
[カスタム音声サービス] の設定をテストするには、[テストメッセージを送信] をクリックします。検証のみを目的としたテストメッセージが送信されます。
パラメーター
説明
受信者
テストメッセージの受信者を選択します。
音声メッセージ
デフォルトのメッセージは [これは Dataphin からのテストメッセージです] です。
メッセージをカスタマイズできますが、128 文字を超えないようにしてください。
カスタム音声サービス メッセージチャンネルの設定を完了するには、[保存] をクリックします。