GlideForm(g_form) - 클라이언트

GlideForm - addDecoration(문자열 필드 이름, 문자열 아이콘, 문자열 제목)

필드의 레이블에 아이콘을 추가합니다.

동일한 항목을 두 번 추가하는 것은 방지됩니다. 그러나 제목이 다른 동일한 아이콘을 추가할 수 있습니다.

주:

이 메서드는 서비스 카탈로그에서 지원되지 않습니다.

표 1. 매개변수
이름	유형	설명
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.
제목	문자열	아이콘의 텍스트 제목입니다.

표 2. 반환
유형	설명
void

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

GlideForm - addDecoration(문자열 필드 이름, 문자열 아이콘, 문자열 제목, 문자열 색상)

필드의 레이블에 아이콘을 추가합니다.

동일한 항목을 두 번 추가하는 것은 방지됩니다. 그러나 제목이 다른 동일한 아이콘을 추가할 수 있습니다.

주:

이 메서드는 서비스 카탈로그에서 지원되지 않습니다.

표 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.
제목	문자열	아이콘의 텍스트 제목입니다.
색상	문자열	CSS 색상입니다.

표 4. 반환
유형	설명
void

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

GlideForm - addErrorMessage(문자열 메시지)

양식 상단에 지정된 오류 메시지를 표시합니다.

이 메시지는 약 4초 동안 표시된 다음 사라집니다. 이 시간 제한은 현재 구성할 수 없습니다.

표 5. 매개변수
이름	유형	설명
메시지	문자열	표시할 메시지입니다.

표 6. 반환
유형	설명
void

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

GlideForm - addFormMessage(문자열 메시지, 문자열 유형, 객체 옵션)

양식 상세 정보 섹션의 맨 위에 부동 양식 메시지를 표시합니다. 이 메시지는 UI 작업을 다루지 않습니다.

참조:

표 7. 매개변수
이름	유형	설명
메시지	문자열	표시할 메시지입니다.
유형	문자열	메시지 유형입니다. 유효한 값은 다음과 같습니다. 오류 정보 경고
옵션	객체	옵션입니다. 양식 메시지에 추가할 버튼과 버튼 클릭을 처리하는 데 필요한 메타데이터를 포함하는 객체입니다. `{ buttons: [Array], meta: {Object} }`
옵션.버튼	배열	양식 메시지에 추가할 버튼의 배열입니다. `buttons: [ { label: "String", actionName: "String" } ]`
옵션.버튼.레이블	문자열	버튼에 표시할 텍스트입니다.
options.buttons.actionName	문자열	클릭한 버튼을 확인하기 위해 FORM_MESSAGE_BUTTON_CLICKED 이벤트 핸들러에서 사용하는 이름입니다. 예를 들어 actionName `assign_to_me` 버튼을 추가하는 경우 actionName이 `assigned_to_me` 경우에만 실행되는 FORM_MESSAGE_BUTTON_CLICKED 이벤트에 이벤트 핸들러 UIB 를 만들어야 합니다.
옵션.메타	객체	키-값 쌍으로 형식이 지정된 버튼 클릭을 처리하는 데 필요한 메타데이터의 맵입니다. `meta: { 'key': 'value' }` 예를 들어 나에게 할당 단추의 경우 이벤트 핸들러에는 기록을 할당할 사용자의 sys_id 필요합니다.

표 8. 반환
유형	설명
안 함

다음 예제에서는 각 형식의 양식 메시지를 추가하는 방법을 보여 줍니다.

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(문자열 메시지)

지정된 정보 메시지를 양식 상단에 추가합니다.

이 메시지는 약 4초 동안 표시된 다음 사라집니다. 이 시간 제한은 현재 구성할 수 없습니다.

표 9. 매개변수
이름	유형	설명
메시지	문자열	표시할 메시지입니다.

표 10. 반환
유형	설명
void

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

GlideForm - addOption(String fieldName, String choiceValue, String choiceLabel)

선택 목록 필드 끝에 선택 항목을 추가합니다.

표 11. 매개변수
이름	유형	설명
fieldName	문자열	필드의 이름입니다.
선택 값	문자열	데이터베이스에 저장할 값입니다.
선택 레이블	문자열	표시되는 값입니다.

표 12. 반환
유형	설명
void

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

GlideForm - addOption(String fieldName, String choiceValue, String choiceLabel, Number, choiceIndex)

지정된 위치의 목록 필드에 선택 항목을 추가합니다.

주:

에서는 중복 목록 레이블이 지원되지 서비스 포털않습니다. 예를 들어 레이블 텍스트가 다른 레이블과 일치하는 항목은 무시되고 목록에 추가되지 않습니다.

표 13. 매개변수
이름	유형	설명
fieldName	문자열	필드 이름입니다.
선택 값	문자열	데이터베이스에 저장된 값입니다.
선택 레이블	문자열	표시되는 값입니다.
선택 인덱스	번호	목록에서 선택한 순서입니다. 인덱스는 0부터 시작하는 배열입니다.

표 14. 반환
유형	설명
void

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

GlideForm - clearMessages()

양식 상단에서 모든 정보 및 오류 메시지를 제거합니다.

g_form.addInfoMessage() 및 g_form.addErrorMessage()와 함께 추가된 정보 메시지와 오류 메시지를 제거합니다.

표 15. 매개변수
이름	유형	설명
없음

표 16. 반환
유형	설명
void

g_form.clearMessages();

GlideForm - clearAllFormMessages()

