g_modal (ネクストエクスペリエンス): クライアント

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：34分

    • g_modal API を使用すると、モーダルウィンドウを表示してアプリケーションの機能を拡張できます。

    この API を使用して、ワークスペースにモーダルを表示します。

    この API を使用すると、次のことができます。
    • モーダルウィンドウに入力タイプフィールドを表示します。
    • UI ページや外部リンクなどのフレームに何かを表示します。
    • ユーザーの確認時にアクションを実行します。
    • コンポーネントをロードします。
    • HTML を使用してモーダルのコンテンツを入力します。

    g_modal (ネクストエクスペリエンス) - alert(文字列タイトル, 文字列メッセージ, 関数コールバック, スタイルオブジェクト)

    UI アクションに関連するアラートメッセージを表示します。

    表 : 1. パラメーター
    名前 タイプ 説明
    title 文字列 オプション。モーダルのヘッダーに表示するタイトル。

    デフォルト:アラート
    メッセージ 文字列 モーダル本文に表示するメッセージ。
    注:
    パラメーターを 1 つだけ渡すと、メソッドはそれを message パラメーターとして扱います。
    コールバック 関数 オプション。フォームが送信され、サーバーで処理された後に呼び出す関数。
    コールバック関数の形式 callbackFunction(文字列 action_verb, 文字列 sys_id, 文字列 table, 文字列 displayValue) は、次のとおりです。
    • action_verb：実行した UI アクションの名前。例：
      • sysverb_cancel (キャンセルボタン)
      • sysverb_insert (送信ボタン)
      • sysverb_save ([保存] ボタン)
    • sys_id：影響を受けるレコードの sys_id。
    • table：レコードを含むテーブルの名前。
    • displayValue：フォームに表示される値。

    デフォルト:追加処理なし
    style オブジェクト オプション。モーダルに表示する確認ボタンのスタイル。
    "style": {
  "buttonTitle": "String",
  "buttonType": "String"
}
    style.buttonTitle 文字列 オプション。確認ボタンに表示するテキスト。

    デフォルト:OK
    style.buttonType 文字列 オプション。表示する確認ボタンのタイプ。

    デフォルト:デフォルト
    表 : 2. 返される内容
    タイプ 説明
    Promise callbackパラメーターが渡された場合、成功した場合は promise を返し、それ以外の場合はエラーを返します。

    callbackパラメーターが渡されない場合、メソッドは常に成功を返します。

    次のコード例は、このメソッドを呼び出して、「担当者のみがこのアクションを終了できます」という警告メッセージを表示する方法を示しています。

    function onClick(g_form) {

  if (g_user.userID != g_form.getValue('assigned_to')) {
    g_modal.alert('Only the assigned to can end this action.');
    return;
  }

  var msg = getMessage("Are you sure you want to take this action?");
  g_modal.confirm(getMessage("Confirmation"), msg, function (confirmed) {
    if (confirmed) {
      g_form.setValue('state', 'closed_complete');
      g_form.save();
    }
  });

  return false;
}

    g_modal (ネクストエクスペリエンス) - confirm(文字列タイトル, 文字列メッセージ, 関数コールバック, スタイルオブジェクト)

    UI アクションに関連する確認メッセージを表示します。

    表 : 3. パラメーター
    名前 タイプ 説明
    title 文字列 オプション。モーダルのヘッダーに表示するタイトル。

    デフォルト:確認
    メッセージ 文字列 モーダル本文に表示するメッセージ。
    注:
    パラメーターを 1 つだけ渡すと、メソッドはそれを message パラメーターとして扱います。
    コールバック 関数 オプション。フォームが送信され、サーバーで処理された後に呼び出す関数。
    コールバック関数の形式 callbackFunction(文字列 action_verb, 文字列 sys_id, 文字列 table, 文字列 displayValue) は、次のとおりです。
    • action_verb：実行した UI アクションの名前。例：
      • sysverb_cancel (キャンセルボタン)
      • sysverb_insert (送信ボタン)
      • sysverb_save ([保存] ボタン)
    • sys_id：影響を受けるレコードの sys_id。
    • table：レコードを含むテーブルの名前。
    • displayValue：フォームに表示される値。

    デフォルト:追加処理なし
    style オブジェクト オプション。モーダルに表示する [確認] ボタンと [キャンセル] ボタンのスタイル。
    "style": {
  "cancelTitle": "String",
  "cancelType": "String",
  "confirmTitle": "String",
  "confirmType": "String"
}
    style.cancelTitle 文字列 オプション。キャンセルボタンに表示するテキスト。

    デフォルト:キャンセル
    style.cancelType 文字列 オプション。表示するキャンセルボタンのタイプ。

    有効な値：

    • 確認 (青色の背景)
    • デフォルト (白い背景)
    • 破棄 (赤色の背景)

    デフォルト:confirm
    style.confirmTitle 文字列 オプション。[確認] ボタンに表示するテキスト。

    デフォルト:OK
    style.confirmType 文字列 オプション。表示する確認ボタンのタイプ。

    有効な値：

    • 確認 (青色の背景)
    • デフォルト (白い背景)
    • 破棄 (赤色の背景)

    デフォルト:デフォルト
    表 : 4. 返される内容
    タイプ 説明
    Promise callbackパラメーターが渡された場合、成功した場合は promise を返し、それ以外の場合はエラーを返します。

    callbackパラメーターが渡されない場合、メソッドは常に成功を返します。

    次のコード例は、このメソッドを呼び出して「このアクションを実行してもよろしいですか?」という確認メッセージを表示する方法を示しています。

    function onClick(g_form) {

  if (g_user.userID != g_form.getValue('assigned_to')) {
    g_modal.alert('Only the assigned to can end this action.');
    return;
  }

  var msg = getMessage("Are you sure you want to take this action?");
  g_modal.confirm(getMessage("Confirmation"), msg, function (confirmed) {
    if (confirmed) {
      g_form.setValue('state', 'closed_complete');
      g_form.save();
    }
  });

  return false;
}

    出力:


    コードによって生成された確認モーダルを示すスクリーンショット

    g_modal (ネクストエクスペリエンス) - confirmDestroy(文字列タイトル, 文字列メッセージ, 関数コールバック, スタイルオブジェクト)

    UI アクションに関連する確認メッセージを表示します。確認ボタンには破壊的なスタイルが表示されます。

    表 : 5. パラメーター
    名前 タイプ 説明
    title 文字列 オプション。モーダルのヘッダーに表示するタイトル。

    デフォルト:確認
    メッセージ 文字列 モーダル本文に表示するメッセージ。
    注:
    パラメーターを 1 つだけ渡すと、メソッドはそれを message パラメーターとして扱います。
    コールバック 関数 オプション。フォームが送信され、サーバーで処理された後に呼び出す関数。
    コールバック関数の形式 callbackFunction(文字列 action_verb, 文字列 sys_id, 文字列 table, 文字列 displayValue) は、次のとおりです。
    • action_verb：実行した UI アクションの名前。例：
      • sysverb_cancel (キャンセルボタン)
      • sysverb_insert (送信ボタン)
      • sysverb_save ([保存] ボタン)
    • sys_id：影響を受けるレコードの sys_id。
    • table：レコードを含むテーブルの名前。
    • displayValue：フォームに表示される値。

    デフォルト:追加処理なし
    style オブジェクト オプション。モーダルに表示する [確認] ボタンと [キャンセル] ボタンのスタイル。
    "style": {
  "cancelTitle": "String",
  "cancelType": "String",
  "confirmTitle": "String",
  "confirmType": "String"
}
    style.cancelTitle 文字列 オプション。キャンセルボタンに表示するテキスト。

    デフォルト:キャンセル
    style.cancelType 文字列 オプション。表示するキャンセルボタンのタイプ。

    有効な値：

    • 確認 (青色の背景)
    • デフォルト (白い背景)
    • 破棄 (赤色の背景)

    デフォルト:confirm
    style.confirmTitle 文字列 オプション。[確認] ボタンに表示するテキスト。

    デフォルト:OK
    style.confirmType 文字列 オプション。表示する確認ボタンのタイプ。

    デフォルト:destructive
    表 : 6. 返される内容
    タイプ 説明
    Promise callbackパラメーターが渡された場合、成功した場合は promise を返し、それ以外の場合はエラーを返します。

    callbackパラメーターが渡されない場合、メソッドは常に成功を返します。

    このコード例は、 confirmDestroy() メソッドを呼び出して、赤い [OK ] ボタンのある確認モーダルを表示する方法を示しています。

    function callback(value){ 
  value ? console.log("confirm destroy callback") : console.log('cancel callback'); 
}

