GlideElementDescriptor - 범위, 전역

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 11분

    • GlideElementDescriptor API는 Glide 기록의 개별 필드에 대한 정보를 제공합니다.

    이 클래스에 대한 생성자가 없습니다. GlideElement 또는 GlideRecord getED() 메서드를 사용하여 GlideElementDescriptor 객체를 가져옵니다.

    GlideElementDescriptor - getAttachmentEncryptionType()

    요소 테이블의 첨부 파일에 사용되는 암호화 유형을 반환합니다.

    이 방법은 플러그인과 에지 암호화 규칙 함께 사용하기 위한 것입니다.

    표 1. 매개변수
    이름 유형 설명
    안 함
    표 2. 반환
    유형 설명
    문자열 첨부 파일에 사용되는 암호화 유형입니다. 요소 테이블의 첨부 파일이 암호화되지 않는 경우 null을 반환합니다. 
    var grInc = new GlideRecord('incident');
grInc.query('priority', '1');

var field = grInc.getElement('priority');
var ed = field.getED();

var isEdge = ed.getAttachmentEncryptionType();
gs.info(isEdge);

    출력:

    null

    GlideElementDescriptor - getEncryptionType()

    요소의 암호화 유형을 반환합니다.

    이 방법은 플러그인과 에지 암호화 규칙 함께 사용하기 위한 것입니다.

    표 3. 매개변수
    이름 유형 설명
    안 함
    표 4. 반환
    유형 설명
    문자열 요소의 암호화 유형입니다. 요소가 암호화되지 않은 경우 null을 반환합니다. 
    var grInc = new GlideRecord('incident');
grInc.query('priority', '1');

var field = grInc.getElement('priority');
var ed = field.getED();

sEdge = ed.getEncryptionType();
gs.info(isEdge);

    출력:

    null

    GlideElementDescriptor - getInternalType()

    요소의 내부 데이터 유형을 반환합니다.

    표 5. 매개변수
    이름 유형 설명
    안 함
    표 6. 반환
    유형 설명
    문자열 요소의 내부 데이터 유형입니다.
    가능한 값:
    • 부울
    • 문자
    • 수집
    • 조건
    • 날짜
    • 10진수
    • documentation_field
    • domain_id
    • due_date
    • 이메일
    • field_name
    • file_attachment
    • 부동
    • glide_date
    • glide_date_time
    • glide_duration
    • glide_list
    • GUID
    • HTML
    • 이미지
    • 정수
    • 길게
    • 경도
    • multi_two_lines
    • 일지
    • journal_input
    • 숫자
    • order_index
    • 암호
    • ph_number
    • 참조
    • 스크립트
    • script_plain
    • 문자열
    • sys_class_name
    • table_name
    • template_value
    • 타이머
    • translated_field
    • URL
    • user_image
    • user_input
    • user_roles
    • 비디오
    • 워크플로우
    		 
    var grInc = new GlideRecord('incident');
grInc.query('priority', '1');
 
var field = grInc.getElement('priority');
var ed = field.getED();
 
var isEdge = ed.getInternalType();
gs.info(isEdge);
    출력: 
    integer

    GlideElementDescriptor - getLabel()

    요소의 레이블을 반환합니다.

    표 7. 매개변수
    이름 유형 설명
    안 함
    표 8. 반환
    유형 설명
    문자열 요소의 레이블입니다. 
    var grInc = new GlideRecord('incident');
grInc.query('priority', '1');
 
var field = grInc.getElement('priority');
var ed = field.getED();
 
var isEdge = ed.getLabel();
gs.info(isEdge);

    출력:

    Priority

    GlideElementDescriptor - getLength()

    요소의 길이를 반환합니다.

    표 9. 매개변수
    이름 유형 설명
    안 함
    표 10. 반환
    유형 설명
    번호 요소의 크기입니다. 
    var grInc = new GlideRecord('incident');
grInc.query('priority', '1');
 
var field = grInc.getElement('priority');
var ed = field.getED();
 