모든 형식의 양식 메시지를 제거합니다.

참조:

표 17. 매개변수
이름	유형	설명
없음

표 18. 반환
유형	설명
안 함

다음 예는 양식에서 모든 메시지를 지우는 방법을 보여줍니다.

g_form.clearAllFormMessages();

GlideForm - clearFormMessages(문자열 유형)

지정된 형식의 모든 양식 메시지를 제거합니다.

참조:

표 19. 매개변수
이름	유형	설명
유형	문자열	메시지 유형입니다. 유효한 값은 다음과 같습니다. 오류 정보 경고

표 20. 반환
유형	설명
안 함

다음 예제에서는 양식에서 모든 오류 메시지를 지우는 방법을 보여 줍니다.

g_form.clearFormMessages('error');

GlideForm - clearOptions(문자열 필드 이름)

선택 목록에서 모든 옵션을 제거합니다.

표 21. 매개변수
이름	유형	설명
fieldName	문자열	필드의 이름입니다.

표 22. 반환
유형	설명
void

GlideForm - clearValue(String fieldName)

필드에서 값을 제거합니다.

표 23. 매개변수
이름	유형	설명
fieldName	문자열	필드의 이름입니다.

표 24. 반환
유형	설명
void

GlideForm - disableAttachments()

첨부 파일이 추가되지 않도록 차단합니다.

모바일 플랫폼에서는 이 방법을 사용할 수 없습니다. 모바일 플랫폼에서 이 메서드를 실행하면 아무 작업도 수행되지 않습니다.

표 25. 매개변수
이름	유형	설명
없음

표 26. 반환
유형	설명
void

GlideForm - enableAttachments()

첨부 파일을 추가할 수 있습니다. 종이 클립 아이콘을 표시합니다.

모바일 플랫폼에서는 이 방법을 사용할 수 없습니다. 모바일 플랫폼에서 이 메서드를 실행하면 아무 작업도 수행되지 않습니다.

표 27. 매개변수
이름	유형	설명
없음

표 28. 반환
유형	설명
void

GlideForm - flash(문자열 필드 이름, 문자열 색상, 숫자 수)

특정 필드에 대한 관심을 끄는 데 사용됩니다. 지정된 필드에서 지정된 시간 동안 지정된 색상을 깜박입니다.

이 메서드는 서비스 카탈로그에서 지원되지 않습니다.

모바일 플랫폼에서는 이 방법을 사용할 수 없습니다. 모바일 플랫폼에서 이 메서드를 실행하면 아무 작업도 수행되지 않습니다.

표 29. 매개변수
이름	유형	설명
fieldName	문자열	`"<table-name>.<field-name>"` 형식으로 강조 표시할 필드를 지정합니다.
색상	문자열	RGB 색상 또는 허용되는 CSS 색상입니다.
카운트	번호	레이블이 깜박이는 시간을 지정합니다. 옵션은 다음과 같습니다. 2: 1초 동안 깜박임 0: 2초 동안 깜박임 -2: 3초 동안 깜박임 -4: 4초 동안 깜박임

표 30. 반환
유형	설명
void

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

GlideForm - getActionName()

가장 최근 작업 이름을 반환하거나 클라이언트 스크립트의 경우 클릭한 UI 작업의 sys_id 반환합니다.

주:

마법사 클라이언트 스크립트에서 사용할 수 없습니다.

표 31. 매개변수
이름	유형	설명
없음

표 32. 반환
유형	설명
문자열	현재 작업 이름입니다.

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

GlideForm - getBooleanValue(문자열 필드 이름)

지정된 필드에 대한 부울 값을 반환합니다.

표 33. 매개변수
이름	유형	설명
fieldName	문자열	필드의 이름입니다.

표 34. 반환
유형	설명
부울	필드 값이 false이거나 정의되지 않은 경우 false를 반환합니다. 그렇지 않으면 true를 반환합니다.

GlideForm - getControl(문자열 필드 이름)

지정된 필드에 대한 HTML 요소를 반환합니다.

복합 필드에는 여러 HTML 요소가 포함될 수 있습니다. 양식의 필드를 사용하는 내장 메서드가 있기 때문에 일반적으로 이 메서드는 필요하지 않습니다.

필드가 참조 필드이고 컨트롤이 선택 목록인 경우 getControl() 은 예상대로 컨트롤을 반환하지 않을 수 있습니다. 이 경우 sys_select 사용합니다.<table name>.<field name>입니다.

모바일 스크립트 또는 서비스 포털 스크립트에서는 이 방법을 사용할 수 없습니다.

표 35. 매개변수
이름	유형	설명
fieldName	문자열	필드의 이름입니다.

표 36. 반환
유형	설명
HTMLElement	필드의 HTML 요소입니다.

GlideForm - getDecimalValue(String fieldName)

지정된 필드의 10진수 값을 반환합니다.

표 37. 매개변수
이름	유형	설명
fieldName	문자열	필드의 이름입니다.

표 38. 반환
유형	설명
문자열	지정된 필드의 10진수 값입니다.

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

GlideForm - getDisplayBox(문자열 fieldName)

코어 UI의 양식에서 표시 값을 가져옵니다.

주:

의 서비스 포털양식에서 표시 값을 가져오려면 getDisplayValue() 메서드를 사용합니다.

참조:

표 39. 매개변수
이름	유형	설명
fieldName	문자열	양식에서 값을 검색할 필드의 이름입니다.

표 40. 반환
유형	설명
안 함

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

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

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