function onClick(g_form) {
  g_modal.confirmDestroy("Confirm Destroy Title", "Confirm Destroy Message", callback, {
    cancelTitle: "Cancel",
    confirmTitle: "Confirm",
    cancelType: "destructive",
    confirmType: "confirm"
  })

  .then( 

    function test() {
      g_form.setValue("state', '7");
    }, 

    function fail() {
      g_form.setValue("state", 2)
    } 
  )
}

    出力:


    破棄モーダルを確認

    g_modal (ネクストエクスペリエンス) - richText(String title, String richText, Function callback, String size, String cancelTitle, String confirmTitle, String cancelType, String confirmType, Object resizableConfig)

    渡された HTML を使用してモーダル内のコンテンツを生成するモーダルを表示します。

    表 : 7. パラメーター
    名前 タイプ 説明
    title 文字列 オプション。モーダルのヘッダーに表示するタイトル。

    デフォルト:空欄
    リッチテキスト 文字列 モーダルに表示する HTML コンテンツ。
    注:
    このメソッドは、 <![CDATA[<script>]]> タグ、インライン JavaScript、およびセキュリティの悪用をもたらす可能性のあるその他の要素を削除します。
    コールバック 関数 オプション。フォームが送信され、サーバーで処理された後に呼び出す関数。
    コールバック関数の形式 callbackFunction(文字列 action_verb, 文字列 sys_id, 文字列 table, 文字列 displayValue) は、次のとおりです。
    • action_verb：実行した UI アクションの名前。例：
      • sysverb_cancel (キャンセルボタン)
      • sysverb_insert (送信ボタン)
      • sysverb_save ([保存] ボタン)
    • sys_id：影響を受けるレコードの sys_id。
    • table：レコードを含むテーブルの名前。
    • displayValue：フォームに表示される値。

    デフォルト:追加処理なし
    タイトルをキャンセル 文字列 オプション。キャンセルボタンに表示するテキスト。

    デフォルト:キャンセル
    確認タイトル 文字列 オプション。[確認] ボタンに表示するテキスト。

    デフォルト:OK
    cancelType 文字列 オプション。表示するキャンセルボタンのタイプ。

    有効な値：

    • 確認 (青色の背景)
    • デフォルト (白い背景)
    • 破棄 (赤色の背景)

    デフォルト:confirm
    confirmType 文字列 オプション。表示する確認ボタンのタイプ。

    有効な値：

    • 確認 (青色の背景)
    • デフォルト (白い背景)
    • 破棄 (赤色の背景)

    デフォルト:デフォルト
    resizableConfig オブジェクト オプション。関連付けられたモーダルのサイズを変更するための設定パラメーター。ユーザーがモーダルのサイズを変更できないようにする場合は、このパラメーターを渡さないでください。
    resizableConfig:
  {
    enableResizable: Boolean,
    resizableMaxHeight: Number,
    resizableMaxWidth: Number,
    resizableMinHeight: Number,
    resizableMinWidth: Number 
  }

    デフォルト:モーダルはサイズ変更できません。
    resizableConfigです。サイズ変更可能 ブール ユーザーが関連するモーダルのサイズを変更できるかどうかを示すフラグ。
    有効な値：
    • true:モーダルはサイズ変更可能です。サイズ変更ハンドルは、モーダルの境界線に表示されます。
    • false:モーダルはサイズ変更できません。

    デフォルト値：false
    resizableConfigです。resizableMaxHeight 番号 モーダルのサイズ変更可能な最大の高さ。

    データタイプ：数値

    単位：ピクセル

    デフォルト:ウィンドウの高さ。
    resizableConfigです。サイズ変更可能な最小高さ 番号 モーダルのサイズ変更可能な最小の高さ。

    データタイプ：数値

    単位：ピクセル

    デフォルト：600px
    resizableConfigです。resizableMaxWidth 番号 モーダルのサイズ変更可能な最大幅。

    データタイプ：数値

    単位：ピクセル

    デフォルト:ウィンドウの幅
    resizableConfigです。resizableMinWidth 番号 モーダルのサイズ変更可能な最小幅。

    データタイプ：数値

    単位：ピクセル

    デフォルト:380px
    表 : 8. 返される内容
    タイプ 説明
    Promise callbackパラメーターが渡された場合、成功した場合は promise を返し、それ以外の場合はエラーを返します。

    callbackパラメーターが渡されない場合、メソッドは常に成功を返します。

    次のコード例は、関連するモーダルに「This is rich text」というテキストを太字で表示する方法を示しています。

    function callback(value){
  value ? console.log("confirm richtext callback") : console.log('cancel rich text callback'); 
} 

