この記事の内容
dropdown icon
アクションボタンをカスタマイズしてください
    緊急通報のパラメータ設定
    カスタムサービスパラメータ設定
    複数のトリガーパラメーター設定
    1つのトリガーで複数のイベントのパラメーター設定が可能
アクションボタンのHTTP POSTリクエスト
アクションボタンを設定してください (Unified CM)
list-menuこの記事の内容
list-menuフィードバックがある場合

このヘルプ記事は Cisco Unified Communications Manager (Unified CM) に登録されているシスコワイヤレスフォン 9821を対象としています。

アクションボタンは、Ciscoワイヤレス電話9821の右側にある赤いボタンです。 これにより、ユーザーは緊急サービスやカスタムサービスなど、指定されたサービスにすばやくアクセスできます。 ボタンをカスタマイズして、特定のユースケースに合ったイベントを開始できます。

アクションボタンをカスタマイズしてください

1

でCisco Unified Communications Manager Administration、必要に応じて次のアクションのいずれかを実行してください。

  • 導入されているすべての電話を設定するには、[システム] > [エンタープライズ電話設定] に移動します。
  • 同じ電話プロファイルを共有する電話を設定するには、[デバイス] > [デバイス設定] > [共通の電話プロファイル] に移動します。
  • 個々の電話を設定するには、[デバイス] > [電話] に移動します。 次に、お使いの電話を見つけて、電話の設定ページを開きます。

設定は階層構造になっています。

  • 個々のデバイス設定は、 共通の電話プロファイルや企業レベルの設定よりも優先されます
  • 一般的な電話プロファイル設定は、企業レベルの設定よりも優先されます

2

ユースケースに基づいてアクションボタンのパラメータをカスタマイズしてください。

アクションボタンには3つのパラメーターグループがあり、 それぞれが独自のトリガーを持つサービスに対応しています。 サービストリガーが複数のグループで指定されている場合、 グループ1の設定がグループ2と3の設定よりも優先され、 グループ2の設定がグループ3よりも優先されます。

これらのパラメーターの詳細については、「 製品固有の構成パラメーター」を参照してください。

3

[保存] を選択します。

4

「設定を適用」を選択します。

緊急通報のパラメータ設定

緊急通報用に次のパラメータを設定してください。

テーブル 1.緊急通報パラメータ設定

パラメーター

設定

アクションボタン機能

緊急通報を選択してください。

アクションボタンサービスの送信先

緊急サービスの電話番号またはURIを入力してください。

アクションボタンのサービス名

(オプション) トリガーに関連するサービスの名前を指定してください。 この名前は、ユーザーがボタンを押すと画面上のメッセージに表示され、 どのサービスが起動されるかを示します。 名前が指定されていない場合、 Emergency callSilent emergency callまたはが表示名として使用されます。

ダイヤルアウト遅延

トリガーを検知した後に電話がイベントを開始するまでのタイムアウト期間を秒単位で設定します。 デフォルト値は5秒です。 0に設定すると、 トリガーが検出されるとすぐにイベントが開始されます。

遅延画面にはカウントダウンタイマーが表示され、 ユーザーはアクションボタンによってトリガーされたアクションをキャンセルできます。 緊急通報のシナリオでは、遅延画面が表示されている間、シスコワイヤレス電話9821は継続的に振動します。 ただし、 無音の緊急電話や信号の場合、Ciscoワイヤレス電話9821は振動しません。

サービストリガー

リストからトリガーを選択してください:シングルプレス、 ロングプレス、または3回プレス。

サイレント・エマージェンシー・コール

(オプション)デフォルトでは、 緊急電話は他の発信電話と同様に双方向通話として機能します。 緊急時のサイレントコールが有効になっていると、 通話中に注意が引かれないように、発信者側の音声は無音になります。 サイレント緊急通報を終了できるのは、電話の受信者だけです。