GlideForm - getDisplayValue(문자열 fieldName)

의 서비스 포털양식에서 표시 값을 가져옵니다.

주:

코어 UI의 양식에서 표시 값을 가져오려면 getDisplayBox() 메서드를 사용합니다.

참조:

주:

코어 UI에서 이 메서드를 인수 없이 g_form.getDisplayValue() 로 호출하면 개별 필드의 표시 값이 아닌 기록 표시 값이 반환됩니다.

표 41. 매개변수
이름	유형	설명
fieldName	문자열	양식에서 값을 검색할 필드의 이름입니다.

표 42. 반환
유형	설명
안 함

다음 예제에서는 코어 UI 또는 서비스 포털에서 참조 변수의 표시 값을 가져오는 방법을 보여줍니다. 이 예제의 사용 사례는 커뮤니티 사이트에 있습니다.

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)

매개변수로 지정된 HTML 요소를 반환합니다.

복합 필드에는 여러 HTML 요소가 포함될 수 있습니다. 양식의 필드를 사용하는 내장 메서드가 있기 때문에 일반적으로 이 메서드는 필요하지 않습니다.

모바일 스크립트 또는 서비스 포털 스크립트에서는 이 방법을 사용할 수 없습니다.

표 43. 매개변수
이름	유형	설명
ID	문자열	필드 ID입니다.

표 44. 반환
유형	설명
HTMLElement	필드의 HTML 요소입니다.

GlideForm - getFormElement()

양식의 HTML 요소를 반환합니다.

모바일 스크립트 또는 서비스 포털 스크립트에서는 이 방법을 사용할 수 없습니다.

표 45. 매개변수
이름	유형	설명
없음

표 46. 반환
유형	설명
HTMLFormElement	양식의 HTML 요소입니다.

GlideForm - getHelpTextControl(문자열 필드 이름)

지정된 필드에 대한 도움말 텍스트의 HTML 요소를 반환합니다.

이 메서드는 서비스 카탈로그 변수에만 적용할 수 있습니다.

표 47. 매개변수
이름	유형	설명
fieldName	문자열	필드의 이름입니다.

표 48. 반환
유형	설명
HTMLElement	도움말 텍스트 필드의 HTML 요소입니다.

GlideForm - getIntValue(문자열 필드 이름)

필드의 정수 값을 반환합니다.

표 49. 매개변수
이름	유형	설명
fieldName	문자열	필드 이름입니다.

표 50. 반환
유형	설명
번호	필드의 정수 값입니다.

GlideForm - getLabelOf(문자열 필드 이름)

필드 레이블의 일반 텍스트 값을 반환합니다.

표 51. 매개변수
이름	유형	설명
fieldName	문자열	필드 이름

표 52. 반환
유형	설명
문자열	레이블 텍스트입니다.

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

GlideForm - getOption(String fieldName, String choiceValue)

where 는 옵션 값과 일치하는 이름으로 choiceValue 선택한 상자에 fieldName 대한 옵션 요소를 반환합니다.

주:

이 메서드는 읽기 전용 필드에서는 작동하지 않습니다.

표 53. 매개변수
이름	유형	설명
fieldName	문자열	필드의 이름입니다.
선택 값	문자열	옵션의 값입니다.

표 54. 반환
유형	설명
HTMLElement	옵션에 대한 HTMLElement입니다. 필드나 옵션을 찾을 수 없으면 null을 반환합니다.

다음 예시에서는 선택 목록 값의 레이블을 가져오는 방법을 보여줍니다.

// 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, 함수 콜백)

지정된 필드에 대한 GlideRecord를 반환합니다.

콜백 함수가 있는 경우 이 루틴은 비동기적으로 실행됩니다. 브라우저(및 스크립트) 처리는 서버가 참조 값을 반환할 때까지 정상적으로 계속되며, 이때 콜백 함수가 호출됩니다. 콜백 함수가 없는 경우 이 루틴은 동기적으로 실행되고 서버 응답을 기다리는 동안 처리가 중단됩니다(브라우저가 중단된 것처럼 보임).

중요사항:

콜백 함수를 사용하는 것이 좋습니다.

ServiceCatalogForm.getReference에 대한 콜백 함수 지원을 사용할 수 있습니다.

주:

이 메서드를 사용하려면 서버를 호출해야 하므로 추가 시간이 필요하고 페이지에 대기 시간이 발생할 수 있습니다. 이 방법은 주의해서 사용해야 합니다. 자세한 내용은 클라이언트 스크립트 디자인 및 처리를 참조하십시오.

표 55. 매개변수
이름	유형	설명
fieldName	문자열	필드의 이름입니다.
콜백	함수	콜백 함수의 이름입니다.

표 56. 반환
유형	설명
GlideRecord	지정된 필드에 대한 GlideRecord 객체입니다. 지정된 참조를 찾을 수 없는 경우 currentRow = -1, rows.length = 0인 초기화된 GlideRecord 객체를 반환합니다.

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()

현재 양식에서 관련 목록 이름의 배열을 반환합니다.

표 57. 매개변수
이름	유형	설명
없음

표 58. 반환
유형	설명
배열	현재 양식에서 관련 목록 이름의 문자열 배열입니다. 관련 목록 이름은 양식에 나타나는 순서대로 나열됩니다.

var listNames = g_form.getRelatedListNames();

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

GlideForm - getSectionNames()

표시 여부에 관계없이 모든 섹션 이름을 반환합니다.

