---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# NotifyConferenceUtil：スコープ指定、グローバル

# NotifyConferenceUtil：スコープ指定、グローバル {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：34分

NotifyConferenceUtil API は、ZoomやWebexなどのさまざまなテレフォニーサービスプロバイダーの通知電話会議と SMS メッセージを管理するためのメソッドを提供します。

NotifyConferenceUtil API を使用すると、次のことができます。  
* 新しい電話会議を作成する
* 電話番号またはユーザー ID によって参加者を追加する
* 電話会議から参加者を除外する
* 電話会議で参加者をミュート状態にする
* 電話会議で参加者のミュート状態を解除する
* 指定されたサービスプロバイダーの機能を取得する
* 電話会議を終了する
{#NotifyConferenceUtils__ul_qvb_kqy_4hb}

この API は、スコープ指定のスクリプトでもグローバルのスクリプトでも使用できます。この API を使用するには、個別のサブスクリプションが必要な Conference Notify プラグイン (com.snc.notify) をアクティブ化する必要があります。このプラグインのアクティブ化の詳細については、「 [通知のアクティブ化](https://www.servicenow.com/docs/access?context=t_ActivateNotify&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)」を参照してください。

## NotifyConferenceUtils - NotifyConferenceUtils() {#ariaid-title2}

NotifyConferenceUtils オブジェクト (コンストラクター) をインスタンス化します。
{#NUtil-NotifyConferenceUtils__table_qy1_cym_d3b__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 1. パラメーター]

{#NUtil-NotifyConferenceUtils__table_qy1_cym_d3b}  

    function () {
    	var confGR = new GlideRecord('notify_conference_call');
    	confGR.get('76d3364d0b5133008e64aabcb4673a6d');

    	var confUtils = new NotifyConferenceUtils();
    	var actionResult = confUtils.addToConferenceByPhoneNumber("+917799555331", confGR)
    	if (actionResult.status)
    		gs.info('Participant has been added to conference');
    	else {
    		gs.info('join operation failed');
    		actionResult.warnMessages.forEach(function (msg) {
    			gs.info(msg);
    		});
    		actionResult.errorMessages.forEach(function (msg) {
    			gs.info(msg);
    		})
    	}
    })();

## NotifyConferenceUtils - addToConferenceByPhoneNumber(文字列 toNumber, GlideRecord confGR) {#ariaid-title3}

参加者を識別する電話番号を使用して、指定された電話会議に参加者を追加します。
{#NUtil-addToConferenceByPhoneNumber_S_GR__table_lt1_kth_nhb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| toNumber | 文字列 | 電話会議に追加する参加者の電話番号。 |
| confGR | GlideRecord | 指定された参加者を追加する電話会議の GlideRecord。このレコードは Notify 電話会議 \[notify_conference_call\] テーブルにあります。 |
[表 : 2. パラメーター]

{#NUtil-addToConferenceByPhoneNumber_S_GR__table_lt1_kth_nhb} {#NUtil-addToConferenceByPhoneNumber_S_GR__table_mt1_kth_nhb__entry__2}

| タイプ | 説明 |
|-|-|
| オブジェクト | 会議アクションの結果。 `<action>.status`：会議アクションのステータス。 * データタイプ：ブール * 有効な値： * true：会議アクションが成功しました * false：会議アクションに失敗しました {#NUtil-addToConferenceByPhoneNumber_S_GR__ul_w5y_hyt_b3b} {#NUtil-addToConferenceByPhoneNumber_S_GR__ul_psg_gyt_b3b} `<action>.successMessages`：<var class="keyword varname">ステータス</var> が true の場合は成功メッセージ、それ以外の場合は空です。 * データタイプ：文字列のアレイ {#NUtil-addToConferenceByPhoneNumber_S_GR__ul_qm2_myt_b3b} `<action>.warnMessages`： <var class="keyword varname">ステータス</var>が false の場合、処理中にスローされた警告メッセージ。 * データタイプ：文字列のアレイ {#NUtil-addToConferenceByPhoneNumber_S_GR__ul_xbz_nyt_b3b} `<action>.errorMessages`： <var class="keyword varname">ステータス</var>が false の場合、処理中にスローされたエラーメッセージ。 * データタイプ：文字列のアレイ {#NUtil-addToConferenceByPhoneNumber_S_GR__ul_tht_4yt_b3b} |
[表 : 3. 返される内容]

{#NUtil-addToConferenceByPhoneNumber_S_GR__table_mt1_kth_nhb}  

    function () {
    	var confGR = new GlideRecord('notify_conference_call');
    	confGR.get('76d3364d0b5133008e64aabcb4673a6d');

    	var confUtils = new NotifyConferenceUtils();
    	var actionResult = confUtils.addToConferenceByPhoneNumber("+917799555331", confGR)
    	if (actionResult.status)
    		gs.info('Participant has been added to conference');
    	else {
    		gs.info('join operation failed');
    		actionResult.warnMessages.forEach(function (msg) {
    			gs.info(msg);
    		});
    		actionResult.errorMessages.forEach(function (msg) {
    			gs.info(msg);
    		})
    	}
    })();

## NotifyConferenceUtils - addToConferenceByUserId(文字列 userId, GlideRecord confGR) {#ariaid-title4}

一意のユーザー識別子を使用して、渡された GlideRecord によって参照される電話会議に参加者を追加します。
{#NUtil-addToConferenceByUserId_S_GR__table_xld_mwh_nhb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| userId | 文字列 | 指定された電話会議に追加する参加者のSys ID。この情報はユーザー \[sys_user\] テーブルにあります。 |
| confGR | GlideRecord | 指定された参加者を追加する電話会議の GlideRecord。このレコードは Notify 電話会議 \[notify_conference_call\] テーブルにあります。 |
[表 : 4. パラメーター]

{#NUtil-addToConferenceByUserId_S_GR__table_xld_mwh_nhb} {#NUtil-addToConferenceByUserId_S_GR__table_yld_mwh_nhb__entry__2}

| タイプ | 説明 |
|-|-|
| オブジェクト | 会議アクションの結果。 `<action>.status`：会議アクションのステータス。 * データタイプ：ブール * 有効な値： * true：会議アクションが成功しました * false：会議アクションに失敗しました {#NUtil-addToConferenceByUserId_S_GR__ul_w5y_hyt_b3b} {#NUtil-addToConferenceByUserId_S_GR__ul_psg_gyt_b3b} `<action>.successMessages`：<var class="keyword varname">ステータス</var> が true の場合は成功メッセージ、それ以外の場合は空です。 * データタイプ：文字列のアレイ {#NUtil-addToConferenceByUserId_S_GR__ul_qm2_myt_b3b} `<action>.warnMessages`： <var class="keyword varname">ステータス</var>が false の場合、処理中にスローされた警告メッセージ。 * データタイプ：文字列のアレイ {#NUtil-addToConferenceByUserId_S_GR__ul_xbz_nyt_b3b} `<action>.errorMessages`： <var class="keyword varname">ステータス</var>が false の場合、処理中にスローされたエラーメッセージ。 * データタイプ：文字列のアレイ {#NUtil-addToConferenceByUserId_S_GR__ul_tht_4yt_b3b} |
[表 : 5. 返される内容]

{#NUtil-addToConferenceByUserId_S_GR__table_yld_mwh_nhb}  

    (function () {
    	var confGR = new GlideRecord('notify_conference_call');
    	confGR.get('76d3364d0b5133008e64aabcb4673a6d');

    	var confUtils = new NotifyConferenceUtils();
    	var actionResult = confUtils.addToConferenceByUserId(gs.getUserID(), confGR)
    	if (actionResult.status)
    		gs.info('Participant has been added to conference');
    	else {
    		gs.info('join operation failed');
    		actionResult.warnMessages.forEach(function (msg) {
    			gs.info(msg);
    		});
    		actionResult.errorMessages.forEach(function (msg) {
    			gs.info(msg);
    		})
    	}
    })();

## NotifyConferenceUtils - doConferenceAction(文字列 action, オブジェクト data) {#ariaid-title5}

電話会議の開始/終了や、電話会議への参加者の追加、除外、ミュート、またはミュート解除などの指定された電話会議アクションを実行します。
新しい電話会議を開始し、このメソッドを 1 回呼び出すことで複数の参加者を追加するか、メソッドを複数回呼び出すことで通話を開始して参加者を個別に管理することができます。さらに、渡されたデータオブジェクトを使用して、次のようにメソッドを設定できます。

* 電話会議レコードのポインターを、電話会議のディスカッションのトピックであるインシデントや問題といった特定のレコード (ソースレコード) に保存します。
* ソースレコードの複数の電話会議を許可または禁止します。
* 電話会議に参加していた参加者を、ソースレコードの \[作業メモ\] フィールドに自動的に記録します。
* 参加者が会議からの発信コールに応答したときにメッセージを読み上げます。
{#NUtil-doConferenceAction_S_O__ul_rqn_z2y_vhb}
{#NUtil-doConferenceAction_S_O__table_qqs_vdv_nhb__entry__3}{#NUtil-doConferenceAction_S_O__data-entry-NConf}{#NUtil-doConferenceAction_S_O__data.addToWorkNotes-p-NConf}{#NUtil-doConferenceAction_S_O__data.allowMulticonference-p-NConf}{#NUtil-doConferenceAction_S_O__data.confId-p-NConf}{#NUtil-doConferenceAction_S_O__data.fromNumber-p-NConf}{#NUtil-doConferenceAction_S_O__data.isNewConference-p-NConf}{#NUtil-doConferenceAction_S_O__data.items-p-NConf}{#NUtil-doConferenceAction_S_O__data.message-p-NConf}{#NUtil-doConferenceAction_S_O__data.serviceProvider-p-NConf}{#NUtil-doConferenceAction_S_O__data.sys_id-p-NConf}{#NUtil-doConferenceAction_S_O__data.table-p-NConf}

| 名前 | タイプ | 説明 |
|-|-|-|
| action | 文字列 | 実行する電話会議アクションを定義します。 利用可能な電話会議アクションは次のとおりです。 * start：data.confId で識別された電話会議を開始します。 * end：data.confId で識別された電話会議を終了します。 * join：data.items アレイで指定された参加者を data.confId で識別された電話会議に追加します。 * multiJoin：data.items アレイで指定された複数の参加者を data.confId で識別された電話会議に追加します。 * selfJoin：現在ログインしているユーザーを電話会議に追加します (data.items のエントリは必要ありません) * kick：data.items アレイで指定された参加者を data.confId で識別された電話会議から削除します。 * multiKick：data.items アレイで指定された複数の参加者を data.confId で識別された電話会議から削除します。 * mute：data.items アレイで指定された参加者を data.confId で識別された電話会議でミュートします。 * multiMute：data.items アレイで指定された複数の参加者を data.confId で識別された電話会議でミュートします。 * unmute：data.items アレイで指定された参加者を data.confId で識別された電話会議でミュート状態を解除します。 * multiUnmute：data.items アレイで指定された複数の参加者を data.confId で識別された電話会議でミュート状態を解除します。 {#NUtil-doConferenceAction_S_O__ul_pq5_qfv_nhb} |
| data | オブジェクト | 電話会議を説明するオブジェクト。 |
| data.addToWorkNotes | ブール | 関連するレコードの作業メモフィールドに電話会議に含まれた参加者に関する情報を追加するかどうかを示すフラグ。 この機能を動作させるには、data.table および data.sysId パラメーターにも値を指定する必要があります。これらのパラメーターは、作業メモを追加するレコードを識別します。{#NUtil-doConferenceAction_S_O__data.addToWorkNotes2-p-NConf} デフォルト値：false このパラメーターが有効なアクション： * start * join * multiJoin * selfJoin {#NUtil-doConferenceAction_S_O__ul_kwg_ktx_vhb} |
| data.allowMulticonference | ブール | 特定のレコードに対して一度に複数の電話会議を許可するかどうかを示すフラグ。 この機能を動作させるには、data.table および data.sysId パラメーターにも値を指定する必要があります。これらのパラメーターは、複数の電話会議を許可されているレコードを識別します。{#NUtil-doConferenceAction_S_O__data.allowMulticonference2-p-NConf} デフォルト値：false このパラメーターが有効なアクション： * start {#NUtil-doConferenceAction_S_O__ul_ay4_mtx_vhb} |
| data.confId | 文字列 | 電話会議の sys ID。 会議の sys ID は Notify 電話会議 \[notify_conference_call\] テーブルにあります。{#NUtil-doConferenceAction_S_O__data.confId2-p-NConf} このパラメーターが必要なアクション： * end * join * multiJoin * selfJoin {#NUtil-doConferenceAction_S_O__ul_afs_qsx_vhb} 注: ミュート、ミュート解除、除外などの参加者アクションでは、メソッドが Notify 電話会議参加者 \[notify_participant\] テーブルからこの情報を取得するために、このパラメーターを設定する必要はありません。 |
| data.fromNumber | 文字列 | 電話会議のために呼び出すサービスプロバイダーの番号。 この値は、Notify 電話番号 \[notify_number\] テーブルの \[Number\] または \[ Phone number\] 列で見つけます。{#NUtil-doConferenceAction_S_O__data.fromNumber2-p-NConf} このパラメーターが必要なアクション： * start {#NUtil-doConferenceAction_S_O__ul_exs_stx_vhb} |
| data.isNewConference | ブール | 新規の電話会議か既存の電話会議かを示すフラグ。 有効な値： * true：新規の電話会議 * false：既存の電話会議 {#NUtil-doConferenceAction_S_O__ul_q1m_wbv_nhb} デフォルト値：false このパラメーターが有効なアクション： * start {#NUtil-doConferenceAction_S_O__ul_d1d_stx_vhb} |
| data.items | アレイ | 電話会議に含める各参加者に関する情報。 有効なアレイ値： * id：ユーザーの sys ID。ユーザー \[sys_User\] テーブルにあります。有効なアクション：join、multiJoin、start * notifyParticipantId：Notify 参加者の Sys ID。Notify 参加者 \[notify_participant\] テーブルにあります。有効なアクション： join、kick、multiJoin、mute、start、unmute * phoneNumber：参加者の電話番号。この値が id または notifyParticipantId とともに渡された場合、この値はユーザー/参加者レコードの電話番号より優先され、コールを発信するために使用されます。 有効なアクション：join、multiJoin、start * email：参加者のメールアドレス。有効なアクション：join、multiJoin、start {#NUtil-doConferenceAction_S_O__ul_qzh_pqt_rhb} |
| data.message | 文字列 | ユーザーがコールに応答したときに読み上げられるメッセージ (「P1 インシデントが作成されました。インスタンスにログインしてください」など)。 このパラメーターが有効なアクション： * start * join * multiJoin {#NUtil-doConferenceAction_S_O__ul_jnl_ntx_vhb} |
| data.serviceProvider | 文字列 | 必須です。Zoom や Webex などの会議サービスプロバイダーの名前。 このパラメーターが必要なアクション： * すべて {#NUtil-doConferenceAction_S_O__ul_vwb_psx_vhb} |
| data.sysId | 文字列 | 電話会議に関連付けるソースレコードの Sys ID。 たとえば、特定のインシデントまたは問題について話し合うために電話会議が行われる場合は、インシデントまたは問題レコードの Sys ID をこの値に入力します。この Sys ID は NotifyConference コール \[notify_conference_call\] テーブルの \[Source\] 列に保存され、後で追跡できます。{#NUtil-doConferenceAction_S_O__data.sys_id-p2-NConf} このパラメーターは、data.Table、data.addToWorkNotes、および allowMulticonference パラメーターと組み合わせて使用されます。{#NUtil-doConferenceAction_S_O__data.sys_id-p3-NConf} このパラメーターが有効なアクション： * start {#NUtil-doConferenceAction_S_O__ul_h3l_qsx_vhb} |
| data.table | 文字列 | 電話会議に関連付けるソースレコードのを含むテーブル。ソースレコードは、「インシデント」や「問題」など、電話会議でのディスカッションのトピックである任意のレコードです。 このテーブル名は NotifyConference コール \[notify_conference_call\] テーブルの \[Table\] 列に保存され、追跡できます。{#NUtil-doConferenceAction_S_O__data.table-p2-NConf} このパラメーターは、data.sysId、data.addToWorkNotes、および allowMulticonference パラメーターと組み合わせて使用されます。{#NUtil-doConferenceAction_S_O__data.table-p3-NConf} このパラメーターが有効なアクション： * start {#NUtil-doConferenceAction_S_O__ul_mj1_4sx_vhb} |
[表 : 6. パラメーター]

{#NUtil-doConferenceAction_S_O__table_qqs_vdv_nhb} {#NUtil-doConferenceAction_S_O__table_rqs_vdv_nhb__entry__2}

| タイプ | 説明 |
|-|-|
| オブジェクト | 会議アクションの結果。 `<action>.status`：会議アクションのステータス。 * データタイプ：ブール * 有効な値： * true：会議アクションが成功しました * false：会議アクションに失敗しました {#NUtil-doConferenceAction_S_O__ul_w5y_hyt_b3b} {#NUtil-doConferenceAction_S_O__ul_psg_gyt_b3b} `<action>.successMessages`：<var class="keyword varname">ステータス</var> が true の場合は成功メッセージ、それ以外の場合は空です。 * データタイプ：文字列のアレイ {#NUtil-doConferenceAction_S_O__ul_qm2_myt_b3b} `<action>.warnMessages`： <var class="keyword varname">ステータス</var>が false の場合、処理中にスローされた警告メッセージ。 * データタイプ：文字列のアレイ {#NUtil-doConferenceAction_S_O__ul_xbz_nyt_b3b} `<action>.errorMessages`： <var class="keyword varname">ステータス</var>が false の場合、処理中にスローされたエラーメッセージ。 * データタイプ：文字列のアレイ {#NUtil-doConferenceAction_S_O__ul_tht_4yt_b3b} |
[表 : 7. 返される内容]

{#NUtil-doConferenceAction_S_O__table_rqs_vdv_nhb}  

    (function (confId) {
    	var confUtils = new NotifyConferenceUtils();
    	var data = confUtils.getConferenceInputDataTemplate();
    	data.table = 'incident';
    	data.sysId = '1234';
    	data.addToWorkNotes = false;
    	data.confId = confId;
    	data.message = 'p1 incident has been created';
    	data.fromNumber = 'twilio/Telephony driver number';
    	data.items.push({ id: 'user3SysId', phoneNumber: '+917799555332' });
    	data.items.push({ id: 'user4SysId', email: 'yln99518@gmail.com' });

    	var result = confUtils.doConferenceAction('start', data);
    	if (result.status) {
    		gs.info('Start conference action succeeded');
    	} else
    		gs.info('Start conference action failed');

    	result.errorMessages.forEach(function (msg) {
    		gs.info(msg);
    	});
    	result.warnMessages.forEach(function (msg) {
    		gs.info(msg);
    	});
    	result.successMessages.forEach(function (msg) {
    		gs.info(msg);
    	});
    })('activeConfSysId');

## NotifyConferenceUtils - getConferenceInputDataTemplate() {#ariaid-title6}

doConferenceAction() メソッドで使用する JSON データテンプレートを返します。このテンプレートを使用すると、データオブジェクトが自動的に構造化されるため、手動で作成する必要はありません。
このメソッドを呼び出してから、doConferenceAction() メソッドを呼び出します。目的の電話会議アクションに対して、テンプレート内で目的のパラメーターを設定し、doConferenceAction() コールでテンプレートを渡します。各アクションの有効なパラメーターの詳細については、「 [doConferenceAction()」](https://servicenow-prod.fluidtopics.net/aJC5vhMuP2aAvK9tBISS1w#NotifyConferenceUtils "NotifyConferenceUtil API は、ZoomやWebexなどのさまざまなテレフォニーサービスプロバイダーの通知電話会議と SMS メッセージを管理するためのメソッドを提供します。")を参照してください。  
注:  
これはヘルパーメソッドです。このオブジェクトを手動で構築し、そのオブジェクトを doConferenceAction() メソッドに渡す方法でも、同じ結果が得られます。
{#NUtil-getConferenceInputDataTemplate__table_azh_qyg_nhb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 8. パラメーター]

{#NUtil-getConferenceInputDataTemplate__table_azh_qyg_nhb} {#NUtil-getConferenceInputDataTemplate__table_c2h_cwd_vhb__entry__2}{#NUtil-getConferenceInputDataTemplate__data.addToWorkNotes-p-NConf}{#NUtil-getConferenceInputDataTemplate__data.allowMulticonference-p-NConf}{#NUtil-getConferenceInputDataTemplate__data.confId-p-NConf}{#NUtil-getConferenceInputDataTemplate__data.fromNumber-p-NConf}{#NUtil-getConferenceInputDataTemplate__data.isNewConference-p-NConf}{#NUtil-getConferenceInputDataTemplate__data.items-p-NConf}{#NUtil-getConferenceInputDataTemplate__data.message-p-NConf}{#NUtil-getConferenceInputDataTemplate__data.serviceProvider-p-NConf}{#NUtil-getConferenceInputDataTemplate__data.sys_id-p-NConf}{#NUtil-getConferenceInputDataTemplate__data.table-p-NConf}

| タイプ | 説明 |
|-|-|
| data | 電話会議を説明するオブジェクト。 |
| data.addToWorkNotes | 関連するレコードの作業メモフィールドに電話会議に含まれた参加者に関する情報を追加するかどうかを示すフラグ。 この機能を動作させるには、data.table および data.sysId パラメーターにも値を指定する必要があります。これらのパラメーターは、作業メモを追加するレコードを識別します。{#NUtil-getConferenceInputDataTemplate__data.addToWorkNotes2-p-NConf} デフォルト値：false このパラメーターが有効なアクション： * start * join * multiJoin * selfJoin {#NUtil-getConferenceInputDataTemplate__ul_kwg_ktx_vhb} |
| data.allowMultconference | 特定のレコードに対して一度に複数の電話会議を許可するかどうかを示すフラグ。 この機能を動作させるには、data.table および data.sysId パラメーターにも値を指定する必要があります。これらのパラメーターは、複数の電話会議を許可されているレコードを識別します。{#NUtil-getConferenceInputDataTemplate__data.allowMulticonference2-p-NConf} デフォルト値：false このパラメーターが有効なアクション： * start {#NUtil-getConferenceInputDataTemplate__ul_ay4_mtx_vhb} |
| data.confId | 電話会議の sys ID。 会議の sys ID は Notify 電話会議 \[notify_conference_call\] テーブルにあります。{#NUtil-getConferenceInputDataTemplate__data.confId2-p-NConf} このパラメーターが必要なアクション： * end * join * multiJoin * selfJoin {#NUtil-getConferenceInputDataTemplate__ul_afs_qsx_vhb} 注: ミュート、ミュート解除、除外などの参加者アクションでは、メソッドが Notify 電話会議参加者 \[notify_participant\] テーブルからこの情報を取得するために、このパラメーターを設定する必要はありません。 |
| data.fromNumber | 電話会議のために呼び出すサービスプロバイダーの番号。 この値は、Notify 電話番号 \[notify_number\] テーブルの \[Number\] または \[ Phone number\] 列で見つけます。{#NUtil-getConferenceInputDataTemplate__data.fromNumber2-p-NConf} このパラメーターが必要なアクション： * start {#NUtil-getConferenceInputDataTemplate__ul_exs_stx_vhb} |
| data.isNewConference | 新規の電話会議か既存の電話会議かを示すフラグ。 有効な値： * true：新規の電話会議 * false：既存の電話会議 {#NUtil-getConferenceInputDataTemplate__ul_q1m_wbv_nhb} デフォルト値：false このパラメーターが有効なアクション： * start {#NUtil-getConferenceInputDataTemplate__ul_d1d_stx_vhb} |
| data.items | 電話会議に含める各参加者に関する情報。 有効なアレイ値： * id：ユーザーの sys ID。ユーザー \[sys_User\] テーブルにあります。有効なアクション：join、multiJoin、start * notifyParticipantId：Notify 参加者の Sys ID。Notify 参加者 \[notify_participant\] テーブルにあります。有効なアクション： join、kick、multiJoin、mute、start、unmute * phoneNumber：参加者の電話番号。この値が id または notifyParticipantId とともに渡された場合、この値はユーザー/参加者レコードの電話番号より優先され、コールを発信するために使用されます。 有効なアクション：join、multiJoin、start * email：参加者のメールアドレス。有効なアクション：join、multiJoin、start {#NUtil-getConferenceInputDataTemplate__ul_qzh_pqt_rhb} |
| data.message | ユーザーがコールに応答したときに読み上げられるメッセージ (「P1 インシデントが作成されました。インスタンスにログインしてください」など)。 このパラメーターが有効なアクション： * start * join * multiJoin {#NUtil-getConferenceInputDataTemplate__ul_jnl_ntx_vhb} |
| data.serviceProvider | 必須です。Zoom や Webex などの会議サービスプロバイダーの名前。 このパラメーターが必要なアクション： * すべて {#NUtil-getConferenceInputDataTemplate__ul_vwb_psx_vhb} |
| data.sysId | 電話会議に関連付けるソースレコードの Sys ID。 たとえば、特定のインシデントまたは問題について話し合うために電話会議が行われる場合は、インシデントまたは問題レコードの Sys ID をこの値に入力します。この Sys ID は NotifyConference コール \[notify_conference_call\] テーブルの \[Source\] 列に保存され、後で追跡できます。{#NUtil-getConferenceInputDataTemplate__data.sys_id-p2-NConf} このパラメーターは、data.Table、data.addToWorkNotes、および allowMulticonference パラメーターと組み合わせて使用されます。{#NUtil-getConferenceInputDataTemplate__data.sys_id-p3-NConf} このパラメーターが有効なアクション： * start {#NUtil-getConferenceInputDataTemplate__ul_h3l_qsx_vhb} |
| data.table | 電話会議に関連付けるソースレコードのを含むテーブル。ソースレコードは、「インシデント」や「問題」など、電話会議でのディスカッションのトピックである任意のレコードです。 このテーブル名は NotifyConference コール \[notify_conference_call\] テーブルの \[Table\] 列に保存され、追跡できます。{#NUtil-getConferenceInputDataTemplate__data.table-p2-NConf} このパラメーターは、data.sysId、data.addToWorkNotes、および allowMulticonference パラメーターと組み合わせて使用されます。{#NUtil-getConferenceInputDataTemplate__data.table-p3-NConf} このパラメーターが有効なアクション： * start {#NUtil-getConferenceInputDataTemplate__ul_mj1_4sx_vhb} |
[表 : 9. 返される内容]

{#NUtil-getConferenceInputDataTemplate__table_c2h_cwd_vhb}  

    (function (confId) {
    	var confUtils = new NotifyConferenceUtils();
    	var data = confUtils.getConferenceInputDataTemplate();
    	data.confId = confId;
    	var result = confUtils.doConferenceAction('end', data);
    	if (result.status) {
    		gs.info('Conference call has been ended');
    	} else
    		gs.info('End conference call action failed');

    	result.errorMessages.forEach(function (msg) {
    		gs.info(msg);
    	});
    	result.warnMessages.forEach(function (msg) {
    		gs.info(msg);
    	});
    	result.successMessages.forEach(function (msg) {
    		gs.info(msg);
    	});
    })('activeConfSysId');

## NotifyConferenceUtils - getServiceProvidersCapabilities() {#ariaid-title7}

インスタンス内のすべての電話通信サービスプロバイダーのドライバーの機能を返します。
返される可能性のある機能には以下のようなものがあります。

* archive：終了後に会議をアーカイブする
* beepOnLeave：参加者が電話会議から退出したときに「ビープ」音を再生する
* beepOnJoin：参加者が電話会議に参加したときに「ビープ」音を再生する
* end：特定された電話会議を終了する
* filesharing：参加者間でファイルを共有可能にする
* join：電話会議に参加者を追加する
* kick：電話会議から参加者を除外する
* multiJoin：電話会議に複数の参加者を追加する
* multiKick：電話会議から複数の参加者を除外する
* muteOnJoin：電話会議への参加者の初回参加時にその参加者をミュートする
* multiUnmute：電話会議に対して複数の参加者のミュートを解除する
* record：電話会議を記録する
* recording：電話会議の記録中に画面上のインジケーターを表示する
* screenSharing：参加者の画面をグループと共有可能にする
* selfJoin：現在ログインしているユーザーを電話会議に追加する
* speaking：現在発言しているユーザーについて画面にメッセージを表示する
* start：識別された電話会議を開始する
* unmute：電話会議で参加者のミュート状態を解除する
{#NUtil-getServiceProvidersCapabilities__ul_pq5_qfv_nhb}
{#NUtil-getServiceProvidersCapabilities__table_azh_qyg_nhb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 10. パラメーター]

{#NUtil-getServiceProvidersCapabilities__table_azh_qyg_nhb} {#NUtil-getServiceProvidersCapabilities__table_bzh_qyg_nhb__entry__2}

| タイプ | 説明 |
|-|-|
| オブジェクト | 各ドライバー機能のステータスのキーと値のペア。 有効な値： * isSupported = 0：機能はサポートされていない * isSupported = 1：機能はサポートされている {#NUtil-getServiceProvidersCapabilities__ul_jbq_mdt_rhb} |
[表 : 11. 返される内容]

{#NUtil-getServiceProvidersCapabilities__table_bzh_qyg_nhb}  
インスタンス内のすべての電話通信サービスプロバイダーのドライバーの機能を一覧表示します。

    (function () {
    	var confUtils = new NotifyConferenceUtils();
    	var providerToCapability = confUtils.getServiceProvidersCapabilites();
    	for (var provider in providerToCapability) {
    		gs.info('{0} supported capabilities \n\n', provider);
    		var capabilities = providerToCapability[provider]
    		for (var cap in capabilities)
    			if(confUtils.isActionSupported(capabilities[cap].isSupported))
    				gs.info('"{0}" action supported', cap);
    			else
    				gs.info("'{0}' action is not supported by this conference driver", cap);
    	}
    })();

出力：このメソッドは、インスタンス内のアクティブな電話通信サービスプロバイダーごとに次のようなノードを返します。

    {
        "Telephony": {
            "start": {
                "isSupported": 1,
                "meta": {}
            },
            "end": {
                "isSupported": 1,
                "meta": {}
            },
            "selfJoin": {
                "isSupported": 1,
                "meta": {}
            },
            "join": {
                "isSupported": 1,
                "meta": {}
            },
            "multiJoin": {
                "isSupported": 1,
                "meta": {}
            },
            "mute": {
                "isSupported": 1,
                "meta": {}
            },
            "multiMute": {
                "isSupported": 1,
                "meta": {}
            },
            "unmute": {
                "isSupported": 1,
                "meta": {}
            },
            "multiUnmute": {
                "isSupported": 1,
                "meta": {}
            },
            "kick": {
                "isSupported": 1,
                "meta": {}
            },
            "multiKick": {
                "isSupported": 1,
                "meta": {}
            },
            "record": {
                "isSupported": 0,
                "meta": {}
            },
            "speaking": {
                "isSupported": 0,
                "meta": {}
            },
            "recording": {
                "isSupported": 0,
                "meta": {}
            },
            "screenSharing": {
                "isSupported": 0,
                "meta": {}
            },
            "fileSharing": {
                "isSupported": 0,
                "meta": {}
            },
            "archive": {
                "isSupported": 0,
                "meta": {}
            },
            "muteOnJoin": {
                "isSupported": 0,
                "meta": {}
            },
            "beepOnJoin": {
                "isSupported": 0,
                "meta": {}
            },
            "beepOnLeave": {
                "isSupported": 0,
                "meta": {}
            }
        }
    }

## NotifyConferenceUtils - isActionSupported(数字 action) {#ariaid-title8}

Notify 会議アクションが電話通信サービスプロバイダーによってサポートされているかどうかを判断します。
このメソッドを使用するには、まず getServiceProviderCapabilities() メソッドを呼び出す必要があります。このメソッドは、インスタンスで設定された各サービスプロバイダーに対して実行可能な Notify 会議アクションそれぞれの可用性に関する情報を含むオブジェクトを返します。

例：  

    {
        "Telephony": {
            "start": {
                "isSupported": 1,
                "meta": {}
            },
            "end": {
                "isSupported": 1,
                "meta": {}
            },
            "selfJoin": {
                "isSupported": 1,
                "meta": {}
            },
            "join": {
                "isSupported": 1,
                "meta": {}
            },
            "multiJoin": {
                "isSupported": 1,
                "meta": {}
            },
            "mute": {
                "isSupported": 1,
                "meta": {}
            },
            "multiMute": {
                "isSupported": 1,
                "meta": {}
            },
            "unmute": {
                "isSupported": 1,
                "meta": {}
            },
            "multiUnmute": {
                "isSupported": 1,
                "meta": {}
            },
            "kick": {
                "isSupported": 1,
                "meta": {}
            },
            "multiKick": {
                "isSupported": 1,
                "meta": {}
            },
            "record": {
                "isSupported": 0,
                "meta": {}
            },
            "speaking": {
                "isSupported": 0,
                "meta": {}
            },
            "recording": {
                "isSupported": 0,
                "meta": {}
            },
            "screenSharing": {
                "isSupported": 0,
                "meta": {}
            },
            "fileSharing": {
                "isSupported": 0,
                "meta": {}
            },
            "archive": {
                "isSupported": 0,
                "meta": {}
            },
            "muteOnJoin": {
                "isSupported": 0,
                "meta": {}
            },
            "beepOnJoin": {
                "isSupported": 0,
                "meta": {}
            },
            "beepOnLeave": {
                "isSupported": 0,
                "meta": {}
            }
        }
    }

{#NUtil-isActionSupported_N__table_gsw_vd2_vhb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| action | 数字 | 特定のアクションおよびサービスプロバイダーの getServiceProvidersCapabilities() メソッドによって返される isSupported パラメーターの値。 注: isSupported の値はブーリアンのように見えますが、実際には数字です。機能をブーリアン値として評価しないでください。関連する値は将来のバージョンで拡張される可能性があるため、このメソッドを使用してください。 |
[表 : 12. パラメーター]

{#NUtil-isActionSupported_N__table_gsw_vd2_vhb} {#NUtil-isActionSupported_N__table_hsw_vd2_vhb__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | 電話通信サービスプロバイダーが指定されたアクションをサポートしているかどうかを示すフラグ。 有効な値： * true：アクションはサービスプロバイダーによってサポートされている * false：アクションはサービスプロバイダーによってサポートされていない {#NUtil-isActionSupported_N__ul_pkt_mf2_vhb} |
[表 : 13. 返される内容]

{#NUtil-isActionSupported_N__table_hsw_vd2_vhb}  

    (function () {
      var confUtils = new NotifyConferenceUtils();
      var providerToCapability = confUtils.getServiceProvidersCapabilites();
        for (var provider in providerToCapability) {
          gs.info('{0} supported capabilities \n\n', provider);
          var capabilities = providerToCapability[provider]
          for (var cap in capabilities)
            if (confUtils.isActionSupported(capabilities[cap].isSupported))
              gs.info('"{0}" action supported', cap);
            else
              gs.info("'{0}' action is not supported by this conference driver", cap);
        }
    })();

## NotifyConferenceUtils - kickByParticipantGR(GlideRecord notifyParticipantGR) {#ariaid-title9}

渡された GlideRecord に関連付けられた参加者を現在の電話会議から除外します。
{#NUtil-kickByParticipantGR_GR__table_inj_thh_nhb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| notifyParticipantGR | GlideRecord | 電話会議から除外する参加者の GlideRecord オブジェクト。このレコードは Notify 参加者 \[notify_participant\] テーブルにあります。 |
[表 : 14. パラメーター]

{#NUtil-kickByParticipantGR_GR__table_inj_thh_nhb} {#NUtil-kickByParticipantGR_GR__table_jnj_thh_nhb__entry__2}

| タイプ | 説明 |
|-|-|
| オブジェクト | 会議アクションの結果。 `<action>.status`：会議アクションのステータス。 * データタイプ：ブール * 有効な値： * true：会議アクションが成功しました * false：会議アクションに失敗しました {#NUtil-kickByParticipantGR_GR__ul_w5y_hyt_b3b} {#NUtil-kickByParticipantGR_GR__ul_psg_gyt_b3b} `<action>.successMessages`：<var class="keyword varname">ステータス</var> が true の場合は成功メッセージ、それ以外の場合は空です。 * データタイプ：文字列のアレイ {#NUtil-kickByParticipantGR_GR__ul_qm2_myt_b3b} `<action>.warnMessages`： <var class="keyword varname">ステータス</var>が false の場合、処理中にスローされた警告メッセージ。 * データタイプ：文字列のアレイ {#NUtil-kickByParticipantGR_GR__ul_xbz_nyt_b3b} `<action>.errorMessages`： <var class="keyword varname">ステータス</var>が false の場合、処理中にスローされたエラーメッセージ。 * データタイプ：文字列のアレイ {#NUtil-kickByParticipantGR_GR__ul_tht_4yt_b3b} |
[表 : 15. 返される内容]

{#NUtil-kickByParticipantGR_GR__table_jnj_thh_nhb}  

    (function () {
        var confUtils = new NotifyConferenceUtils();
        var participantGR = new GlideRecord('notify_participant');  // Participant record contains conf call ID
        participantGR.get('validParticipantSysId');
        var actionResult = confUtils.kickByParticipantGR(participantGR);
        if (actionResult.status)
            gs.info('Participant has been kicked out of conference');
        else {
            gs.info('kick operation failed');
            actionResult.warnMessages.forEach(function (msg) {
                gs.info(msg);
            });
            actionResult.errorMessages.forEach(function (msg) {
                gs.info(msg);
            })
        }
    })()

## NotifyConferenceUtils - muteByParticipantGR(GlideRecord notifyParticipantGR) {#ariaid-title10}

渡された GlideRecord に関連付けられた参加者を現在の電話会議でミュートします。
{#NUtil-muteByParticipantGR_GR__table_vpk_ckh_nhb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| notifyParticipantGR | オブジェクト | ミュートする参加者の GlideRecord オブジェクト。このレコードは Notify 参加者 \[notify_participant\] テーブルにあります。 |
[表 : 16. パラメーター]

{#NUtil-muteByParticipantGR_GR__table_vpk_ckh_nhb} {#NUtil-muteByParticipantGR_GR__table_wpk_ckh_nhb__entry__2}

| タイプ | 説明 |
|-|-|
| オブジェクト | 会議アクションの結果。 `<action>.status`：会議アクションのステータス。 * データタイプ：ブール * 有効な値： * true：会議アクションが成功しました * false：会議アクションに失敗しました {#NUtil-muteByParticipantGR_GR__ul_w5y_hyt_b3b} {#NUtil-muteByParticipantGR_GR__ul_psg_gyt_b3b} `<action>.successMessages`：<var class="keyword varname">ステータス</var> が true の場合は成功メッセージ、それ以外の場合は空です。 * データタイプ：文字列のアレイ {#NUtil-muteByParticipantGR_GR__ul_qm2_myt_b3b} `<action>.warnMessages`： <var class="keyword varname">ステータス</var>が false の場合、処理中にスローされた警告メッセージ。 * データタイプ：文字列のアレイ {#NUtil-muteByParticipantGR_GR__ul_xbz_nyt_b3b} `<action>.errorMessages`： <var class="keyword varname">ステータス</var>が false の場合、処理中にスローされたエラーメッセージ。 * データタイプ：文字列のアレイ {#NUtil-muteByParticipantGR_GR__ul_tht_4yt_b3b} |
[表 : 17. 返される内容]

{#NUtil-muteByParticipantGR_GR__table_wpk_ckh_nhb}  

    (function () {
        var confUtils = new NotifyConferenceUtils();
        var participantGR = new GlideRecord('notify_participant');
        participantGR.get('validSysId');
        var actionResult = confUtils.muteByParticipantGR(participantGR);
        if (actionResult.status)
            gs.info('Participant has been muted');
        else {
            gs.info('mute operation failed');
            actionResult.warnMessages.forEach(function (msg) {
                gs.info(msg);
            });
            actionResult.errorMessages.forEach(function (msg) {
                gs.info(msg);
            })
        }
    })()

## NotifyConferenceUtils - unmuteByParticipantGR(GlideRecord notifyParticipantGR) {#ariaid-title11}

渡された GlideRecord に関連付けられた参加者を現在の電話会議でミュート解除します。
{#NUtil-unmuteByParticipantGR_GR__table_byp_zqh_nhb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| notifyParticipantGR | GlideRecord | ミュート解除する参加者の GlideRecord オブジェクト。このレコードは Notify 参加者 \[notify_participant\] テーブルにあります。 |
[表 : 18. パラメーター]

{#NUtil-unmuteByParticipantGR_GR__table_byp_zqh_nhb} {#NUtil-unmuteByParticipantGR_GR__table_cyp_zqh_nhb__entry__2}

| タイプ | 説明 |
|-|-|
| オブジェクト | 会議アクションの結果。 `<action>.status`：会議アクションのステータス。 * データタイプ：ブール * 有効な値： * true：会議アクションが成功しました * false：会議アクションに失敗しました {#NUtil-unmuteByParticipantGR_GR__ul_w5y_hyt_b3b} {#NUtil-unmuteByParticipantGR_GR__ul_psg_gyt_b3b} `<action>.successMessages`：<var class="keyword varname">ステータス</var> が true の場合は成功メッセージ、それ以外の場合は空です。 * データタイプ：文字列のアレイ {#NUtil-unmuteByParticipantGR_GR__ul_qm2_myt_b3b} `<action>.warnMessages`： <var class="keyword varname">ステータス</var>が false の場合、処理中にスローされた警告メッセージ。 * データタイプ：文字列のアレイ {#NUtil-unmuteByParticipantGR_GR__ul_xbz_nyt_b3b} `<action>.errorMessages`： <var class="keyword varname">ステータス</var>が false の場合、処理中にスローされたエラーメッセージ。 * データタイプ：文字列のアレイ {#NUtil-unmuteByParticipantGR_GR__ul_tht_4yt_b3b} |
[表 : 19. 返される内容]

{#NUtil-unmuteByParticipantGR_GR__table_cyp_zqh_nhb}  

    (function () {
        var confUtils = new NotifyConferenceUtils();
        var participantGR = new GlideRecord('notify_participant');
        participantGR.get('validSysId');
        var actionResult = confUtils.unmuteByParticipantGR(participantGR);
        if (actionResult.status)
            gs.info('Participant has been Unmuted');
        else {
            gs.info('Unmute operation failed');
            actionResult.warnMessages.forEach(function (msg) {
                gs.info(msg);
            });
            actionResult.errorMessages.forEach(function (msg) {
                gs.info(msg);
            })
        }
    })();