--- 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 --- # GlideForm (g_form): クライアント # GlideForm (g_form): クライアント {#ariaid-title1} * リリースバージョン: Australia * * 更新日 2026年03月12日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：81分 GlideForm API は、フォームをカスタマイズするためのメソッドを提供します。 クライアント上でのみ GlideForm メソッドを使用してください。これらのメソッドを使用して、レコードのフォームビューにカスタム変更を加えることができます。例の検証はすべてクライアントスクリプトを使用して行われました。 これらのメソッドの一部を他のクライアントスクリプト (カタログクライアントスクリプトやウィザードクライアントスクリプトなど) でも使用できますが、最初にこれをテストして、期待どおりに機能するかどうかを判断する必要があります。 注: getControl()、getHelpTextControl()、getElement()、および getFormElement() メソッドは、モバイルデバイスで不使用になりました。モバイル用 GlideForm の使用方法については、「 [モバイルクライアント GlideForm (g_form) スクリプトと移行](https://servicenow-prod.fluidtopics.net/2QZQkexBO9mSuksGJVXGhQ "モバイル用のクライアントスクリプトは、Web 用のスクリプトと同じですが、いくつかの例外があります。すべての新しいスクリプトは特定のガイドラインに準拠する必要があります。モバイルプラットフォームで影響を受けるアイテムは、クライアントスクリプト、UI ポリシー、ナビゲーターモジュール、および UI アクションです。")」を参照してください。 GlideForm クラスのコンストラクターはありません。`g_form` グローバルオブジェクトを使用して GlideForm メソッドにアクセスします。 ## GlideForm - addDecoration(文字列 fieldName, 文字列 icon, 文字列 title) {#ariaid-title2} フィールドのラベルにアイコンを追加します。 同じアイテムを 2 回追加することはできませんが、別のタイトルで同じアイコンを追加することはできます。 注: このメソッドは サービスカタログ ではサポートされていません。 {#r_GlideForm-AddDecoration_S_S_S__table_vyw_1dw_ts__entry__3}{#r_GlideForm-AddDecoration_S_S_S__g_form-add_decor-fieldName-entry}{#r_GlideForm-AddDecoration_S_S_S__g_form-add_decor-icon-entry}{#r_GlideForm-AddDecoration_S_S_S__g_form-add_decor-title-entry} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | フィールド名。 | | アイコン | 文字列 | 指定したフィールドの横に表示するアイコンの名前。 有効な値： * icon-add * icon-alert * icon-book * icon-book-open * icon-calendar * icon-cards * icon-cart-full * icon-catalog * icon-check-circle * icon-cog * icon-comment * icon-console * icon-dashboard * icon-database * icon-delete * icon-drawer * アイコン - 編集 * icon-filter * icon-folder * icon-form * icon-help * icon-home * icon-image * icon-info * icon-label * icon-lightbulb * icon-list * icon-livefeed * icon-locked * icon-mail * icon-mobile * icon-new-ticket * アイコン:ペーパークリップ * icon-power * icon-script * icon-search * icon-sort-ascending * icon-star * icon-star-empty * icon-tab * icon-trash * icon-tree * icon-tree-right * icon-user * icon-user-group * icon-view {#r_GlideForm-AddDecoration_S_S_S__ul_p2d_sqg_5fc} | | タイトル | 文字列 | アイコンのタイトル。 | [表 : 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 回追加することはできませんが、別のタイトルで同じアイコンを追加することはできます。 注: この方法はサービスカタログではサポートされていません。 {#r_GlideForm-AddDecoration_S_S_S_S__table_gzh_fyd_5s__entry__3}{#r_GlideForm-AddDecoration_S_S_S_S__g_form-add_decor-fieldName-entry}{#r_GlideForm-AddDecoration_S_S_S_S__g_form-add_decor-icon-entry}{#r_GlideForm-AddDecoration_S_S_S_S__g_form-add_decor-title-entry}{#r_GlideForm-AddDecoration_S_S_S_S__g_form-add_decor-color-entry} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | フィールド名。 | | アイコン | 文字列 | 指定したフィールドの横に表示するアイコンの名前。 有効な値： * icon-add * icon-alert * icon-book * icon-book-open * icon-calendar * icon-cards * icon-cart-full * icon-catalog * icon-check-circle * icon-cog * icon-comment * icon-console * icon-dashboard * icon-database * icon-delete * icon-drawer * アイコン - 編集 * icon-filter * icon-folder * icon-form * icon-help * icon-home * icon-image * icon-info * icon-label * icon-lightbulb * icon-list * icon-livefeed * icon-locked * icon-mail * icon-mobile * icon-new-ticket * アイコン:ペーパークリップ * icon-power * icon-script * icon-search * icon-sort-ascending * icon-star * icon-star-empty * icon-tab * icon-trash * icon-tree * icon-tree-right * icon-user * icon-user-group * icon-view {#r_GlideForm-AddDecoration_S_S_S_S__ul_p2d_sqg_5fc} | | タイトル | 文字列 | アイコンのタイトル。 | | 色 | 文字列 | 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}{#r_GlideFormAddErrorMessage_String__g_form-add_err_msg-message-entry} | 名前 | タイプ | 説明 | |-|-|-| | 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://servicenow-prod.fluidtopics.net/TOJ5TIb2BhZv_76tquWNCA#GF-clearAllFormMessages "任意のタイプのすべてのフォームメッセージを削除します。") * [clearFormMessages()](https://servicenow-prod.fluidtopics.net/TOJ5TIb2BhZv_76tquWNCA#GF-clearFormMessages_S "指定したタイプのすべてのフォームメッセージを削除します。") {#GF-addFormMessage_S_S__ul_unz_vkt_4pb} {#GF-addFormMessage_S_S__table_f2v_zym_4pb__entry__3}{#GF-addFormMessage_S_S__g_form-add_form_msg-message-entry}{#GF-addFormMessage_S_S__glideform-parm-type-entry}{#GF-addFormMessage_S_S__g_form-add_form_msg-options-entry}{#GF-addFormMessage_S_S__g_form-add_form_msg-options_buttons-entry}{#GF-addFormMessage_S_S__g_form-add_form_msg-options_buttons_actionName-entry}{#GF-addFormMessage_S_S__g_form-add_form_msg-options_buttons_label-entry}{#GF-addFormMessage_S_S__g_form-add_form_msg-options_meta-entry} | 名前 | タイプ | 説明 | |-|-|-| | メッセージ | 文字列 | 表示するメッセージ。 | | タイプ | 文字列 | メッセージのタイプ 有効な値： * エラー * 情報 * 警告 {#GF-addFormMessage_S_S__ul_mgd_sqg_5fc} | | オプション | オブジェクト | オプション。フォームメッセージに追加するボタンと、ボタンクリックを処理するために必要なメタデータ。 { buttons: [Array], meta: {Object} } | | options.buttons | アレイ | フォームメッセージに追加するボタンのリスト。 buttons: [ { actionName: "String", label: "String" } ] | | options.buttons.actionName | 文字列 | クリックされたボタンを決定するために `FORM_MESSAGE_BUTTON_CLICKED` イベントハンドラーによって使用される名前。 たとえば、actionName `assign_to_me`にボタンを追加する場合は、actionNameが`assigned_to_me`場合にのみ実行される`FORM_MESSAGE_BUTTON_CLICKED`イベントに対して、UIBイベントでイベントハンドラーを作成する必要があります。 | | options.buttons.label | 文字列 | ボタンに表示するテキスト。 | | 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 - addHighMessage (文字列メッセージ) {#ariaid-title6} フォームの上部に高優先度のメッセージが表示されます。 このメッセージは約 4 秒間表示され、その後消えます。現時点でこのタイムアウトは設定できません。 {#GF-addHighMessage_S__table_ft2_hk4_2fc__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | メッセージ | 文字列 | フォームに表示する高優先度のメッセージ。 | [表 : 9. パラメーター] {#GF-addHighMessage_S__table_ft2_hk4_2fc} {#GF-addHighMessage_S__table_gt2_hk4_2fc__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 10. 返される内容] {#GF-addHighMessage_S__table_gt2_hk4_2fc} 次の例は、フォームの上部に優先度の高いメッセージを表示する方法を示しています。 g_form.addHighMessage("This is a high priority message"); ## GlideForm - addInfoMessage(文字列 message) {#ariaid-title7} 指定された情報メッセージをフォームの上部に追加します。 このメッセージは約 4 秒間表示され、その後消えます。現時点でこのタイムアウトは設定できません。 {#r_GlideFormAddInfoMessage_String__table_pcg_n4d_5s__entry__3}{#r_GlideFormAddInfoMessage_String__g_form-add_info_msg-message-entry} | 名前 | タイプ | 説明 | |-|-|-| | メッセージ | 文字列 | 表示するメッセージ。 | [表 : 11. パラメーター] {#r_GlideFormAddInfoMessage_String__table_pcg_n4d_5s} {#r_GlideFormAddInfoMessage_String__table_qcg_n4d_5s__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 12. 返される内容] {#r_GlideFormAddInfoMessage_String__table_qcg_n4d_5s} g_form.addInfoMessage('The top five fields in this form are mandatory'); ## GlideForm - addLowMessage (文字列メッセージ) {#ariaid-title8} 優先度の低いメッセージをフォームの上部に表示します。 このメッセージは約 4 秒間表示され、その後消えます。現時点でこのタイムアウトは設定できません。 {#GF-addLowMessage_S__table_ydn_fj4_2fc__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | メッセージ | 文字列 | フォームに表示する優先度の低いメッセージ。 | [表 : 13. パラメーター] {#GF-addLowMessage_S__table_ydn_fj4_2fc} {#GF-addLowMessage_S__table_zdn_fj4_2fc__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 14. 返される内容] {#GF-addLowMessage_S__table_zdn_fj4_2fc} 次の例は、優先度の低いメッセージをフォームの上部に表示する方法を示しています。 g_form.addLowMessage("This is a low priority message"); ## GlideForm - addModerateMessage(文字列メッセージ) {#ariaid-title9} フォームの上部に中レベルの優先度のメッセージを表示します。 このメッセージは約 4 秒間表示され、その後消えます。現時点でこのタイムアウトは設定できません。 {#GF-addModerateMessage_S__table_kfb_vj4_2fc__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | メッセージ | 文字列 | フォームに表示する中優先度のメッセージ。 | [表 : 15. パラメーター] {#GF-addModerateMessage_S__table_kfb_vj4_2fc} {#GF-addModerateMessage_S__table_lfb_vj4_2fc__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 16. 返される内容] {#GF-addModerateMessage_S__table_lfb_vj4_2fc} 次の例は、フォームの上部に中程度の優先度のメッセージを表示する方法を示しています。 g_form.addModerateMessage("This is a moderate priority message"); ## GlideForm - addOption(文字列 fieldName, 文字列 choiceValue, 文字列 ChoiceLabel) {#ariaid-title10} 指定された選択リストフィールドの末尾に選択肢を追加します。 {#r_GF-AddOption_S_S_S__table_omk_pgd_5s__entry__3}{#r_GF-AddOption_S_S_S__g_form-addOption-fieldName-entry}{#r_GF-AddOption_S_S_S__g_form-addOption-choiceValue-entry}{#r_GF-AddOption_S_S_S__g_form-addOption-choiceLabel-entry} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | 選択肢フィールドオプションを追加するフィールドの名前。 | | choiceValue | 文字列 | データベースに格納する値。 | | choiceLabel | 文字列 | 表示する値。 | [表 : 17. パラメーター] {#r_GF-AddOption_S_S_S__table_omk_pgd_5s} {#r_GF-AddOption_S_S_S__table_pmk_pgd_5s__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 18. 返される内容] {#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-title11} リストフィールドの指定された位置に選択肢を追加します。 注: サービスポータル では、重複するリストラベルはサポートされていません。たとえば、ラベルテキストが別のラベルと一致するアイテムは無視され、リストに追加されません。 {#r_GlideForm-AddOption_S_S_S_N__table_k5s_qhd_5s__entry__3}{#r_GlideForm-AddOption_S_S_S_N__g_form-addOption-fieldName-entry}{#r_GlideForm-AddOption_S_S_S_N__g_form-addOption-choiceValue-entry}{#r_GlideForm-AddOption_S_S_S_N__g_form-addOption-choiceLabel-entry}{#r_GlideForm-AddOption_S_S_S_N__g_form-addOption-choiceIndex-entry} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | 選択肢フィールドオプションを追加するフィールドの名前。 | | choiceValue | 文字列 | データベースに格納する値。 | | choiceLabel | 文字列 | 表示する値。 | | choiceIndex | 番号 | リスト内の選択肢の順序。インデックスは 0 から始まる配列です。 | [表 : 19. パラメーター] {#r_GlideForm-AddOption_S_S_S_N__table_k5s_qhd_5s} {#r_GlideForm-AddOption_S_S_S_N__table_l5s_qhd_5s__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 20. 返される内容] {#r_GlideForm-AddOption_S_S_S_N__table_l5s_qhd_5s} g_form.addOption('priority', '2.5', '2.5 - Moderately High', 3); ## GlideForm - addSuccessMessage(文字列メッセージ) {#ariaid-title12} フォームの上部に成功メッセージが表示されます。 このメッセージは約 4 秒間表示され、その後消えます。現時点でこのタイムアウトは設定できません。 {#GF-addSuccessMessage_S__table_mln_jh4_2fc__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | メッセージ | 文字列 | フォームに表示する成功メッセージ。 | [表 : 21. パラメーター] {#GF-addSuccessMessage_S__table_mln_jh4_2fc} {#GF-addSuccessMessage_S__table_nln_jh4_2fc__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 22. 返される内容] {#GF-addSuccessMessage_S__table_nln_jh4_2fc} 次の例は、成功メッセージを確認するメッセージをフォームの上部に表示する方法を示しています。 g_form.addSuccessMessage("This is a success message"); ## GlideForm:clearAllFormMessages() {#ariaid-title13} 任意のタイプのすべてのフォームメッセージを削除します。 関連項目： * [addFormMessage()](https://servicenow-prod.fluidtopics.net/TOJ5TIb2BhZv_76tquWNCA#GF-addFormMessage_S_S "フォーム詳細セクションの上部に浮遊型のフォームメッセージを表示します。このメッセージには、UI アクションは表示されません。") * [clearFormMessages()](https://servicenow-prod.fluidtopics.net/TOJ5TIb2BhZv_76tquWNCA#GF-clearFormMessages_S "指定したタイプのすべてのフォームメッセージを削除します。") {#GF-clearAllFormMessages__ul_unz_vkt_4pb} {#GF-clearAllFormMessages__table_qpm_dzm_4pb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 23. パラメーター] {#GF-clearAllFormMessages__table_qpm_dzm_4pb} {#GF-clearAllFormMessages__table_rpm_dzm_4pb__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 24. 返される内容] {#GF-clearAllFormMessages__table_rpm_dzm_4pb} 次の例は、フォームからすべてのメッセージをクリアする方法を示しています。 g_form.clearAllFormMessages(); ## GlideForm - clearFormMessages(文字列 type) {#ariaid-title14} 指定したタイプのすべてのフォームメッセージを削除します。 関連項目： * [addFormMessage()](https://servicenow-prod.fluidtopics.net/TOJ5TIb2BhZv_76tquWNCA#GF-addFormMessage_S_S "フォーム詳細セクションの上部に浮遊型のフォームメッセージを表示します。このメッセージには、UI アクションは表示されません。") * [clearAllFormMessages()](https://servicenow-prod.fluidtopics.net/TOJ5TIb2BhZv_76tquWNCA#GF-clearAllFormMessages "任意のタイプのすべてのフォームメッセージを削除します。") {#GF-clearFormMessages_S__ul_unz_vkt_4pb} {#GF-clearFormMessages_S__table_ilw_bzm_4pb__entry__3}{#GF-clearFormMessages_S__glideform-parm-type-entry} | 名前 | タイプ | 説明 | |-|-|-| | タイプ | 文字列 | メッセージのタイプ 有効な値： * エラー * 情報 * 警告 {#GF-clearFormMessages_S__ul_mgd_sqg_5fc} | [表 : 25. パラメーター] {#GF-clearFormMessages_S__table_ilw_bzm_4pb} {#GF-clearFormMessages_S__table_jlw_bzm_4pb__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 26. 返される内容] {#GF-clearFormMessages_S__table_jlw_bzm_4pb} 次の例は、フォームからすべてのエラーメッセージをクリアする方法を示しています。 g_form.clearFormMessages('error'); ## GlideForm - clearMessages() {#ariaid-title15} フォームの上部からすべての情報メッセージとエラーメッセージを削除します。 g_form.addInfoMessage() および g_form.addErrorMessage() とともに追加された情報メッセージとエラーメッセージを削除します。 {#r_GlideFormClearMessages__table_krr_y4d_5s__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 27. パラメーター] {#r_GlideFormClearMessages__table_krr_y4d_5s} {#r_GlideFormClearMessages__table_lrr_y4d_5s__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 28. 返される内容] {#r_GlideFormClearMessages__table_lrr_y4d_5s} g_form.clearMessages(); ## GlideForm - clearOptions(文字列 fieldName) {#ariaid-title16} 指定された選択リストからすべてのオプションを削除します。 {#r_GlideFormClearOptions_String__table_bdt_v3d_5s__entry__3}{#r_GlideFormClearOptions_String__g_form-clearOptions-fieldName-entry} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | 選択オプションをクリアするフィールドの名前。 | [表 : 29. パラメーター] {#r_GlideFormClearOptions_String__table_bdt_v3d_5s} {#r_GlideFormClearOptions_String__table_cdt_v3d_5s__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 30. 返される内容] {#r_GlideFormClearOptions_String__table_cdt_v3d_5s} ## GlideForm - clearValue(文字列 fieldName) {#ariaid-title17} 指定されたフィールドから値を削除します。 注: このメソッドは、厳格読み取り専用に設定されたフィールドを更新するために使用できません。このメソッドが厳格な読み取り専用フィールドで呼び出された場合、フィールドは更新されず、警告がブラウザーコンソールに記録されます。詳細については、「[Configuring read-only security options](https://www.servicenow.com/docs/access?context=read-only-option&version=australia&pubname=australia-platform-administration&ft:locale=en-US)」を参照してください。 {#r_GlideFormClearValue_String__table_tlr_znc_5s__entry__3}{#r_GlideFormClearValue_String__g_form-clearValue-fieldName-entry} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | クリアするフィールドの名前。 | [表 : 31. パラメーター] {#r_GlideFormClearValue_String__table_tlr_znc_5s} {#r_GlideFormClearValue_String__table_ulr_znc_5s__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 32. 返される内容] {#r_GlideFormClearValue_String__table_ulr_znc_5s} ## GlideForm:disableAttachments() {#ariaid-title18} 添付ファイルがフォームに追加されないようにします。 このメソッドはモバイルプラットフォームでは利用できません。このメソッドがモバイルプラットフォームで実行されても、何も起こりません。 {#r_GlideFormDisableAttachments__table_ggk_bqd_5s__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 33. パラメーター] {#r_GlideFormDisableAttachments__table_ggk_bqd_5s} {#r_GlideFormDisableAttachments__table_hgk_bqd_5s__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 34. 返される内容] {#r_GlideFormDisableAttachments__table_hgk_bqd_5s} ## GlideForm:disableChoice(文字列 fieldName, 文字列 choiceValue) {#ariaid-title19} 選択肢が存在する場合、プログラムによりドロップダウン フィールドの特定の選択肢が無効になります。選択が既に無効になっている場合、変更は行われません。 {#GF-disableChoice_S_S__table_q2s_gds_rfc__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | 無効にする選択肢のフィールド名。 データタイプ：文字列 | | choiceValue | 文字列 | 無効にする選択肢の値。 データタイプ：文字列 | [表 : 35. パラメーター] {#GF-disableChoice_S_S__table_q2s_gds_rfc} {#GF-disableChoice_S_S__table_fvm_xbs_rfc__entry__2} | タイプ | 説明 | |-|-| | ブール | 指定された選択肢がフォームで無効かアクティブかを示すフラグ。 有効な値： * true:選択肢が無効です。 * false:オプションが既に無効になっているか、見つかりません。 データタイプ：ブーリアン | [表 : 36. 返される内容] {#GF-disableChoice_S_S__table_fvm_xbs_rfc} 次の例では、 disableChoice() を呼び出して、delivery_locationフォームフィールドのloading_dock選択肢を無効にします。 if (g_form.getValue('address_type') == 'home') { g_form.disableChoice('delivery_location', 'loading_dock'); } // Only itil_admin users can select the "Closed" option function onLoad() { if (g_user.hasRole('itil_admin')) return; if (g_form.getValue('incident_state') != '7') g_form.disableChoice('incident_state', 7); if (g_form.getValue('state') != '7') { g_form.disableChoice('state', 7); } } ## GlideForm - enableAttachments() {#ariaid-title20} 添付ファイルをフォームに追加することができます。ペーパークリップアイコンを表示します。 このメソッドはモバイルプラットフォームでは利用できません。このメソッドがモバイルプラットフォームで実行されても、何も起こりません。 {#r_GlideFormEnableAttachments__table_i3c_ppd_5s__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 37. パラメーター] {#r_GlideFormEnableAttachments__table_i3c_ppd_5s} {#r_GlideFormEnableAttachments__table_j3c_ppd_5s__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 38. 返される内容] {#r_GlideFormEnableAttachments__table_j3c_ppd_5s} ## GlideForm - enableChoice(文字列 fieldName, 文字列 choiceValue) {#ariaid-title21} 選択肢が存在する場合、プログラムによりドロップダウン フィールドで特定の選択肢が有効になります。このオプションが既に有効になっている場合は、変更は行われません。 {#GF-enableChoice_S_S__table_q2s_gds_rfc__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | 有効にする選択肢のフィールド名。 | | choiceValue | 文字列 | 有効にする選択肢の値。 | [表 : 39. パラメーター] {#GF-enableChoice_S_S__table_q2s_gds_rfc} {#GF-enableChoice_S_S__table_fvm_xbs_rfc__entry__2} | タイプ | 説明 | |-|-| | ブール | 指定された選択肢が正常に有効になっているかどうかを示すフラグ。 有効な値： * true:選択肢は有効です。 * false:選択肢が既に有効になっているか、見つかりません。 {#GF-enableChoice_S_S__ul_sxx_tcs_rfc} データタイプ：ブーリアン | [表 : 40. 返される内容] {#GF-enableChoice_S_S__table_fvm_xbs_rfc} 次の例では、enable() を呼び出して、`優先度`フォームフィールドで新しいドロップダウン選択肢 `1` を有効にします。 var shortDescription = g_form.getValue('shortDescription'); // Allow priority 1 selection if short description mentions security if (shortDescription.includes('security')) { var p1Choice = g_form.getChoice('priority', '1'); g_form.enableChoice('priority', '1'); } ## GlideForm - flash(文字列 fieldName, 文字列 color, 数値 count) {#ariaid-title22} フィールドに注意を引くために使用します。指定されたフィールドを指定された時間、指定された色で点滅させます。 このメソッドは サービスカタログ ではサポートされていません。 このメソッドはモバイルプラットフォームでは利用できません。このメソッドがモバイルプラットフォームで実行されても、何も起こりません。 {#r_GlideFormFlash_String_String_Number__table_htn_w2w_ts__entry__3}{#r_GlideFormFlash_String_String_Number__g_form-flash-fieldName-entry}{#r_GlideFormFlash_String_String_Number__g_form-flash-color-entry}{#r_GlideFormFlash_String_String_Number__g_form-flash-count-entry} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | `「.」`の形式でハイライト表示するフィールド。 | | 色 | 文字列 | RGB カラーまたは許容される CSS カラー。 | | カウント | 番号 | ラベルが点滅する時間。 有効な値： * 2：1 秒間点滅 * 0:2秒間点滅 * -2:3秒間点滅 * -4：4 秒間点滅 {#r_GlideFormFlash_String_String_Number__ul_idd_sqg_5fc} | [表 : 41. パラメーター] {#r_GlideFormFlash_String_String_Number__table_htn_w2w_ts} {#r_GlideFormFlash_String_String_Number__table_itn_w2w_ts__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 42. 返される内容] {#r_GlideFormFlash_String_String_Number__table_itn_w2w_ts} g_form.flash("incident.number", "#FFFACD", 0); ## GlideForm:getActionName() {#ariaid-title23} 最新のアクション名を返します。クライアントスクリプトの場合はクリックされた UI アクションの sys_id を返します。 注: ウィザードクライアントスクリプトでは使用できません。 {#r_GlideFormGetActionName__table_zhn_xjd_5s__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 43. パラメーター] {#r_GlideFormGetActionName__table_zhn_xjd_5s} {#r_GlideFormGetActionName__table_a3n_xjd_5s__entry__2} | タイプ | 説明 | |-|-| | 文字列 | クリックされた UI アクションの現在のアクション名または UI アクションのsys_id。 | [表 : 44. 返される内容] {#r_GlideFormGetActionName__table_a3n_xjd_5s} function onSubmit() { var action = g_form.getActionName(); alert('You pressed ' + action); } ## GlideForm - getAnnotationByName(文字列名) {#ariaid-title24} 指定された名前のフォーム注釈を返します。 [注釈](https://www.servicenow.com/docs/access?context=configure-form-layout&version=australia&pubname=australia-platform-administration§ion=t_AddAFormAnnotation&ft:locale=en-US) は、フォーム要素間の視覚的なセパレーター、またはフォーム要素を強調表示するために使用される色付きのテキストのブロックです。[GlideForm - getAnnotationByName(文字列名)](https://servicenow-prod.fluidtopics.net/TOJ5TIb2BhZv_76tquWNCA#GF-getAnnotationByName_S "指定された名前のフォーム注釈を返します。")を使用して、フォーム内のすべての注釈を返します。 {#GF-getAnnotationByName_S__table_skr_c4l_rfc__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | 名前 | 文字列 | 返される注釈の名前。 テーブル:フォーム注釈 \[sys_ui_annotation\]、フィールド: 名前 | [表 : 45. パラメーター] {#GF-getAnnotationByName_S__table_skr_c4l_rfc} {#GF-getAnnotationByName_S__table_irm_qnl_rfc__entry__2} | プロパティ | 説明 | |-|-| | オブジェクトのアレイ | 注釈のコンテンツ。 データタイプ：オブジェクトのアレイ [{content: "String", name: "String", visible: Boolean}] | | array.content | 返される注釈のテキスト。 データタイプ：文字列 | | array.name | 返される注釈の名前。 データタイプ：文字列 テーブルの場所:フォーム注釈 \[sys_ui_annotation\]、フィールド: 名前 | | array.visible | 注釈がフォームに表示されるかどうかを示すフラグ。 有効な値： * true:注釈は表示されます。 * false:注釈は表示されません。 {#GF-getAnnotationByName_S__ul_z2j_4tl_rfc} データタイプ：ブーリアン | [表 : 46. 返される内容] {#GF-getAnnotationByName_S__table_irm_qnl_rfc} 次の例は、 getAnnotationByName() メソッドを使用して、指定された名前 test-annotation-msg-1 に従ってフォーム注釈を取得する方法を示しています。 var sampleAnnotation = g_form.getAnnotationByName("test-annotation-msg-1"); /* returns: { "name": "test-annotation-msg-1", "visible": true, "content": "Test" } */ ## GlideForm:getAnnotations() {#ariaid-title25} フォーム上のすべての注釈のリストを返します。 [注釈](https://www.servicenow.com/docs/access?context=configure-form-layout&version=australia&pubname=australia-platform-administration§ion=t_AddAFormAnnotation&ft:locale=en-US) は、フォーム要素間の視覚的なセパレーター、またはフォーム要素を強調表示するために使用される色付きのテキストのブロックです。[GlideForm - getAnnotationByName(文字列名)](https://servicenow-prod.fluidtopics.net/TOJ5TIb2BhZv_76tquWNCA#GF-getAnnotationByName_S "指定された名前のフォーム注釈を返します。")を使用して、特定の注釈をその名前で返します。 {#GF-getAnnotations__table_hrm_qnl_rfc__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 47. パラメーター] {#GF-getAnnotations__table_hrm_qnl_rfc} {#GF-getAnnotations__table_irm_qnl_rfc__entry__2} | プロパティ | 説明 | |-|-| | オブジェクトのアレイ | 注釈のコンテンツ。 データタイプ：オブジェクトのアレイ [{content: "String", name: "String", visible: Boolean}] | | array.content | 返される注釈のテキスト。 データタイプ：文字列 | | array.name | 返される注釈の名前。 データタイプ：文字列 テーブルの場所:フォーム注釈 \[sys_ui_annotation\]、フィールド: 名前 | | array.visible | 注釈がフォームに表示されるかどうかを示すフラグ。 有効な値： * true:注釈は表示されます。 * false:注釈は表示されません。 {#GF-getAnnotations__ul_z2j_4tl_rfc} データタイプ：ブーリアン | [表 : 48. 戻り値] {#GF-getAnnotations__table_irm_qnl_rfc} 次の例では、最初に getAnnotations() を呼び出してフォーム内のすべての注釈を返し、 次に hideAnnotation() を呼び出してフォーム内のすべての注釈を非表示にします。 const annotations = getAnnotations(); /* returns: [ { "name": "test-annotation-msg-1", "visible": true, "content": "Test" }, { "name": "test-annotation-msg-2", "visible": true, "content": "Test 2" } ]*/ annotations.forEach(function(annotation) { g_form.hideAnnotation(annotation.name); }); // this script hides all annotations on the form. ## GlideForm - getBooleanValue(文字列 fieldName) {#ariaid-title26} 指定されたフィールドのブーリアン値を返します。 {#r_GlideFormGetBooleanValue_String__table_vfk_25b_5s__entry__3}{#r_GlideFormGetBooleanValue_String__g_form-getBooleanValue-fieldName-entry} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | `「.」`の形式でハイライト表示するフィールド。 | [表 : 49. パラメーター] {#r_GlideFormGetBooleanValue_String__table_vfk_25b_5s} {#r_GlideFormGetBooleanValue_String__table_wfk_25b_5s__entry__2} | タイプ | 説明 | |-|-| | ブール | フィールド値が false または undefined の場合は false を返します。それ以外の場合は true を返します。 | [表 : 50. 返される内容] {#r_GlideFormGetBooleanValue_String__table_wfk_25b_5s} ## GlideForm:getChoice(文字列 fieldName, 文字列 choiceValue) {#ariaid-title27} 指定されたフィールドと選択値を表すプロパティを持つオブジェクトを返します。 {#GF-getChoice_S_S__table_evm_xbs_rfc__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | 取得する選択肢のフィールド名。 | | choiceValue | 文字列 | 取得する選択肢の値。 | [表 : 51. パラメーター] {#GF-getChoice_S_S__table_evm_xbs_rfc} {#GF-getChoice_S_S__table_fvm_xbs_rfc__entry__2} | プロパティ | 説明 | |-|-| | GlideFormChoice オブジェクトまたは null | 指定されたフィールドと選択値の GlideFormChoice オブジェクト。一致する選択肢がない場合は null を返します。 データタイプ: オブジェクト ("label", "value", "disabled", "index") | | GlideFormChoice.label | 選択した読み取り専用表示テキスト。 データタイプ：文字列 | | GlideFormChoice.value | 選択肢の読み取り専用値。 データタイプ：文字列 | | GlideFormChoice.disabled | フォームで選択肢が無効かどうかを示すフラグ。 有効な値： * true:選択肢が無効です * false:選択は有効です。 {#GF-getChoice_S_S__ul_xzv_rbz_tfc} データタイプ：ブーリアン | | GlideFormChoice.index | ドロップダウン内の選択肢の位置を示します。 データタイプ：数値 | [表 : 52. 返される内容] {#GF-getChoice_S_S__table_fvm_xbs_rfc} 次の例では、enable() を呼び出して、`優先度`フォームフィールドで新しいドロップダウン選択肢 `1` を有効にします。 var shortDescription = g_form.getValue('shortDescription'); // Allow priority 1 selection if short description mentions security if (shortDescription.includes('security')) { var p1Choice = g_form.getChoice('priority', '1'); g_form.enableChoice('priority', '1'); } ## GlideForm - getControl(文字列 fieldName) {#ariaid-title28} 指定されたフィールドの HTML 要素を返します。 複合フィールドには、複数の HTML 要素が含まれている場合があります。フォーム上でフィールドを使用する組み込みメソッドがあるため、このメソッドは通常必要ありません。 フィールドが参照フィールドで、コントロールが選択リストの場合、 getControl() は 想定どおりにコントロールを返さないことがあります。この場合、`sys_select..<フィールド名>` を使用します。 このメソッドは、モバイルスクリプトまたは サービスポータル スクリプトでは使用できません。 {#r_GlideFormGetControl_String__table_lzt_x5b_5s__entry__3}{#r_GlideFormGetControl_String__g_form-getControl-fieldName-entry} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | HTML 要素を返すフィールドの名前。 | [表 : 53. パラメーター] {#r_GlideFormGetControl_String__table_lzt_x5b_5s} {#r_GlideFormGetControl_String__table_mzt_x5b_5s__entry__2}{#r_GlideFormGetControl_String__g_form-getControl-returns-HTMLElement-entry} | タイプ | 説明 | |-|-| | HTML リリース | フィールドの HTML 要素。 | [表 : 54. 返される内容] {#r_GlideFormGetControl_String__table_mzt_x5b_5s} ## GlideForm - getDecimalValue(文字列 fieldName) {#ariaid-title29} 指定されたフィールドの 10 進数値を返します。 {#r_GlideFormGetDecimalValue_String__table_izt_31c_5s__entry__3}{#r_GlideFormGetDecimalValue_String__g_form-getDecimalValue-fieldName-entry} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | 10 進数値を返すフィールドの名前。 | [表 : 55. パラメーター] {#r_GlideFormGetDecimalValue_String__table_izt_31c_5s} {#r_GlideFormGetDecimalValue_String__table_jzt_31c_5s__entry__2} | タイプ | 説明 | |-|-| | 文字列 | 指定されたフィールドの 10 進数値。 | [表 : 56. 返される内容] {#r_GlideFormGetDecimalValue_String__table_jzt_31c_5s} function onChange(control, oldValue, newValue, isLoading) { alert(g_form.getDecimalValue('percent_complete')); } ## GlideForm - getDisplayBox(文字列 fieldName) {#ariaid-title30} コア UI のフォームから表示値を返します。 注: サービスポータル のフォームから表示値を取得するには、[getDisplayValue()](https://servicenow-prod.fluidtopics.net/TOJ5TIb2BhZv_76tquWNCA#GF-getDisplayValue_S "サービスポータルフォームから表示値を返します。") メソッドを使用します。 関連項目： * [getValue()](https://servicenow-prod.fluidtopics.net/TOJ5TIb2BhZv_76tquWNCA#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 | 文字列 | | [表 : 57. パラメーター] {#GF-getDisplayBox_S__table_nf2_bfp_zw} {#GF-getDisplayBox_S__table_ydf_qpc_5s__entry__2} | タイプ | 説明 | |-|-| | なし | フォーム内の値を取得するフィールドの名前。 | [表 : 58. 返される内容] {#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(文字列 fieldName) {#ariaid-title31} サービスポータルフォームから表示値を返します。 関連項目： * [getValue()](https://servicenow-prod.fluidtopics.net/TOJ5TIb2BhZv_76tquWNCA#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}{#GF-getDisplayValue_S__g_form-getDisplayValue-fieldName-entry} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | フォームで値を取得するフィールドの名前。 | [表 : 59. パラメーター] {#GF-getDisplayValue_S__table_nf2_bfp_zw} {#GF-getDisplayValue_S__table_ydf_qpc_5s__entry__2} | タイプ | 説明 | |-|-| | 文字列 | 指定したフィールドの表示値。 | [表 : 60. 返される内容] {#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-title32} パラメーターで指定された HTML 要素を返します。 複合フィールドには、複数の HTML 要素が含まれている場合があります。フォーム上でフィールドを使用する組み込みメソッドがあるため、このメソッドは通常必要ありません。 このメソッドは、モバイルスクリプトまたは サービスポータル スクリプトでは使用できません。 {#r_GlideFormGetElement_String__table_l1k_vvb_5s__entry__3}{#r_GlideFormGetElement_String__g_form-getElement-id-entry} | 名前 | タイプ | 説明 | |-|-|-| | ID | 文字列 | フィールド ID。 | [表 : 61. パラメーター] {#r_GlideFormGetElement_String__table_l1k_vvb_5s} {#r_GlideFormGetElement_String__table_m1k_vvb_5s__entry__2}{#r_GlideFormGetElement_String__g_form-getElement-returns-HTMLElement-entry} | タイプ | 説明 | |-|-| | HTML リリース | フィールドの HTML 要素。 | [表 : 62. 返される内容] {#r_GlideFormGetElement_String__table_m1k_vvb_5s} ## GlideForm - getFormElement() {#ariaid-title33} フォームの HTML 要素を返します。 このメソッドは、モバイルスクリプトまたは サービスポータル スクリプトでは使用できません。 {#r_GlideFormGetFormElement__table_fs4_kkd_5s__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 63. パラメーター] {#r_GlideFormGetFormElement__table_fs4_kkd_5s} {#r_GlideFormGetFormElement__table_gs4_kkd_5s__entry__2}{#r_GlideFormGetFormElement__g_form-getFormElement-returns-HTMLElement-entry} | タイプ | 説明 | |-|-| | HTMLFormElement | フォームの HTML 要素。 | [表 : 64. 返される内容] {#r_GlideFormGetFormElement__table_gs4_kkd_5s} ## GlideForm - getHelpTextControl(文字列 fieldName) {#ariaid-title34} 指定されたフィールドのヘルプテキストの HTML 要素を返します。 このメソッドは、サービスカタログ変数にのみ適用できます。 {#r_GF-getHelpTextControl_S__table_nf2_bfp_zw__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | フィールドの名前 | [表 : 65. パラメーター] {#r_GF-getHelpTextControl_S__table_nf2_bfp_zw} {#r_GF-getHelpTextControl_S__table_of2_bfp_zw__entry__2} | タイプ | 説明 | |-|-| | HTML リリース | ヘルプテキストフィールドの HTML 要素。 | [表 : 66. 返される内容] {#r_GF-getHelpTextControl_S__table_of2_bfp_zw} ## GlideForm - getIntValue(文字列 fieldName) {#ariaid-title35} 指定されたフィールドの整数値を返します。 {#r_GlideFormGetIntValue_String__table_unc_nwb_5s__entry__3}{#r_GlideFormGetIntValue_String__g_form-getIntValue-fieldName-entry} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | フィールド名。 | [表 : 67. パラメーター] {#r_GlideFormGetIntValue_String__table_unc_nwb_5s} {#r_GlideFormGetIntValue_String__table_vnc_nwb_5s__entry__2}{#r_GlideFormGetIntValue_String__g_form-getIntValue-returns-entry} | タイプ | 説明 | |-|-| | 番号 | フィールドの整数値。 | [表 : 68. 返される内容] {#r_GlideFormGetIntValue_String__table_vnc_nwb_5s} ## GlideForm - getLabelOf(文字列 fieldName) {#ariaid-title36} フィールドラベルのプレーンテキスト値を返します。 {#r_GlideFormGetLabelOf_String__table_gfz_kgw_ts__entry__3}{#r_GlideFormGetLabelOf_String__g_form-getLabelOf-fieldName-entry} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | フィールド名。 | [表 : 69. パラメーター] {#r_GlideFormGetLabelOf_String__table_gfz_kgw_ts} {#r_GlideFormGetLabelOf_String__table_hfz_kgw_ts__entry__2}{#r_GlideFormGetLabelOf_String__g_form-getLabelOf-returns-entry} | タイプ | 説明 | |-|-| | 文字列 | ラベルテキスト。 | [表 : 70. 返される内容] {#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, 文字列 choiceValue) {#ariaid-title37} choiceValue がオプション値と一致する、fieldName という名前の選択されたボックスのオプション要素を返します。 注: このメソッドは読み取り専用フィールドでは機能しません。 {#r_GlideFormGetOption_String_String__table_u1p_1xb_5s__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | フィールドの名前 | | choiceValue | 文字列 | オプションの値。 | [表 : 71. パラメーター] {#r_GlideFormGetOption_String_String__table_u1p_1xb_5s} {#r_GlideFormGetOption_String_String__table_v1p_1xb_5s__entry__2} | タイプ | 説明 | |-|-| | HTML リリース | オプションの HTMLElement。フィールドまたはオプションが見つからない場合は null を返します。 | [表 : 72. 返される内容] {#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 - getOptions(文字列 fieldName) {#ariaid-title38} フォームの選択肢フィールドまたは参照フィールドで使用可能なオプションと選択されたオプションを返します。この方法は、動的フォーム、カタログ変数と変数セット、および実行時にフィールドオプションの検査またはフィルタリングを必要とする統合に役立ちます。 たとえば、 g_form.getOptions() を使用して次のことができます。 * watch_listフィールドタイプの名前と値のペアを取得および設定します。 * 利用可能なオプションを検索用語で検索またはフィルタリングします。 * コールバックを介して同じオートコンプリート結果にアクセスできるようにします。 * 選択フィールド、参照フィールド、および高度なフィールドタイプ (watch_list、glide_list、field_list、スラッシュバケットなど) のオプションを取得および設定します。 {#GF-getOptions_S__ul_rgd_24f_wfc} {#GF-getOptions_S__table_dz3_jyr_rfc__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | 取得する選択肢または参照フィールドのフィールド名。 | [表 : 73. パラメーター] {#GF-getOptions_S__table_dz3_jyr_rfc} {#GF-getOptions_S__table_ez3_jyr_rfc__entry__2} | プロパティ | 説明 | |-|-| | オブジェクトのアレイまたは null | 選択した各オプションの値とラベルを含む、読み取り専用のオブジェクトのアレイ。フィールドがオプションをサポートしていない場合は null を返します。 データタイプ：オブジェクトのアレイ [{value: "String", displayValue: "String"}] | | array.displayValue | 選択肢の表示値。 データタイプ：文字列 | | array.value | オプションの値。 データタイプ：文字列 | | getAvailable (用語) | 利用可能なすべてのオプションを返すための関数。検索用語は、表示値 (大文字と小文字を区別しないサブ文字列の一致) でオプションをフィルタリングするための引数として指定できます。一致する選択肢の表示値と値を持つオブジェクトの配列の Promise を返します。 データタイプ：オブジェクトのアレイ [{value: "String", displayValue: "String"}] | [表 : 74. 返される内容] {#GF-getOptions_S__table_ez3_jyr_rfc} 次の例では、 g_form.getOptions() を呼び出して、指定されたフォームフィールド (ステータス、work_notes_listなど) で使用可能なすべての選択肢を返します。 g_form.getOptions("state"); //table: incident, field: state, type: integer, choice: Dropdown without --None-- /* returns [{"value":"1","displayValue":"New"},{"value":"2","displayValue":"In Progress"},{"value":"3","displayValue":"On Hold"},{"value":"6","displayValue":"Resolved"},{"value":"7","displayValue":"Closed"},{"value":"8","displayValue":"Canceled"}] */ g_form.getOptions("category"); //table: incident, field: category, type: string, choice: Dropdown with --None-- /* returns [{"value":"","displayValue":"-- None --"},{"value":"inquiry","displayValue":"Inquiry / Help"},{"value":"software","displayValue":"Software"},{"value":"hardware","displayValue":"Hardware"},{"value":"network","displayValue":"Network"},{"value":"database","displayValue":"Database"}] */ g_form.getOptions("work_notes_list") //table: incident, field: work_notes_list, type: glide_list /* returns [{"value":"62826bf03710200044e0bfc8bcbe5df1","displayValue":"Abel Tuter"},{"value":"a8f98bb0eb32010045e1a5115206fe3a","displayValue":"Abraham Lincoln"},{"value":"5137153cc611227c000bbd1bd8cd2005","displayValue":"Fred Luddy"},{"value":"6a826bf03710200044e0bfc8bcbe5dec","displayValue":"Alissa Mountjoy"}] */ g_form.getOptions("restricted_fields") //table: std_change_properties, field: restricted_fields, type: field_list /* [{"value":"activity_due","displayValue":"Activity due"},{"value":"additional_assignee_list","displayValue":"Additional assignee list"},{"value":"comments","displayValue":"Additional comments"},{"value":"assignment_group","displayValue":"Assignment group"},{"value":"backout_plan","displayValue":"Backout plan"},{"value":"business_duration","displayValue":"Business duration"},{"value":"cab_delegate","displayValue":"CAB delegate"},...] */ g_form.getOptions('table') //table: sys_script_client, field: table, type: table_name /* [{"value":"","displayValue":"-- None --"},{"value":"cmdb_ci_appl_dot_net","displayValue":".NET Application [cmdb_ci_appl_dot_net]"},{"value":"evaluation","displayValue":"A/B Testing Evaluation [evaluation]"},{"value":"evaluation_execution","displayValue":"A/B Testing Evaluation Execution [evaluation_execution]"},{"value":"evaluation_parameter","displayValue":"A/B Testing Evaluation Parameter [evaluation_parameter]"},{"value":"sn_access_analyzer_request","displayValue":"Access Analyzer Query [sn_access_analyzer_request]"},{"value":"sn_access_analyzer_access_comparison_request","displayValue":"Access Comparison Request [sn_access_analyzer_access_comparison_request]"},{"value":"sys_security_acl","displayValue":"Access Control [sys_security_acl]"},...] */ g_form.getOptions('mandatory_fields'); //table: kb_knowledge_base, field: mandatory_fields, type: slushbucket /* [{"value":"active","displayValue":"Active"},{"value":"article_id","displayValue":"Article ID"},{"value":"displayValue","displayValue":"Article body"},{"value":"article_type","displayValue":"Article type"},{"value":"direct","displayValue":"Attachment link"},{"value":"author","displayValue":"Author"},{"value":"base_version","displayValue":"Base Version"},...] */ 次のスクリプト例は、getAvailable() 関数を使用して g_form.getOptions() を呼び出す方法を示しています。 const options = g_form.getOptions('priority'); if (options) { console.log('Selected:', options.selected); options.getAvailable('high').then(available => { console.log('Available matching "high":', available); }); } ## GlideForm - getReference(文字列 fieldName, 関数 callBack) {#ariaid-title39} 指定されたフィールドの GlideRecord を返します。 コールバック関数が存在する場合、このルーチンは非同期で実行されます。ブラウザー (およびスクリプト) の処理は、サーバーが参照値を返すまで正常に続行され、その時点でコールバック関数が呼び出されます。コールバック関数が存在しない場合、このルーチンは同期的に実行され、サーバーの応答を待っている間に処理が停止します (ブラウザーがハングアップしたように見えます)。 重要: コールバック関数を使用することを強くお勧めします。 ServiceCatalogForm.getReference のコールバック関数サポートが利用可能です。 注: この方法を使用すると、サーバーを呼び出す必要があり、追加の時間が必要になり、ページにレイテンシーが発生する可能性があります。この方法は慎重に使用してください。詳細については、「 [クライアントスクリプトの設計と処理](https://servicenow-prod.fluidtopics.net/gU4dX0nl5SDMyf3IPu2FRQ#client-script-best-practices "クライアントスクリプトを適切に設計すれば、ユーザーのフォーム入力時間を短縮できます。")」を参照してください。 {#r_GlideForm-GetReference_S_F__table_k4c_1yb_5s__entry__3}{#r_GlideForm-GetReference_S_F__g_form-getReference-fieldName-entry}{#r_GlideForm-GetReference_S_F__g_form-getReference-callBack-entry} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | フィールドの名前 | | コールバック | 関数 | コールバック関数の名前。 | [表 : 75. パラメーター] {#r_GlideForm-GetReference_S_F__table_k4c_1yb_5s} {#r_GlideForm-GetReference_S_F__table_l4c_1yb_5s__entry__2}{#r_GlideForm-GetReference_S_F__g_form-getReference-returns-entry} | タイプ | 説明 | |-|-| | GlideRecord | 指定されたフィールドの GlideRecord オブジェクト。 指定された参照が見つからない場合は、 `currentRow = -1` および `rows.length = 0` の初期化された GlideRecord オブジェクトを返します。 | [表 : 76. 返される内容] {#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-title40} 現在のフォームから関連リスト名のアレイを返します。 {#GF-getRelatedListNames__table_vfp_grv_dhb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 77. パラメーター] {#GF-getRelatedListNames__table_vfp_grv_dhb} {#GF-getRelatedListNames__table_wfp_grv_dhb__entry__2}{#GF-getRelatedListNames__g_form-getRelatedListNames-returns-entry} | タイプ | 説明 | |-|-| | 文字列のアレイ | 現在のフォームの関連リスト名のリスト。関連リスト名はフォームに表示される順序で一覧表示されます。 | [表 : 78. 返される内容] {#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-title41} 表示されるかどうかにかかわらず、すべてのセクション名を返します。 {#r_GlideFormGetSectionNames__table_rsg_vkd_5s__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 79. パラメーター] {#r_GlideFormGetSectionNames__table_rsg_vkd_5s} {#r_GlideFormGetSectionNames__table_ssg_vkd_5s__entry__2}{#r_GlideFormGetSectionNames__g_form-getSectionNames-returns-entry} | タイプ | 説明 | |-|-| | 文字列のアレイ | セクション名。 | [表 : 80. 返される内容] {#r_GlideFormGetSectionNames__table_ssg_vkd_5s} ## GlideForm - getSections() {#ariaid-title42} フォームのセクションのアレイを返します。 このメソッドはモバイルプラットフォームでは利用できません。このメソッドがモバイルプラットフォームで実行されても、何も起こりません。 {#r_GlideFormGetSections__table_sg4_hld_5s__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 81. パラメーター] {#r_GlideFormGetSections__table_sg4_hld_5s} {#r_GlideFormGetSections__table_tg4_hld_5s__entry__2}{#r_GlideFormGetSections__g_form-getSections-returns-entry} | タイプ | 説明 | |-|-| | HTML 要素のアレイ | フォームのセクション。 | [表 : 82. 返される内容] {#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-title43} このレコードが属するテーブルの名前を返します。 サーバー側では、 current.sys_class_name または current.getTableName() を使用して現在のレコードのテーブルを取得できます。 {#r_GlideFormGetTableName__table_gqk_5ld_5s__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 83. パラメーター] {#r_GlideFormGetTableName__table_gqk_5ld_5s} {#r_GlideFormGetTableName__table_hqk_5ld_5s__entry__2}{#r_GlideFormGetTableName__g_form-getTableName-returns-entry} | タイプ | 説明 | |-|-| | 文字列 | テーブルの名前。 | [表 : 84. 返される内容] {#r_GlideFormGetTableName__table_hqk_5ld_5s} function onLoad() { if (g_form.isNewRecord()) { var tableName = g_form.getTableName(); //Get the table name } } ## GlideForm:getUniqueValue() {#ariaid-title44} フォームに表示されているレコードの sys_id を返します。 {#r_GlideFormGetUniqueValue__table_xxg_lmd_5s__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 85. パラメーター] {#r_GlideFormGetUniqueValue__table_xxg_lmd_5s} {#r_GlideFormGetUniqueValue__table_yxg_lmd_5s__entry__2}{#r_GlideFormGetUniqueValue__g_form-getUniqueValue-returns-entry} | タイプ | 説明 | |-|-| | 文字列 | レコードのsys_id。 | [表 : 86. 返される内容] {#r_GlideFormGetUniqueValue__table_yxg_lmd_5s} function onLoad() { var incSysid = g_form.getUniqueValue(); alert(incSysid); } ## GlideForm - getValue(文字列 fieldName) {#ariaid-title45} 指定されたフォームフィールドの値を返します。 このメソッドでは、複数行の変数セット (MRVS) からの値の取得もサポートされています。MRVS 内のフィールドからデータを取得するには、まず `JSON.parse(getValue('') ||'[]')` を使用して MRVS アレイを取得し、インデックス作成を使用して行オブジェクト内のフィールドにアクセスします。詳細については、以下のコード例を参照してください。 {#r_GlideFormGetValue_String__table_nxm_wzb_5s__entry__3}{#r_GlideFormGetValue_String__g_form-getValue-fieldName-entry} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | 値を返すフィールドの名前。 | [表 : 87. パラメーター] {#r_GlideFormGetValue_String__table_nxm_wzb_5s} {#r_GlideFormGetValue_String__table_oxm_wzb_5s__entry__2}{#r_GlideFormGetValue_String__g_form-getValue-returns-entry} | タイプ | 説明 | |-|-| | 文字列 | 指定されたフィールドの値。 | [表 : 88. 返される内容] {#r_GlideFormGetValue_String__table_oxm_wzb_5s} 次の例は、現在のフォームから簡単な説明を取得する方法を示しています。 function onChange(control, oldValue, newValue, isLoading) { alert(g_form.getValue('short_description')); } 次の例は、MRVS から値を取得する方法を示しています。この例では、給与はサービスカタログを通じて管理されています。クライアントスクリプトは、MRVS 内のすべての行で ジョブタイトル に入力された値を検索し、MRVS 内の一致するエントリーを \[ 給与\] フィールドに入力した値で更新します。MRVS の名前は「variable_set_1」で、各行オブジェクト内に従業員名 \[employee_name\]、役職 \[employee_job_title\]、給与 \[employee_salary\] のフィールドが含まれています。さらに、カタログアイテムには、役職 \[job_title\] と給与 \[給与\] が含まれます。 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-title46} すべてのフィールドメッセージを非表示にします。 {#r_GlideFormHideAllFieldMsgs__table_mr1_3hw_ts__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 89. パラメーター] {#r_GlideFormHideAllFieldMsgs__table_mr1_3hw_ts} {#r_GlideFormHideAllFieldMsgs__table_nr1_3hw_ts__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 90. 返される内容] {#r_GlideFormHideAllFieldMsgs__table_nr1_3hw_ts} ## GlideForm - hideAllFieldMsgs(文字列 type) {#ariaid-title47} 指定されたタイプのすべてのフィールドメッセージを非表示にします。 {#r_GlideFormHideAllFieldMsgs_String__table_y2c_qhw_ts__entry__3}{#r_GlideFormHideAllFieldMsgs_String__g_form-hideAllFieldMsgs_S-type-entry} | 名前 | タイプ | 説明 | |-|-|-| | タイプ | 文字列 | \>メッセージのタイプ。 有効な値： * エラー * 情報 {#r_GlideFormHideAllFieldMsgs_String__ul_rgd_sqg_5fc} | [表 : 91. パラメーター] {#r_GlideFormHideAllFieldMsgs_String__table_y2c_qhw_ts} {#r_GlideFormHideAllFieldMsgs_String__table_z2c_qhw_ts__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 92. 返される内容] {#r_GlideFormHideAllFieldMsgs_String__table_z2c_qhw_ts} ## GlideForm - hideAnnotation(文字列名) {#ariaid-title48} 指定された名前の注釈をフォーム UI で非表示にします。 [注釈](https://www.servicenow.com/docs/access?context=configure-form-layout&version=australia&pubname=australia-platform-administration§ion=t_AddAFormAnnotation&ft:locale=en-US) は、フォーム要素間の視覚的なセパレーター、またはフォーム要素を強調表示するために使用される色付きのテキストのブロックです。関連項目： * [GlideForm - showErrorBox(文字列 name, 文字列 message, ブーリアン scrollForm)](https://servicenow-prod.fluidtopics.net/TOJ5TIb2BhZv_76tquWNCA#r_GF-ShowErrorBox_S_S_B "指定されたフォームフィールド (コントロールオブジェクトまたはフィールドの名前) の下にエラーメッセージを表示します。コントロールまたはフィールドが現在画面外にあり、 scrollForm パラメーターが true の場合、フォームはコントロールまたはフィールドまでスクロールします。") をクリックして、フォームに特定の注釈を表示します。 * [GlideForm:toggleAnnotations()](https://servicenow-prod.fluidtopics.net/TOJ5TIb2BhZv_76tquWNCA#GF-toggleAnnotations "フォーム上のすべての注釈を表示または非表示にします。") により、注釈のオンとオフをより柔軟に切り替えることができます。 {#GF-hideAnnotation_S__ul_iqn_jmf_wfc} {#GF-hideAnnotation_S__table_isv_1nt_rfc__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | 名前 | 文字列 | フォームで非表示にする注釈の名前。 テーブル:フォーム注釈 \[sys_ui_annotation\]、フィールド: 名前 | [表 : 93. パラメーター] {#GF-hideAnnotation_S__table_isv_1nt_rfc} {#GF-hideAnnotation_S__table_ovh_cnt_rfc__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 94. 返される内容] {#GF-hideAnnotation_S__table_ovh_cnt_rfc} 次の例は、 hideAnnotation() メソッドを使用して、フォームフィールド上の test-annotation-msg-1 という名前のアノテーションをプログラムで非表示にする方法を示しています。 g_form.hideAnnotation('test-annotation-msg-1'); ## GlideForm - hideErrorBox(文字列 fieldName) {#ariaid-title49} showErrorBox() によって出されたエラーメッセージを非表示にします。 可能な限り、このメソッドではなく hideFieldMsg() を使用してください。 {#r_GlideFormHideErrorBox_String__table_kll_t4w_ts__entry__3}{#r_GlideFormHideErrorBox_String__g_form-hideErrorBox-fieldName-entry} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | エラーメッセージを非表示にするフィールドまたはコントロールの名前。 | [表 : 95. パラメーター] {#r_GlideFormHideErrorBox_String__table_kll_t4w_ts} {#r_GlideFormHideErrorBox_String__table_lll_t4w_ts__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 96. 返される内容] {#r_GlideFormHideErrorBox_String__table_lll_t4w_ts} ## GlideForm - hideFieldMsg(文字列 fieldName, ブーリアン clearAll) {#ariaid-title50} 現在のフォームの指定されたフィールドに表示される最初のメッセージを非表示にします。 フォームにメッセージを表示するには、 [GlideForm - showFieldMsg(文字列 field, 文字列 message, 文字列 type)](https://servicenow-prod.fluidtopics.net/TOJ5TIb2BhZv_76tquWNCA#r_GF-ShowFieldMsg_S_S_S "指定されたフォームフィールド (コントロールオブジェクトまたはフィールドの名前) の下にメッセージを表示します。コントロールまたはフィールドが画面外にある場合、メソッドはフォームをそのフィールドまで自動的にスクロールします。") メソッドまたは [GlideForm - showFieldMsg(文字列 field, 文字列 message, 文字列 type, ブーリアン scrollForm)](https://servicenow-prod.fluidtopics.net/TOJ5TIb2BhZv_76tquWNCA#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}{#r_GlideFormHideFieldMsg_String__g_form-hideFieldMsg-fieldName-entry}{#r_GlideFormHideFieldMsg_String__g_form-hideFieldMsg-clearAll-entry} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | メッセージを非表示にするフィールドの名前。 | | clearAll | ブーリアン | オプション。指定されたフィールドのすべてのメッセージを非表示にするかどうかを示すフラグ。 有効な値： * true:すべてのメッセージを非表示にします。 * false:表示される最初のメッセージのみを非表示にします。 {#r_GlideFormHideFieldMsg_String__ul_add_sqg_5fc} デフォルト値：false | [表 : 97. パラメーター] {#r_GlideFormHideFieldMsg_String__table_xnf_3pw_ts} {#r_GlideFormHideFieldMsg_String__table_ynf_3pw_ts__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 98. 返される内容] {#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:hideRelatedLinks() {#ariaid-title51} フォームの \[関連リンク\] セクションを非表示にします。 関連項目： * [GlideForm:showRelatedLinks()](https://servicenow-prod.fluidtopics.net/TOJ5TIb2BhZv_76tquWNCA#GF-showRelatedLinks "フォームの [関連リンク] セクションを表示します。") * [GlideForm:setRelatedLinksDisplay(ブール表示)](https://servicenow-prod.fluidtopics.net/TOJ5TIb2BhZv_76tquWNCA#GF-setRelatedLinksDisplay_B "ブール値を使用して、フォーム UI の [関連リンク] セクションを表示または非表示にします。") {#GF-hideRelatedLinks__ul_lbh_5hq_vfc} {#GF-hideRelatedLinks__table_zn5_jzs_rfc__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 99. パラメーター] {#GF-hideRelatedLinks__table_zn5_jzs_rfc} {#GF-hideRelatedLinks__table_a45_jzs_rfc__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 100. 返される内容] {#GF-hideRelatedLinks__table_a45_jzs_rfc} 次のスクリプト例では、現在のフォーム内の関連リンクを非表示にします。 // Hide related links g_form.hideRelatedLinks() ## GlideForm - hideRelatedList(文字列 listTableName) {#ariaid-title52} フォームの指定された関連リストを非表示にします。 このメソッドはモバイルプラットフォームでは利用できません。このメソッドがモバイルプラットフォームで実行されても、何も起こりません。 {#r_GlideFormHideRelatedList_String__table_syn_wqw_ts__entry__3}{#r_GlideFormHideRelatedList_String__g_form-hideRelatedList-listTableName-entry} | 名前 | タイプ | 説明 | |-|-|-| | listTableName | 文字列 | 関連リストの名前。sys_id を使用し、関係を介してリストを非表示にします。 | [表 : 101. パラメーター] {#r_GlideFormHideRelatedList_String__table_syn_wqw_ts} {#r_GlideFormHideRelatedList_String__table_tyn_wqw_ts__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 102. 返される内容] {#r_GlideFormHideRelatedList_String__table_tyn_wqw_ts} ## GlideForm:hideRelatedLists() {#ariaid-title53} フォーム上のすべての関連リストを非表示にします。 このメソッドはモバイルプラットフォームでは利用できません。このメソッドがモバイルプラットフォームで実行されても、何も起こりません。 {#r_GlideFormHideRelatedLists__table_zmg_jrw_ts__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 103. パラメーター] {#r_GlideFormHideRelatedLists__table_zmg_jrw_ts} {#r_GlideFormHideRelatedLists__table_ang_jrw_ts__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 104. 返される内容] {#r_GlideFormHideRelatedLists__table_ang_jrw_ts} ## GlideForm - hideTemplateBar() {#ariaid-title54} フォームのテンプレートバーを非表示にします。 {#GF-hideTemplateBar__table_ivb_s5g_5fc__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 105. パラメーター] {#GF-hideTemplateBar__table_ivb_s5g_5fc} {#GF-hideTemplateBar__table_jvb_s5g_5fc__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 106. 返される内容] {#GF-hideTemplateBar__table_jvb_s5g_5fc} 次のスクリプト例では、現在のフォームのテンプレートバーを非表示にします。 g_form.hideTemplateBar() ## GlideForm:isLiveUpdating() {#ariaid-title55} フォームに表示されているレコードのライブ更新中に true を返します。 これを onChange() クライアントスクリプトで使用して、レコードの変更が別のセッションからのライブ更新によるものかどうかを判断できます。クライアントスクリプトは、実行するアクションまたは実行しないアクションを決定できます。これは、ライブフォームが有効になっている コア UI を使用しているシステムに適用されます。 {#r_GF-isLiveUpdating__table_fjz_sks_kx__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 107. パラメーター] {#r_GF-isLiveUpdating__table_fjz_sks_kx} {#r_GF-isLiveUpdating__table_gjz_sks_kx__entry__2}{#r_GF-isLiveUpdating__g_form-isLiveUpdating-returns-entry} | タイプ | 説明 | |-|-| | ブール | フォームに表示されているレコードでライブ更新が行われている場合は true を返します。 | [表 : 108. 返される内容] {#r_GF-isLiveUpdating__table_gjz_sks_kx} ## GlideForm - isMandatory(文字列 fieldName) {#ariaid-title56} フィールドが必須の場合は true を返します。 必須フィールドは、フィールドラベルの横にあるアスタリスクによって視覚的に区別されます。アスタリスクは、フィールドが空の場合は赤で、フィールドが空でない場合は黒です。ユーザーがこれらのフィールドに入力せずにフォームを保存または送信しようとすると、検証メッセージが表示されます。詳細については、「[Form fields](https://www.servicenow.com/docs/access?context=c_FormFields&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US)」を参照してください。 {#r_GlideFormIsMandatory_String__table_kpt_nnc_5s__entry__3}{#r_GlideFormIsMandatory_String__g_form-isMandatory-fieldName-entry} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | フィールドの名前 | [表 : 109. パラメーター] {#r_GlideFormIsMandatory_String__table_kpt_nnc_5s} {#r_GlideFormIsMandatory_String__table_lpt_nnc_5s__entry__2}{#r_GlideFormIsMandatory_String__g_form-isMandatory-returns-entry} | タイプ | 説明 | |-|-| | ブール | フィールドが必須の場合は true、そうでない場合は false。 | [表 : 110. 返される内容] {#r_GlideFormIsMandatory_String__table_lpt_nnc_5s} ## GlideForm:isNewRecord() {#ariaid-title57} レコードが一度も保存されていない場合は true を返します。 {#r_GlideFormIsNewRecord__table_wlm_wmd_5s__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 111. パラメーター] {#r_GlideFormIsNewRecord__table_wlm_wmd_5s} {#r_GlideFormIsNewRecord__table_xlm_wmd_5s__entry__2}{#r_GlideFormIsNewRecord__g_form-isNewRecord-returns-entry} | タイプ | 説明 | |-|-| | ブール | レコードが保存されていない場合は true、それ以外の場合は false を返します。 | [表 : 112. 返される内容] {#r_GlideFormIsNewRecord__table_xlm_wmd_5s} function onLoad() { if(g_form.isNewRecord()){ alert('New Record!'); } } ## GlideForm:isSectionVisible(文字列 sectionName) {#ariaid-title58} セクションが表示されている場合は true を返します。 重要: isSectionVisible() 関数はワークスペースではサポートされていません。 {#r_GlideFormIsSectionVisible_String__table_msy_jnd_5s__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 113. パラメーター] {#r_GlideFormIsSectionVisible_String__table_msy_jnd_5s} {#r_GlideFormIsSectionVisible_String__table_nsy_jnd_5s__entry__2} | タイプ | 説明 | |-|-| | ブーリアン | セクションが表示されている場合は true を返します。それ以外の場合は false が返されます。 | [表 : 114. 返される内容] {#r_GlideFormIsSectionVisible_String__table_nsy_jnd_5s} ## GlideForm - isVisible(文字列 fieldName) {#ariaid-title59} 渡されたフィールド名に関連付けられたフィールドを現在のフォーム上に表示するかどうかを決定します。 {#GF-isVisible_S__table_ps3_gqy_m2c__entry__3}{#GF-isVisible_S__g_form-isVisible-fieldName-entry} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | 現在のフォームに表示されるかどうかを確認するフィールドの名前。 | [表 : 115. パラメーター] {#GF-isVisible_S__table_ps3_gqy_m2c} {#GF-isVisible_S__table_qs3_gqy_m2c__entry__2}{#GF-isVisible_S__g_form-isVisible-returns-entry} | タイプ | 説明 | |-|-| | ブール | 指定したフィールドが現在のフォーム上に表示されるかどうかを示すフラグ。 可能な値： * true:フィールドはフォームに表示されます。 * false:フィールドはフォームに表示されません。 {#GF-isVisible_S__ul_p1v_dhp_jfc} | [表 : 116. 返される内容] {#GF-isVisible_S__table_qs3_gqy_m2c} 次のコード例は、現在のフォームに `[user_address` \] フィールドが表示されているかどうかを確認する方法を示しています。 if(g_form.isVisible('user_address')) { alert('is visible'); } else { alert('is hidden'); } ## GlideForm - onUserChangeValue(関数 fn) {#ariaid-title60} 現在のフォーム内でいずれかのフィールドがユーザーによって変更されたことを検出するカスタムイベントリスナーを登録します。 フォームフィールドが変更されると、イベントリスナーはリスナーの初期登録時に渡された関数を呼び出します。このリスナーは、ユーザーがフォームのフィールドに変更を加えた場合にのみトリガーされます。クライアントスクリプト、UI ポリシー、またはその他のユーザー以外の操作による変更は、リスナーをトリガーしません。 注: このメソッドは、クラシック環境のジャーナルフィールドまたは サービスカタログ アイテムでは機能しません。 {#GF-onUserChangeValue_F__table_m5y_wll_1hb__entry__3}{#GF-onUserChangeValue_F__g_form-onUserChangeValue-fn-entry} | 名前 | タイプ | 説明 | |-|-|-| | fn | 関数 | ユーザーが現在のフォーム内のフィールドの値を変更したときに呼び出す関数。これは関数名だけでなく、実際には関数コードです。 この関数は、次の 3 つの引数を受け入れる必要があります。 * フィールド名 * 元のフィールド値 * 更新されたフィールド値 {#GF-onUserChangeValue_F__ul_k2d_sqg_5fc} | [表 : 117. パラメーター] {#GF-onUserChangeValue_F__table_m5y_wll_1hb} {#GF-onUserChangeValue_F__table_n5y_wll_1hb__entry__2}{#GF-onUserChangeValue_F__g_form-onUserChangeValue-returns-entry} | タイプ | 説明 | |-|-| | 関数 | onUserChangeValue イベントリスナーを登録解除するために呼び出す関数。 | [表 : 118. 返される内容] {#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-title61} リストコレクター変数を更新できます。 {#r_GF-refreshSlushbucket_S__table_n3v_plp_cv__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | スラッシュバケットの名前。 | [表 : 119. パラメーター] {#r_GF-refreshSlushbucket_S__table_n3v_plp_cv} {#r_GF-refreshSlushbucket_S__table_o3v_plp_cv__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 120. 返される内容] {#r_GF-refreshSlushbucket_S__table_o3v_plp_cv} g_form.refreshSlushbucket('bucket'); ## GlideForm - removeDecoration(文字列 fieldName, 文字列 icon, 文字列 title) {#ariaid-title62} 指定されたフィールドから、指定されたアイコンとタイトルに一致するアイコンを削除します。 注: このメソッドは サービスカタログ ではサポートされていません。 {#r_GF-RemoveDecoration_S_S_S__table_x23_vrw_ts__entry__3}{#r_GF-RemoveDecoration_S_S_S__g_form-removeDecoration-fieldName-entry}{#r_GF-RemoveDecoration_S_S_S__g_form-removeDecoration-icon-entry}{#r_GF-RemoveDecoration_S_S_S__g_form-removeDecoration-title-entry} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | 装飾を削除するフィールド名。 | | アイコン | 文字列 | 削除するアイコンの名前。 | | タイトル | 文字列 | アイコンのテキストタイトル (名前)。 | [表 : 121. パラメーター] {#r_GF-RemoveDecoration_S_S_S__table_x23_vrw_ts} {#r_GF-RemoveDecoration_S_S_S__table_y23_vrw_ts__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 122. 返される内容] {#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-title63} 指定されたフィールドから、指定されたアイコン、タイトル、および色に一致するアイコンを削除します。 注: このメソッドは サービスカタログ ではサポートされていません。 {#r_GF-RemoveDecoration_S_S_S_S__table_mcg_5zd_5s__entry__3}{#r_GF-RemoveDecoration_S_S_S_S__g_form-removeDecoration-fieldName-entry}{#r_GF-RemoveDecoration_S_S_S_S__g_form-removeDecoration-icon-entry}{#r_GF-RemoveDecoration_S_S_S_S__g_form-removeDecoration-title-entry}{#r_GF-RemoveDecoration_S_S_S_S__g_form-removeDecoration-color-entry} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | 装飾を削除するフィールド名。 | | アイコン | 文字列 | 削除するアイコンの名前。 | | タイトル | 文字列 | アイコンのテキストタイトル (名前)。 | | 色 | 文字列 | 一致する CSS カラー。 | [表 : 123. パラメーター] {#r_GF-RemoveDecoration_S_S_S_S__table_mcg_5zd_5s} {#r_GF-RemoveDecoration_S_S_S_S__table_ncg_5zd_5s__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 124. 返される内容] {#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-title64} 指定された選択肢リストから指定されたオプションを削除します。 {#r_GlideFormRemoveOption_String_String__table_p4k_hjd_5s__entry__3}{#r_GlideFormRemoveOption_String_String__g_form-removeOption-fieldName-entry}{#r_GlideFormRemoveOption_String_String__g_form-removeOption-choiceValue-entry} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | 選択リストからオプションを削除するフィールドの名前。 | | choiceValue | 文字列 | データベースに格納されている値。これはラベルではありません。 | [表 : 125. パラメーター] {#r_GlideFormRemoveOption_String_String__table_p4k_hjd_5s} {#r_GlideFormRemoveOption_String_String__table_q4k_hjd_5s__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 126. 返される内容] {#r_GlideFormRemoveOption_String_String__table_q4k_hjd_5s} g_form.removeOption('priority', '1'); ## GlideForm:save() {#ariaid-title65} 移動せずにレコードを保存します (更新して留まる)。 {#r_GlideFormSave__table_xgb_3qd_5s__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 127. パラメーター] {#r_GlideFormSave__table_xgb_3qd_5s} {#r_GlideFormSave__table_ygb_3qd_5s__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 128. 返される内容] {#r_GlideFormSave__table_ygb_3qd_5s} ## GlideForm - setChoiceLabel(文字列 fieldName, 文字列 choiceValue, 文字列 newLabel) {#ariaid-title66} ドロップダウンフィールドの特定の選択肢のラベルを更新します。 このメソッドを呼び出すと、ドロップダウン内の更新されたオプションのインデックス位置は変更されません。このオプションの有効または無効のステータスは保持されます。 {#GF-setChoiceLabel_S_S_S__table_q2s_gds_rfc__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | 更新する選択肢を含むフィールド名。 データタイプ：文字列 | | choiceValue | 文字列 | 新しいラベルで更新する選択肢ラベルの値。 データタイプ：文字列 | | 新しいラベル | 文字列 | 既存の選択肢ラベルを更新するラベル名。 データタイプ：文字列 | [表 : 129. パラメーター] {#GF-setChoiceLabel_S_S_S__table_q2s_gds_rfc} {#GF-setChoiceLabel_S_S_S__table_fvm_xbs_rfc__entry__2} | タイプ | 説明 | |-|-| | ブール | オプションラベルが正常に更新されたかどうかを示すフラグ。 有効な値： * true:選択肢ラベルが更新されます。 * false:指定された更新対象の選択肢が読み取り専用であるか存在しないか、新しいラベルが存在していて既に別のオプションに関連付けられている可能性があるため、選択肢ラベルは更新されません。 {#GF-setChoiceLabel_S_S_S__ul_m4d_pfq_xfc} | [表 : 130. 返される内容] {#GF-setChoiceLabel_S_S_S__table_fvm_xbs_rfc} 次の例では、setChoiceLabel() を呼び出して、「ボーナス」フィールドの選択肢 (10、20、および 30) を新しい値に更新します。 // Show the calculated bonus next to the percentage label var salary = parseInt(g_form.getValue('salary'), 10); g_form.setChoiceLabel('bonus', '10', '10% ($'+ (salary * .10) +')'); g_form.setChoiceLabel('bonus', '20', '20% ($'+ (salary * .20) +')'); g_form.setChoiceLabel('bonus', '30', '30% ($'+ (salary * .30) +')'); ## GlideForm - setDisabled(文字列 fieldName, ブーリアン disable) {#ariaid-title67} 指定されたフィールドを使用可能または使用不可にします。 {#r_GlideFormSetDisabled_String_Boolean__table_sn2_j4c_5s__entry__3}{#r_GlideFormSetDisabled_String_Boolean__g_form-setDisabled-fieldName-entry}{#r_GlideFormSetDisabled_String_Boolean__g_form-setDisabled-disable-entry} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | 有効または無効にするフィールドの名前。 | | 無効化 | ブール | 指定されたフィールドを無効にするかどうかを示すフラグ。 有効な値： * true:フィールドを無効にします。 * false:フィールドを有効にします。 {#r_GlideFormSetDisabled_String_Boolean__ul_odn_3hw_jfc} デフォルト値：false | [表 : 131. パラメーター] {#r_GlideFormSetDisabled_String_Boolean__table_sn2_j4c_5s} {#r_GlideFormSetDisabled_String_Boolean__table_tn2_j4c_5s__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 132. 返される内容] {#r_GlideFormSetDisabled_String_Boolean__table_tn2_j4c_5s} ## GlideForm - setDisplay(文字列 fieldName, ブーリアン display) {#ariaid-title68} フォームの指定されたフィールドを表示または非表示にします。 このメソッドでは、値のない必須フィールドを非表示にすることはできません。フィールドが非表示の場合、スペースは他のアイテムを表示するために使用されます。可能な場合は常に、このメソッドの代わりに UI ポリシーを使用してください。 {#r_GlideFormSetDisplay_String_Boolean__table_k4d_ctw_ts__entry__3}{#r_GlideFormSetDisplay_String_Boolean__g_form-setDisplay-fieldName-entry}{#r_GlideFormSetDisplay_String_Boolean__g_form-setDisplay-display-entry} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | フィールドの名前 | | 表示 | ブール | 指定したフィールドを表示するかどうかを示すフラグ。 有効な値： * true:フィールドを表示します。 * false:フィールドを非表示にします。 {#r_GlideFormSetDisplay_String_Boolean__ul_vdd_sqg_5fc} | [表 : 133. パラメーター] {#r_GlideFormSetDisplay_String_Boolean__table_k4d_ctw_ts} {#r_GlideFormSetDisplay_String_Boolean__table_l4d_ctw_ts__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 134. 返される内容] {#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-title69} 指定されたフィールドラベルのプレーンテキスト値を設定します。 注: このメソッドは サービスカタログ ではサポートされていません。 {#r_GlideFormSetLabelOf_String_String__table_h5q_ytw_ts__entry__3}{#r_GlideFormSetLabelOf_String_String__g_form-setLabelOf-fieldName-entry}{#r_GlideFormSetLabelOf_String_String__g_form-setLabelOf-label-entry} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | ラベルを設定するフィールドの名前。 | | ラベル | 文字列 | ラベルに設定するプレーンテキスト値。 | [表 : 135. パラメーター] {#r_GlideFormSetLabelOf_String_String__table_h5q_ytw_ts} {#r_GlideFormSetLabelOf_String_String__table_i5q_ytw_ts__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 136. 返される内容] {#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 - setMandatory(文字列 fieldName, ブーリアン mandatory) {#ariaid-title70} 指定されたフィールドを必須にします。 必須フィールドは、フィールドラベルの横にあるアスタリスクによって視覚的に区別されます。アスタリスクは、フィールドが空の場合は赤で、フィールドが空でない場合は黒です。ユーザーがこれらのフィールドに入力せずにフォームを保存または送信しようとすると、検証メッセージが表示されます。詳細については、「[Form fields](https://www.servicenow.com/docs/access?context=c_FormFields&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US)」を参照してください。 注: 可能な限り、この方法ではなく UI ポリシーを使用してください。 {#r_GF-SetMandatory_S_B__table_xnx_z4c_5s__entry__3}{#r_GF-SetMandatory_S_B__g_form-setMandatory-fieldName-entry}{#r_GF-SetMandatory_S_B__g_form-setMandatory-mandatory-entry} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | 必須にするフィールドの名前。 | | 必須 | ブール | フィールドが必須かどうかを示すフラグ。 有効な値： * true:フィールドは必須です。 * false:フィールドはオプションです。 {#r_GF-SetMandatory_S_B__ul_ofd_sqg_5fc} デフォルト値：false | [表 : 137. パラメーター] {#r_GF-SetMandatory_S_B__table_xnx_z4c_5s} {#r_GF-SetMandatory_S_B__table_ynx_z4c_5s__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 138. 返される内容] {#r_GF-SetMandatory_S_B__table_ynx_z4c_5s} ## GlideForm - setReadOnly(文字列 fieldName, ブーリアン readOnly) {#ariaid-title71} 指定されたフィールドを読み取り専用または編集可能にします。 可能な場合は常に、このメソッドの代わりに UI ポリシーを使用してください。 必須フィールドを読み取り専用にするには、まず setMandatory() メソッドを使用してそのフィールドの必須要件を削除する必要があります。 フィールドを読み取り専用に設定すると、[setValue()](https://servicenow-prod.fluidtopics.net/TOJ5TIb2BhZv_76tquWNCA#r_GlideForm-SetValue_S_S_S "指定されたフォームフィールドの値を、参照レコードの指定された値または指定された表示値の値に設定します。") メソッドを使用してそのフィールドの値を更新することはできません。この方法で値を設定する必要がある場合は、 readOnly 値を false に設定する必要があります `。` {#r_GlideFormSetReadOnly_String_Boolean__table_xdf_qpc_5s__entry__3}{#r_GlideFormSetReadOnly_String_Boolean__g_form-setReadOnly-fieldName-entry}{#r_GlideFormSetReadOnly_String_Boolean__g_form-setReadOnly-readOnly-entry} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | アクセス値を設定するフィールドの名前。 | | readOnly | ブーリアン | 関連するフィールドが編集可能か読み取り専用かを決定するフラグ。 有効な値： * true:フィールドを読み取り専用に設定します。 * false:フィールドを編集可能に設定します。 {#r_GlideFormSetReadOnly_String_Boolean__ul_tfd_sqg_5fc} | [表 : 139. パラメーター] {#r_GlideFormSetReadOnly_String_Boolean__table_xdf_qpc_5s} {#r_GlideFormSetReadOnly_String_Boolean__table_ydf_qpc_5s__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 140. 返される内容] {#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:setRelatedLinksDisplay(ブール表示) {#ariaid-title72} ブール値を使用して、フォーム UI の \[関連リンク\] セクションを表示または非表示にします。 [GlideForm:hideRelatedLinks()](https://servicenow-prod.fluidtopics.net/TOJ5TIb2BhZv_76tquWNCA#GF-hideRelatedLinks "フォームの [関連リンク] セクションを非表示にします。") 関連リンク UI アクションをフォームで非表示にし、関連リンク UI アクションを表示します [GlideForm:showRelatedLinks()](https://servicenow-prod.fluidtopics.net/TOJ5TIb2BhZv_76tquWNCA#GF-showRelatedLinks "フォームの [関連リンク] セクションを表示します。") 。ただし、 g_form.setRelatedLinksDisplay(boolean: display) メソッドを使用すると、スクリプトをより柔軟に関連リンクを表示または非表示にすることができます。 {#GF-setRelatedLinksDisplay_B__table_ebq_t1t_rfc__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | 表示 | ブール | フォームの \[関連リンク\] セクションを表示するか非表示にするかを示すフラグ。 有効な値： * true:フォームに関連リンクを表示します。 * false:フォーム内の関連リンクを非表示にします。 {#GF-setRelatedLinksDisplay_B__ul_bks_tbt_rfc} デフォルト：true | [表 : 141. パラメーター] {#GF-setRelatedLinksDisplay_B__table_ebq_t1t_rfc} {#GF-setRelatedLinksDisplay_B__table_fbq_t1t_rfc__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 142. 返される内容] {#GF-setRelatedLinksDisplay_B__table_fbq_t1t_rfc} 次の例は、フォームの \[関連リンク\] セクションを表示または非表示にする方法を示しています。 // Displays the Related Links section in the UI g_form.setRelatedLinksDisplay(true); // Hides the Related Links section in the UI g_form.setRelatedLinksDisplay(false); ## GlideForm - setSectionDisplay(文字列 sectionName, ブーリアン display) {#ariaid-title73} フォームの指定されたセクションを表示または非表示にします。 {#r_GF-SetSectionDisplay_S_B__table_pqq_qqd_5s__entry__3}{#r_GF-SetSectionDisplay_S_B__g_form-setSectionDisplay-sectionName-entry}{#r_GF-SetSectionDisplay_S_B__g_form-setSectionDisplay-display-entry} | 名前 | タイプ | 説明 | |-|-|-| | sectionName | 文字列 | セクション名は小文字で、名前の最初のスペースがアンダースコアで置き換えられ、残りのスペースは削除されます。たとえば、「セクション 4 はこちら」は「section_fourishere」になります。アンパサンド (\&) など、その他の英数字以外の文字は削除されます。セクション名は、getSectionNames() メソッドを使用して見つけることができます。 | | 表示 | ブール | セクションを表示するかどうかを示すフラグ。 有効な値： * true:セクションを表示します。 * false:セクションを非表示にします。 {#r_GF-SetSectionDisplay_S_B__ul_odd_sqg_5fc} | [表 : 143. パラメーター] {#r_GF-SetSectionDisplay_S_B__table_pqq_qqd_5s} {#r_GF-SetSectionDisplay_S_B__table_qqq_qqd_5s__entry__2}{#r_GF-SetSectionDisplay_S_B__g_form-setSectionDisplay-returns-entry} | タイプ | 説明 | |-|-| | ブール | 成功した場合は true を返します。 | [表 : 144. 返される内容] {#r_GF-SetSectionDisplay_S_B__table_qqq_qqd_5s} ## GlideForm - setValue(文字列 fieldName, 文字列 value, 文字列 displayValue) {#ariaid-title74} 指定されたフォームフィールドの値を、参照レコードの指定された値または指定された表示値の値に設定します。 参照フィールドの値を設定するときに往復を防止してパフォーマンスを向上させるには、 setValue(fieldName, value) ではなくこのメソッドを使用します。リストコレクターフィールドに複数の参照値を設定する場合は、value パラメーターおよび displayValue パラメーターでアレイを渡します。 このメソッドは、複数行の変数セット (MRVS) での値の設定もサポートしています。最初に `JSON.parse(getValue(''))` を使用して MRVS アレイを取得し、次にインデックス作成を使用して行オブジェクト内のフィールドを更新する必要があります。MRVS ですべての値が更新されたら、 setValue() メソッドを使用して更新された MRVS アレイを保存します。詳細については、以下のコード例を参照してください。 注: このメソッドは、厳格読み取り専用に設定されたフィールドを更新するために使用できません。このメソッドが厳格な読み取り専用フィールドで呼び出された場合、フィールドは更新されず、警告がブラウザーコンソールに記録されます。詳細については、「[Configuring read-only security options](https://www.servicenow.com/docs/access?context=read-only-option&version=australia&pubname=australia-platform-administration&ft:locale=en-US)」を参照してください。 注: このメソッドは、厳格読み取り専用に設定されたフィールドを更新するために使用できません。このメソッドが厳格な読み取り専用フィールドで呼び出された場合、フィールドは更新されず、警告がブラウザーコンソールに記録されます。詳細については、「[Configuring read-only security options](https://www.servicenow.com/docs/access?context=read-only-option&version=australia&pubname=australia-platform-administration&ft:locale=en-US)」を参照してください。 注: メソッド setValue() は、`onchange` クライアントスクリプトで使用するとスタックオーバーフローを引き起こす可能性があります。これは、値が設定されるたびに変更として登録され、OnChange クライアントスクリプトが再トリガーされるためです。これを防ぐには、新しい値が古い値と異なることを検証するチェックを実行します。たとえば、 `setValue(shortDesc, newValue.toUpperCase());` を実行する前に、簡単な説明がまだ大文字になっていないことを検証します。これにより、クライアントスクリプトが toUpperCase() を複数回適用するのを防ぐことができます。 {#r_GlideForm-SetValue_S_S_S__table_oxn_vrc_5s__entry__3}{#r_GlideForm-SetValue_S_S_S__g_form-setValue-fieldName-entry}{#r_GlideForm-SetValue_S_S_S__g_form-setValue-value-entry}{#r_GlideForm-SetValue_S_S_S__g_form-setValue-displayValue-entry} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | 更新するフォームフィールドの名前。 | | 値 | 文字列またはアレイ | フィールドの更新に使用する参照レコードのSys_id。 指定されたフィールドが GlideList の場合、このパラメーターにはsys_idsのアレイを含めることができます。この場合、メソッドはアレイ内で指定されたすべてのレコードのルックアップを実行し、それらの値を使用して指定されたフィールド (関連リスト) の内容を更新します。 注: 選択リストで値を定義するときは、ラベルではなく数値を使用してください。 | | displayValue | 文字列またはアレイ | オプション。指定されたフィールドを更新するために使用する、指定された参照レコード内のフィールド。たとえば、ユーザー \[sys_user\] テーブルでは userName である可能性があります。 指定されたフィールドが GlideList の場合、このパラメーターには表示値名のアレイを含めることができます。 表示値の詳細については、「 [表示値](https://www.servicenow.com/docs/access?context=c_DisplayValues&version=australia&pubname=australia-platform-administration&ft:locale=en-US)」を参照してください。 | [表 : 145. パラメーター] {#r_GlideForm-SetValue_S_S_S__table_oxn_vrc_5s} {#r_GlideForm-SetValue_S_S_S__table_pxn_vrc_5s__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 146. 返される内容] {#r_GlideForm-SetValue_S_S_S__table_pxn_vrc_5s} 次の例は、現在のフォームに簡単な説明を設定する方法を示しています。 g_form.setValue('short_description', 'replace this with appropriate text'); 次の例は、MRVS で値を設定する方法を示しています。この例では、給与はサービスカタログを通じて管理されています。クライアントスクリプトは、MRVS 内のすべての行で ジョブタイトル に入力された値を検索し、MRVS 内の一致するエントリーを \[ 給与\] フィールドに入力した値で更新します。MRVS の名前は「variable_set_1」で、各行オブジェクト内に従業員名 \[employee_name\]、役職 \[employee_job_title\]、給与 \[employee_salary\] のフィールドが含まれています。さらに、カタログアイテムには、役職 \[job_title\] と給与 \[給与\] が含まれます。 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)); } この例では、\[assigned_to\] フォームフィールドを更新するために使用する \[userName\] フィールドを含む参照レコードの sys_id を渡しています。 g_form.setValue('assigned_to', userSysID, userName); この例では、参照レコードsys_idsのアレイと、対応する表示値名のアレイを渡して、 GlideList glide-list_field_name のフォームフィールドを更新するために使用する方法を示しています。 g_form.setValue('glide-list_field_name', sysIDArray, displayNameArray); ## GlideForm - setVariablesReadOnly(ブーリアン isReadOnly) {#ariaid-title75} サービスカタログ変数エディターを読み取り専用にします。 注: このメソッドは、コア UI の サービスカタログ 変数エディターにのみ適用できます。このメソッドは サービスカタログ フォームではサポートされていません。 メソッドは、要求アイテム \[sc_req_item\] やインシデント \[incident\] など、変数エディターが追加されるテーブルのクライアントスクリプトに配置する必要があります。変数を他のテーブルで読み取り専用に設定するには、 [setReadOnly()](https://servicenow-prod.fluidtopics.net/TOJ5TIb2BhZv_76tquWNCA#r_GlideFormSetReadOnly_String_Boolean "指定されたフィールドを読み取り専用または編集可能にします。") メソッドを使用します。 関連項目: [サービスカタログ変数エディター](https://www.servicenow.com/docs/access?context=service-catalog-variable-editor&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) {#GF-setVariablesReadOnly_B__table_xdf_qpc_5s__entry__3}{#GF-setVariablesReadOnly_B__g_form-setVariablesReadOnly-isReadOnly-entry} | 名前 | タイプ | 説明 | |-|-|-| | isReadOnly | ブーリアン | 変数エディターが読み取り専用かどうかを決定するフラグ。 有効な値： * true：変数エディターを読み取り専用に設定します。 * false:変数エディターを編集可能に設定します。 {#GF-setVariablesReadOnly_B__ul_ifd_sqg_5fc} デフォルト値：false | [表 : 147. パラメーター] {#GF-setVariablesReadOnly_B__table_xdf_qpc_5s} {#GF-setVariablesReadOnly_B__table_ydf_qpc_5s__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 148. 返される内容] {#GF-setVariablesReadOnly_B__table_ydf_qpc_5s} 次の行をクライアントスクリプトに追加すると、変数エディターが読み取り専用に設定されます。 g_form.setVariablesReadOnly(true); ## GlideForm - setVisible(文字列 fieldName, ブーリアン display) {#ariaid-title76} 指定されたフィールドを表示または非表示にします。 デスクトップ UI では、非表示の場合は空白のままになります。モバイルや サービスポータル UI では、非表示にすると他のフィールドにスペースが入力されます。この方法では、値のない必須フィールドを非表示にすることはできません。 可能な限り、このメソッドでなく UI ポリシーを使用してください。 {#r_GlideFormSetVisible_String_Boolean__table_k24_45w_ts__entry__3}{#r_GlideFormSetVisible_String_Boolean__g_form-setVisible-fieldName-entry}{#r_GlideFormSetVisible_String_Boolean__g_form-setVisible-display-entry} | 名前 | タイプ | 説明 | |-|-|-| | fieldName | 文字列 | 表示または非表示にするフィールドの名前。 | | 表示 | ブール | 指定したフィールドを表示するかどうかを示すフラグ。 有効な値： * true:フィールドを表示します。 * false:フィールドを非表示にします。 {#r_GlideFormSetVisible_String_Boolean__ul_c2d_sqg_5fc} | [表 : 149. パラメーター] {#r_GlideFormSetVisible_String_Boolean__table_k24_45w_ts} {#r_GlideFormSetVisible_String_Boolean__table_l24_45w_ts__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 150. 返される内容] {#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 - showAnnotation(文字列名) {#ariaid-title77} 指定された名前の注釈をフォーム UI に表示します。 [注釈](https://www.servicenow.com/docs/access?context=configure-form-layout&version=australia&pubname=australia-platform-administration§ion=t_AddAFormAnnotation&ft:locale=en-US) は、フォーム要素間の視覚的なセパレーター、またはフォーム要素を強調表示するために使用される色付きのテキストのブロックです。関連項目： * [GlideForm - hideAnnotation(文字列名)](https://servicenow-prod.fluidtopics.net/TOJ5TIb2BhZv_76tquWNCA#GF-hideAnnotation_S "指定された名前の注釈をフォーム UI で非表示にします。") でフォーム上の特定の注釈を非表示にします。 * [GlideForm:toggleAnnotations()](https://servicenow-prod.fluidtopics.net/TOJ5TIb2BhZv_76tquWNCA#GF-toggleAnnotations "フォーム上のすべての注釈を表示または非表示にします。") により、注釈のオンとオフをより柔軟に切り替えることができます。 {#GF-showAnnotation_S__ul_iqn_jmf_wfc} {#GF-showAnnotation_S__table_isv_1nt_rfc__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | 名前 | 文字列 | フォームに表示する注釈の名前。 テーブル:フォーム注釈 \[sys_ui_annotation\]、フィールド: 名前 | [表 : 151. パラメーター] {#GF-showAnnotation_S__table_isv_1nt_rfc} {#GF-showAnnotation_S__table_jsv_1nt_rfc__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 152. 返される内容] {#GF-showAnnotation_S__table_jsv_1nt_rfc} 次の例は、 showAnnotation() メソッドを使用して、フォームフィールドに test-annotation-msg という名前の注釈をプログラムで表示する方法を示しています。 g_form.showAnnotation('test-annotation-msg'); ## GlideForm - showErrorBox(文字列 name, 文字列 message, ブーリアン scrollForm) {#ariaid-title78} 指定されたフォームフィールド (コントロールオブジェクトまたはフィールドの名前) の下にエラーメッセージを表示します。コントロールまたはフィールドが現在画面外にあり、 scrollForm パラメーターが true の場合、フォームはコントロールまたはフィールドまでスクロールします。 フォームフィールドが画面外にあるときの自動メッセージスクロールを制御するグローバルプロパティ (glide.ui.scroll_to_message_field) を使用できます (フォームをコントロールまたはフィールドまでスクロールします)。showFieldMsg() メソッドは、型パラメーターを必要とする同様のメソッドです。 {#r_GF-ShowErrorBox_S_S_B__table_lyr_dww_ts__entry__3}{#r_GF-ShowErrorBox_S_S_B__g_form-showErrorBox-name-entry}{#r_GF-ShowErrorBox_S_S_B__g_form-showErrorBox-message-entry}{#r_GF-ShowErrorBox_S_S_B__g_form-showErrorBox-scrollForm-entry} | 名前 | タイプ | 説明 | |-|-|-| | 名前 | 文字列 | エラーメッセージを表示するフィールドまたはコントロールの名前。 | | メッセージ | 文字列 | 表示するエラー メッセージ。 | | スクロールフォーム | ブール | エラーメッセージフィールドにフォームを自動的にスクロールするかどうかを示すフラグ。 有効な値： * true:エラーメッセージフィールドまでスクロールします。 * false:エラーメッセージフィールドまでスクロールしません。 {#r_GF-ShowErrorBox_S_S_B__ul_bgd_sqg_5fc} デフォルト：true | [表 : 153. パラメーター] {#r_GF-ShowErrorBox_S_S_B__table_lyr_dww_ts} {#r_GF-ShowErrorBox_S_S_B__table_myr_dww_ts__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 154. 返される内容] {#r_GF-ShowErrorBox_S_S_B__table_myr_dww_ts} ## GlideForm - showErrorBox(文字列 name, 文字列 message) {#ariaid-title79} 指定されたフォームフィールド (コントロールオブジェクトまたはフィールドの名前) の下にエラーメッセージを表示します。コントロールまたはフィールドが現在画面外にある場合、フォームは自動的にコントロールまたはフィールドまでスクロールします。 フォームフィールドが画面外にあるときの自動メッセージスクロールを制御するグローバルプロパティ (glide.ui.scroll_to_message_field) を使用できます (フォームをコントロールまたはフィールドまでスクロールします)。showFieldMsg() メソッドは、型パラメーターを必要とする同様のメソッドです。 {#r_GlideFormShowErrorBox_String_String__table_rxv_2vw_ts__entry__3}{#r_GlideFormShowErrorBox_String_String__g_form-showErrorBox-name-entry}{#r_GlideFormShowErrorBox_String_String__g_form-showErrorBox-message-entry} | 名前 | タイプ | 説明 | |-|-|-| | 名前 | 文字列 | エラーメッセージを表示するフィールドまたはコントロールの名前。 | | メッセージ | 文字列 | 表示するエラー メッセージ。 | [表 : 155. パラメーター] {#r_GlideFormShowErrorBox_String_String__table_rxv_2vw_ts} {#r_GlideFormShowErrorBox_String_String__table_sxv_2vw_ts__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 156. 返される内容] {#r_GlideFormShowErrorBox_String_String__table_sxv_2vw_ts} ## GlideForm - showFieldMsg(文字列 field, 文字列 message, 文字列 type) {#ariaid-title80} 指定されたフォームフィールド (コントロールオブジェクトまたはフィールドの名前) の下にメッセージを表示します。コントロールまたはフィールドが画面外にある場合、メソッドはフォームをそのフィールドまで自動的にスクロールします。 フォームフィールドが画面外にあるときの自動メッセージスクロールを制御するグローバルプロパティ (glide.ui.scroll_to_message_field) を使用できます (フォームをコントロールまたはフィールドまでスクロールします)。 showErrorBox() メソッドは、type パラメーターを必要としない短縮形メソッドです。 注: このメソッドは、コア UI のjournal_fieldタイプフィールドでは機能しません。 {#r_GF-ShowFieldMsg_S_S_S__table_u3z_hxw_ts__entry__3}{#r_GF-ShowFieldMsg_S_S_S__g_form-showFieldMsg-field-entry}{#r_GF-ShowFieldMsg_S_S_S__g_form-showFieldMsg-message-entry}{#r_GF-ShowFieldMsg_S_S_S__g_form-showFieldMsg-type-entry} | 名前 | タイプ | 説明 | |-|-|-| | フィールド | 文字列 | メッセージを表示するフィールドまたはコントロールの名前。 | | メッセージ | 文字列 | 表示するメッセージ。 | | タイプ | 文字列 | メッセージのタイプ 有効な値： * エラー * 情報 * 警告 {#r_GF-ShowFieldMsg_S_S_S__ul_vgd_sqg_5fc} | [表 : 157. パラメーター] {#r_GF-ShowFieldMsg_S_S_S__table_u3z_hxw_ts} {#r_GF-ShowFieldMsg_S_S_S__table_v3z_hxw_ts__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 158. 返される内容] {#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-title81} 指定されたフォームフィールド (コントロールオブジェクトまたはフィールドの名前) の下にメッセージを表示します。コントロールまたはフィールドが現在画面外にあり、 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}{#r_GF-ShowFieldMsg_S_S_S_B__g_form-showFieldMsg-field-entry}{#r_GF-ShowFieldMsg_S_S_S_B__g_form-showFieldMsg-message-entry}{#r_GF-ShowFieldMsg_S_S_S_B__g_form-showFieldMsg-type-entry}{#r_GF-ShowFieldMsg_S_S_S_B__g_form-showFieldMsg-scrollForm-entry} | 名前 | タイプ | 説明 | |-|-|-| | フィールド | 文字列 | メッセージを表示するフィールドまたはコントロールの名前。 | | メッセージ | 文字列 | 表示するメッセージ。 | | タイプ | 文字列 | メッセージのタイプ 有効な値： * エラー * 情報 * 警告 {#r_GF-ShowFieldMsg_S_S_S_B__ul_vgd_sqg_5fc} | | スクロールフォーム | ブール | フォームをメッセージフィールドに自動的にスクロールするかどうかを示すフラグ。 有効な値： * true:メッセージフィールドまでスクロールします。 * false:メッセージ フィールドまでスクロールしません。 {#r_GF-ShowFieldMsg_S_S_S_B__ul_hgd_sqg_5fc} デフォルト：true | [表 : 159. パラメーター] {#r_GF-ShowFieldMsg_S_S_S_B__table_wmr_gyw_ts} {#r_GF-ShowFieldMsg_S_S_S_B__table_xmr_gyw_ts__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 160. 返される内容] {#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:showRelatedLinks() {#ariaid-title82} フォームの \[関連リンク\] セクションを表示します。 関連項目： * [GlideForm:hideRelatedLinks()](https://servicenow-prod.fluidtopics.net/TOJ5TIb2BhZv_76tquWNCA#GF-hideRelatedLinks "フォームの [関連リンク] セクションを非表示にします。") * [GlideForm:setRelatedLinksDisplay(ブール表示)](https://servicenow-prod.fluidtopics.net/TOJ5TIb2BhZv_76tquWNCA#GF-setRelatedLinksDisplay_B "ブール値を使用して、フォーム UI の [関連リンク] セクションを表示または非表示にします。") {#GF-showRelatedLinks__ul_lbh_5hq_vfc} {#GF-showRelatedLinks__table_wgv_31t_rfc__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 161. パラメーター] {#GF-showRelatedLinks__table_wgv_31t_rfc} {#GF-showRelatedLinks__table_xgv_31t_rfc__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 162. 返される内容] {#GF-showRelatedLinks__table_xgv_31t_rfc} 次の例では、フォーム UI に関連リンクを表示します。 // Show related links g_form.showRelatedLinks() ## GlideForm - showRelatedList(文字列 listTableName) {#ariaid-title83} 指定された関連リストをフォームに表示します。 このメソッドは、モバイルプラットフォームでは使用できません。このメソッドがモバイルプラットフォームで実行されても、何も起こりません。 {#r_GlideFormShowRelatedList_String__table_mps_2zw_ts__entry__3}{#r_GlideFormShowRelatedList_String__g_form-showRelatedList-listTableName-entry} | 名前 | タイプ | 説明 | |-|-|-| | listTableName | 文字列 | 表示する関連リストの名前。 | [表 : 163. パラメーター] {#r_GlideFormShowRelatedList_String__table_mps_2zw_ts} {#r_GlideFormShowRelatedList_String__table_nps_2zw_ts__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 164. 返される内容] {#r_GlideFormShowRelatedList_String__table_nps_2zw_ts} ## GlideForm:showRelatedLists() {#ariaid-title84} フォームの関連リストをすべて表示します。 このメソッドは、モバイルプラットフォームでは使用できません。このメソッドがモバイルプラットフォームで実行されても、何も起こりません。 {#r_GlideFormShowRelatedLists__table_jcj_rzw_ts__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 165. パラメーター] {#r_GlideFormShowRelatedLists__table_jcj_rzw_ts} {#r_GlideFormShowRelatedLists__table_kcj_rzw_ts__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 166. 返される内容] {#r_GlideFormShowRelatedLists__table_kcj_rzw_ts} ## GlideForm - showTemplateBar() {#ariaid-title85} 非表示にすると、フォームの下部にテンプレートバーが表示されます。 {#GF-showTemplateBar__table_ivb_s5g_5fc__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 167. パラメーター] {#GF-showTemplateBar__table_ivb_s5g_5fc} {#GF-showTemplateBar__table_jvb_s5g_5fc__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 168. 返される内容] {#GF-showTemplateBar__table_jvb_s5g_5fc} 次のスクリプト例では、現在のフォームの下部にテンプレートバーを表示します。 g_form.showTemplateBar() ## GlideForm - submit() {#ariaid-title86} レコードを保存します。 ユーザーはフォームから離れ、元の場所に戻されます。 {#r_GlideFormSubmit__table_nhk_grd_5s__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 169. パラメーター] {#r_GlideFormSubmit__table_nhk_grd_5s} {#r_GlideFormSubmit__table_ohk_grd_5s__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 170. 返される内容] {#r_GlideFormSubmit__table_ohk_grd_5s} ## GlideForm - submit(文字列 verb) {#ariaid-title87} 指定された UI アクションを実行します。 {#GF-submit_S__table_o1z_d3p_qx__entry__3}{#GF-submit_S__g_form-submit-verb-entry} | 名前 | タイプ | 説明 | |-|-|-| | verb | 文字列 | sys_ui_actionレコードからのaction_name。アクション名は、表示されるフォームボタンのものである必要があります。 | [表 : 171. パラメーター] {#GF-submit_S__table_o1z_d3p_qx} {#GF-submit_S__table_p1z_d3p_qx__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 172. 返される内容] {#GF-submit_S__table_p1z_d3p_qx} ## GlideForm:toggleAnnotations() {#ariaid-title88} フォーム上のすべての注釈を表示または非表示にします。 [注釈](https://www.servicenow.com/docs/access?context=configure-form-layout&version=australia&pubname=australia-platform-administration§ion=t_AddAFormAnnotation&ft:locale=en-US) は、フォーム要素間の視覚的なセパレーター、またはフォーム要素を強調表示するために使用される色付きのテキストのブロックです。注釈がフォームに表示されている場合は、 toggleAnnotations() を呼び出すと非表示になります。同様に、注釈がフォームで非表示になっている場合、このメソッドを呼び出すと注釈が表示されます。 関連項目： * [GlideForm - hideAnnotation(文字列名)](https://servicenow-prod.fluidtopics.net/TOJ5TIb2BhZv_76tquWNCA#GF-hideAnnotation_S "指定された名前の注釈をフォーム UI で非表示にします。") * [GlideForm - showAnnotation(文字列名)](https://servicenow-prod.fluidtopics.net/TOJ5TIb2BhZv_76tquWNCA#GF-showAnnotation_S "指定された名前の注釈をフォーム UI に表示します。") {#GF-toggleAnnotations__ul_ytp_ytm_5fc} {#GF-toggleAnnotations__table_xqy_vjz_rfc__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 173. パラメーター] {#GF-toggleAnnotations__table_xqy_vjz_rfc} {#GF-toggleAnnotations__table_yqy_vjz_rfc__entry__2} | タイプ | 説明 | |-|-| | なし | | [表 : 174. 返される内容] {#GF-toggleAnnotations__table_yqy_vjz_rfc} 次の例は、 toggleAnnotations() を呼び出してフォーム注釈を表示または非表示にする方法を示しています。その結果、注釈は以前のステータスに応じて非表示または表示されます。 g_form.toggleAnnotations();