표 59. 매개변수
이름	유형	설명
없음

표 60. 반환
유형	설명
문자열 배열	섹션 이름입니다.

GlideForm - getSections()

양식 섹션의 배열을 반환합니다.

모바일 플랫폼에서는 이 방법을 사용할 수 없습니다. 모바일 플랫폼에서 이 메서드를 실행하면 아무 작업도 수행되지 않습니다.

표 61. 매개변수
이름	유형	설명
없음

표 62. 반환
유형	설명
HTML 요소의 배열	양식의 섹션입니다.

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()

이 기록이 속한 테이블의 이름을 반환합니다.

서버 측에서 current.sys_class_name 또는 current.getTableName()을 사용하여 현재 레코드의 테이블을 검색할 수 있습니다.

표 63. 매개변수
이름	유형	설명
없음

표 64. 반환
유형	설명
문자열	테이블의 이름입니다.

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

GlideForm - getUniqueValue()

양식에 표시된 기록의 sys_id 반환합니다.

표 65. 매개변수
이름	유형	설명
없음

표 66. 반환
유형	설명
문자열	기록의 sys_id.

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

GlideForm - getValue(문자열 필드 이름)

지정된 양식 필드의 값을 반환합니다.

이 방법은 MRVS(복수 행 변수 세트)에서 값을 가져오는 것도 지원합니다. MRVS 내의 필드에서 데이터를 가져오려면 먼저 JSON.parse(getValue('<mrvs_field_name>') || '[]') 를 사용하여 MRVS 배열을 가져온 다음, 인덱싱을 사용하여 행 객체 내의 필드에 액세스합니다. 자세한 내용은 아래 코드 예제를 참조하십시오.

표 67. 매개변수
이름	유형	설명
fieldName	문자열	반환할 값이 있는 필드의 이름입니다.

표 68. 반환
유형	설명
문자열	지정된 필드의 값입니다.

다음 예시에서는 현재 양식에서 짧은 설명을 가져오는 방법을 보여줍니다.

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

다음 예제에서는 MRVS에서 값을 가져오는 방법을 보여 줍니다. 이 예에서는 Service Catalog를 통해 급여가 관리되고 있습니다. 클라이언트 스크립트는 직함에 입력된 값에 대해 MRVS 내의 모든 행을 검색한 다음 급여 필드에 입력된 값으로 MRVS 내의 일치하는 항목을 업데이트합니다 . 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()

모든 필드 메시지를 숨깁니다.

표 69. 매개변수
이름	유형	설명
없음

표 70. 반환
유형	설명
void

GlideForm - hideAllFieldMsgs(문자열 유형)

지정된 유형의 모든 필드 메시지를 숨깁니다.

표 71. 매개변수
이름	유형	설명
유형	문자열	메시지 유형입니다. 유효한 값은 다음과 같습니다. 오류 정보

표 72. 반환
유형	설명
void

GlideForm - hideErrorBox(문자열 필드 이름)

showErrorBox()가 배치한 오류 메시지를 숨깁니다.

가능하면 이 메서드 대신 hideFieldMsg() 를 사용하십시오.

표 73. 매개변수
이름	유형	설명
fieldName	문자열	필드 또는 컨트롤의 이름입니다.

표 74. 반환
유형	설명
void

GlideForm - hideFieldMsg(String fieldName, Boolean clearAll)

현재 양식의 지정된 필드에 나타나는 첫 번째 메시지를 숨깁니다.

GlideForm - showFieldMsg(문자열 필드, 문자열 메시지, 문자열 유형) or GlideForm - showFieldMsg(문자열 필드, 문자열 메시지, 문자열 유형, 부울 scrollForm) 메서드를 사용하여 양식에 메시지를 표시합니다.

예를 들어, 다음 코드 조각에서는 폼의 work_notes 필드에 두 개의 메시지를 표시한 다음 첫 번째 메시지를 숨기는 방법을 보여 줍니다.

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'

표 75. 매개변수
이름	유형	설명
fieldName	문자열	메시지를 숨길 필드의 이름입니다.
모두 지우기	부울	옵션입니다. 지정된 필드에 대한 모든 메시지를 숨길지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 모든 메시지를 숨깁니다. false: 표시되는 첫 번째 메시지만 숨깁니다. 기본값: false

표 76. 반환
유형	설명
void

다음 예제에서는 지정된 양식 필드에 대한 모든 메시지를 지운 다음 암호화 오류 메시지를 표시하는 방법을 보여줍니다.

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 - hideRelatedList(문자열 listTableName)

양식에 지정된 관련 목록을 숨깁니다.

모바일 플랫폼에서는 이 방법을 사용할 수 없습니다. 모바일 플랫폼에서 이 메서드를 실행하면 아무 작업도 수행되지 않습니다.

표 77. 매개변수
이름	유형	설명
listTableName	문자열	관련 목록의 이름입니다. sys_id 사용하여 관계를 통해 목록을 숨깁니다.

표 78. 반환
유형	설명
void

GlideForm - hideRelatedLists()

양식에서 모든 관련 목록을 숨깁니다.

모바일 플랫폼에서는 이 방법을 사용할 수 없습니다. 모바일 플랫폼에서 이 메서드를 실행하면 아무 작업도 수행되지 않습니다.

표 79. 매개변수
이름	유형	설명
없음

표 80. 반환
유형	설명
void

GlideForm - isLiveUpdating()

양식이 표시되는 기록에서 라이브 업데이트가 수행되는 동안 예를 반환합니다.