サイレント・エマージェンシー・コール中は、Ciscoワイヤレス電話9821の画面はオフになります。 他のすべての機能にはアクセスできません。 受信者が通話を終了すると、電話は通常の動作に戻ります。

サイレント・エマージェンシー・コール検索を許可します

(オプション) 緊急通報を受けながらユーザーが任意のキーを押して通常の電話操作に戻せるようにする場合は、この機能を有効にしてください。 ユーザーが音量キーを使用してスピーカーの音量を上げない限り、通話音声は無音のままです。

カスタムサービスパラメータ設定

カスタムサービスには次のパラメータを設定してください。

テーブル 2.カスタムサービスパラメータ設定

パラメーター

設定

アクションボタン機能

「カスタム」を選択します。

アクションボタンサービスの送信先

カスタムサービスのURLを入力してください。 http://https://URLはまたはで始まる必要があります(例:) https://10.11.20.159/path/service.xml。

アクションボタンのサービス名

(オプション) トリガーに関連するサービスの名前を指定してください。 この名前は、ユーザーがボタンを押すと画面上のメッセージに表示され、 どのサービスが起動されるかを示します。 名前が指定されていない場合は、 カスタムサービスが表示名として使用されます。

カスタムコンテンツフィールド

(オプション) アクションボタンが押されたときに電話がHTTP Postリクエストを送信できるようにするには、メソッド、ヘッダー、 投稿コンテンツなどのHTTPデータを最大1024文字で入力してください。

POSTスクリプトの例と構文については、 アクションボタンのHTTP Postリクエストを参照してください。

ダイヤルアウト遅延

トリガーを検知した後に電話がイベントを開始するまでのタイムアウト期間を秒単位で設定します。 デフォルト値は5秒です。 0に設定すると、 トリガーが検出されるとすぐにイベントが開始されます。

遅延画面にはカウントダウンタイマーが表示され、 ユーザーはアクションボタンによってトリガーされたアクションをキャンセルできます。 カスタムサービスのシナリオでは、遅延画面が表示されている間、Ciscoワイヤレス電話9821は継続的に振動します。

サービストリガー

リストからトリガーを選択してください:シングルプレス、 ロングプレス、または3回プレス。

サービスシークレット

認証シークレット、トークン、パスワードなどのシークレットストリングを設定してください。 入力されたシークレットはマスクされた文字列として表示され、 $SS カスタムコンテンツフィールドとアクションボタンサービスデスティネーションのマクロを使用して参照できます。

複数のトリガーパラメーター設定

各グループのパラメータをそれぞれ設定してください。 上記の「緊急通報」と「 カスタムサービス」セクションを参照してください。

1つのトリガーで複数のイベントのパラメーター設定が可能

トリガーに複数のイベントを割り当てるには、次のパラメータを設定します。

テーブル 3.1つのトリガーで複数のイベントのパラメーター設定が可能

パラメーター

設定

アクションボタン機能

「カスタム」を選択します。

アクションボタンサービスの送信先

電話する電話番号とXMLサービスのURLを次の形式で入力してください:

tel:<phonenumber or SIP URI> + <serviceURL>

http://URLはまたはで始まる必要があります https://。

例: tel:1234 + https://10.11.20.159/path/service.xml

アクションボタンのサービス名

(オプション) トリガーに関連するサービスの名前を指定してください。 この名前は、ユーザーがボタンを押すと画面上のメッセージに表示され、 どのサービスが起動されるかを示します。 名前が指定されていない場合は、 カスタムサービスが表示名として使用されます。

カスタムコンテンツフィールド

(オプション) アクションボタンが押されたときに電話がHTTP Postリクエストを送信できるようにするには、メソッド、ヘッダー、 投稿コンテンツなどのHTTPデータを最大1024文字で入力してください。

POSTスクリプトの例と構文については、 アクションボタンのHTTP Postリクエストを参照してください。

ダイヤルアウト遅延