var isEdge = ed.getLength();
gs.info(isEdge);

    출력:

    40

    GlideElementDescriptor - getName()

    요소의 이름을 반환합니다.

    표 11. 매개변수
    이름 유형 설명
    안 함
    표 12. 반환
    유형 설명
    문자열 요소의 이름입니다. 
    var grInc = new GlideRecord('incident');
grInc.query('priority', '1');
 
var field = grInc.getElement('priority');
var ed = field.getED();
 
var isEdge = ed.getName();
gs.info(isEdge);

    출력:

    priority

    GlideElementDescriptor - getPlural()

    요소의 복수 레이블을 반환합니다.

    표 13. 매개변수
    이름 유형 설명
    안 함
    표 14. 반환
    유형 설명
    문자열 요소의 복수 레이블입니다. 
    var now_GR = new GlideRecord('incident');
now_GR.query();
var ed = now_GR.getED();
gs.info(ed.getPlural());

    출력:

    Incidents

    GlideElementDescriptor - hasAttachmentsEncrypted()

    암호화된 첨부 파일이 테이블에 추가된 경우 예를 반환합니다.

    이 방법은 플러그인과 에지 암호화 규칙 함께 사용하기 위한 것입니다.

    표 15. 매개변수
    이름 유형 설명
    안 함
    표 16. 반환
    유형 설명
    부울 암호화된 첨부 파일이 테이블에 추가된 경우 예를 반환합니다. 
    var grInc = new GlideRecord('incident');
grInc.query('priority', '1');

var field = grInc.getElement('priority');
var ed = field.getED();

var isEdge = ed.hasAttachmentsEncrypted();
gs.info(isEdge);

    출력:

    false

    GlideElementDescriptor - isAutoOrSysID()

    요소가 자동 생성 필드 또는 시스템 필드인 경우 예를 반환합니다.

    자동으로 생성된 시스템 필드는 암호화할 수 없습니다. 이 방법은 플러그인과 에지 암호화 규칙 함께 사용하기 위한 것입니다.

    표 17. 매개변수
    이름 유형 설명
    안 함
    표 18. 반환
    유형 설명
    부울 요소가 자동으로 생성되거나 시스템 필드인 경우 True입니다. 
    var grInc = new GlideRecord('incident');
grInc.query('priority', '1');
var field = grInc.getElement('priority');
var ed = field.getED();

isEdge = ed.isAutoOrSysID();
gs.info(isEdge);

    출력:

    false

    GlideElementDescriptor - isChoiceTable()

    요소가 사전 정의에서 드롭다운 선택으로 정의된 경우 예를 반환합니다.

    선택 필드를 암호화할 수 없습니다.

    표 19. 매개변수
    이름 유형 설명
    안 함
    표 20. 반환
    유형 설명
    부울 요소가 드롭다운 선택으로 정의된 경우 예를 반환합니다. 선택 테이블에 정의된 항목이 없더라도 예를 반환합니다. 마지막 선택 유형인 제안은 true를 반환하지 않습니다. 
    var grInc = new GlideRecord('incident');
grInc.query('priority', '1');

var field = grInc.getElement('priority');
var ed = field.getED();

var isChoiceTable = ed.isChoiceTable();
gs.info(isChoiceTable);

    출력:

    true

    GlideElementDescriptor - isEdgeEncrypted()

    요소가 암호화된 경우 예를 반환합니다.

    이 방법은 플러그인과 에지 암호화 규칙 함께 사용하기 위한 것입니다.

    표 21. 매개변수
    이름 유형 설명
    안 함
    표 22. 반환
    유형 설명
    부울 요소가 암호화되면 예를 반환하고 그렇지 않으면 아니오를 반환합니다. 
    var grInc = new GlideRecord('incident');
grInc.query('priority', '1');

var field = grInc.getElement('priority');
var ed = field.getED();