onChange() 클라이언트 스크립트에서 기록 변경이 다른 세션의 라이브 업데이트로 인한 것인지 판별하는 데 사용할 수 있습니다. 그런 다음 클라이언트 스크립트는 수행할 작업 또는 수행하지 않을 작업을 결정할 수 있습니다. 이는 라이브 양식을 사용하는 코어 UI 시스템에 적용됩니다.

표 81. 매개변수
이름	유형	설명
없음

표 82. 반환
유형	설명
부울	양식에 표시된 기록에서 라이브 업데이트가 발생하는 경우 예를 반환합니다.

GlideForm - isMandatory(문자열, fieldName)

필드가 필수인 경우 예를 반환합니다.

표 83. 매개변수
이름	유형	설명
fieldName	문자열	필드의 이름입니다.

표 84. 반환
유형	설명
부울	필드가 필수이면 True, 그렇지 않으면 False입니다.

GlideForm - isNewRecord()

기록이 저장되지 않은 경우 예를 반환합니다.

표 85. 매개변수
이름	유형	설명
없음

표 86. 반환
유형	설명
부울	기록이 저장되지 않은 경우 예를 반환합니다. 그렇지 않으면 false입니다.

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

GlideForm - isSectionVisible(문자열, sectionName)

섹션이 표시되는 경우 예를 반환합니다.

중요사항:

작업 공간에서 isSectionVisible() 함수는 지원되지 않습니다.

표 87. 매개변수
이름	유형	설명
없음

표 88. 반환
유형	설명
부울	섹션이 표시되면 true를 반환합니다. 그렇지 않으면 false가 반환됩니다.

GlideForm - isVisible(문자열 필드 이름)

전달된 필드 이름과 연결된 필드를 현재 양식에 표시할지 여부를 결정합니다.

표 89. 매개변수
이름	유형	설명
fieldName	문자열	현재 양식에 표시되는지 여부를 확인할 필드의 이름입니다.

표 90. 반환
유형	설명
부울	지정된 필드가 현재 양식에 표시되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 필드가 양식에 표시됩니다. false: 필드가 양식에 표시되지 않습니다.

다음 코드 예제에서는 user_address 필드가 현재 폼에 표시되는지 확인하는 방법을 보여 줍니다.

if(g_form.isVisible('user_address')) {
    alert('is visible');
}
else {
    alert('is hidden');
}

GlideForm - onUserChangeValue(함수 fn)

사용자가 현재 양식의 필드를 수정할 때 이를 탐지하는 사용자 지정 이벤트 수신기를 등록합니다.

양식 필드가 수정되면 이벤트 수신기는 수신기가 처음 등록될 때 전달된 함수를 호출합니다. 이 수신기는 사용자가 양식의 필드를 변경할 때만 트리거됩니다. 클라이언트 스크립트, UI 정책 또는 기타 비 사용자 상호작용의 변경 사항은 수신기를 트리거하지 않습니다.

주:

클래식 환경의 저널 필드 또는 서비스 카탈로그 항목에는 이 방법이 작동하지 않습니다.

표 91. 매개변수
이름	유형	설명
에프엔	함수	사용자가 현재 양식 내에서 필드 값을 변경할 때 호출할 함수입니다. 이것은 실제로 함수 이름이 아니라 함수 코드입니다. 이 함수는 다음 세 개의 인수를 받아야 합니다. 필드 이름 원래 필드 값 업데이트된 필드 값

표 92. 반환
유형	설명
함수	onUserChangeValue 이벤트 리스너의 등록을 취소하기 위해 호출하는 함수입니다.

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(문자열 필드 이름)

목록 수집기 변수를 업데이트할 수 있습니다.

표 93. 매개변수
이름	유형	설명
fieldName	문자열	슬러시 버킷의 이름입니다.

표 94. 반환
유형	설명
void

g_form.refreshSlushbucket('bucket');

GlideForm - removeDecoration(String fieldname, String icon, String title)

지정된 필드에서 아이콘 및 제목과 일치하는 아이콘을 제거합니다.

주:

이 메서드는 서비스 카탈로그에서 지원되지 않습니다.

표 95. 매개변수
이름	유형	설명
fieldName	문자열	필드 이름입니다.
아이콘	문자열	제거할 아이콘의 이름입니다.
제목	문자열	아이콘의 텍스트 제목(이름)입니다.

표 96. 반환
유형	설명
void

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(String fieldname, String icon, String title, String color)

지정된 필드에서 아이콘, 제목 및 색상과 일치하는 아이콘을 제거합니다.

주:

이 메서드는 서비스 카탈로그에서 지원되지 않습니다.

표 97. 매개변수
이름	유형	설명
fieldName	문자열	필드 이름입니다.
아이콘	문자열	제거할 아이콘의 이름입니다.
제목	문자열	아이콘의 텍스트 제목(이름)입니다.
색상	문자열	CSS 색상

표 98. 반환
유형	설명
void

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

GlideForm - removeOption(String fieldName, String choiceValue)

선택 목록에서 지정된 옵션을 제거합니다.

표 99. 매개변수
이름	유형	설명
fieldName	문자열	필드의 이름입니다.
선택 값	문자열	데이터베이스에 저장된 값입니다. 이것은 레이블이 아닙니다.

표 100. 반환
유형	설명
void

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

GlideForm - save()

다른 곳으로 이동하지 않고 기록을 저장합니다(업데이트 및 유지).