トリガーを検知した後に電話がイベントを開始するまでのタイムアウト期間を秒単位で設定します。 デフォルト値は5秒です。 0に設定すると、 トリガーが検出されるとすぐにイベントが開始されます。

遅延画面にはカウントダウンタイマーが表示され、 ユーザーはアクションボタンによってトリガーされたアクションをキャンセルできます。 緊急通報やカスタムサービスのシナリオでは、遅延画面が表示されている間、Ciscoワイヤレス電話9821は継続的に振動します。 ただし、 無音の緊急電話や信号の場合、Ciscoワイヤレス電話9821は振動しません。

サービストリガー

リストからトリガーを選択してください:シングルプレス、 ロングプレス、または3回プレス。

サービスシークレット

認証シークレット、トークン、パスワードなどのシークレットストリングを設定してください。 入力されたシークレットはマスクされた文字列として表示され、 $SS カスタムコンテンツフィールドとアクションボタンサービスデスティネーションのマクロを使用して参照できます。

サイレント・エマージェンシー・コール

(オプション)デフォルトでは、 緊急電話は他の発信電話と同様に双方向通話として機能します。 緊急時のサイレントコールが有効になっていると、 通話中に注意が引かれないように、発信者側の音声は無音になります。 サイレント緊急通報を終了できるのは、電話の受信者だけです。

サイレント・エマージェンシー・コール中は、Ciscoワイヤレス電話9821の画面はオフになります。 他のすべての機能にはアクセスできません。 受信者が通話を終了すると、電話は通常の動作に戻ります。

サイレント・エマージェンシー・コール検索を許可します

(オプション) 緊急通報を受けながらユーザーが任意のキーを押して通常の電話操作に戻せるようにする場合は、この機能を有効にしてください。 ユーザーが音量キーを使用してスピーカーの音量を上げない限り、通話音声は無音のままです。

アクションボタンのHTTP POSTリクエスト

Ciscoワイヤレス電話9821のアクションボタンは、HTTP Postリクエストを介してXMLアプリケーションをトリガーするように設定できます。

カスタムコンテンツフィールドに、カスタマイズしたリクエストスクリプトを入力します。 XMLまたはJSONのコンテンツタイプを指定して、リクエストにマクロを含めることができます。 たとえば、をスクリプトに追加して、サービスシークレットフィールドに入力された認証シークレット、 トークン、 $SSまたはパスワードを取得できます。

次の例はXMLとJSON形式です。

Sample #1: XML
--method POST
--header 'Content-Type: application/xml'
--header 'Authorization: Bearer username:$SS'
--body '<MetaData><Trigger>True</Trigger><Description>This is for HTTP POST XML</Description></MetaData>' 

Sample #2: JSON
--method POST
--header 'Content-Type: application/json'
--header 'Authorization: $SS'
--body '{"events":[{"evtid":"12345", "parameters": {"trigger":true}, "Description":"This is for HTTP POST JSON"}]}' 

Cisco Unified CMRFC 3986に従って、予約文字をパーセントエンコードする必要があります。

テーブル 4.予約文字のパーセントエンコーディング
キャラクターパーセントエンコーディング
&%26
'%27
"%22
< %3c
> %3e

次のスクリプトは、パーセントでエンコードされた文字列を使った例です。

--method POST
--header %27Content-Type: application/xml%27
--body %27%3cMetaData%3e%3cTrigger%3eTrue%3c/Trigger%3e%3cDescription%3eThis is for HTTP POST XML%3c/Description%3e%3c/MetaData%3e%27
テーブル 5.サポートされているマクロ
マクロ名マクロ拡張
#DEVICENAME#通話システムに表示されるデバイス名。 たとえば、 SEP845A3EC21288
$SSサービスシークレットは、認証シークレット、トークン、 パスワードなどのマスクされた文字列を電話の設定ページに表示します。
この投稿記事は役に立ちましたか?
この投稿記事は役に立ちましたか?