---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://www.servicenow.com/docs/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideForm - クライアント

# GlideForm - クライアント {#ariaid-title1}

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

GlideForm API はフォームをカスタマイズするメソッドを提供します。

GlideForm.js はメソッドを含む JavaScript クラスです。GlideForm メソッドはクライアントでのみ使用します。これらのメソッドを使用して、レコードのフォームビューにカスタム変更を加えることができます。例のすべての検証は、クライアントスクリプトを使用して行われています。

これらのメソッドの一部は、他のクライアント・スクリプト (カタログ・クライアント・スクリプトやウィザード・クライアント・スクリプトなど) でも使用できますが、最初にこれをテストして、期待どおりに機能するかどうかを確認する必要があります。  
注:  
getControl()、getHelpTextControl()、getElement()、および getFormElement() は、モバイルデバイスでは使用されていません。モバイル用 GlideForm の使用方法については、「 [モバイルクライアント GlideForm (g_form) スクリプトと移行](https://www.servicenow.com/docs/access?context=r_MobilePlatformMigrationImpacts&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US)」を参照してください。

GlideForm クラスにコンストラクターはありません。`g_form` グローバルオブジェクトを使用して GlideForm メソッドにアクセスします。

## GlideForm - addDecoration(文字列 fieldName, 文字列 icon, 文字列 title) {#ariaid-title2}

フィールドのラベルにアイコンを追加します。
同じアイテムを 2 回追加することはできませんが、別のタイトルで同じアイコンを追加することはできます。  
注:  
このメソッドは Service Catalog ではサポートされていません。
{#r_GlideForm-AddDecoration_S_S_S__table_vyw_1dw_ts__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | フィールド名 |
| アイコン | 文字列 | フィールドの横に表示するフォントアイコン。サポートされているアイコン：icon-user、icon-user-group、icon-lightbulb、icon-home、icon-mobile、icon-comment、icon-mail、icon-locked、icon-database、icon-book、icon-drawer、icon-folder、icon-catalog、icon-tab、icon-cards、icon-tree-right、icon-tree、icon-book-open、icon-paperclip、icon-edit、icon-trash、icon-image、icon-search、icon-power、icon-cog、icon-star、icon-star-empty、icon-new-ticket、icon-dashboard、icon-cart-full、icon-view、icon-label、icon-filter、icon-calendar、icon-script、icon-add、icon-delete、icon-help、icon-info、icon-check-circle、icon-alert、icon-sort-ascending、icon-console、icon-list、icon-form、および icon-livefeed。 |
| title | 文字列 | アイコンのテキストタイトル。 |
[表 : 1. パラメーター]

{#r_GlideForm-AddDecoration_S_S_S__table_vyw_1dw_ts} {#r_GlideForm-AddDecoration_S_S_S__table_wyw_1dw_ts__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 2. 返される内容]

{#r_GlideForm-AddDecoration_S_S_S__table_wyw_1dw_ts}  

    g_form.addDecoration('caller_id', 'icon-star', 'preferred member');

## GlideForm - addDecoration(文字列 fieldName, 文字列 icon, 文字列 title, 文字列 color) {#ariaid-title3}

フィールドのラベルにアイコンを追加します。
同じアイテムを 2 回追加することはできませんが、別のタイトルで同じアイコンを追加することはできます。  
注:  
このメソッドは Service Catalog ではサポートされていません。
{#r_GlideForm-AddDecoration_S_S_S_S__table_gzh_fyd_5s__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | フィールド名 |
| アイコン | 文字列 | フィールドの横に表示するフォントアイコン。サポートされているアイコン：icon-user、icon-user-group、icon-lightbulb、icon-home、icon-mobile、icon-comment、icon-mail、icon-locked、icon-database、icon-book、icon-drawer、icon-folder、icon-catalog、icon-tab、icon-cards、icon-tree-right、icon-tree、icon-book-open、icon-paperclip、icon-edit、icon-trash、icon-image、icon-search、icon-power、icon-cog、icon-star、icon-star-empty、icon-new-ticket、icon-dashboard、icon-cart-full、icon-view、icon-label、icon-filter、icon-calendar、icon-script、icon-add、icon-delete、icon-help、icon-info、icon-check-circle、icon-alert、icon-sort-ascending、icon-console、icon-list、icon-form、および icon-livefeed。 |
| title | 文字列 | アイコンのテキストタイトル。 |
| 色 | 文字列 | CSS カラー。 |
[表 : 3. パラメーター]

{#r_GlideForm-AddDecoration_S_S_S_S__table_gzh_fyd_5s} {#r_GlideForm-AddDecoration_S_S_S_S__table_hzh_fyd_5s__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 4. 返される内容]

{#r_GlideForm-AddDecoration_S_S_S_S__table_hzh_fyd_5s}  

    g_form.addDecoration('caller_id', 'icon-star', 'Mark as Favorite', 'color-green');

## GlideForm - addErrorMessage(文字列 message) {#ariaid-title4}

指定されたエラーメッセージをフォームの上部に表示します。
このメッセージは約 4 秒間表示され、その後消えます。現時点でこのタイムアウトは設定できません。
{#r_GlideFormAddErrorMessage_String__table_fyn_vnd_5s__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| message | 文字列 | 表示するメッセージ。 |
[表 : 5. パラメーター]

{#r_GlideFormAddErrorMessage_String__table_fyn_vnd_5s} {#r_GlideFormAddErrorMessage_String__table_gyn_vnd_5s__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 6. 返される内容]

{#r_GlideFormAddErrorMessage_String__table_gyn_vnd_5s}  

    g_form.addErrorMessage('This is an error');

## GlideForm - addFormMessage(文字列メッセージ, 文字列型, オブジェクトオプション) {#ariaid-title5}

フォーム詳細セクションの上部に浮遊型のフォームメッセージを表示します。メッセージは UI アクションに対応していません。
関連項目：

* [clearAllFormMessages()](https://www.servicenow.com/docs/iZXkMKU701Cuwf8ZI0XoLA#GF-clearAllFormMessages "任意のタイプのすべてのフォームメッセージを削除します。")
* [clearFormMessages()](https://www.servicenow.com/docs/iZXkMKU701Cuwf8ZI0XoLA#GF-clearFormMessages_S "指定されたタイプのすべてのフォームメッセージを削除します。")
{#GF-addFormMessage_S_S__ul_unz_vkt_4pb}
{#GF-addFormMessage_S_S__table_f2v_zym_4pb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| message | 文字列 | 表示するメッセージ。 |
| type | 文字列 | メッセージのタイプ。 有効な値： * error * 情報 * 警告 {#GF-addFormMessage_S_S__ul_gzv_bbn_4pb} |
| オプション | オブジェクト | オプション。フォームメッセージに追加するボタンと、ボタンのクリックを処理するために必要なメタデータを含むオブジェクト。 { buttons: [Array], meta: {Object} } |
| options.buttons | アレイ | フォームメッセージに追加するボタンのアレイ。 buttons: [ { label: "String", actionName: "String" } ] |
| options.buttons.label | 文字列 | ボタンに表示するテキスト。 |
| options.buttons.actionName | 文字列 | クリックされたボタンを特定するためにFORM_MESSAGE_BUTTON_CLICKEDイベントハンドラーによって使用された名前。 たとえば、actionName `assign_to_me`ボタンを追加する場合は、actionName が`assigned_to_me`の場合にのみ実行されるFORM_MESSAGE_BUTTON_CLICKEDイベントUIBイベントハンドラーを作成する必要があります。 |
| options.meta | オブジェクト | キーと値のペアとして書式設定された、ボタンクリックを処理するために必要なメタデータのマップ。 meta: { 'key': 'value' } たとえば、\[ 自分にアサイン \] ボタンの場合、イベントハンドラーにはレコードをアサインするユーザーのsys_idが必要です。 |
[表 : 7. パラメーター]

{#GF-addFormMessage_S_S__table_f2v_zym_4pb} {#GF-addFormMessage_S_S__table_g2v_zym_4pb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 8. 返される内容]

{#GF-addFormMessage_S_S__table_g2v_zym_4pb}  
次の例は、各タイプのフォームメッセージを追加する方法を示しています。

    g_form.addFormMessage('info message','info');
    g_form.addFormMessage('warning message','warning');
    g_form.addFormMessage('error message','error');
    g_form.addFormMessage('info2 message','info');
    g_form.addFormMessage('warning2 message','warning');
    g_form.addFormMessage('error2 message','error');
    g_form.addFormMessage('Would you like to reassign this to yourself?', 'info', {buttons: [{label: "Assign to me", actionName: "assign_to_me"}], meta: {'userId': '46d44a23a9fe19810012d100cca80666'}});

## GlideForm - addInfoMessage(文字列 message) {#ariaid-title6}

指定された情報メッセージをフォームの上部に追加します。
このメッセージは約 4 秒間表示され、その後消えます。現時点でこのタイムアウトは設定できません。
{#r_GlideFormAddInfoMessage_String__table_pcg_n4d_5s__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| message | 文字列 | 表示するメッセージ。 |
[表 : 9. パラメーター]

{#r_GlideFormAddInfoMessage_String__table_pcg_n4d_5s} {#r_GlideFormAddInfoMessage_String__table_qcg_n4d_5s__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 10. 返される内容]

{#r_GlideFormAddInfoMessage_String__table_qcg_n4d_5s}  

    g_form.addInfoMessage('The top five fields in this form are mandatory');

## GlideForm - addOption(文字列 fieldName, 文字列 choiceValue, 文字列 ChoiceLabel) {#ariaid-title7}

選択リストフィールドの末尾に選択肢を追加します。
{#r_GF-AddOption_S_S_S__table_omk_pgd_5s__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | フィールドの名前。 |
| choiceValue | 文字列 | データベースに格納される値。 |
| choiceLabel | 文字列 | 表示される値。 |
[表 : 11. パラメーター]

{#r_GF-AddOption_S_S_S__table_omk_pgd_5s} {#r_GF-AddOption_S_S_S__table_pmk_pgd_5s__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 12. 返される内容]

{#r_GF-AddOption_S_S_S__table_pmk_pgd_5s}  

    g_form.addOption('priority', '6', '6 - Really Low');

## GlideForm - addOption(文字列 fieldName, 文字列 choiceValue, 文字列 ChoiceLabel, 数値 choiceIndex) {#ariaid-title8}

リストフィールドの指定された位置に選択肢を追加します。
注:  
サービスポータル では重複するリストラベルはサポートされていません。たとえば、別のラベルと一致するラベルテキストを持つアイテムは無視され、リストに追加されません。
{#r_GlideForm-AddOption_S_S_S_N__table_k5s_qhd_5s__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | フィールド名 |
| choiceValue | 文字列 | データベースに格納されている値。 |
| choiceLabel | 文字列 | 表示される値。 |
| choiceIndex | 数値 | リスト内の選択肢の順序。インデックスはゼロベースのアレイです。 |
[表 : 13. パラメーター]

{#r_GlideForm-AddOption_S_S_S_N__table_k5s_qhd_5s} {#r_GlideForm-AddOption_S_S_S_N__table_l5s_qhd_5s__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 14. 返される内容]

{#r_GlideForm-AddOption_S_S_S_N__table_l5s_qhd_5s}  

    g_form.addOption('priority', '2.5', '2.5 - Moderately High', 3);

## GlideForm - clearMessages() {#ariaid-title9}

フォームの上部からすべての情報メッセージとエラーメッセージを削除します。
g_form.addInfoMessage() および g_form.addErrorMessage() で追加された情報メッセージとエラーメッセージを削除します。
{#r_GlideFormClearMessages__table_krr_y4d_5s__entry__3}

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

{#r_GlideFormClearMessages__table_krr_y4d_5s} {#r_GlideFormClearMessages__table_lrr_y4d_5s__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 16. 返される内容]

{#r_GlideFormClearMessages__table_lrr_y4d_5s}  

    g_form.clearMessages();

## GlideForm - clearAllFormMessages() {#ariaid-title10}

任意のタイプのすべてのフォームメッセージを削除します。
関連項目：

* [addFormMessage()](https://www.servicenow.com/docs/iZXkMKU701Cuwf8ZI0XoLA#GF-addFormMessage_S_S "フォーム詳細セクションの上部に浮遊型のフォームメッセージを表示します。メッセージは UI アクションに対応していません。")
* [clearFormMessages()](https://www.servicenow.com/docs/iZXkMKU701Cuwf8ZI0XoLA#GF-clearFormMessages_S "指定されたタイプのすべてのフォームメッセージを削除します。")
{#GF-clearAllFormMessages__ul_unz_vkt_4pb}
{#GF-clearAllFormMessages__table_qpm_dzm_4pb__entry__3}

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

{#GF-clearAllFormMessages__table_qpm_dzm_4pb} {#GF-clearAllFormMessages__table_rpm_dzm_4pb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 18. 返される内容]

{#GF-clearAllFormMessages__table_rpm_dzm_4pb}  
次の例は、フォームからすべてのメッセージをクリアする方法を示しています。

    g_form.clearAllFormMessages();

## GlideForm - clearFormMessages(文字列 type) {#ariaid-title11}

指定されたタイプのすべてのフォームメッセージを削除します。
関連項目：

* [addFormMessage()](https://www.servicenow.com/docs/iZXkMKU701Cuwf8ZI0XoLA#GF-addFormMessage_S_S "フォーム詳細セクションの上部に浮遊型のフォームメッセージを表示します。メッセージは UI アクションに対応していません。")
* [clearAllFormMessages()](https://www.servicenow.com/docs/iZXkMKU701Cuwf8ZI0XoLA#GF-clearAllFormMessages "任意のタイプのすべてのフォームメッセージを削除します。")
{#GF-clearFormMessages_S__ul_unz_vkt_4pb}
{#GF-clearFormMessages_S__table_ilw_bzm_4pb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| type | 文字列 | メッセージのタイプ。 有効な値： * error * 情報 * 警告 {#GF-clearFormMessages_S__ul_gzv_bbn_4pb} |
[表 : 19. パラメーター]

{#GF-clearFormMessages_S__table_ilw_bzm_4pb} {#GF-clearFormMessages_S__table_jlw_bzm_4pb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 20. 返される内容]

{#GF-clearFormMessages_S__table_jlw_bzm_4pb}  
次の例は、フォームからすべてのエラーメッセージをクリアする方法を示しています。

    g_form.clearFormMessages('error');

## GlideForm - clearOptions(文字列 fieldName) {#ariaid-title12}

選択リストからすべてのオプションを削除します。
{#r_GlideFormClearOptions_String__table_bdt_v3d_5s__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | フィールドの名前 |
[表 : 21. パラメーター]

{#r_GlideFormClearOptions_String__table_bdt_v3d_5s} {#r_GlideFormClearOptions_String__table_cdt_v3d_5s__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 22. 返される内容]

{#r_GlideFormClearOptions_String__table_cdt_v3d_5s}

## GlideForm - clearValue(文字列 fieldName) {#ariaid-title13}

フィールドから値を削除します。
{#r_GlideFormClearValue_String__table_tlr_znc_5s__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | フィールドの名前 |
[表 : 23. パラメーター]

{#r_GlideFormClearValue_String__table_tlr_znc_5s} {#r_GlideFormClearValue_String__table_ulr_znc_5s__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 24. 返される内容]

{#r_GlideFormClearValue_String__table_ulr_znc_5s}

## GlideForm - disableAttachments() {#ariaid-title14}

添付ファイルが追加されないようにします。
このメソッドはモバイルプラットフォームでは利用できません。このメソッドがモバイルプラットフォームで実行されても、何も起こりません。
{#r_GlideFormDisableAttachments__table_ggk_bqd_5s__entry__3}

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

{#r_GlideFormDisableAttachments__table_ggk_bqd_5s} {#r_GlideFormDisableAttachments__table_hgk_bqd_5s__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 26. 返される内容]

{#r_GlideFormDisableAttachments__table_hgk_bqd_5s}

## GlideForm - enableAttachments() {#ariaid-title15}

添付ファイルの追加を許可します。ペーパークリップアイコンを表示します。
このメソッドはモバイルプラットフォームでは利用できません。このメソッドがモバイルプラットフォームで実行されても、何も起こりません。
{#r_GlideFormEnableAttachments__table_i3c_ppd_5s__entry__3}

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

{#r_GlideFormEnableAttachments__table_i3c_ppd_5s} {#r_GlideFormEnableAttachments__table_j3c_ppd_5s__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 28. 返される内容]

{#r_GlideFormEnableAttachments__table_j3c_ppd_5s}

## GlideForm - flash(文字列 fieldName, 文字列 color, 数値 count) {#ariaid-title16}

特定のフィールドへの関心を引くために使用します。指定されたフィールドを指定された時間、指定された色で点滅させます。
このメソッドは Service Catalog ではサポートされていません。

このメソッドはモバイルプラットフォームでは利用できません。このメソッドがモバイルプラットフォームで実行されても、何も起こりません。
{#r_GlideFormFlash_String_String_Number__table_htn_w2w_ts__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | ハイライト表示するフィールドを形式`「<テーブル名>.<フィールド名>」`で指定します。 |
| 色 | 文字列 | RGB カラーまたは許容される CSS カラー。 |
| count | 数値 | ラベルの点滅時間を指定します。次のオプションが含まれます。 * 2：1 秒間点滅 * 0：2 秒間点滅 * -2：3 秒間点滅 * -4：4 秒間点滅 {#r_GlideFormFlash_String_String_Number__ul_qcc_4fw_ts} |
[表 : 29. パラメーター]

{#r_GlideFormFlash_String_String_Number__table_htn_w2w_ts} {#r_GlideFormFlash_String_String_Number__table_itn_w2w_ts__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 30. 返される内容]

{#r_GlideFormFlash_String_String_Number__table_itn_w2w_ts}  

    g_form.flash("incident.number", "#FFFACD", 0);

## GlideForm - getActionName() {#ariaid-title17}

最新のアクション名を返します。クライアントスクリプトの場合はクリックされた UI アクションの sys_id を返します。
注:  
ウィザードクライアントスクリプトでは使用できません。
{#r_GlideFormGetActionName__table_zhn_xjd_5s__entry__3}

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

{#r_GlideFormGetActionName__table_zhn_xjd_5s} {#r_GlideFormGetActionName__table_a3n_xjd_5s__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 現在のアクション名。 |
[表 : 32. 返される内容]

{#r_GlideFormGetActionName__table_a3n_xjd_5s}  

    function onSubmit() {
       var action = g_form.getActionName();
       alert('You pressed ' + action);
    }

## GlideForm - getBooleanValue(文字列 fieldName) {#ariaid-title18}

指定されたフィールドのブーリアン値を返します。
{#r_GlideFormGetBooleanValue_String__table_vfk_25b_5s__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | フィールドの名前 |
[表 : 33. パラメーター]

{#r_GlideFormGetBooleanValue_String__table_vfk_25b_5s} {#r_GlideFormGetBooleanValue_String__table_wfk_25b_5s__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | フィールド値が false または undefined の場合は false を返します。それ以外の場合は true を返します。 |
[表 : 34. 返される内容]

{#r_GlideFormGetBooleanValue_String__table_wfk_25b_5s}

## GlideForm - getControl(文字列 fieldName) {#ariaid-title19}

指定されたフィールドの HTML 要素を返します。
複合フィールドには複数の HTML 要素を含めることができます。フォーム上でフィールドを使用する組み込みメソッドがあるため、このメソッドは通常必要ありません。

フィールドが参照フィールドであり、コントロールが選択リストである場合、getControl() は想定どおりにコントロールを返さないことがあります。この場合、`sys_select.<table name>.<フィールド名>` を使用します。

このメソッドは、モバイルスクリプトまたは Service Portal スクリプトでは使用できません。
{#r_GlideFormGetControl_String__table_lzt_x5b_5s__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | フィールドの名前 |
[表 : 35. パラメーター]

{#r_GlideFormGetControl_String__table_lzt_x5b_5s} {#r_GlideFormGetControl_String__table_mzt_x5b_5s__entry__2}

| タイプ | 説明 |
|-|-|
| HTMLElement | フィールドの HTML 要素。 |
[表 : 36. 返される内容]

{#r_GlideFormGetControl_String__table_mzt_x5b_5s}

## GlideForm - getDecimalValue(文字列 fieldName) {#ariaid-title20}

指定されたフィールドの 10 進数値を返します。
{#r_GlideFormGetDecimalValue_String__table_izt_31c_5s__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | フィールドの名前。 |
[表 : 37. パラメーター]

{#r_GlideFormGetDecimalValue_String__table_izt_31c_5s} {#r_GlideFormGetDecimalValue_String__table_jzt_31c_5s__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 指定されたフィールドの 10 進数値。 |
[表 : 38. 返される内容]

{#r_GlideFormGetDecimalValue_String__table_jzt_31c_5s}  

    function onChange(control, oldValue, newValue, isLoading) {
       alert(g_form.getDecimalValue('percent_complete'));
    }

## GlideForm - getDisplayBox(文字列 fieldName) {#ariaid-title21}

コア UI のフォームから表示値を取得します。
注:  
サービスポータル のフォームから表示値を取得するには、[getDisplayValue()](https://www.servicenow.com/docs/iZXkMKU701Cuwf8ZI0XoLA#GF-getDisplayValue_S "サービスポータル のフォームから表示値を取得します。") メソッドを使用します。  
関連項目：

* [getValue()](https://www.servicenow.com/docs/iZXkMKU701Cuwf8ZI0XoLA#r_GlideFormGetValue_String "指定されたフォームフィールドの値を返します。")
* [参照変数の表示値を取得する](https://www.servicenow.com/community/developer-blog/get-display-value-of-reference-variable-service-catalog/ba-p/2287763)
{#GF-getDisplayBox_S__ul_djx_h4g_cvb}
{#GF-getDisplayBox_S__table_nf2_bfp_zw__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | フォーム内の値を取得するフィールドの名前。 |
[表 : 39. パラメーター]

{#GF-getDisplayBox_S__table_nf2_bfp_zw} {#GF-getDisplayBox_S__table_ydf_qpc_5s__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 40. 返される内容]

{#GF-getDisplayBox_S__table_ydf_qpc_5s}  

    var caller = g_form.getDisplayBox('caller_id').value;

    var assignee = g_form.getDisplayBox('assigned_to').value;

    if (caller == assignee)
    {
       alert('in');
    }

## GlideForm - getDisplayValue (文字列フィールド名) {#ariaid-title22}

サービスポータル のフォームから表示値を取得します。
注:  
コア UI のフォームから表示値を取得するには、 [getDisplayBox()](https://www.servicenow.com/docs/iZXkMKU701Cuwf8ZI0XoLA#GF-getDisplayBox_S "コア UI のフォームから表示値を取得します。") メソッドを使用します。  
関連項目：

* [getValue()](https://www.servicenow.com/docs/iZXkMKU701Cuwf8ZI0XoLA#r_GlideFormGetValue_String "指定されたフォームフィールドの値を返します。")
* [参照変数の表示値を取得する](https://www.servicenow.com/community/developer-blog/get-display-value-of-reference-variable-service-catalog/ba-p/2287763)
{#GF-getDisplayValue_S__ul_djx_h4g_cvb}  
注:  
コア UI では、このメソッドを引数なしで `g_form.getDisplayValue()` として呼び出すと、個々のフィールドの表示値ではなくレコードの表示値が返されます。
{#GF-getDisplayValue_S__table_nf2_bfp_zw__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | フォーム内の値を取得するフィールドの名前。 |
[表 : 41. パラメーター]

{#GF-getDisplayValue_S__table_nf2_bfp_zw} {#GF-getDisplayValue_S__table_ydf_qpc_5s__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 42. 返される内容]

{#GF-getDisplayValue_S__table_ydf_qpc_5s}  
次の例は、コア UI または サービスポータルで参照変数の表示値を取得する方法を示しています。この例のユースケースは [、コミュニティ](https://www.servicenow.com/community/developer-blog/get-display-value-of-reference-variable-service-catalog/ba-p/2287763) サイトにあります。

    function onChange(control, oldValue, newValue, isLoading) {
         if (isLoading || newValue == '') {
              return;
         }
         if(window == null){
              var valuePortal = g_form.getDisplayValue('requester');
              alert('Portal->' + valuePortal);
         }
         else{
              var valueNative = g_form.getDisplayBox('requester').value;     
              alert('CoreUI->' + valueCoreUI);
         }
         //Type appropriate comment here, and begin script below
    }

## GlideForm - getElement(文字列 id) {#ariaid-title23}

パラメーターで指定された HTML 要素を返します。
複合フィールドには複数の HTML 要素を含めることができます。フォーム上でフィールドを使用する組み込みメソッドがあるため、このメソッドは通常必要ありません。

このメソッドは、モバイルスクリプトまたは Service Portal スクリプトでは使用できません。
{#r_GlideFormGetElement_String__table_l1k_vvb_5s__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| ID | 文字列 | フィールド ID。 |
[表 : 43. パラメーター]

{#r_GlideFormGetElement_String__table_l1k_vvb_5s} {#r_GlideFormGetElement_String__table_m1k_vvb_5s__entry__2}

| タイプ | 説明 |
|-|-|
| HTMLElement | フィールドの HTML 要素。 |
[表 : 44. 返される内容]

{#r_GlideFormGetElement_String__table_m1k_vvb_5s}

## GlideForm - getFormElement() {#ariaid-title24}

フォームの HTML 要素を返します。
このメソッドは、モバイルスクリプトまたは Service Portal スクリプトでは使用できません。
{#r_GlideFormGetFormElement__table_fs4_kkd_5s__entry__3}

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

{#r_GlideFormGetFormElement__table_fs4_kkd_5s} {#r_GlideFormGetFormElement__table_gs4_kkd_5s__entry__2}

| タイプ | 説明 |
|-|-|
| HTMLFormElement | フォームの HTML 要素。 |
[表 : 46. 返される内容]

{#r_GlideFormGetFormElement__table_gs4_kkd_5s}

## GlideForm - getHelpTextControl(文字列 fieldName) {#ariaid-title25}

指定されたフィールドのヘルプテキストの HTML 要素を返します。
このメソッドはサービスカタログ変数にのみ適用されます。
{#r_GF-getHelpTextControl_S__table_nf2_bfp_zw__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | フィールドの名前 |
[表 : 47. パラメーター]

{#r_GF-getHelpTextControl_S__table_nf2_bfp_zw} {#r_GF-getHelpTextControl_S__table_of2_bfp_zw__entry__2}

| タイプ | 説明 |
|-|-|
| HTMLElement | ヘルプテキストフィールドの HTML 要素。 |
[表 : 48. 返される内容]

{#r_GF-getHelpTextControl_S__table_of2_bfp_zw}

## GlideForm - getIntValue(文字列 fieldName) {#ariaid-title26}

フィールドの整数値を返します。
{#r_GlideFormGetIntValue_String__table_unc_nwb_5s__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | フィールド名 |
[表 : 49. パラメーター]

{#r_GlideFormGetIntValue_String__table_unc_nwb_5s} {#r_GlideFormGetIntValue_String__table_vnc_nwb_5s__entry__2}

| タイプ | 説明 |
|-|-|
| 数値 | フィールドの整数値。 |
[表 : 50. 返される内容]

{#r_GlideFormGetIntValue_String__table_vnc_nwb_5s}

## GlideForm - getLabelOf(文字列 fieldName) {#ariaid-title27}

フィールドラベルのプレーンテキスト値を返します。
{#r_GlideFormGetLabelOf_String__table_gfz_kgw_ts__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | フィールド名 |
[表 : 51. パラメーター]

{#r_GlideFormGetLabelOf_String__table_gfz_kgw_ts} {#r_GlideFormGetLabelOf_String__table_hfz_kgw_ts__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | ラベルテキスト。 |
[表 : 52. 返される内容]

{#r_GlideFormGetLabelOf_String__table_hfz_kgw_ts}  

    if (g_user.hasRole('itil')) {
        var oldLabel = g_form.getLabelOf('comments');
        g_form.setLabelOf('comments', oldLabel + ' (Customer visible)');
    }

## GlideForm - getOption(文字列 fieldName, 文字列 choiceValuel) {#ariaid-title28}

choiceValue がオプション値に一致する、選択された fieldName という名前のボックスのオプション要素を返します。
注:  
このメソッドは読み取り専用フィールドでは機能しません。
{#r_GlideFormGetOption_String_String__table_u1p_1xb_5s__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | フィールドの名前 |
| choiceValue | 文字列 | オプションの値。 |
[表 : 53. パラメーター]

{#r_GlideFormGetOption_String_String__table_u1p_1xb_5s} {#r_GlideFormGetOption_String_String__table_v1p_1xb_5s__entry__2}

| タイプ | 説明 |
|-|-|
| HTMLElement | オプションの HTMLElement。フィールドまたはオプションが見つからない場合は null を返します。 |
[表 : 54. 返される内容]

{#r_GlideFormGetOption_String_String__table_v1p_1xb_5s}  
次の例は、選択リスト値のラベルを取得する方法を示しています。

    // Get the label for a choice list value
    // fieldName is 'category'
     
    function onChange(control, oldValue, newValue, isLoading) {
    var choiceValue = g_form.getValue('category');
    var choiceLabel = g_form.getOption('category', choiceValue).text; 
    }

## GlideForm - getReference(文字列 fieldName, 関数 callBack) {#ariaid-title29}

指定されたフィールドの GlideRecord を返します。
コールバック関数が存在する場合、このルーチンは非同期で実行されます。ブラウザー (およびスクリプト) の処理はサーバーが参照値を返すまで続行され、その時点でコールバック関数が呼び出されます。コールバック関数が存在しない場合、このルーチンは同期的に実行され、サーバーの応答を待機している間は処理が停止します (ブラウザーがハングアップしているように見えます)。  
重要:  
コールバック関数を使用することを強くお勧めします。

ServiceCatalogForm.getReference のコールバック関数が利用可能です。  
注:  
このメソッドを使用するにはサーバーへの呼び出しが必要であり、ページに遅延が発生する可能性があります。この方法は慎重に使用してください。詳細については、「 [クライアントスクリプトの設計と処理](https://www.servicenow.com/docs/access?context=client-script-best-practices&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US)」を参照してください。
{#r_GlideForm-GetReference_S_F__table_k4c_1yb_5s__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | フィールドの名前 |
| callBack | 関数 | コールバック関数の名前。 |
[表 : 55. パラメーター]

{#r_GlideForm-GetReference_S_F__table_k4c_1yb_5s} {#r_GlideForm-GetReference_S_F__table_l4c_1yb_5s__entry__2}

| タイプ | 説明 |
|-|-|
| GlideRecord | 指定されたフィールドの GlideRecord オブジェクト。 指定された参照が見つからない場合は、currentRow が -1 および rows.length が 0 の初期化された GlideRecord オブジェクトを返します。 |
[表 : 56. 返される内容]

{#r_GlideForm-GetReference_S_F__table_l4c_1yb_5s}  

    function onChange(control, oldValue, newValue, isLoading) {
        g_form.getReference('caller_id', doAlert); // doAlert is our callback function
    }
     
    function doAlert(caller) { // reference is passed into callback as first arguments
       if (caller.getValue('vip') == 'true') {
          alert('Caller is a VIP!');
       }
    }

## GlideForm - getRelatedListNames() {#ariaid-title30}

現在のフォームから関連リスト名のアレイを返します。
{#GF-getRelatedListNames__table_vfp_grv_dhb__entry__3}

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

{#GF-getRelatedListNames__table_vfp_grv_dhb} {#GF-getRelatedListNames__table_wfp_grv_dhb__entry__2}

| タイプ | 説明 |
|-|-|
| アレイ | 現在のフォームからの関連リスト名の文字列アレイ。関連リスト名はフォームに表示される順序で一覧表示されます。 |
[表 : 58. 返される内容]

{#GF-getRelatedListNames__table_wfp_grv_dhb}  

    var listNames = g_form.getRelatedListNames();

    for (var i = 0; i < listNames.length; i++) {  
      this.showRelatedList(listNames[i]);
     }

## GlideForm - getSectionNames() {#ariaid-title31}

表示されるかどうかにかかわらず、すべてのセクション名を返します。
{#r_GlideFormGetSectionNames__table_rsg_vkd_5s__entry__3}

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

{#r_GlideFormGetSectionNames__table_rsg_vkd_5s} {#r_GlideFormGetSectionNames__table_ssg_vkd_5s__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列のアレイ | セクション名。 |
[表 : 60. 返される内容]

{#r_GlideFormGetSectionNames__table_ssg_vkd_5s}

## GlideForm - getSections() {#ariaid-title32}

フォームのセクションのアレイを返します。
このメソッドはモバイルプラットフォームでは利用できません。このメソッドがモバイルプラットフォームで実行されても、何も起こりません。
{#r_GlideFormGetSections__table_sg4_hld_5s__entry__3}

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

{#r_GlideFormGetSections__table_sg4_hld_5s} {#r_GlideFormGetSections__table_tg4_hld_5s__entry__2}

| タイプ | 説明 |
|-|-|
| HTML 要素のアレイ | フォームのセクション。 |
[表 : 62. 返される内容]

{#r_GlideFormGetSections__table_tg4_hld_5s}  

    function onChange(control, oldValue, newValue, isLoading) {
       //this example was run on a form divided into sections (Change form)
       // and hid a section when the "state" field was changed
       var sections = g_form.getSections();
       if (newValue == '2') {
          g_form.setSectionDisplay(sections[1], false);
       } else {
          g_form.setSectionDisplay(sections[1], true);
       }
    }

## GlideForm - getTableName() {#ariaid-title33}

このレコードが属するテーブルの名前を返します。
サーバー側では、current.sys_class_name または current.getTableName() を使用して現在のレコードのテーブルを取得できます。
{#r_GlideFormGetTableName__table_gqk_5ld_5s__entry__3}

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

{#r_GlideFormGetTableName__table_gqk_5ld_5s} {#r_GlideFormGetTableName__table_hqk_5ld_5s__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | テーブルの名前です。 |
[表 : 64. 返される内容]

{#r_GlideFormGetTableName__table_hqk_5ld_5s}  

    function onLoad() {
        if (g_form.isNewRecord()) {
            var tableName = g_form.getTableName(); //Get the table name
        }
    }

## GlideForm - getUniqueValue() {#ariaid-title34}

フォームに表示されているレコードの sys_id を返します。
{#r_GlideFormGetUniqueValue__table_xxg_lmd_5s__entry__3}

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

{#r_GlideFormGetUniqueValue__table_xxg_lmd_5s} {#r_GlideFormGetUniqueValue__table_yxg_lmd_5s__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | レコードの sys_id。 |
[表 : 66. 返される内容]

{#r_GlideFormGetUniqueValue__table_yxg_lmd_5s}  

    function onLoad() {
       var incSysid = g_form.getUniqueValue();
       alert(incSysid);
    }

## GlideForm - getValue(文字列 fieldName) {#ariaid-title35}

指定されたフォームフィールドの値を返します。
このメソッドは、複数行の変数セット (MRVS) からの値の取得もサポートしています。MRVS 内のフィールドからデータを取得するには、まず `JSON.parse(getValue('<mrvs_field_name>') ||'[]')` を使用して MRVS アレイを取得し、インデックスを使用して行オブジェクト内のフィールドにアクセスします。詳細については、以下のコード例を参照してください。
{#r_GlideFormGetValue_String__table_nxm_wzb_5s__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | 値を返すフィールドの名前。 |
[表 : 67. パラメーター]

{#r_GlideFormGetValue_String__table_nxm_wzb_5s} {#r_GlideFormGetValue_String__table_oxm_wzb_5s__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 指定されたフィールドの値。 |
[表 : 68. 返される内容]

{#r_GlideFormGetValue_String__table_oxm_wzb_5s}  
次の例は、現在のフォームから簡単な説明を取得する方法を示しています。

    function onChange(control, oldValue, newValue, isLoading) {
       alert(g_form.getValue('short_description'));
    }

次の例は、MRVS から値を取得する方法を示しています。この例では、給与は Service Catalog を介して管理されています。クライアントスクリプトは、MRVS 内のすべての行で \[ Job Title (ジョブタイトル )\] に入力された値を検索し、MRVS 内の一致するエントリを \[ Salay\] フィールドに入力された値で更新します。MRVS には「variable_set_1」という名前が付けられ、各行オブジェクト内に従業員名 \[employee_name\]、ジョブタイトル \[employee_job_title\]、および給与 \[employee_salary\] のフィールドが含まれています。さらに、カタログアイテムには、ジョブタイトル \[job_title\] と給与 \[salary\] が含まれています。

    function onChange(control, oldValue, newValue, isLoading) {
    if (isLoading || newValue == '') {
    return;
    }
     
    // Get the MRVS
    var vs1 = g_form.getValue('variable_set_1') || '[]';
    var multiRowVariableSet = JSON.parse(vs1);
     
    for (var i = 0; i < multiRowVariableSet.length; i++) {
    // Check if the entered job title matches the title in the current MRVS row
      if (multiRowVariableSet[i].employee_job_title == g_form.getValue("job_title")){
        // Update the value of a matching field with the new salary
        multiRowVariableSet[i].employee_salary = newValue;
      }
    }
     
    // Update the MRVS
    g_form.setValue('variable_set_1', JSON.stringify(multiRowVariableSet));
    }

## GlideForm - hideAllFieldMsgs() {#ariaid-title36}

すべてのフィールドメッセージを非表示にします。
{#r_GlideFormHideAllFieldMsgs__table_mr1_3hw_ts__entry__3}

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

{#r_GlideFormHideAllFieldMsgs__table_mr1_3hw_ts} {#r_GlideFormHideAllFieldMsgs__table_nr1_3hw_ts__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 70. 返される内容]

{#r_GlideFormHideAllFieldMsgs__table_nr1_3hw_ts}

## GlideForm - hideAllFieldMsgs(文字列 type) {#ariaid-title37}

指定されたタイプのすべてのフィールドメッセージを非表示にします。
{#r_GlideFormHideAllFieldMsgs_String__table_y2c_qhw_ts__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| type | 文字列 | メッセージのタイプ。 有効な値： * error * info {#r_GlideFormHideAllFieldMsgs_String__ul_gzv_bbn_4pb} |
[表 : 71. パラメーター]

{#r_GlideFormHideAllFieldMsgs_String__table_y2c_qhw_ts} {#r_GlideFormHideAllFieldMsgs_String__table_z2c_qhw_ts__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 72. 返される内容]

{#r_GlideFormHideAllFieldMsgs_String__table_z2c_qhw_ts}

## GlideForm - hideErrorBox(文字列 fieldName) {#ariaid-title38}

showErrorBox() によってされた配置エラーメッセージを非表示にします。
可能な限り、このメソッドではなく hideFieldMsg() を使用してください。
{#r_GlideFormHideErrorBox_String__table_kll_t4w_ts__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | フィールドまたはコントロールの名前。 |
[表 : 73. パラメーター]

{#r_GlideFormHideErrorBox_String__table_kll_t4w_ts} {#r_GlideFormHideErrorBox_String__table_lll_t4w_ts__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 74. 返される内容]

{#r_GlideFormHideErrorBox_String__table_lll_t4w_ts}

## GlideForm - hideFieldMsg(文字列 fieldName, ブーリアン clearAll) {#ariaid-title39}

現在のフォームの指定されたフィールドに表示される最初のメッセージを非表示にします。
フォームにメッセージを表示するには、 [GlideForm - showFieldMsg(文字列 field, 文字列 message, 文字列 type)](https://www.servicenow.com/docs/iZXkMKU701Cuwf8ZI0XoLA#r_GF-ShowFieldMsg_S_S_S "指定されたフォームフィールド (コントロールオブジェクトまたはフィールドの名前) の下に情報またはエラーメッセージを表示します。コントロールまたはフィールドが画面の外にある場合、フォームはフィールドまでスクロールします。") または [GlideForm - showFieldMsg(文字列 field, 文字列 message, 文字列 type, ブーリアン scrollForm)](https://www.servicenow.com/docs/iZXkMKU701Cuwf8ZI0XoLA#r_GF-ShowFieldMsg_S_S_S_B "指定されたフォームフィールド (コントロールオブジェクトまたはフィールドの名前) の下に情報またはエラーメッセージを表示します。コントロールまたはフィールドが現在画面の外にあり、scrollForm が true の場合、フォームはフィールドまでスクロールします。") メソッドを使用します。  
たとえば、次のコード スニペットは、フォームの `work_notes` フィールドに 2 つのメッセージを表示し、最初のメッセージを非表示にする方法を示しています。

    g_form.showFieldMsg('work_notes', 'First message', "error");
    g_form.showFieldMsg('work_notes', 'Second message', "error");
    g_form.hideFieldMsg('work_notes', false); // This call hides the 'First message'

{#r_GlideFormHideFieldMsg_String__table_xnf_3pw_ts__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | メッセージを非表示にするフィールドの名前。 |
| clearAll | ブーリアン | オプション。指定されたフィールドのすべてのメッセージを非表示にするかどうかを示すフラグ。 有効な値： * true:すべてのメッセージを非表示にします。 * false:表示される最初のメッセージのみを非表示にします。 デフォルト値：false |
[表 : 75. パラメーター]

{#r_GlideFormHideFieldMsg_String__table_xnf_3pw_ts} {#r_GlideFormHideFieldMsg_String__table_ynf_3pw_ts__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 76. 返される内容]

{#r_GlideFormHideFieldMsg_String__table_ynf_3pw_ts}  
次の例は、指定したフォームフィールドのすべてのメッセージをクリアし、暗号化エラーメッセージを表示する方法を示しています。

    function submitEncryptedInputs() {
      return processEncryptedInputs(function(inputName, fieldName) {
        if (!checkEncryptedFieldValue(fieldName)) {
          g_form.hideFieldMsg(fieldName, true); // Hide all messages for the specified field
          g_form.showFieldMsg(fieldName, "Your activity requires an encrypted input.", "error");
          return false;
        }
        return true;
      });
    }

## GlideForm - hideFieldMsg(文字列 fieldName, ブーリアン clearAll) {#ariaid-title40}

showFieldMsg() によって配置されたメッセージを非表示にします。
{#r_GlideForm-HideFieldMsg_S_B__table_gvy_vpw_ts__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | フィールドの名前 |
| clearAll | ブーリアン | true の場合、フィールドに対するすべてのメッセージがクリアされます。false の場合、最後のメッセージのみが削除されます。 |
[表 : 77. パラメーター]

{#r_GlideForm-HideFieldMsg_S_B__table_gvy_vpw_ts} {#r_GlideForm-HideFieldMsg_S_B__table_hvy_vpw_ts__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 78. 返される内容]

{#r_GlideForm-HideFieldMsg_S_B__table_hvy_vpw_ts}  

    g_form.hideFieldMsg('impact', true);

## GlideForm - hideRelatedList(文字列 listTableName) {#ariaid-title41}

フォームの指定された関連リストを非表示にします。
このメソッドはモバイルプラットフォームでは利用できません。このメソッドがモバイルプラットフォームで実行されても、何も起こりません。
{#r_GlideFormHideRelatedList_String__table_syn_wqw_ts__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| listTableName | 文字列 | 関連リストの名前。sys_id を使用し、関係を介してリストを非表示にします。 |
[表 : 79. パラメーター]

{#r_GlideFormHideRelatedList_String__table_syn_wqw_ts} {#r_GlideFormHideRelatedList_String__table_tyn_wqw_ts__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 80. 返される内容]

{#r_GlideFormHideRelatedList_String__table_tyn_wqw_ts}

## GlideForm - hideRelatedLists() {#ariaid-title42}

フォーム上のすべての関連リストを非表示にします。
このメソッドはモバイルプラットフォームでは利用できません。このメソッドがモバイルプラットフォームで実行されても、何も起こりません。
{#r_GlideFormHideRelatedLists__table_zmg_jrw_ts__entry__3}

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

{#r_GlideFormHideRelatedLists__table_zmg_jrw_ts} {#r_GlideFormHideRelatedLists__table_ang_jrw_ts__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 82. 返される内容]

{#r_GlideFormHideRelatedLists__table_ang_jrw_ts}

## GlideForm - isLiveUpdating() {#ariaid-title43}

フォームに表示されているレコードのライブ更新中に true を返します。
これを onChange() クライアントスクリプトで使用して、レコードの変更が別のセッションからのライブ更新によるものかどうかを判断できます。その後、クライアントスクリプトは実行するアクションまたは実行しないアクションを決定できます。これは、ライブフォームが有効になっている コア UI を使用するシステムに適用されます。
{#r_GF-isLiveUpdating__table_fjz_sks_kx__entry__3}

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

{#r_GF-isLiveUpdating__table_fjz_sks_kx} {#r_GF-isLiveUpdating__table_gjz_sks_kx__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | フォームに表示されているレコードでライブ更新が行われている場合は true を返します。 |
[表 : 84. 返される内容]

{#r_GF-isLiveUpdating__table_gjz_sks_kx}

## GlideForm - isMandatory(文字列 fieldName) {#ariaid-title44}

フィールドが必須の場合は true を返します。
{#r_GlideFormIsMandatory_String__table_kpt_nnc_5s__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | フィールドの名前 |
[表 : 85. パラメーター]

{#r_GlideFormIsMandatory_String__table_kpt_nnc_5s} {#r_GlideFormIsMandatory_String__table_lpt_nnc_5s__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | フィールドが必須の場合は true、そうでない場合は false。 |
[表 : 86. 返される内容]

{#r_GlideFormIsMandatory_String__table_lpt_nnc_5s}

## GlideForm - isNewRecord() {#ariaid-title45}

レコードが一度も保存されていない場合は true を返します。
{#r_GlideFormIsNewRecord__table_wlm_wmd_5s__entry__3}

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

{#r_GlideFormIsNewRecord__table_wlm_wmd_5s} {#r_GlideFormIsNewRecord__table_xlm_wmd_5s__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | レコードが保存されていない場合は true、それ以外の場合は false を返します。 |
[表 : 88. 返される内容]

{#r_GlideFormIsNewRecord__table_xlm_wmd_5s}  

    function onLoad() {
       if(g_form.isNewRecord()){
          alert('New Record!');
       }
    }

## GlideForm - isSectionVisible(文字列 sectionName) {#ariaid-title46}

セクションが表示されている場合は true を返します。
重要:  
isSectionVisible() 関数はワークスペースではサポートされていません。
{#r_GlideFormIsSectionVisible_String__table_msy_jnd_5s__entry__3}

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

{#r_GlideFormIsSectionVisible_String__table_msy_jnd_5s} {#r_GlideFormIsSectionVisible_String__table_nsy_jnd_5s__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | セクションが表示されている場合は true、表示されていない場合は false を返します。 |
[表 : 90. 返される内容]

{#r_GlideFormIsSectionVisible_String__table_nsy_jnd_5s}

## GlideForm - onUserChangeValue(関数 fn) {#ariaid-title47}

現在のフォーム内でいずれかのフィールドがユーザーによって変更されたことを検出するカスタムイベントリスナーを登録します。
フォームフィールドが変更されると、イベントリスナーはリスナーが最初に登録されたときに渡される関数を呼び出します。このリスナーは、ユーザーがフォームのフィールドを変更した場合にのみトリガーされます。クライアントスクリプト、UI ポリシー、またはその他のユーザー以外のインタラクションからの変更では、リスナーはトリガーされません。  
注:  
このメソッドは、クラシック環境のジャーナルフィールドまたは サービスカタログ アイテムでは機能しません。
{#GF-onUserChangeValue_F__table_m5y_wll_1hb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fn | 関数 | ユーザーが現在のフォーム内のフィールドの値を変更したときに呼び出す関数。これは実際には単なる関数名ではなく、関数コードです。 この関数は、次の 3 つの引数を受け入れる必要があります。 * フィールド名 * 元のフィールド値 * 更新されたフィールド値 {#GF-onUserChangeValue_F__ul_fnz_j4l_1hb} |
[表 : 91. パラメーター]

{#GF-onUserChangeValue_F__table_m5y_wll_1hb} {#GF-onUserChangeValue_F__table_n5y_wll_1hb__entry__2}

| タイプ | 説明 |
|-|-|
| 関数 | onUserChangeValue イベントリスナーを登録解除するために呼び出す関数。 |
[表 : 92. 返される内容]

{#GF-onUserChangeValue_F__table_n5y_wll_1hb}  

    var handler = function(fieldname, originalValue, newValue) {
      console.log('The field ('+ fieldname + ') has a new value of: ' + newValue); // function code
    }
     
    var unregister = g_form.onUserChangeValue(handler);
     
    // To unregister the event listener
    unregister();

## GlideForm - refreshSlushbucket(文字列 fieldName) {#ariaid-title48}

リストコレクター変数を更新できます。
{#r_GF-refreshSlushbucket_S__table_n3v_plp_cv__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | スラッシュバケットの名前。 |
[表 : 93. パラメーター]

{#r_GF-refreshSlushbucket_S__table_n3v_plp_cv} {#r_GF-refreshSlushbucket_S__table_o3v_plp_cv__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 94. 返される内容]

{#r_GF-refreshSlushbucket_S__table_o3v_plp_cv}  

    g_form.refreshSlushbucket('bucket');

## GlideForm - removeDecoration(文字列 fieldName, 文字列 icon, 文字列 title) {#ariaid-title49}

指定されたフィールドからアイコンとタイトルに一致するアイコンを削除します。
注:  
このメソッドは Service Catalog ではサポートされていません。
{#r_GF-RemoveDecoration_S_S_S__table_x23_vrw_ts__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | フィールド名。 |
| アイコン | 文字列 | 削除するアイコンの名前。 |
| title | 文字列 | アイコンのテキストタイトル (名前)。 |
[表 : 95. パラメーター]

{#r_GF-RemoveDecoration_S_S_S__table_x23_vrw_ts} {#r_GF-RemoveDecoration_S_S_S__table_y23_vrw_ts__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 96. 返される内容]

{#r_GF-RemoveDecoration_S_S_S__table_y23_vrw_ts}  

    function onChange(control, oldValue, newValue, isLoading) {
    	// if the caller_id field is not present, then we can't add an icon anywhere
    	if (!g_form.hasField('caller_id'))
    		return;
     
    	if (!newValue)
    		return;
     
    	g_form.getReference('caller_id', function(ref) {
    		g_form.removeDecoration('caller_id', 'icon-star', 'VIP');
     
    		if (ref.getValue('vip') == 'true')
    			g_form.addDecoration('caller_id', 'icon-star', 'VIP');			
    	});
    }

## GlideForm - removeDecoration(文字列 fieldname, 文字列 icon, 文字列 title, 文字列 color) {#ariaid-title50}

指定されたフィールドから、アイコン、タイトル、カラーに一致するアイコンを削除します。
注:  
このメソッドは Service Catalog ではサポートされていません。
{#r_GF-RemoveDecoration_S_S_S_S__table_mcg_5zd_5s__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | フィールド名。 |
| アイコン | 文字列 | 削除するアイコンの名前。 |
| title | 文字列 | アイコンのテキストタイトル (名前)。 |
| 色 | 文字列 | CSS カラー |
[表 : 97. パラメーター]

{#r_GF-RemoveDecoration_S_S_S_S__table_mcg_5zd_5s} {#r_GF-RemoveDecoration_S_S_S_S__table_ncg_5zd_5s__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 98. 返される内容]

{#r_GF-RemoveDecoration_S_S_S_S__table_ncg_5zd_5s}  

    g_form.removeDecoration('caller_id', 'icon-star', 'VIP', 'blue');

## GlideForm - removeOption(文字列 fieldName, 文字列 choiceValuel) {#ariaid-title51}

選択リストから指定されたオプションを削除します。
{#r_GlideFormRemoveOption_String_String__table_p4k_hjd_5s__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | フィールドの名前 |
| choiceValue | 文字列 | データベースに格納されている値。これはラベルではありません。 |
[表 : 99. パラメーター]

{#r_GlideFormRemoveOption_String_String__table_p4k_hjd_5s} {#r_GlideFormRemoveOption_String_String__table_q4k_hjd_5s__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 100. 返される内容]

{#r_GlideFormRemoveOption_String_String__table_q4k_hjd_5s}  

    g_form.removeOption('priority', '1');

## GlideForm - save() {#ariaid-title52}

移動せずにレコードを保存します (更新して留まる)。
{#r_GlideFormSave__table_xgb_3qd_5s__entry__3}

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

{#r_GlideFormSave__table_xgb_3qd_5s} {#r_GlideFormSave__table_ygb_3qd_5s__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 102. 返される内容]

{#r_GlideFormSave__table_ygb_3qd_5s}

## GlideForm - setMandatory(文字列 fieldName, ブーリアン mandatory) {#ariaid-title53}

指定されたフィールドを必須にします。
可能な限り、このメソッドでなく UI ポリシーを使用してください。
{#r_GF-SetMandatory_S_B__table_xnx_z4c_5s__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | フィールドの名前 |
| mandatory | ブーリアン | true の場合、フィールドは必須になります。false の場合、フィールドはオプションになります。 |
[表 : 103. パラメーター]

{#r_GF-SetMandatory_S_B__table_xnx_z4c_5s} {#r_GF-SetMandatory_S_B__table_ynx_z4c_5s__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 104. 返される内容]

{#r_GF-SetMandatory_S_B__table_ynx_z4c_5s}

## GlideForm - setSectionDisplay(文字列 sectionName, ブーリアン display) {#ariaid-title54}

セクションを表示または非表示にします。
{#r_GF-SetSectionDisplay_S_B__table_pqq_qqd_5s__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sectionName | 文字列 | セクション名は小文字で、名前の最初のスペースがアンダースコアで置き換えられ、残りのスペースは削除されます。たとえば、「Section Four is Here」は「section_fourishere」になります。アンパサンド (\&) などの英数字以外の文字は削除されます。セクション名は、getSectionNames() メソッドを使用して見つけることができます。 |
| 表示 | ブーリアン | true の場合、セクションが表示されます。false の場合、セクションは非表示になります。 |
[表 : 105. パラメーター]

{#r_GF-SetSectionDisplay_S_B__table_pqq_qqd_5s} {#r_GF-SetSectionDisplay_S_B__table_qqq_qqd_5s__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | 成功した場合は true を返します。 |
[表 : 106. 返される内容]

{#r_GF-SetSectionDisplay_S_B__table_qqq_qqd_5s}

## GlideForm - setValue(文字列 fieldName, 文字列 value, 文字列 displayValue) {#ariaid-title55}

指定されたフォームフィールドの値を参照レコードの指定された表示値に設定します。
参照フィールドの値を設定するときに往復を防止してパフォーマンスを向上させるには、setValue(fieldName, value) ではなくこのメソッドを使用します。リストコレクターフィールドに複数の参照値を設定する場合は、value パラメーターおよび displayValue パラメーターでアレイを渡します。  
注:  
OnChange クライアントスクリプトで setValue() メソッドを使用すると、スタックのオーバーフローが発生する可能性があります。これは、値が設定されるたびに変更として登録され、OnChange クライアントスクリプトが再トリガーされるためです。これを防ぐには、新しい値が古い値と異なることを検証するチェックを実行します。たとえば、`setValue(shortDesc, newValue.toUpperCase());` を実行する前に、簡単な説明が大文字になっていないことを確認します。これにより、クライアントスクリプトが toUpperCase() を複数回適用することを防ぎます。
{#r_GlideForm-SetValue_S_S_S__table_oxn_vrc_5s__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | 更新するフォームフィールドの名前。 |
| value | 文字列またはアレイ | フィールドを更新するために使用する参照レコードの sys_id。 指定されたフィールドが GlideList の場合、このパラメーターには sys_id のアレイを含めることができます。この場合、メソッドはアレイ内で指定されたすべてのレコードのルックアップを実行し、それらの値を使用して指定されたフィールド (関連リスト) の内容を更新します。 注: 選択リストで値を定義するときは、ラベルではなく数値を使用してください。 |
| displayValue | 文字列またはアレイ | 指定されたフィールドを更新するために使用される、指定された参照レコード内のフィールド。たとえば、ユーザー \[sys_user\] テーブルでは userName になります。 指定されたフィールドが GlideList の場合、このパラメーターには表示値名のアレイを含めることができます。 表示値の詳細については、「 [表示値](https://www.servicenow.com/docs/access?context=c_DisplayValues&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。 |
[表 : 107. パラメーター]

{#r_GlideForm-SetValue_S_S_S__table_oxn_vrc_5s} {#r_GlideForm-SetValue_S_S_S__table_pxn_vrc_5s__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 108. 返される内容]

{#r_GlideForm-SetValue_S_S_S__table_pxn_vrc_5s}  
この例では、\[assigned_to\] フォームフィールドを更新するために使用する \[userName\] フィールドを含む参照レコードの sys_id を渡しています。

    g_form.setValue('assigned_to', userSysID, userName);

この例では、GlideList の \[glide-list_field_name\] フォームフィールドを更新するために使用する、参照レコード sys_id のアレイと対応する表示値名のアレイを渡します。

    g_form.setValue('glide-list_field_name', sysIDArray, displayNameArray);

## GlideForm - showErrorBox(文字列 name, 文字列 message, ブーリアン scrollForm) {#ariaid-title56}

指定されたフォームフィールド (コントロールオブジェクトまたはフィールドの名前) の下にエラーメッセージを表示します。コントロールまたはフィールドが現在画面の外にあり、scrollForm パラメーターが true の場合、フォームはコントロールまたはフィールドまでスクロールします。
グローバルプロパティ (glide.ui.scroll_to_message_field) はフォームフィールドが画面外にある場合の自動メッセージのスクロール (フォームからコントロールまたはフィールドまでスクロール) を制御するために利用できます。showFieldMsg() メソッドは type パラメーターを必要とする同様のメソッドです。
{#r_GF-ShowErrorBox_S_S_B__table_lyr_dww_ts__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| name | 文字列 | フィールドまたはコントロールの名前。 |
| message | 文字列 | 表示するメッセージ。 |
| scrollForm | ブーリアン | true の場合、フォームをフィールドまでスクロールします。false の場合、フォームはフィールドまでスクロールしません。 |
[表 : 109. パラメーター]

{#r_GF-ShowErrorBox_S_S_B__table_lyr_dww_ts} {#r_GF-ShowErrorBox_S_S_B__table_myr_dww_ts__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 110. 返される内容]

{#r_GF-ShowErrorBox_S_S_B__table_myr_dww_ts}

## GlideForm - showFieldMsg(文字列 field, 文字列 message, 文字列 type) {#ariaid-title57}

指定されたフォームフィールド (コントロールオブジェクトまたはフィールドの名前) の下に情報またはエラーメッセージを表示します。コントロールまたはフィールドが画面の外にある場合、フォームはフィールドまでスクロールします。
グローバルプロパティ (glide.ui.scroll_to_message_field) はフォームフィールドが画面外にある場合の自動メッセージのスクロール (フォームからコントロールまたはフィールドまでスクロール) を制御するために利用できます。

showErrorBox() メソッドは type パラメーターを必要としない短縮形のメソッドです。  
注:  
このメソッドは、コア UI の journal_field タイプフィールドでは機能しません。
{#r_GF-ShowFieldMsg_S_S_S__table_u3z_hxw_ts__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| フィールド | 文字列 | フィールドまたはコントロールの名前。 |
| message | 文字列 | 表示するメッセージ。 |
| type | 文字列 | 「エラー」、「情報」、または「警告」。 |
[表 : 111. パラメーター]

{#r_GF-ShowFieldMsg_S_S_S__table_u3z_hxw_ts} {#r_GF-ShowFieldMsg_S_S_S__table_v3z_hxw_ts__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 112. 返される内容]

{#r_GF-ShowFieldMsg_S_S_S__table_v3z_hxw_ts}  

    g_form.showFieldMsg('impact','Low impact response time can be one week','info');

## GlideForm - showFieldMsg(文字列 field, 文字列 message, 文字列 type, ブーリアン scrollForm) {#ariaid-title58}

指定されたフォームフィールド (コントロールオブジェクトまたはフィールドの名前) の下に情報またはエラーメッセージを表示します。コントロールまたはフィールドが現在画面の外にあり、scrollForm が true の場合、フォームはフィールドまでスクロールします。
グローバルプロパティ (glide.ui.scroll_to_message_field) はフォームフィールドが画面外にある場合の自動メッセージのスクロール (フォームからコントロールまたはフィールドまでスクロール) を制御するために利用できます。

showErrorBox() メソッドは type パラメーターを必要としない短縮形のメソッドです。  
注:  
このメソッドは、コア UI の journal_field タイプフィールドでは機能しません。
{#r_GF-ShowFieldMsg_S_S_S_B__table_wmr_gyw_ts__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| フィールド | 文字列 | フィールドまたはコントロールの名前。 |
| message | 文字列 | 表示するメッセージ。 |
| type | 文字列 | 「エラー」、「情報」、または「警告」。 |
| scrollForm | ブーリアン | true の場合、フォームが画面の外にあると、そのフィールドまでスクロールします。false の場合、フォームはスクロールしません。 |
[表 : 113. パラメーター]

{#r_GF-ShowFieldMsg_S_S_S_B__table_wmr_gyw_ts} {#r_GF-ShowFieldMsg_S_S_S_B__table_xmr_gyw_ts__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 114. 返される内容]

{#r_GF-ShowFieldMsg_S_S_S_B__table_xmr_gyw_ts}  

    g_form.showFieldMsg('impact','Low impact not allowed with High priority','error',false);

## GlideForm - setDisabled(文字列 fieldName, ブーリアン disable) {#ariaid-title59}

指定されたフィールドを使用可能または使用不可にします。
{#r_GlideFormSetDisabled_String_Boolean__table_sn2_j4c_5s__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | フィールドの名前 |
| disable | ブーリアン | true の場合、フィールドが無効になります。false の場合、フィールドが有効になります。 |
[表 : 115. パラメーター]

{#r_GlideFormSetDisabled_String_Boolean__table_sn2_j4c_5s} {#r_GlideFormSetDisabled_String_Boolean__table_tn2_j4c_5s__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 116. 返される内容]

{#r_GlideFormSetDisabled_String_Boolean__table_tn2_j4c_5s}

## GlideForm - setDisplay(文字列 fieldName, ブーリアン display) {#ariaid-title60}

フィールドを表示または非表示にします。
このメソッドで値のない必須フィールドを非表示にすることはできません。フィールドが非表示の場合、スペースは他のアイテムを表示するために使用されます。可能な限り、このメソッドの代わりに UI ポリシーを使用してください。
{#r_GlideFormSetDisplay_String_Boolean__table_k4d_ctw_ts__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldname | 文字列 | フィールドの名前 |
| 表示 | ブーリアン | true の場合はフィールドが表示され、false の場合はフィールドが非表示になります。 |
[表 : 117. パラメーター]

{#r_GlideFormSetDisplay_String_Boolean__table_k4d_ctw_ts} {#r_GlideFormSetDisplay_String_Boolean__table_l4d_ctw_ts__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 118. 返される内容]

{#r_GlideFormSetDisplay_String_Boolean__table_l4d_ctw_ts}  

    function onChange(control, oldValue, newValue, isLoading, isTemplate) {
       //If the page isn't loading
       if (!isLoading) {
          //If the new value isn't blank
          if (newValue != '') {
             g_form.setDisplay('priority', false);   
          }
          else 
             g_form.setDisplay('priority', true);
          }
       }

## GlideForm - setLabelOf(文字列 fieldName, 文字列 label) {#ariaid-title61}

フィールドラベルのプレーンテキスト値を設定します。
注:  
このメソッドは Service Catalog ではサポートされていません。
{#r_GlideFormSetLabelOf_String_String__table_h5q_ytw_ts__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | フィールド名 |
| label | 文字列 | フィールドのテキストラベル。 |
[表 : 119. パラメーター]

{#r_GlideFormSetLabelOf_String_String__table_h5q_ytw_ts} {#r_GlideFormSetLabelOf_String_String__table_i5q_ytw_ts__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 120. 返される内容]

{#r_GlideFormSetLabelOf_String_String__table_i5q_ytw_ts}  

    if (g_user.hasRole('itil')) {
        var oldLabel = g_form.getLabelOf('comments');
        g_form.setLabelOf('comments', oldLabel + ' (Customer visible)');
    }

## GlideForm - setReadOnly(文字列 fieldName, ブーリアン readOnly) {#ariaid-title62}

指定されたフィールドを読み取り専用または編集可能にします。
可能な限り、このメソッドの代わりに UI ポリシーを使用してください。

必須フィールドを読み取り専用にするには、まず setMandatory() メソッドを使用してそのフィールドの必須要件を削除する必要があります。

フィールドを読み取り専用に設定すると、[setValue()](https://www.servicenow.com/docs/iZXkMKU701Cuwf8ZI0XoLA#r_GlideFormSetValue_String_String "指定されたフォームフィールドの値を、渡された値に設定します。") メソッドを使用してそのフィールドの値を更新することはできません。この方法で値を設定する必要がある場合は、readOnly 値を false に設定する必要があります。
{#r_GlideFormSetReadOnly_String_Boolean__table_xdf_qpc_5s__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | フィールドの名前 |
| readOnly | ブーリアン | 関連するフィールドが編集可能か読み取り専用かを決定するフラグ。 可能な値： * true：フィールドを読み取り専用に設定 * false：フィールドを編集可能に設定 {#r_GlideFormSetReadOnly_String_Boolean__ul_ah1_bkw_yqb} |
[表 : 121. パラメーター]

{#r_GlideFormSetReadOnly_String_Boolean__table_xdf_qpc_5s} {#r_GlideFormSetReadOnly_String_Boolean__table_ydf_qpc_5s__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 122. 返される内容]

{#r_GlideFormSetReadOnly_String_Boolean__table_ydf_qpc_5s}  
次の例は、変数エディターを読み取り専用に設定する方法を示しています。サービスカタログテーブルでこれを行うには、setVariablesReadOnly() を使用します。

    // Create a Client Script on a table (e.g., incident) and paste this script
    // Uncheck (set to false) the "isolate script" checkbox (not available by default)
    // To add the isolate script checkbox to the form, configure form layout to add the checkbox
    function onLoad() { 
      $("variable_map").querySelectorAll("item").forEach(function(item){
        var variable = item.getAttribute("qname"); 
        g_form.setReadOnly("variables."+ variable, true); 
      }); 
    }

## GlideForm - setValue(文字列 fieldName, 文字列 value) {#ariaid-title63}

指定されたフォームフィールドの値を、渡された値に設定します。
このメソッドは、複数行の変数セット (MRVS) への値の設定もサポートしています。最初に `JSON.parse(getValue('<mrvs_field_name>'))` を使用して MRVS アレイを取得し、インデックスを使用して行オブジェクト内のフィールドにアクセスします。MRVS ですべての値が更新されたら、setValue() メソッドを使用して更新された MRVS アレイを保存します。詳細については、以下のコード例を参照してください。  
注:  
OnChange クライアントスクリプトで setValue() メソッドを使用すると、スタックのオーバーフローが発生する可能性があります。これは、値が設定されるたびに変更として登録され、OnChange クライアントスクリプトが再トリガーされるためです。これを防ぐには、新しい値が古い値と異なることを検証するチェックを実行します。たとえば、`setValue(shortDesc, newValue.toUpperCase());` を実行する前に、簡単な説明が大文字になっていないことを確認します。これにより、クライアントスクリプトが toUpperCase() を複数回適用することを防ぎます。  
注:  
選択リストで値を定義するときは、ラベルではなく数値を使用してください。
{#r_GlideFormSetValue_String_String__table_bqz_pqc_5s__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | 更新するフォームフィールドの名前。 |
| value | 文字列 | 指定されたフィールドに設定する文字列値。 |
[表 : 123. パラメーター]

{#r_GlideFormSetValue_String_String__table_bqz_pqc_5s} {#r_GlideFormSetValue_String_String__table_cqz_pqc_5s__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 124. 返される内容]

{#r_GlideFormSetValue_String_String__table_cqz_pqc_5s}  
次の例は、現在のフォームに簡単な説明を設定する方法を示しています。

    g_form.setValue('short_description', 'replace this with appropriate text');

次の例は、MRVS に値を設定する方法を示しています。この例では、給与は Service Catalog を介して管理されています。クライアントスクリプトは、MRVS 内のすべての行で \[ Job Title (ジョブタイトル )\] に入力された値を検索し、MRVS 内の一致するエントリを \[ Salay\] フィールドに入力された値で更新します。MRVS には「variable_set_1」という名前が付けられ、各行オブジェクト内に従業員名 \[employee_name\]、ジョブタイトル \[employee_job_title\]、および給与 \[employee_salary\] のフィールドが含まれています。さらに、カタログアイテムには、ジョブタイトル \[job_title\] と給与 \[salary\] が含まれています。

    function onChange(control, oldValue, newValue, isLoading) {
    if (isLoading || newValue == '') {
    return;
    }

    // Get the MRVS
    var multiRowVariableSet = JSON.parse(g_form.getValue('variable_set_1'));

    for (var i = 0; i < multiRowVariableSet.length; i++) {
    // Check if the entered job title matches the title in the current MRVS row
      if (multiRowVariableSet[i].employee_job_title == g_form.getValue("job_title")){
        // Update the value of a matching field with the new salary
        multiRowVariableSet[i].employee_salary = newValue;
      }
    }

    // Update the MRVS
    g_form.setValue('variable_set_1', JSON.stringify(multiRowVariableSet));
    }

## GlideForm - setVariablesReadOnly(ブーリアン isReadOnly) {#ariaid-title64}

サービスカタログ 変数エディターを読み込み専用にします。
注:  
このメソッドは、コア UI の サービスカタログ 変数エディターにのみ適用できます。このメソッドは、 サービスカタログ フォームではサポートされていません。

このメソッドは、要求アイテム \[sc_req_item\]、インシデント \[incident\] など、変数エディターが追加されたテーブルのクライアントスクリプトに配置する必要があります。他のテーブルで読み取り専用になるように変数を設定するには、 [setReadOnly()](https://www.servicenow.com/docs/iZXkMKU701Cuwf8ZI0XoLA#r_GlideFormSetReadOnly_String_Boolean "指定されたフィールドを読み取り専用または編集可能にします。") メソッドを使用します。

関連項目: [サービスカタログ変数エディタ](https://www.servicenow.com/docs/access?context=service-catalog-variable-editor&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)
{#GF-setVariablesReadOnly_B__table_xdf_qpc_5s__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| isReadOnly | ブーリアン | 変数エディターが読み取り専用かどうかを決定するフラグ。 可能な値： * true：変数エディターを読み取り専用に設定します。 * false：変数エディターを編集可能に設定します。 {#GF-setVariablesReadOnly_B__ul_ah1_bkw_yqb} デフォルト値：false |
[表 : 125. パラメーター]

{#GF-setVariablesReadOnly_B__table_xdf_qpc_5s} {#GF-setVariablesReadOnly_B__table_ydf_qpc_5s__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 126. 返される内容]

{#GF-setVariablesReadOnly_B__table_ydf_qpc_5s}  
次の行をクライアントスクリプトに追加すると、変数エディターが読み取り専用に設定されます。

    g_form.setVariablesReadOnly(true);

## GlideForm - setVisible(文字列 fieldName, ブーリアン display) {#ariaid-title65}

フィールドを表示または非表示にします。
デスクトップ UI では、非表示の場合は空白のままになります。モバイル UI または Service Portal UI では、非表示の場合は他のフィールドにスペースが入力されます。このメソッドで値のない必須フィールドを非表示にすることはできません。

可能な限り、このメソッドでなく UI ポリシーを使用してください。
{#r_GlideFormSetVisible_String_Boolean__table_k24_45w_ts__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| fieldName | 文字列 | フィールド名 |
| 表示 | ブーリアン | true の場合、フィールドを表示します。false の場合、フィールドを非表示にします。 |
[表 : 127. パラメーター]

{#r_GlideFormSetVisible_String_Boolean__table_k24_45w_ts} {#r_GlideFormSetVisible_String_Boolean__table_l24_45w_ts__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 128. 返される内容]

{#r_GlideFormSetVisible_String_Boolean__table_l24_45w_ts}  

    function onChange(control, oldValue, newValue, isLoading, isTemplate) {
       //If the page isn't loading
       if (!isLoading) {
          //If the new value isn't blank
          if(newValue != '') {
             g_form.setVisible('priority', false); 
          }
          else
             g_form.setVisible('priority', true); 
          }
       }

## GlideForm - showErrorBox(文字列 name, 文字列 message) {#ariaid-title66}

指定されたフォームフィールド (コントロールオブジェクトまたはフィールドの名前) の下にエラーメッセージを表示します。コントロールまたはフィールドが現在画面の外にある場合、フォームはコントロールまたはフィールドまでスクロールします。
グローバルプロパティ (glide.ui.scroll_to_message_field) はフォームフィールドが画面外にある場合の自動メッセージのスクロール (フォームからコントロールまたはフィールドまでスクロール) を制御するために利用できます。showFieldMsg() メソッドは type パラメーターを必要とする同様のメソッドです。
{#r_GlideFormShowErrorBox_String_String__table_rxv_2vw_ts__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| name | 文字列 | コントロールまたはフィールドの名前。 |
| message | 文字列 | 表示されるメッセージ。 |
[表 : 129. パラメーター]

{#r_GlideFormShowErrorBox_String_String__table_rxv_2vw_ts} {#r_GlideFormShowErrorBox_String_String__table_sxv_2vw_ts__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 130. 返される内容]

{#r_GlideFormShowErrorBox_String_String__table_sxv_2vw_ts}

## GlideForm - showRelatedList(文字列 listTableName) {#ariaid-title67}

指定された関連リストをフォームに表示します。
このメソッドはモバイルプラットフォームでは利用できません。このメソッドがモバイルプラットフォームで実行されても、何も起こりません。
{#r_GlideFormShowRelatedList_String__table_mps_2zw_ts__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| listTableName | 文字列 | 関連リストの名前。 |
[表 : 131. パラメーター]

{#r_GlideFormShowRelatedList_String__table_mps_2zw_ts} {#r_GlideFormShowRelatedList_String__table_nps_2zw_ts__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 132. 返される内容]

{#r_GlideFormShowRelatedList_String__table_nps_2zw_ts}

## GlideForm - showRelatedLists() {#ariaid-title68}

フォームの関連リストをすべて表示します。
このメソッドはモバイルプラットフォームでは利用できません。このメソッドがモバイルプラットフォームで実行されても、何も起こりません。
{#r_GlideFormShowRelatedLists__table_jcj_rzw_ts__entry__3}

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

{#r_GlideFormShowRelatedLists__table_jcj_rzw_ts} {#r_GlideFormShowRelatedLists__table_kcj_rzw_ts__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 134. 返される内容]

{#r_GlideFormShowRelatedLists__table_kcj_rzw_ts}

## GlideForm - submit() {#ariaid-title69}

レコードを保存します。
フォームから離れて元の場所に戻ります。
{#r_GlideFormSubmit__table_nhk_grd_5s__entry__3}

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

{#r_GlideFormSubmit__table_nhk_grd_5s} {#r_GlideFormSubmit__table_ohk_grd_5s__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 136. 返される内容]

{#r_GlideFormSubmit__table_ohk_grd_5s}

## GlideForm - submit(文字列 verb) {#ariaid-title70}

パラメーターで指定された UI アクションを実行します。
{#GF-submit_S__table_o1z_d3p_qx__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| verb | 文字列 | sys_ui_action レコードからの action_name。アクション名は、表示されるフォームボタンを対象とする必要があります。 |
[表 : 137. パラメーター]

{#GF-submit_S__table_o1z_d3p_qx} {#GF-submit_S__table_p1z_d3p_qx__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 138. 返される内容]

{#GF-submit_S__table_p1z_d3p_qx}