표 101. 매개변수
이름	유형	설명
없음

표 102. 반환
유형	설명
void

GlideForm - setMandatory(String fieldName, 부울 필수)

지정된 필드를 필수 필드로 만듭니다.

가능하면 이 메서드 대신 UI 정책을 사용합니다.

표 103. 매개변수
이름	유형	설명
fieldName	문자열	필드의 이름입니다.
필수	부울	예일 경우 필드는 필수 필드입니다. false인 경우 필드는 선택 사항입니다.

표 104. 반환
유형	설명
void

GlideForm - setSectionDisplay(String sectionName, 부울 표시)

섹션을 표시하거나 숨깁니다.

표 105. 매개변수
이름	유형	설명
sectionName	문자열	섹션 이름은 소문자이며 이름의 첫 번째 공백을 밑줄로 대체하고 나머지 공백은 제거됩니다(예: "Section Four is Here"는 "section_fourishere"가 됨). 앰퍼샌드(&)와 같은 영숫자가 아닌 다른 문자는 제거됩니다. 섹션 이름은 getSectionNames() 메서드를 사용하여 찾을 수 있습니다.
표시	부울	예일 경우 섹션이 표시됩니다. false인 경우 섹션을 숨깁니다.

표 106. 반환
유형	설명
부울	성공하면 예를 반환합니다.

GlideForm - setValue(String fieldName, String value, String displayValue)

지정된 양식 필드의 값을 참조 기록에 지정된 표시 값의 값으로 설정합니다.

참조 필드의 값을 설정할 때 왕복을 방지하여 성능을 향상시키려면 setValue(fieldName, value)가 아닌 이 메서드를 사용합니다. 목록 수집기 필드에 여러 참조 값을 설정할 때는 and displayValue 매개변수에 value 배열을 전달합니다.

주:

setValue() 메소드는 OnChange 클라이언트 스크립트에서 사용될 때 스택 오버플로우를 일으킬 수 있습니다. 이는 값이 설정될 때마다 변경으로 등록되어 OnChange 클라이언트 스크립트가 다시 트리거될 수 있기 때문입니다. 이를 방지하려면 새 값이 이전 값과 다른지 확인하는 검사를 수행합니다. 예를 들어, setValue(shortDesc, newValue.toUpperCase());를 수행하기 전에 짧은 설명이 이미 대문자가 아닌지 확인합니다. 이렇게 하면 클라이언트 스크립트가 toUpperCase() 를 두 번 이상 적용하지 못하게 됩니다.

표 107. 매개변수
이름	유형	설명
fieldName	문자열	업데이트할 양식 필드의 이름입니다.
값	문자열 또는 배열	필드를 업데이트하는 데 사용할 참조 기록의 Sys_id입니다. 지정된 필드가 GlideList인 경우 이 매개변수는 sys_ids 배열을 포함할 수 있습니다. 이 경우 메서드는 배열에 지정된 모든 레코드의 조회를 수행하고 해당 값은 지정된 필드(관련 목록)의 내용을 업데이트하는 데 사용됩니다. 주: 선택 목록에서 값을 정의할 때는 레이블 대신 숫자 값을 사용해야 합니다.
displayValue	문자열 또는 배열	지정된 필드를 업데이트하는 데 사용할 지정된 참조 기록 내의 필드입니다. 예를 들어 사용자 [sys_user] 테이블에서는 userName일 수 있습니다. 지정된 필드가 GlideList인 경우 이 매개변수에는 표시 값 이름의 배열이 포함될 수 있습니다. 표시 값에 대한 자세한 내용은 표시 값을 참조하십시오.

표 108. 반환
유형	설명
void

이 예에서는 assigned_to 양식 필드를 업데이트하는 데 사용할 userName 필드가 포함된 참조 기록의 sys_id 전달하는 방법을 보여줍니다.

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

이 예에서는 GlideList glide-list_field_name에서 양식 필드를 업데이트하는 데 사용할 참조 기록 sys_ids 배열과 해당 표시 값 이름의 배열을 전달하는 방법을 보여줍니다.

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

GlideForm - showErrorBox(문자열 이름, 문자열 메시지, 부울 scrollForm)

지정된 양식 필드(제어 개체 또는 필드 이름) 아래에 오류 메시지를 표시합니다. 컨트롤이나 필드가 현재 화면에서 벗어나 있고 scrollForm 매개변수가 true이면 양식이 컨트롤이나 필드로 스크롤됩니다.

양식 필드가 화면을 벗어날 때(양식을 컨트롤 또는 필드로 스크롤) 자동 메시지 스크롤을 제어하는 전역 속성(glide.ui.scroll_to_message_field)을 사용할 수 있습니다. showFieldMsg() 메서드는 유형 매개 변수가 필요한 유사한 메서드입니다.

표 109. 매개변수
이름	유형	설명
이름	문자열	필드 또는 컨트롤의 이름입니다.
메시지	문자열	표시할 메시지입니다.
스크롤폼	부울	예인 경우 양식을 필드로 스크롤합니다. 속성이 false인 경우 양식이 필드로 스크롤되지 않습니다.

표 110. 반환
유형	설명
void

GlideForm - showFieldMsg(문자열 필드, 문자열 메시지, 문자열 유형)

지정된 양식 필드(제어 개체 또는 필드 이름) 아래에 정보 또는 오류 메시지를 표시합니다. 컨트롤이나 필드가 화면 밖에 있으면 양식이 필드로 스크롤됩니다.