function onClick(g_form) {
  g_modal.richText("RichTextTitle", "<b>This is rich text</b>", callback, {
    cancelTitle: "Rich Cancel",
    confirmTitle: "Rich Confirm"
  }) 

  .then(
    function test() {
      g_form.setValue("state', '7"); 
    }, 

    function fail() {
      g_form.setValue("state", 2) 
    }
  )
}

    出力:


    リッチテキストモーダル

    g_modal (ネクストエクスペリエンス) - showFields(文字列タイトル、アレイフィールド、関数コールバック、文字列サイズ、文字列 cancelTitle、文字列 confirmTitle、文字列 cancelType、文字列 confirmType、オブジェクト resizableConfig、文字列 instruction)

    指定したフィールドと、デフォルトで [OK ] ボタンと [ キャンセル ] ボタンを含むモーダルウィンドウを表示します。

    表 : 9. パラメーター
    名前 タイプ 説明
    title 文字列 オプション。モーダルのヘッダーに表示するタイトル。

    デフォルト:" "
    フィールド オブジェクトのアレイ モーダルに表示するフィールドのリスト。各フィールドは、個別のオブジェクトで定義されます。渡す fields パラメーターは、指定したフィールドのタイプ (fields.type) によって異なります。

    フィールドは、アレイに表示される順序と同じ順序でモーダルに表示されます。

    fields: [
  {
    autoFocus: Boolean,
    choices: "Array",
    display_value_list: "String",
    enableMentions: Boolean,
    label: "String",
    mandatory: Boolean,
    name: "String",
    referringTable: "String",
    referringRecordId: "String",
    type: "String",
    value: "String"
  }
]
    田畑。オートフォーカス ブール オプション。モーダルのロード時にフィールドをデフォルトでオートフォーカスするかどうかを示すフラグ。1 つのフィールドでのみ、この値を true に設定する必要があります。
    有効な値：
    • true:オートフォーカス。
    • false:オートフォーカスしません。

    デフォルト値：false
    田畑。選択肢 オブジェクトのアレイ fields.typeパラメーターが choice に設定されている場合は必須です。関連するリストフィールドに表示するオプションのリスト。選択肢リスト内の各エントリは、 選択肢 アレイ内の個別のオブジェクトとして指定する必要があります。
    たとえば、次のようになります。
    choices: [
  {
    displayValue: "String",
    value: "String
  }
]
    田畑。選択肢。表示値 文字列 オプション。リストフィールドに表示する値。

    デフォルト：空欄
    fields.choices.value 文字列 オプション。リストフィールドに表示される値の内部値。

    デフォルト：Null
    田畑。display_value_list 文字列のアレイ オプション。表示する文字列のリスト。例:['item1', 'item2', 'item3']
    田畑。enablementions ブール fields.typeが html の場合は必須です。モーダルでユーザーをメンションできるかどうかを示すフラグ。
    有効な値：
    • true:モーダルでユーザーについてメンションできます。
    • false:モーダルでユーザーについてメンションできません。

    デフォルト値：false
    fields.label 文字列 オプション。モーダルでこのフィールドのラベルとして表示するテキスト。

    デフォルト：空欄
    田畑。必須 ブール オプション。フィールドが必須かどうかを示すフラグ。
    有効な値：
    • true：フィールドは必須です。
    • false：フィールドはオプションです。

    デフォルト値：false
    田畑。名前 文字列 フィールドの内部名。fields.typeパラメーターが reference または glide_list に設定されている場合、検索に使用される現在のレコードの参照フィールドになります。
    fields.referringTable 文字列 fields.typeパラメーターが reference または glide_list に設定されている場合は必須です。参照元のテーブルの名前。

    例: インシデント
    田畑。referringRecordId 文字列 fields.typeパラメーターが参照に設定されている場合は必須です。UI アクションフォームで呼び出すレコードのSys_id。
    fields.type 文字列 モーダルに表示するフィールドのタイプ。

    各フィールドタイプには、渡すことができる fields.<> 要素のセットがあります。以下の角かっこ [ ] 内の値は、関連するfieldsタイプでサポートされているfields要素です。

    有効な値：

    • boolean [autofocus, label, mandatory, name, value]
    • choice [AutoFocus, choices, label, mandatory, name, value]
    • domain_id [label, referringRecordId, referringTable, value]
    • glide_list [autofocus, display_value_list, label, name, mandatory, referringRecordId, referringTable, value]
    • html [autofocus, enableMentions, label, mandatory, name, referringRecordId, referringTable, value]
    • reference [autofocus, label, mandatory, name, reference, referringRecordId, referringTable, value]
    • string [AutoFocus, label, mandatory, name, value]
    • textarea [AutoFocus, label, mandatory, name, value]
    fields.value 文字列 オプション。フィールドに表示する値。

    たとえば、選択肢フィールドに対して、ユーザープロンプトを表示できます。

    値:getMessage(' -- Select -- ')

    または、参照フィールドの場合は、関連するフォームにフィールドの値を表示できます。

    g_form.getValue('caller_id')

    デフォルト：空欄
    コールバック 関数 オプション。フォームが送信され、サーバーで処理された後に呼び出す関数。
    コールバック関数の形式 callbackFunction(文字列 action_verb, 文字列 sys_id, 文字列 table, 文字列 displayValue) は、次のとおりです。
    • action_verb：実行した UI アクションの名前。例：
      • sysverb_cancel (キャンセルボタン)
      • sysverb_insert (送信ボタン)
      • sysverb_save ([保存] ボタン)
    • sys_id：影響を受けるレコードの sys_id。
    • table：レコードを含むテーブルの名前。
    • displayValue：フォームに表示される値。

    デフォルト:追加処理なし
    サイズ 文字列 オプション。
    モーダルのサイズ。
    有効な値：
    • fw:全角
    • SM:420 x 315 ピクセル
    • md:600 x 450 px
    • 長さ:800px x 600px
    注:
    ピクセル値を指定すると、モーダルがブラウザー全体を占めます。たとえば、「1px」を渡すとモーダルは全幅になります。

    デフォルト：sm
    タイトルをキャンセル 文字列 オプション。キャンセルボタンに表示するテキスト。

    デフォルト:キャンセル
    確認タイトル 文字列 オプション。[確認] ボタンに表示するテキスト。

    デフォルト:OK
    cancelType 文字列 オプション。表示するキャンセルボタンのタイプ。

    有効な値：

    • 確認 (青色の背景)
    • デフォルト (白い背景)
    • 破棄 (赤色の背景)

    デフォルト:confirm
    confirmType 文字列 オプション。表示する確認ボタンのタイプ。

    有効な値：

    • 確認 (青色の背景)
    • デフォルト (白い背景)
    • 破棄 (赤色の背景)

    デフォルト:デフォルト
    resizableConfig オブジェクト オプション。関連付けられたモーダルのサイズを変更するための設定パラメーター。ユーザーがモーダルのサイズを変更できないようにする場合は、このパラメーターを渡さないでください。
    resizableConfig:
  {
    enableResizable: Boolean,
    resizableMaxHeight: Number,
    resizableMaxWidth: Number,
    resizableMinHeight: Number,
    resizableMinWidth: Number 
  }

    デフォルト:モーダルはサイズ変更できません。
    resizableConfigです。サイズ変更可能 ブール ユーザーが関連するモーダルのサイズを変更できるかどうかを示すフラグ。
    有効な値：
    • true:モーダルはサイズ変更可能です。サイズ変更ハンドルは、モーダルの境界線に表示されます。
    • false:モーダルはサイズ変更できません。

    デフォルト値：false
    resizableConfigです。resizableMaxHeight 番号 モーダルのサイズ変更可能な最大の高さ。

    データタイプ：数値

    単位：ピクセル

    デフォルト:ウィンドウの高さ。
    resizableConfigです。サイズ変更可能な最小高さ 番号 モーダルのサイズ変更可能な最小の高さ。

    データタイプ：数値

    単位：ピクセル

    デフォルト：600px
    resizableConfigです。resizableMaxWidth 番号 モーダルのサイズ変更可能な最大幅。

    データタイプ：数値

    単位：ピクセル

    デフォルト:ウィンドウの幅
    resizableConfigです。resizableMinWidth 番号 モーダルのサイズ変更可能な最小幅。

    データタイプ：数値

    単位：ピクセル

    デフォルト:380px
    命令 文字列 オプション。モーダルに表示する指示。このコンテンツは、モーダルタイトルの下、モーダルの最初のフィールドの上に表示されます。

    デフォルト:指示は表示されません
    表 : 10. 返される内容
    タイプ 説明
    Promise callbackパラメーターが渡された場合、成功した場合は promise を返し、それ以外の場合はエラーを返します。

    callbackパラメーターが渡されない場合、メソッドは常に成功を返します。

    次の例は、モーダルウィンドウを使用してユーザーに理由の入力を求め、それをレコードの作業メモフィールドに戻す方法を示しています。then() メソッドは、モーダルが返すものを返す promise を返します。この場合は fieldValues です。クライアント側の作業メモフィールドとフィールド値は、 updatedFields アレイにあります。返されるフィールドは 1 つだけであるため、この例ではインデックス位置を 0 と想定しています。

    function onClick(g_form) {
    g_modal.showFields({
        title: "Enter your reason",
        fields: [{
            type: 'textarea',
            name: 'work_notes',
            label: getMessage('Reason'),
            mandatory: true
        }],
        size: 'lg'
    }).then(function(fieldValues) {
        g_form.setValue('work_notes', fieldValues.updatedFields[0].value);
        g_form.save();
    });
}

    出力:

    関連コードによって生成されたモーダルのスクリーンショット。

    次の例では、上記の例を拡張して、選択肢フィールドと参照フィールドを追加します。

    function onClick(g_form) {

    var fields = [{
        type: 'textarea',
        name: 'work_notes',
        label: getMessage('Reason'),
        mandatory: true
    },
    {
        type: 'choice',
        name: 'reason_code',
        label: getMessage('Reason code'),
        value: getMessage(' -- Select -- '),
        choices: [
          {
            displayValue: 'Duplicate',
            value: 'duplicate'
          },
          {
            displayValue: 'Canceled',
            value: 'canceled'
          }
        ],
        mandatory: true
    },
    {
        type: 'reference',
        name: 'caller_id',
        label: getMessage('What is your name?'),
        mandatory: true,
        reference: 'sys_user',
        referringTable: 'incident',
        referringRecordId: g_form.getUniqueValue(),
	 value: g_form.getValue('caller_id'),
	 displayValue: g_form.getDisplayValue('caller_id')
    }
  ];

  g_modal.showFields({
    title: "Enter your reason",
    fields: fields,
    size: 'lg'
  }).then(function(fieldValues) {
        g_form.setValue('work_notes', fieldValues.updatedFields[0].value);
        g_form.setValue('caller_id', fieldValues.updatedFields[2].value);
        g_form.save();
  });
}

    出力:

    関連コードによって生成されたモーダルのスクリーンショット。

    次の例は、このメソッドを使用して、textarea、choices、reference、glide_list、および domain_id フィールドタイプを含むモーダルを表示する方法を示しています。

    function onClick(g_form) {
  var fields = [
    {
      type: 'textarea',
      name: 'work_notes',
      label: getMessage('Reason'),
      mandatory: true
    },
    {
      type: 'choice',
      name: 'reason_code',
      label: getMessage('Reason code'),
      value: getMessage(' -- Select -- '),
      choices: [
        {
          displayValue: 'Duplicate',
          value: 'duplicate'
        },
        {
          displayValue: 'Canceled',
          value: 'canceled'
        }
      ],
      mandatory: true
    },
    {
      type: 'reference',
      name: 'caller_id',
      label: getMessage('What is your name?'),
      mandatory: true,
      referringTable: 'incident',
      referringRecordId: g_form.getUniqueValue(),
      value: g_form.getValue('caller_id')
    },
    {
      type: 'glide_list',
      name: 'watch_list',
      label: 'A list', 
      mandatory: false,
      referringTable: 'incident',
      referringRecordId: g_form.getUniqueValue(),
      value: '628,9ee1,f298d',
      display_value_list: ['item1', 'item2', 'item3']
    },
    {
      label: 'Domain ID',
      type: 'domain_id',
      value: 'c90d4b084a362312013398f051272c0d',
      displayValue: 'TOP/ACME',
      referringRecordId: '552c48888c033300964f4932b03eb092',
      referringTable: 'incident'
    }
  ];

  g_modal.showFields({
    title: "Enter your reason",
    fields: fields,
    size: 'lg'
  }).then(function(fieldValues) {

  });
}

    出力:


    モーダルのスクリーンショット

    g_modal (ネクストエクスペリエンス) - showFrame(文字列 title, 文字列 url, 関数コールバック, 文字列サイズ, 文字列の高さ, 文字列 modalHeight, 文字列 modalWidth, ブール値 showClose, 文字列 autoCloseOn, ブール値 hasLoadingMessage, ブール値 closeOnEscape, ブール値 hideOverlay, Object resizableConfig)

    コンテンツに外部 URL または UI ページへのリンクを使用するモーダルを表示します。

    表 : 11. パラメーター
    名前 タイプ 説明
    title 文字列 オプション。モーダルのヘッダーに表示するタイトル。

    デフォルト:空欄
    URL 文字列 IFrame にロードする情報の URL。
    注:
    引数が 1 つだけ渡された場合は、 url パラメーターとして扱われます。
    コールバック 関数 オプション。フォームが送信され、サーバーで処理された後に呼び出す関数。
    コールバック関数の形式 callbackFunction(文字列 action_verb, 文字列 sys_id, 文字列 table, 文字列 displayValue) は、次のとおりです。
    • action_verb：実行した UI アクションの名前。例：
      • sysverb_cancel (キャンセルボタン)
      • sysverb_insert (送信ボタン)
      • sysverb_save ([保存] ボタン)
    • sys_id：影響を受けるレコードの sys_id。
    • table：レコードを含むテーブルの名前。
    • displayValue：フォームに表示される値。

    デフォルト:追加処理なし
    サイズ 文字列 オプション。モーダルのサイズ。
    有効な値：
    • fw:全角
    • SM:420px x 253.25px
    • md:600px x 253.25px
    • 長さ:800px x 254px

    デフォルト:lg
    高さ 文字列 オプション。モーダルのコンテンツセクションの高さ。この値は、「80%」や「300px」などの「<number><unit>」の形式です。数値のみを渡した場合、メソッドは測定単位をピクセルと見なします。
    有効な測定単位:
    • パーセンテージ
    • em
    • px
    • VH

    デフォルト:100% または 153.75px
    モーダルの高さ 文字列 オプション。モーダルの高さ。この値は、「80%」や「300px」などの「<number><unit>」の形式です。数値のみを渡した場合、メソッドは測定単位をピクセルと見なします。
    有効な測定単位:
    • パーセンテージ
    • em
    • px
    • VH

    デフォルト:254px
    モーダルの幅 文字列 オプション。モーダルの幅。この値は、「80%」や「300px」などの「<number><unit>」の形式です。数値のみを渡した場合、メソッドは測定単位をピクセルと見なします。
    有効な測定単位:
    • パーセンテージ
    • em
    • px
    • VH

    デフォルト:800px
    showClose ブール オプション。モーダルの右上隅に閉じるアイコン (X) を表示するかどうかを示すフラグ。
    有効な値：
    • true:閉じるアイコンを表示します。
    • false:閉じるアイコンを表示しません。

    デフォルト：true
    autoCloseOn 文字列 オプション。モーダルを自動的にクローズする条件。
    有効な値：
    • EMPTY_BODY
    • URL_CHANGED

    デフォルト:モーダルを自動的に閉じません。
    hasLoadingMessage ブール オプション。モーダルコンテンツをロードする前に、モーダルのコンテンツスロットに [読み込み中... ] メッセージを表示するかどうかを示すフラグ。
    有効な値：
    • true:ロードメッセージを表示します。
    • false:ロードメッセージを表示しません。コンテンツがロードされる前は、モーダルのコンテンツスロットが空です。
    注:
    「ロードしています...」をカスタマイズすることはできません。メッセージ;表示するかどうかのみを設定します。

    デフォルト値：false
    エスケープを閉じる ブール オプション。ユーザーが Esc キーを押してモーダルを閉じることができるかどうかを示すフラグ。
    有効な値：
    • true:ユーザーがエスケープキーを押すとモーダルが閉じます。
    • false:ユーザーが Esc キーを押してもモーダルは閉じません。

    デフォルト値：false
    hideOverlay ブール オプション。レコードページに透明なグレーのオーバーレイを表示するかどうかを示すフラグ。
    有効な値：
    • true:レコードページ上の透明なグレーのオーバーレイを非表示にします。
    • false:レコードページ上に透明なグレーのオーバーレイを表示します。

    デフォルト値：false
    resizableConfig オブジェクト オプション。関連付けられたモーダルのサイズを変更するための設定パラメーター。ユーザーがモーダルのサイズを変更できないようにする場合は、このパラメーターを渡さないでください。
    resizableConfig:
  {
    enableResizable: Boolean,
    resizableMaxHeight: Number,
    resizableMaxWidth: Number,
    resizableMinHeight: Number,
    resizableMinWidth: Number 
  }

    デフォルト:モーダルはサイズ変更できません。
    resizableConfigです。サイズ変更可能 ブール ユーザーが関連するモーダルのサイズを変更できるかどうかを示すフラグ。
    有効な値：
    • true:モーダルはサイズ変更可能です。サイズ変更ハンドルは、モーダルの境界線に表示されます。
    • false:モーダルはサイズ変更できません。

    デフォルト値：false
    resizableConfigです。resizableMaxHeight 番号 モーダルのサイズ変更可能な最大の高さ。

    データタイプ：数値

    単位：ピクセル

    デフォルト:ウィンドウの高さ。
    resizableConfigです。サイズ変更可能な最小高さ 番号 モーダルのサイズ変更可能な最小の高さ。

    データタイプ：数値

    単位：ピクセル

    デフォルト：600px
    resizableConfigです。resizableMaxWidth 番号 モーダルのサイズ変更可能な最大幅。

    データタイプ：数値

    単位：ピクセル

    デフォルト:ウィンドウの幅
    resizableConfigです。resizableMinWidth 番号 モーダルのサイズ変更可能な最小幅。

    データタイプ：数値

    単位：ピクセル

    デフォルト:380px
    表 : 12. 返される内容
    タイプ 説明
    Promise 成功した場合は promise を返し、それ以外の場合はエラーを返します。この約束は、IFrame モーダルがクローズされると解決されます。

    次の例は、KB 記事レコードのsys_idとベース URL を使用して、モデルに KB 記事を表示する方法を示しています。

    function onClick(g_form) {
  var kbId = '24d9243187032100deddb882a2e3ec33'; //sysId of KB article
  g_modal.showFrame({
    url: '/kb_view.do?sys_kb_id=' + kbId,
    title: 'Test Knowledge Article',
    size: 'lg',
    height: 500px
  });
}

    出力:

    コードによって生成されたモーダルのスクリーンショット

    この例では、モーダルを作成するときに埋め込み UI ページを使用する方法を示します。g_form API が iFrame にある場合は UI ページでアクセスできないため、UI ページで window.parent.postMessage() を使用して iFrame からワークスペースにデータを渡します。

    function onClick(g_form) {
  function proposeMIC(data) {
    var workNotes = data.msg + "\n" + data.workNotes;
    var notes = g_form.getValue('work_notes') + ' ' + workNotes;
    var bi = g_form.getValue('business_impact') + ' ' + data.businessImpact;
    g_form.setValue('work_notes', notes.trim());
    g_form.setValue('business_impact', bi.trim());
    g_form.submit('sysverb_mim_propose');
  }
	
  function openPopup() {
    if(!g_form.getControl('work_notes')) {
      getMessage('Cannot propose major incident as "Worknotes" is not visible', function(msg) {
	 g_form.addErrorMessage(msg);
      });
      return false;
    }

    var url = "/sn_major_inc_mgmt_mim_propose.do?sysparm_stack=no&sysparm_workspace=" + true;
    g_modal.showFrame({
      title: getMessage("Propose Major Incident"),
      url: url,
      size: 'lg',
      autoCloseOn: 'URL_CHANGED',
      callback: function (ret, data) {
        if (ret)
          proposeMIC(data);
      }
    });
  }
	
  openPopup();
}

    出力:


    コードによって生成されたモーダルのスクリーンショット