--- sourceDocument: オーストラリア API リファレンス sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference Release : - australia ft:locale : - ja-JP ft:publication_title : - オーストラリア API リファレンス ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # OnCallContactPreferenceUtil: グローバル # OnCallContactPreferenceUtil: グローバル {#ariaid-title1} * リリースバージョン: Australia * * 更新日 2026年03月12日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：9分 OnCallContactPreferenceUtil スクリプトインクルードは、連絡先設定を処理するためのメソッドを提供します。連絡先設定の構成については、「 [連絡先設定を構成する」](https://www.servicenow.com/docs/access?context=config-my-contact-prefs-oncall&version=australia&pubname=australia-it-service-management&ft:locale=en-US)を参照してください。このスクリプトインクルードは、 [OnCallRotation](https://servicenow-prod.fluidtopics.net/6L9rcyEfkH8WR~PsKYzFWw#c_OnCallRotationAPI "OnCallRotation スクリプトインクルードは、オンコールスケジュールを管理するメソッドを提供します。") スクリプトインクルードをサポートしています。 ## OnCallContactPreferenceUtil:OnCallContactPreferenceUtil() {#ariaid-title2} OnCallContactPreferenceUtil クラスのインスタンスを作成します。 {#P-OnCallContactPreferenceUtil__table_pzm_w3f_2w__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 1. パラメーター] {#P-OnCallContactPreferenceUtil__table_pzm_w3f_2w} ## OnCallContactPreferenceUtil - getContactsAtByEscalatee(Object escalatee, Number contactAttempt, GlideDateTime gdt, String rotaSysIds) {#ariaid-title3} エスカレーション先オブジェクトを含む連絡先のリストを取得します。返された各連絡先には、ユーザーの連絡先設定のリストが含まれています。 {#P-getContactsAtByEscalatee_O_N_F_S__table_o1s_x5j_3gb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | エスカレーション先 | オブジェクト | 必須。[getEscalationPlan()](https://servicenow-prod.fluidtopics.net/6L9rcyEfkH8WR~PsKYzFWw#r_OCR-getEscalationPlan_S_GDT "指定された日時にグループのシフトについて、エスカレート先オブジェクトのリスト、ユーザー [sys_user] または通知デバイス [cmn_notif_device] のいずれかで構成されるエスカレーション計画を取得します。この API は、単一シフト、重複シフト、およびカスタムエスカレーションに適用されます。") メソッドによって返されるエスカレーション先オブジェクト。 | | 接触試行 | 番号 | オプション。連絡しようとしている試み \[デフォルト値 = 1\]。 * 1:最初の試行 * 2:最初のリマインダー * 3 つ以上:後続のリマインダー {#P-getContactsAtByEscalatee_O_N_F_S__ul_gp2_q4w_gjb} | | GDT | GlideDateTime | オプション。UTC タイムゾーンの yyyy-MM-dd HH:mm:ss 形式。デフォルトは now.admin です | | rotaSysId | 文字列 | オプション。\[cmn_rota\] テーブルからのシフトの Sys ID のカンマ区切り文字列。デフォルト値は、現時点でのシフトの Sys ID を返します。 | [表 : 2. パラメーター] {#P-getContactsAtByEscalatee_O_N_F_S__table_o1s_x5j_3gb} {#P-getContactsAtByEscalatee_O_N_F_S__table_nmd_wvj_3gb__entry__2} | タイプ | 説明 | |-|-| | アレイオブジェクト | 特定の時間と位置でのエスカレーション先 (通知ルールに応じてユーザー、グループ、またはデバイスレコード) のアレイ。 * タイプ:文字列。連絡先のタイプ (ユーザーなど)。 * sys_id:文字列。\[sys_user\] テーブルのユーザーの Sys ID。 * rota_id:文字列。\[cmn_rota\] テーブルからのシフトの Sys ID。 * roster_id:文字列。\[cmn_rota_roster\] テーブルの勤務表の Sys ID。 * escalation_step_id:文字列。エスカレーションパスが定義されている場合、\[cmn_rota_esc_step_def\] テーブルからのエスカレーションステップの Sys ID。 * forced_communication_channel:文字列。設定で指定した場合は、必須コミュニケーションチャネルです。サポートされている値には、SMS、音声、またはメールがあります。 * override_user_contact_preference:ブーリアン。連絡先の上書きがある場合は true、それ以外の場合は false。 * preference_source:文字列。連絡先やグループなどの優先のソース。 * contact_attempt:番号。連絡試行:1 = 最初の試行、2 = 最初のリマインダーなどです。 * user_preferences:アレイオブジェクト。 * タイプ:文字列。ユーザーが希望する連絡形式 (SMS、メール、番号など)。 * \<メールや番号など、希望する形式の名前\>:文字列。優先連絡先タイプの内容 (メールアドレスや電話番号など)。 {#P-getContactsAtByEscalatee_O_N_F_S__ul_pzn_52r_gjb} * contact_preferences、アレイオブジェクト。 * タイプ:文字列。ユーザーの優先連絡先形式 (メールや番号など)。 * \<メールや番号など、希望する形式の名前\>:文字列。優先連絡先タイプの内容 (メールアドレスや電話番号など)。 {#P-getContactsAtByEscalatee_O_N_F_S__ul_vnw_y2r_gjb} {#P-getContactsAtByEscalatee_O_N_F_S__ul_whv_4bp_3jb} | [表 : 3. 返される内容] {#P-getContactsAtByEscalatee_O_N_F_S__table_nmd_wvj_3gb} var serviceDeskSysId = ''; var ocRotation = new OnCallRotation(); var escalationPlan = ocRotation.getEscalationPlan(serviceDeskSysId); var escalatee = escalationPlan[0]; var onContactPrefUtil = new OnCallContactPreferenceUtil(); var contactAttempt = 1; var gdt = new GlideDateTime(); var contacts = onContactPrefUtil.getContactsAtByEscalatee(escalatee, contactAttempt, gdt); gs.log(JSON.stringify(contacts)); 出力: [{ "type": "user", "sys_id": "", "rota_id": "", "roster_id": "", "escalation_step_id": "", "forced_communication_channel": "", "override_user_contact_preference": true, "preference_source": "contact", "contact_attempt": 1, "user_preferences": [{ "type": "sms", "number": "8587200477" }], "contact_preferences": [{ "type": "voice", "number": "5555555555" }] }] ## OnCallContactPreferenceUtil - getUserPreferences(文字列 userSysId, Number contactAttempt, GlideDateTime gdt, 文字列 communicationTypes) {#ariaid-title4} ユーザーが通信を選択したときの連絡先設定のリストを取得します。時刻が指定されていない場合は、現在の時刻が使用されます。この方法は、単一シフトおよび重複シフトに適用できます。 {#P-getUserPreferences_S_N_GDT_S__table_ixr_4jk_3gb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | userSysId | 文字列 | \[sys_user\] テーブルのユーザーの Sys ID。 | | 接触試行 | 番号 | オプション。連絡しようとしている試み \[デフォルト値 = 1\]。 * 1:最初の試行 * 2:最初のリマインダー * 3 つ以上:後続のリマインダー {#P-getUserPreferences_S_N_GDT_S__ul_gp2_q4w_gjb} | | GDT | GlideDateTime | オプション。UTC タイムゾーンの yyyy-MM-dd HH:mm:ss 形式。デフォルトは \[now\] です。 | | communicationType | 文字列 | オプション。次の値の 1 つ以上を含むカンマ区切りの文字列: * メール * sms * voice {#P-getUserPreferences_S_N_GDT_S__ul_pbz_gp5_1jb} デフォルトには、利用可能なすべての通信タイプが含まれます。 | [表 : 4. パラメーター] {#P-getUserPreferences_S_N_GDT_S__table_ixr_4jk_3gb} {#P-getUserPreferences_S_N_GDT_S__table_ubq_ykk_3gb__entry__2} | タイプ | 説明 | |-|-| | アレイオブジェクト | オンコールユーザーの連絡先設定。 * タイプ:文字列。ユーザーが希望する連絡形式 (SMS、メール、番号など)。 * \<メールや番号など、希望する形式の名前\>:文字列。優先連絡先タイプの内容 (メールアドレスや電話番号など)。 {#P-getUserPreferences_S_N_GDT_S__ul_pzn_52r_gjb} | [表 : 5. 返される内容] {#P-getUserPreferences_S_N_GDT_S__table_ubq_ykk_3gb} var onContactPrefUtil = new OnCallContactPreferenceUtil(); var contactAttempt = 1; var gdt = new GlideDateTime(); var itilUserSysId = '; var userPreferences = onContactPrefUtil.getUserPreferences(itilUserSysId, contactAttempt, gdt); gs.log(JSON.stringify(userPreferences)); 出力: [{ "type": "sms", "number": "5555555555" }, { "type": "voice", "number": "5555555555" }] ## OnCallContactPreferenceUtil - getCatchAllContacts(String rotaId, GlideDateTime gdt) {#ariaid-title5} 予備連絡先と設定のリストを取得します。 {#P-getCatchAllContacts_S_GDT_S__table_xgb_ypj_3gb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | rotaId | 文字列 | \[cmn_rota\] テーブルからのシフトの Sys ID。 | | GDT | GlideDateTime | オプション。UTC タイムゾーンの yyyy-MM-dd HH:mm:ss 形式。デフォルトは \[now\] です。 | [表 : 6. パラメーター] {#P-getCatchAllContacts_S_GDT_S__table_xgb_ypj_3gb} {#P-getCatchAllContacts_S_GDT_S__table_ygb_ypj_3gb__entry__2} | タイプ | 説明 | |-|-| | アレイオブジェクト | 設定を含む予備連絡先のリスト。 * タイプ:文字列。連絡先のタイプ (ユーザーなど)。 * sys_id:文字列。\[sys_user\] テーブルのユーザーの Sys ID。 * rota_id:文字列。\[cmn_rota\] テーブルからのシフトの Sys ID。 * roster_id:文字列。\[cmn_rota_roster\] テーブルの勤務表の Sys ID。 * escalation_step_id:文字列。エスカレーションパスが定義されている場合、\[cmn_rota_esc_step_def\] テーブルからのエスカレーションステップの Sys ID。 * forced_communication_channel:文字列。設定で指定した場合は、必須コミュニケーションチャネルです。サポートされている値には、SMS、音声、またはメールがあります。 * override_user_contact_preference:ブーリアン。連絡先の上書きがある場合は true、それ以外の場合は false。 * preference_source:文字列。連絡先やグループなどの優先のソース。 * contact_attempt:番号。連絡試行:1 = 最初の試行、2 = 最初のリマインダーなどです。 * user_preferences:アレイオブジェクト。 * タイプ:文字列。ユーザーが希望する連絡形式 (SMS、メール、番号など)。 * \<メールや番号など、希望する形式の名前\>:文字列。優先連絡先タイプの内容 (メールアドレスや電話番号など)。 {#P-getCatchAllContacts_S_GDT_S__ul_pzn_52r_gjb} * contact_preferences、アレイオブジェクト。 * タイプ:文字列。ユーザーの優先連絡先形式 (メールや番号など)。 * \<メールや番号など、希望する形式の名前\>:文字列。優先連絡先タイプの内容 (メールアドレスや電話番号など)。 {#P-getCatchAllContacts_S_GDT_S__ul_vnw_y2r_gjb} {#P-getCatchAllContacts_S_GDT_S__ul_ftv_sbp_3jb} | [表 : 7. 返される内容] {#P-getCatchAllContacts_S_GDT_S__table_ygb_ypj_3gb} 例： var onContactPrefUtil = new OnCallContactPreferenceUtil(); var contactAttempt = 1; var gdt = new GlideDateTime(); var rotaSysId = ''; var catchAllContacts = onContactPrefUtil.getCatchAllContacts(rotaSysId, gdt); gs.log(JSON.stringify(catchAllContacts)); 出力： [{ "type": "user", "sys_id": "", "rota_id": "", "roster_id": "", "escalation_step_id": "", "forced_communication_channel": "", "override_user_contact_preference": true, "preference_source": "contact", "contact_attempt": 1, "user_preferences": [{ "type": "sms", "number": "8587200477" }], "contact_preferences": [{ "type": "voice", "number": "5555555555" }] }]