양식 필드가 화면을 벗어날 때(양식을 컨트롤 또는 필드로 스크롤) 자동 메시지 스크롤을 제어하는 전역 속성(glide.ui.scroll_to_message_field)을 사용할 수 있습니다.

showErrorBox() 메서드는 type 매개 변수가 필요하지 않은 약식 메서드입니다.

주:

이 메서드는 의 코어 UI유형 필드에서는 journal_field 작동하지 않습니다.

표 111. 매개변수
이름	유형	설명
필드	문자열	필드 또는 컨트롤의 이름입니다.
메시지	문자열	표시할 메시지입니다.
유형	문자열	"오류", "정보" 또는 "경고".

표 112. 반환
유형	설명
void

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

GlideForm - showFieldMsg(문자열 필드, 문자열 메시지, 문자열 유형, 부울 scrollForm)

지정된 양식 필드(제어 개체 또는 필드 이름) 아래에 정보 또는 오류 메시지를 표시합니다. 컨트롤이나 필드가 현재 화면 밖에 있고 scrollForm이 true이면 양식이 필드로 스크롤됩니다.

양식 필드가 화면을 벗어날 때(양식을 컨트롤 또는 필드로 스크롤) 자동 메시지 스크롤을 제어하는 전역 속성(glide.ui.scroll_to_message_field)을 사용할 수 있습니다.

showErrorBox() 메서드는 type 매개 변수가 필요하지 않은 약식 메서드입니다.

주:

이 메서드는 의 코어 UI유형 필드에서는 journal_field 작동하지 않습니다.

표 113. 매개변수
이름	유형	설명
필드	문자열	필드 또는 컨트롤의 이름입니다.
메시지	문자열	표시할 메시지입니다.
유형	문자열	"오류", "정보" 또는 "경고".
스크롤폼	부울	예일 때는 양식이 화면 밖에 있는 경우 필드로 스크롤됩니다. false인 경우 양식이 스크롤되지 않습니다.

표 114. 반환
유형	설명
void

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

GlideForm - setDisabled(문자열 필드 이름, 부울 사용 안 함)

지정된 필드를 사용할 수 있거나 사용할 수 없게 만듭니다.

표 115. 매개변수
이름	유형	설명
fieldName	문자열	필드의 이름입니다.
사용 안 함	부울	예일 때는 필드를 비활성화합니다. false인 경우 필드를 활성화합니다.

표 116. 반환
유형	설명
void

GlideForm - setDisplay(문자열 필드 이름, 부울 표시)

필드를 표시하거나 숨깁니다.

이 메서드는 값이 없는 필수 필드를 숨길 수 없습니다. 필드가 숨겨지면 다른 항목을 표시하는 데 공간이 사용됩니다. 가능하면 이 메서드 대신 UI 정책을 사용합니다.

표 117. 매개변수
이름	유형	설명
필드 이름	문자열	필드의 이름입니다.
표시	부울	예일 경우 필드를 표시하고 아니오일 경우 필드를 숨깁니다.

표 118. 반환
유형	설명
void

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(문자열 필드 이름, 문자열 레이블)

필드 레이블의 일반 텍스트 값을 설정합니다.

주:

이 메서드는 서비스 카탈로그에서 지원되지 않습니다.

표 119. 매개변수
이름	유형	설명
fieldName	문자열	필드 이름입니다.
레이블	문자열	필드 텍스트 레이블입니다.

표 120. 반환
유형	설명
void

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

GlideForm - setReadOnly(String fieldName, Boolean readOnly)

지정된 필드를 읽기 전용 또는 편집 가능하게 만듭니다.

가능하면 이 메서드 대신 UI 정책을 사용합니다.

필수 필드를 읽기 전용으로 만들려면 먼저 setMandatory() 메서드를 사용하여 해당 필드에 대한 필수 요구 사항을 제거해야 합니다.

필드를 읽기 전용으로 설정하면 setValue() 메서드를 사용하여 해당 필드의 값을 업데이트할 수 없습니다. 이러한 방식으로 값을 설정해야 하는 경우 readOnly 값을 false로 설정해야 합니다.

표 121. 매개변수
이름	유형	설명
fieldName	문자열	필드의 이름입니다.
readOnly	부울	연결 필드를 편집할 수 있는지 또는 읽기 전용인지 여부를 결정하는 플래그입니다. 가능한 값: true: 필드를 읽기 전용으로 설정 false: 필드를 편집 가능하도록 설정

표 122. 반환
유형	설명
안 함

다음 예는 변수 편집기를 읽기 전용으로 설정하는 방법을 보여줍니다. 테이블에서 이 서비스 카탈로그 작업을 수행하려면 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(String fieldName, String value)

지정된 양식 필드의 값을 전달된 값으로 설정합니다.

이 방법은 MRVS(복수 행 변수 세트)의 값 설정도 지원합니다. 먼저 JSON.parse(getValue('<mrvs_field_name>')) 를 사용하여 MRVS 배열을 가져온 다음 인덱싱을 사용하여 행 개체 내의 필드를 업데이트해야 합니다. MRVS에서 모든 값이 업데이트되면 setValue() 메서드를 사용하여 업데이트된 MRVS 배열을 저장합니다. 자세한 내용은 아래 코드 예제를 참조하십시오.

주:

