GlideForm(g_form) - 클라이언트

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

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

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

주:

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

표 1. 매개변수
이름	유형	설명
fieldName	문자열	필드 이름입니다.
아이콘	문자열	지정된 필드 옆에 표시할 아이콘의 이름입니다. 유효한 값은 다음과 같습니다. icon-add icon-alert icon-book icon-book-open icon-calendar 아이콘 카드 icon-cart-full icon-catalog icon-check-circle icon-cog icon-comment icon-console icon-dashboard icon-database icon-delete 아이콘 서랍 icon-Edit icon-filter icon-folder icon-form icon-help icon-home icon-image icon-info icon-label icon-lightbulb 아이콘 목록 icon-livefeed icon-locked icon-mail icon-mobile icon-new-ticket icon-paperclip icon-power 아이콘 스크립트 icon-search icon-sort-ascending 아이콘 스타 icon-star-empty icon-tab icon-trash icon-tree icon-tree-right 아이콘-사용자 icon-user-group icon-view
직위	문자열	아이콘의 제목입니다.

표 2. 반환
유형	설명
void

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

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

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

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

주:

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

표 3. 매개변수
이름	유형	설명
fieldName	문자열	필드 이름입니다.
아이콘	문자열	지정된 필드 옆에 표시할 아이콘의 이름입니다. 유효한 값은 다음과 같습니다. icon-add icon-alert icon-book icon-book-open icon-calendar 아이콘 카드 icon-cart-full icon-catalog icon-check-circle icon-cog icon-comment icon-console icon-dashboard icon-database icon-delete 아이콘 서랍 icon-Edit icon-filter icon-folder icon-form icon-help icon-home icon-image icon-info icon-label icon-lightbulb 아이콘 목록 icon-livefeed icon-locked icon-mail icon-mobile icon-new-ticket icon-paperclip icon-power 아이콘 스크립트 icon-search icon-sort-ascending 아이콘 스타 icon-star-empty icon-tab icon-trash icon-tree icon-tree-right 아이콘-사용자 icon-user-group icon-view
직위	문자열	아이콘의 제목입니다.
색상	문자열	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: [ { actionName: "String", label: "String" } ]`
options.buttons.actionName	문자열	클릭한 버튼을 확인하기 위해 `FORM_MESSAGE_BUTTON_CLICKED` 이벤트 핸들러에서 사용하는 이름입니다. 예를 들어 actionName `assign_to_me` 버튼을 추가하는 경우 `FORM_MESSAGE_BUTTON_CLICKED` 이벤트에 `assigned_to_me` 때만 actionName 실행되는 이벤트 핸들러 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 - addHighMessage(문자열 메시지)

양식 상단에 높은 우선순위 메시지를 표시합니다.

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

표 9. 매개변수
이름	유형	설명
메시지	문자열	양식에 표시할 높은 우선순위 메시지입니다.

표 10. 반환
유형	설명
없음

다음 예제에서는 양식 맨 위에 높은 우선 순위 메시지를 표시하는 방법을 보여 줍니다.

g_form.addHighMessage("This is a high priority message");

GlideForm - addInfoMessage(문자열 메시지)

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

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

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

표 12. 반환
유형	설명
void

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

GlideForm - addLowMessage(문자열 메시지)

양식 상단에 우선순위가 낮은 메시지를 표시합니다.

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

표 13. 매개변수
이름	유형	설명
메시지	문자열	양식에 표시할 낮은 우선순위 메시지입니다.

표 14. 반환
유형	설명
없음

다음 예제에서는 양식 맨 위에 우선 순위가 낮은 메시지를 표시하는 방법을 보여 줍니다.

g_form.addLowMessage(“This is a low priority message");

GlideForm - addModerateMessage(문자열 메시지)

양식 상단에 보통 수준의 우선순위 메시지를 표시합니다.

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

표 15. 매개변수
이름	유형	설명
메시지	문자열	양식에 표시할 보통 우선순위 메시지입니다.

표 16. 반환
유형	설명
없음

다음 예제에서는 양식 맨 위에 보통 우선 순위 메시지를 표시하는 방법을 보여 줍니다.

g_form.addModerateMessage("This is a moderate priority message");

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

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

표 17. 매개변수
이름	유형	설명
fieldName	문자열	선택 필드 옵션을 추가할 필드의 이름입니다.
choiceValue	문자열	데이터베이스에 저장할 값입니다.
선택 레이블	문자열	표시할 값입니다.

표 18. 반환
유형	설명
void

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

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

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

주:

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

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

표 20. 반환
유형	설명
void

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

GlideForm - addSuccessMessage(문자열 메시지)

양식 상단에 성공 메시지를 표시합니다.

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

표 21. 매개변수
이름	유형	설명
메시지	문자열	양식에 표시할 성공 메시지입니다.

표 22. 반환
유형	설명
없음

다음 예제에서는 양식 맨 위에 성공 확인 메시지를 표시하는 방법을 보여 줍니다.

g_form.addSuccessMessage("This is a success message");

GlideForm - clearAllFormMessages()

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

참조:

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

표 24. 반환
유형	설명
없음

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

g_form.clearAllFormMessages();

GlideForm - clearFormMessages(문자열 유형)

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

참조:

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

표 26. 반환
유형	설명
없음

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

g_form.clearFormMessages('error');

GlideForm - clearMessages()

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

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

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

표 28. 반환
유형	설명
void

g_form.clearMessages();

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

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

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

표 30. 반환
유형	설명
void

GlideForm - clearValue(String fieldName)

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

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

표 32. 반환
유형	설명
void

GlideForm - disableAttachments()

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

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

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

표 34. 반환
유형	설명
void

GlideForm - disableChoice(String fieldName, String choiceValue)

선택 항목이 있는 경우 드롭다운 필드에서 특정 선택 항목을 프로그래밍 방식으로 비활성화합니다. 선택이 이미 비활성화되어 있으면 변경되지 않습니다.

표 35. 매개변수
이름	유형	설명
fieldName	문자열	비활성화할 선택의 필드 이름입니다. 데이터 유형: 문자열
choiceValue	문자열	비활성화할 선택 항목의 값입니다. 데이터 유형: 문자열

표 36. 반환
유형	설명
부울	양식에서 지정된 선택이 비활성화 또는 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 선택을 사용할 수 없습니다. false: 옵션이 이미 비활성화되었거나 찾을 수 없습니다. 데이터 유형: 부울

다음 예제에서는 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()

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

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

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

표 38. 반환
유형	설명
void

GlideForm - enableChoice(String fieldName, String choiceValue)

선택 항목이 있는 경우 드롭다운 필드에서 특정 선택 항목을 프로그래밍 방식으로 활성화합니다. 이 옵션이 이미 활성화되어 있으면 변경되지 않습니다.

표 39. 매개변수
이름	유형	설명
fieldName	문자열	사용하도록 선택할 필드 이름입니다.
choiceValue	문자열	활성화하도록 선택하는 값입니다.

표 40. 반환
유형	설명
부울	지정된 선택이 성공적으로 활성화되었는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 선택이 활성화됩니다. false: 선택 항목이 이미 활성화되어 있거나 찾을 수 없습니다. 데이터 유형: 부울

다음 예시에서는 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(문자열 필드 이름, 문자열 색상, 숫자 수)

필드에 주의를 끄는 데 사용합니다. 지정된 필드에서 지정된 시간 동안 지정된 색상을 깜박입니다.

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

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

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

표 42. 반환
유형	설명
void

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

GlideForm - getActionName()

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

주:

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

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

표 44. 반환
유형	설명
문자열	클릭한 UI 작업의 현재 작업 이름 또는 sys_id입니다.

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

GlideForm - getAnnotationByName(문자열 이름)

지정된 이름의 양식 주석을 반환합니다.

주석 은 양식 요소 간의 시각적 구분 기호 또는 양식 요소를 강조 표시하는 데 사용되는 색상 텍스트 블록입니다. 양식의 모든 주석을 반환하는 데 사용합니다 GlideForm - getAnnotationByName(문자열 이름) .

표 45. 매개변수
이름	유형	설명
이름	문자열	반환할 주석의 이름입니다. 테이블: 양식 주석 [sys_ui_annotation], 필드: 이름

표 46. 반환
속성	설명
객체 배열	주석의 내용입니다. 데이터 유형: 객체 배열 `[{content: "String", name: "String", visible: Boolean}]`
array.content	반환된 주석의 텍스트입니다. 데이터 유형: 문자열
array.name	반환된 주석의 이름입니다. 데이터 유형: 문자열 테이블 위치: 양식 주석 [sys_ui_annotation], 필드: 이름
array.visible	양식에 주석이 표시되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 주석이 표시됩니다. false: 주석이 표시되지 않습니다. 데이터 유형: 부울

다음 예제에서는 getAnnotationByName() 메서드를 사용하여 지정된 이름인 test-annotation-msg-1에 따라 양식 주석을 검색하는 방법을 보여 줍니다.

   var sampleAnnotation = g_form.getAnnotationByName("test-annotation-msg-1");

   /* returns:  
   { 
       "name": "test-annotation-msg-1", 
       "visible": true, 
       "content": "Test<input id=\"make_spacing_ok\" style=\"visibility:hidden; width:0px;\">" 
   }
   */

GlideForm - getAnnotations()

양식에 있는 모든 주석의 목록을 반환합니다.

주석 은 양식 요소 간의 시각적 구분 기호 또는 양식 요소를 강조 표시하는 데 사용되는 색상 텍스트 블록입니다. 특정 주석을 이름으로 반환하는 데 사용합니다 GlideForm - getAnnotationByName(문자열 이름) .

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

표 48. 반환
속성	설명
객체 배열	주석의 내용입니다. 데이터 유형: 객체 배열 `[{content: "String", name: "String", visible: Boolean}]`
array.content	반환된 주석의 텍스트입니다. 데이터 유형: 문자열
array.name	반환된 주석의 이름입니다. 데이터 유형: 문자열 테이블 위치: 양식 주석 [sys_ui_annotation], 필드: 이름
array.visible	양식에 주석이 표시되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 주석이 표시됩니다. false: 주석이 표시되지 않습니다. 데이터 유형: 부울

다음 예제에서는 먼저 getAnnotations() 를 호출하여 양식의 모든 주석을 반환한 다음 hideAnnotation() 을 호출하여 양식의 모든 주석을 숨깁니다.

const annotations = getAnnotations();

/* returns:  
[ 
    { 
        "name": "test-annotation-msg-1", 
        "visible": true, 
        "content": "Test<input id=\"make_spacing_ok\" style=\"visibility:hidden; width:0px;\">" 
    }, 
    { 
        "name": "test-annotation-msg-2", 
        "visible": true, 
        "content": "Test 2<input id=\"make_spacing_ok\" style=\"visibility:hidden; width:0px;\">" 
    } 

]*/
annotations.forEach(function(annotation) {
	g_form.hideAnnotation(annotation.name);
});

// this script hides all annotations on the form.

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

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

표 49. 매개변수
이름	유형	설명
fieldName	문자열	`"<table-name>.<field-name>"` 형식으로 강조 표시할 필드입니다.

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

GlideForm - getChoice(String fieldName, String choiceValue)

지정된 필드와 선택 값을 나타내는 속성이 있는 객체를 반환합니다.

표 51. 매개변수
이름	유형	설명
fieldName	문자열	검색하기 위해 선택한 필드 이름입니다.
choiceValue	문자열	검색하기 위해 선택한 값입니다.

표 52. 반환
속성	설명
GlideFormChoice 객체 또는 null	지정된 필드 및 선택 값에 대한 GlideFormChoice 객체입니다. 일치하는 선택 항목이 없으면 null을 반환합니다. 데이터 유형: 객체 `("label", "value", "disabled", "index")`
GlideFormChoice.label	선택한 읽기 전용 표시 텍스트입니다. 데이터 유형: 문자열
GlideFormChoice.value	선택한 읽기 전용 값입니다. 데이터 유형: 문자열
GlideFormChoice.disabled	양식에서 선택을 사용할 수 없는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 선택이 비활성화됨 false: 선택이 활성화됩니다. 데이터 유형: 부울
GlideFormChoice.index	드롭다운에서 선택 위치를 나타냅니다. 데이터 유형: 숫자

다음 예시에서는 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(문자열 필드 이름)

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

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

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

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

표 53. 매개변수
이름	유형	설명
fieldName	문자열	HTML 요소를 반환할 필드의 이름입니다.

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

GlideForm - getDecimalValue(String fieldName)

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

표 55. 매개변수
이름	유형	설명
fieldName	문자열	10진수 값을 반환할 필드의 이름입니다.

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

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

GlideForm - getDisplayBox(문자열 fieldName)

코어 UI의 양식에서 표시 값을 반환합니다.

주:

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

참조:

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

표 58. 반환
유형	설명
없음	양식에서 값을 검색할 필드의 이름입니다.

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에서 이 메서드를 인수 없이 g_form.getDisplayValue() 로 호출하면 개별 필드의 표시 값이 아닌 기록 표시 값이 반환됩니다.

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

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

다음 예제에서는 코어 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 요소가 포함될 수 있습니다. 양식의 필드를 사용하는 내장 메서드가 있기 때문에 일반적으로 이 메서드는 필요하지 않습니다.

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

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

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

GlideForm - getFormElement()

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

표 70. 반환
유형	설명
문자열	레이블 텍스트.

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 대한 옵션 요소를 반환합니다.

주:

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

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

표 72. 반환
유형	설명
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 - getOptions(문자열 필드 이름)

양식의 선택 또는 참조 필드에 대해 사용 가능한 옵션과 선택한 옵션을 반환합니다. 이 방법은 런타임 시 필드 옵션을 검사하거나 필터링해야 하는 동적 양식, 카탈로그 변수 및 변수 세트 및 통합에 유용합니다.

예를 들어 g_form.getOptions() 를 사용하여 다음을 수행할 수 있습니다.

watch_list 필드 유형에서 이름-값 쌍을 가져오고 설정합니다.
검색어로 사용 가능한 옵션을 검색하거나 필터링합니다.
콜백을 통해 동일한 자동 완성 결과에 액세스할 수 있습니다.
선택 필드, 참조 필드 및 고급 필드 유형(예: watch_list, glide_list, field_list, 슬러시버킷)에 대한 옵션을 가져와 설정합니다.

표 73. 매개변수
이름	유형	설명
fieldName	문자열	검색할 선택 또는 참조 필드의 필드 이름입니다.

표 74. 반환
속성	설명
객체 배열 또는 null	선택한 각 옵션의 값과 레이블을 포함하는 객체의 읽기 전용 배열입니다. 필드가 옵션을 지원하지 않는 경우 null을 반환합니다. 데이터 유형: 객체 배열 `[{value: "String", displayValue: "String"}]`
array.displayValue	선택 표시 값입니다. 데이터 유형: 문자열
array.value	옵션의 값입니다. 데이터 유형: 문자열
getAvailable(기간)	사용 가능한 모든 옵션을 반환하는 함수입니다. 검색어를 인수로 제공하여 표시 값(대/소문자를 구분하지 않는 하위 문자열 일치)별로 옵션을 필터링할 수 있습니다. 일치하는 선택 항목의 표시 값과 값을 가진 객체 배열의 약속을 반환합니다. 데이터 유형: 객체 배열 `[{value: "String", displayValue: "String"}]`

다음 예제에서는 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, 함수 콜백)

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

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

중요사항:

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

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

주:

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

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

표 76. 반환
유형	설명
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()

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

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

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

var listNames = g_form.getRelatedListNames();

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

GlideForm - getSectionNames()

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

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

표 80. 반환
유형	설명
문자열 배열	섹션 이름.

GlideForm - getSections()

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

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

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

표 82. 반환
유형	설명
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()을 사용하여 현재 레코드의 테이블을 검색할 수 있습니다.

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

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

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

GlideForm - getUniqueValue()

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

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

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

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

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

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

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

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

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

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

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

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

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

표 90. 반환
유형	설명
void

GlideForm - hideAllFieldMsgs(문자열 유형)

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

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

표 92. 반환
유형	설명
void

GlideForm - hideAnnotation(문자열 이름)

양식 UI에서 지정된 이름의 주석을 숨깁니다.

주석 은 양식 요소 간의 시각적 구분 기호 또는 양식 요소를 강조 표시하는 데 사용되는 색상 텍스트 블록입니다. 참조:

GlideForm - showErrorBox(문자열 이름, 문자열 메시지, 부울 scrollForm) 을 클릭하여 양식에 특정 주석을 표시합니다.
GlideForm - toggleAnnotations() 주석을 더욱 유연하게 켜고 끌 수 있습니다.

표 93. 매개변수
이름	유형	설명
이름	문자열	양식에서 숨길 주석의 이름입니다. 테이블: 양식 주석 [sys_ui_annotation], 필드: 이름

표 94. 반환
유형	설명
없음

다음 예는 hideAnnotation() 메서드를 사용하여 양식 필드에서 test-annotation-msg-1이라는 주석을 프로그래밍 방식으로 숨기는 방법을 보여줍니다.

g_form.hideAnnotation('test-annotation-msg-1');

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

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

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

표 95. 매개변수
이름	유형	설명
fieldName	문자열	오류 메시지를 숨길 필드 또는 컨트롤의 이름입니다.

표 96. 반환
유형	설명
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'

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

표 98. 반환
유형	설명
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 - hideRelatedLinks()

양식의 관련 링크 섹션을 숨깁니다.

참조:

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

표 100. 반환
유형	설명
없음

다음 예시 스크립트는 현재 양식에서 관련 링크를 숨깁니다.

// Hide related links
g_form.hideRelatedLinks()

GlideForm - hideRelatedList(문자열 listTableName)

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

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

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

표 102. 반환
유형	설명
void

GlideForm - hideRelatedLists()

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

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

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

표 104. 반환
유형	설명
void

GlideForm - hideTemplateBar()

양식에서 템플릿 막대를 숨깁니다.

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

표 106. 반환
유형	설명
없음

다음 예시 스크립트는 현재 양식에서 템플릿 모음을 숨깁니다.

g_form.hideTemplateBar()

GlideForm - isLiveUpdating()

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

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

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

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

GlideForm - isMandatory(문자열, fieldName)

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

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

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

GlideForm - isNewRecord()

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

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

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

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

GlideForm - isSectionVisible(문자열, sectionName)

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

중요사항:

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

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

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

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

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

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

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

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

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

GlideForm - onUserChangeValue(함수 fn)

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

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

주:

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

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

표 118. 반환
유형	설명
함수	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(문자열 필드 이름)

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

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

표 120. 반환
유형	설명
void

g_form.refreshSlushbucket('bucket');

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

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

주:

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

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

표 122. 반환
유형	설명
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)

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

주:

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

표 123. 매개변수
이름	유형	설명
fieldName	문자열	장식을 제거할 필드 이름입니다.
아이콘	문자열	제거할 아이콘의 이름입니다.
직위	문자열	아이콘의 텍스트 제목(이름)입니다.
색상	문자열	일치시킬 CSS 색상입니다.

표 124. 반환
유형	설명
void

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

GlideForm - removeOption(String fieldName, String choiceValue)

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

표 125. 매개변수
이름	유형	설명
fieldName	문자열	선택 목록에서 옵션을 제거할 필드의 이름입니다.
choiceValue	문자열	데이터베이스에 저장된 값입니다. 이것은 레이블이 아닙니다.

표 126. 반환
유형	설명
void

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

GlideForm - save()

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

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

표 128. 반환
유형	설명
void

GlideForm - setChoiceLabel(String fieldName, String choiceValue, String newLabel)

드롭다운 필드에서 특정 선택 항목의 레이블을 업데이트합니다.

이 메서드를 호출할 때 드롭다운에서 업데이트된 옵션의 인덱스 위치는 변경되지 않은 상태로 유지됩니다. 옵션의 사용 또는 사용 안 함 상태는 유지됩니다.

표 129. 매개변수
이름	유형	설명
fieldName	문자열	업데이트할 선택 항목이 포함된 필드 이름입니다. 데이터 유형: 문자열
choiceValue	문자열	새 레이블로 업데이트할 선택 레이블의 값입니다. 데이터 유형: 문자열
새 레이블	문자열	기존 선택 레이블을 업데이트할 레이블 이름입니다. 데이터 유형: 문자열

표 130. 반환
유형	설명
부울	옵션 레이블이 성공적으로 업데이트되었는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 선택 레이블이 업데이트됩니다. false: 업데이트하도록 지정된 선택 항목이 읽기 전용이거나 존재하지 않거나, 새 레이블이 존재하고 이미 다른 옵션과 연결되어 있기 때문에 선택 레이블이 업데이트되지 않습니다.

다음 예제에서는 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(문자열 필드 이름, 부울 사용 안 함)

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

표 131. 매개변수
이름	유형	설명
fieldName	문자열	사용하거나 사용하지 않도록 설정할 필드의 이름입니다.
사용 안 함	부울	지정된 필드를 비활성화할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 필드를 비활성화합니다. false: 필드를 활성화합니다. 기본값: false

표 132. 반환
유형	설명
void

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

양식에 지정된 필드를 표시하거나 숨깁니다.

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

표 133. 매개변수
이름	유형	설명
fieldName	문자열	필드의 이름입니다.
표시	부울	지정된 필드를 표시할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 필드를 표시합니다. false: 필드를 숨깁니다.

표 134. 반환
유형	설명
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(문자열 필드 이름, 문자열 레이블)

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

주:

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

표 135. 매개변수
이름	유형	설명
fieldName	문자열	레이블을 설정할 필드의 이름입니다.
레이블	문자열	레이블에 설정할 일반 텍스트 값입니다.

표 136. 반환
유형	설명
void

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

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

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

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

표 137. 매개변수
이름	유형	설명
fieldName	문자열	필수로 지정할 필드의 이름입니다.
필수	부울	필드가 필수인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 필드가 필수입니다. false: 필드는 선택 사항입니다. 기본값: false

표 138. 반환
유형	설명
void

GlideForm - setReadOnly(String fieldName, Boolean readOnly)

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

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

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

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

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

표 140. 반환
유형	설명
void

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

부울 값을 사용하여 양식 UI에서 관련 링크 섹션을 표시하거나 숨깁니다.

GlideForm - hideRelatedLinks() 양식에서 관련 링크 UI 작업을 표시하는 동안 GlideForm - showRelatedLinks() 숨깁니다. 그러나 g_form.setRelatedLinksDisplay(boolean: display) 메서드를 사용하여 스크립트에서 보다 유연하게 관련 링크를 표시하거나 숨길 수 있습니다.

표 141. 매개변수
이름	유형	설명
표시	부울	양식의 관련 링크 섹션을 표시하거나 숨길지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 양식에 관련 링크를 표시합니다. false: 양식에서 관련 링크를 숨깁니다. 기본값: true

표 142. 반환
유형	설명
없음

다음 예제에서는 양식에서 관련 링크 섹션을 표시하거나 숨기는 방법을 보여 줍니다.

// 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(String sectionName, 부울 표시)

양식에서 지정된 섹션을 표시하거나 숨깁니다.

표 143. 매개변수
이름	유형	설명
sectionName	문자열	섹션 이름은 소문자이며 이름의 첫 번째 공백을 밑줄로 대체하고 나머지 공백은 제거됩니다. 예를 들어, "Section Four는 Here"가 "section_fourishere"이 됩니다. 앰퍼샌드(&)와 같은 영숫자가 아닌 다른 문자는 제거됩니다. 섹션 이름은 getSectionNames() 메서드를 사용하여 찾을 수 있습니다.
표시	부울	섹션을 표시할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 섹션을 표시합니다. false: 섹션을 숨깁니다.

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

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() 를 두 번 이상 적용하지 못하게 됩니다.

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

표 146. 반환
유형	설명
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 - setValue(String fieldName, String value, String displayValue)

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

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

주:

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

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

표 148. 반환
유형	설명
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 - setVariablesReadOnly(부울: isReadOnly)

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

주:

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

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

참조: Service Catalog 변수 편집기

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

표 150. 반환
유형	설명
void

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

g_form.setVariablesReadOnly(true);

GlideForm - setVisible(String fieldName, Boolean display)

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

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

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

표 151. 매개변수
이름	유형	설명
fieldName	문자열	표시하거나 숨길 필드의 이름입니다.
표시	부울	지정된 필드를 표시할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 필드를 표시합니다. false: 필드를 숨깁니다.

표 152. 반환
유형	설명
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 - showAnnotation(문자열 이름)

양식 UI에 지정된 이름의 주석을 표시합니다.

주석 은 양식 요소 간의 시각적 구분 기호 또는 양식 요소를 강조 표시하는 데 사용되는 색상 텍스트 블록입니다. 참조:

GlideForm - hideAnnotation(문자열 이름) 을 클릭하여 양식에서 특정 주석을 숨깁니다.
GlideForm - toggleAnnotations() 주석을 더욱 유연하게 켜고 끌 수 있습니다.

표 153. 매개변수
이름	유형	설명
이름	문자열	양식에 표시할 주석의 이름입니다. 테이블: 양식 주석 [sys_ui_annotation], 필드: 이름

표 154. 반환
유형	설명
없음

다음 예제에서는 showAnnotation() 메서드를 사용하여 양식 필드에 test-annotation-msg라는 주석을 프로그래밍 방식으로 표시하는 방법을 보여줍니다.

g_form.showAnnotation('test-annotation-msg');

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

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

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

표 155. 매개변수
이름	유형	설명
이름	문자열	오류 메시지를 표시할 필드 또는 컨트롤의 이름입니다.
메시지	문자열	표시할 오류 메시지입니다.
스크롤폼	부울	양식을 오류 메시지 필드로 자동 스크롤할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 오류 메시지 필드로 스크롤합니다. false: 오류 메시지 필드로 스크롤하지 않습니다. 기본값: true

표 156. 반환
유형	설명
void

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

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

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

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

표 158. 반환
유형	설명
void

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

지정된 양식 필드(제어 개체 또는 필드 이름) 아래에 메시지를 표시합니다. 컨트롤이나 필드가 화면 밖에 있으면 메서드는 자동으로 폼을 해당 필드로 스크롤합니다.

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

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

주:

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

표 159. 매개변수
이름	유형	설명
필드	문자열	메시지를 표시할 필드 또는 컨트롤의 이름입니다.
메시지	문자열	표시할 메시지입니다.
유형	문자열	메시지 유형입니다. 유효한 값은 다음과 같습니다. 오류 정보 경고

표 160. 반환
유형	설명
void

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

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

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

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

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

주:

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

표 161. 매개변수
이름	유형	설명
필드	문자열	메시지를 표시할 필드 또는 컨트롤의 이름입니다.
메시지	문자열	표시할 메시지입니다.
유형	문자열	메시지 유형입니다. 유효한 값은 다음과 같습니다. 오류 정보 경고
스크롤폼	부울	양식을 메시지 필드까지 자동으로 스크롤할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 메시지 필드로 스크롤합니다. false: 메시지 필드로 스크롤하지 않습니다. 기본값: true

표 162. 반환
유형	설명
void

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

GlideForm - showRelatedLinks()

양식의 관련 링크 섹션을 표시합니다.

참조:

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

표 164. 반환
유형	설명
없음

다음 예에서는 양식 UI에 관련 링크를 표시합니다.

// Show related links
g_form.showRelatedLinks()

GlideForm - showRelatedList(문자열, listTableName)

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

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

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

표 166. 반환
유형	설명
void

GlideForm - showRelatedLists()

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

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

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

표 168. 반환
유형	설명
void

GlideForm - showTemplateBar()

숨겨지면 폼 아래쪽에 템플릿 모음이 표시됩니다.

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

표 170. 반환
유형	설명
없음

다음 예시 스크립트는 현재 양식의 맨 아래에 템플릿 막대를 표시합니다.

g_form.showTemplateBar()

GlideForm - 제출()

기록을 저장합니다.

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

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

표 172. 반환
유형	설명
void

GlideForm - 제출(문자열 동사)

지정된 UI 작업을 수행합니다.

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

표 174. 반환
유형	설명
void

GlideForm - toggleAnnotations()

양식의 모든 주석을 숨기거나 표시합니다.

주석 은 양식 요소 간의 시각적 구분 기호 또는 양식 요소를 강조 표시하는 데 사용되는 색상 텍스트 블록입니다. 어노테이션이 폼에 표시되는 경우 toggleAnnotations() 를 호출하면 주석이 숨겨집니다. 마찬가지로 폼에 주석이 숨겨져 있는 경우 이 메서드를 호출하면 주석이 표시됩니다.

참조:

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

표 176. 반환
유형	설명
없음

다음 예제에서는 toggleAnnotations() 를 호출하여 폼 주석을 표시하거나 숨기는 방법을 보여 줍니다. 따라서 주석은 이전 상태에 따라 숨겨지거나 표시됩니다.

g_form.toggleAnnotations();