var isEdge = ed.isEdgeEncrypted();
gs.info(isEdge)

    출력:

    false

    GlideElementDescriptor - isEncrypted()

    이 설명자로 표시되는 필드가 필드 암호화를 위해 구성되었는지 여부를 반환합니다.

    이 방법을 사용하면 중요한 데이터를 읽거나 쓰기 전에 암호화된 필드를 프로그래밍 방식으로 탐지하거나 필드의 암호화 상태에 따라 접근 정책을 적용할 수 있습니다.

    필요한 플러그인: Field Encryption Starter(com.glide.field.encryption.starter). 이 플러그인이 없으면 isEncrypted()가 false를 반환합니다 .

    표 23. 매개변수
    이름 유형 설명
    안 함
    표 24. 반환
    유형 설명
    부울

    필드가 필드 암호화를 위해 구성되어 있는지 여부를 나타내는 플래그입니다.

    유효한 값은 다음과 같습니다.
    • true: 필드가 필드 암호화를 위해 구성되어 있습니다.
    • 아니오: 필드가 암호화되지 않았거나 필드 암호화 스타터(com.glide.field.encryption.starter) 플러그인이 활성화되지 않았습니다.
    다음 서버 측 스크립트는 isEncrypted() 를 사용하여 값을 로깅하기 전에 인시던트 테이블의 short_description 필드가 암호화되었는지 확인합니다. 이를 인스턴스의 백그라운드 스크립트 또는 비즈니스 규칙에 복사하여 테스트합니다.
    주:
    또는 범위가 지정된 GlideElement - getED() 메서드 GlideRecord - getED() 를 사용하여 GlideElementDescriptor 개체를 가져옵니다.
    // Retrieve a sample Incident record
var gr = new GlideRecord('incident');
gr.setLimit(1);
gr.query();

if (gr.next()) {
    // Get the GlideElement for the field you want to inspect
    var element = gr.getElement('short_description');

    // Retrieve the descriptor from the element
    var descriptor = element.getED();

    // Check whether the field is configured for Field Encryption
    if (descriptor.isEncrypted()) {
        gs.info('short_description is encrypted. Value: ' + element.getDisplayValue());
    } else {
        gs.info('short_description is NOT encrypted. Value: ' + gr.getValue('short_description'));
    }
}
    출력(암호화되지 않음):
    short_description is NOT encrypted. Value: Unable to connect to network
    출력(필드에서 암호화 사용):
    short_description is encrypted. Value: Unable to connect to network

    GlideElementDescriptor - isMandatory()

    요소가 필수인지와 기록을 저장하기 전에 값을 포함해야 하는지 여부를 결정합니다.

    표 25. 매개변수
    이름 유형 설명
    안 함
    표 26. 반환
    유형 설명
    부울 연결된 요소가 필수인지 여부를 나타내며 요소를 포함하는 기록을 저장하기 전에 값을 포함해야 합니다.

    가능한 값:

    • true: 요소에 값이 포함되어야 합니다. 필수 필드
    • 아니오: 요소에 값을 포함할 필요가 없음

    이 예시에서는 이름 필드가 필수인지 여부를 확인하는 방법을 보여줍니다.

    var isRecordValid;
var now_GR = new GlideRecord('my_table');
var field = now_GR.getElement('name');
var elementDescriptor = field.getED();
now_GR.query();
while (now_GR.next()) {
if (elementDescriptor.isMandatory() && !now_GR.name) {
       isRecordValid = false;
  }
}

    GlideElementDescriptor - isVirtual()

    요소가 가상 요소인 경우 예를 반환합니다.

    가상 요소는 필드의 딕셔너리 정의에 의해 설정된 계산된 필드입니다. 가상 필드는 암호화할 수 없습니다.

    표 27. 매개변수
    이름 유형 설명
    안 함
    표 28. 반환
    유형 설명
    부울 요소가 가상 요소인 경우 예를 반환합니다. 
    var grInc = new GlideRecord('incident');
grInc.query('priority', '1');

var field = grInc.getElement('priority');
var ed = field.getED();

var isVirtual = ed.isVirtual();
gs.info(isVirtual);

    출력:

    false