setValue() 메소드는 OnChange 클라이언트 스크립트에서 사용될 때 스택 오버플로우를 일으킬 수 있습니다. 이는 값이 설정될 때마다 변경으로 등록되어 OnChange 클라이언트 스크립트가 다시 트리거될 수 있기 때문입니다. 이를 방지하려면 새 값이 이전 값과 다른지 확인하는 검사를 수행합니다. 예를 들어, setValue(shortDesc, newValue.toUpperCase());를 수행하기 전에 짧은 설명이 이미 대문자가 아닌지 확인합니다. 이렇게 하면 클라이언트 스크립트가 toUpperCase() 를 두 번 이상 적용하지 못하게 됩니다.

표 123. 매개변수
이름	유형	설명
fieldName	문자열	업데이트할 양식 필드의 이름입니다.
값	문자열	지정된 필드에 설정할 문자열 값입니다. 주: 선택 목록에서 값을 정의할 때는 레이블이 아닌 숫자 값을 사용해야 합니다.

표 124. 반환
유형	설명
void

다음 예시에서는 현재 양식에서 짧은 설명을 설정하는 방법을 보여줍니다.

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

다음 예제에서는 MRVS에서 값을 설정하는 방법을 보여 줍니다. 이 예에서는 Service Catalog를 통해 급여가 관리되고 있습니다. 클라이언트 스크립트는 직함에 입력된 값에 대해 MRVS 내의 모든 행을 검색한 다음 급여 필드에 입력된 값으로 MRVS 내의 일치하는 항목을 업데이트합니다 . 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)

변수 편집기를 읽기 전용으로 서비스 카탈로그 만듭니다.

주:

이 메서드는 코어 UI의 변수 편집기에만 서비스 카탈로그 적용할 수 있습니다. 이 메서드는 양식에서 서비스 카탈로그 지원되지 않습니다.

메서드는 요청된 항목 [sc_req_item], 인시던트 [incident] 등과 같이 변수 편집기가 추가되는 테이블의 클라이언트 스크립트에 배치되어야 합니다. 변수를 다른 테이블에서 읽기 전용으로 설정하려면 setReadOnly() 메서드를 사용합니다.

참조: Service Catalog 변수 편집기

표 125. 매개변수
이름	유형	설명
isReadOnly	부울	변수 편집기가 읽기 전용인지 여부를 결정하는 플래그입니다. 가능한 값: true: 변수 편집기를 읽기 전용으로 설정합니다. false: 변수 편집기를 편집 가능으로 설정합니다. 기본값: false

표 126. 반환
유형	설명
안 함

클라이언트 스크립트에 다음 줄을 추가하면 변수 편집기가 읽기 전용으로 설정됩니다.

g_form.setVariablesReadOnly(true);

GlideForm - setVisible(String fieldName, Boolean display)

필드를 표시하거나 숨깁니다.

데스크톱 UI에서 숨겨진 공간은 빈 상태로 유지됩니다. 모바일 또는 서비스 포털 UI를 숨기면 내 다른 필드에 공백이 채워집니다. 이 메서드는 값이 없는 필수 필드를 숨길 수 없습니다.

가능하면 이 메서드 대신 UI 정책을 사용하십시오.

표 127. 매개변수
이름	유형	설명
fieldName	문자열	필드 이름입니다.
표시	부울	예일 경우 필드가 표시됩니다. false인 경우 필드를 숨깁니다.

표 128. 반환
유형	설명
void

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(문자열 이름, 문자열 메시지)

지정된 양식 필드(제어 개체 또는 필드 이름) 아래에 오류 메시지를 표시합니다. 컨트롤이나 필드가 현재 화면에서 벗어나 있으면 양식이 컨트롤이나 필드로 스크롤됩니다.

양식 필드가 화면을 벗어날 때(양식을 컨트롤 또는 필드로 스크롤) 자동 메시지 스크롤을 제어하는 전역 속성(glide.ui.scroll_to_message_field)을 사용할 수 있습니다. showFieldMsg() 메서드는 유형 매개 변수가 필요한 유사한 메서드입니다.

표 129. 매개변수
이름	유형	설명
이름	문자열	컨트롤 또는 필드의 이름입니다.
메시지	문자열	표시할 메시지입니다.

표 130. 반환
유형	설명
void

GlideForm - showRelatedList(문자열, listTableName)

양식에 지정된 관련 목록을 표시합니다.

모바일 플랫폼에서는 이 방법을 사용할 수 없습니다. 모바일 플랫폼에서 이 메서드를 실행하면 아무 작업도 수행되지 않습니다.

표 131. 매개변수
이름	유형	설명
listTableName	문자열	관련 목록의 이름입니다.

표 132. 반환
유형	설명
void

GlideForm - showRelatedLists()

양식의 모든 관련 목록을 표시합니다.

모바일 플랫폼에서는 이 방법을 사용할 수 없습니다. 모바일 플랫폼에서 이 메서드를 실행하면 아무 작업도 수행되지 않습니다.

표 133. 매개변수
이름	유형	설명
없음

표 134. 반환
유형	설명
void

GlideForm - 제출()

기록을 저장합니다.

사용자는 양식에서 제거되고 원래 위치로 돌아갑니다.

표 135. 매개변수
이름	유형	설명
없음

표 136. 반환
유형	설명
void

GlideForm - 제출(문자열 동사)

매개변수로 지정된 UI 작업을 수행합니다.

표 137. 매개변수
이름	유형	설명
동사	문자열	sys_ui_action 기록의 action_name입니다. 작업 이름은 표시되는 양식 버튼에 대한 것이어야 합니다.

표 138. 반환
유형	설명
void