---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideElementDescriptor - 범위, 전역

# GlideElementDescriptor - 범위, 전역 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 11분

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

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

## GlideElementDescriptor - getAttachmentEncryptionType() {#ariaid-title2}

요소 테이블의 첨부 파일에 사용되는 암호화 유형을 반환합니다.
이 방법은 플러그인과 에지 암호화 규칙 함께 사용하기 위한 것입니다.
{#r_ScopedGlideElementDescriptorGetAttachmentEncyrptionType__table_a3m_cg4_yr__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 1. 매개변수]

{#r_ScopedGlideElementDescriptorGetAttachmentEncyrptionType__table_a3m_cg4_yr} {#r_ScopedGlideElementDescriptorGetAttachmentEncyrptionType__table_b3m_cg4_yr__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 첨부 파일에 사용되는 암호화 유형입니다. 요소 테이블의 첨부 파일이 암호화되지 않는 경우 null을 반환합니다. |
[표 2. 반환]

{#r_ScopedGlideElementDescriptorGetAttachmentEncyrptionType__table_b3m_cg4_yr}  

    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() {#ariaid-title3}

요소의 암호화 유형을 반환합니다.
이 방법은 플러그인과 에지 암호화 규칙 함께 사용하기 위한 것입니다.
{#r_ScopedGlideElementDescriptorGetEncryptionType__table_icz_j24_yr__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 3. 매개변수]

{#r_ScopedGlideElementDescriptorGetEncryptionType__table_icz_j24_yr} {#r_ScopedGlideElementDescriptorGetEncryptionType__table_jcz_j24_yr__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 요소의 암호화 유형입니다. 요소가 암호화되지 않은 경우 null을 반환합니다. |
[표 4. 반환]

{#r_ScopedGlideElementDescriptorGetEncryptionType__table_jcz_j24_yr}  

    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() {#ariaid-title4}

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

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 5. 매개변수]

{#r_ScopedGlideElementDescriptorGetInternalType__table_rcc_gv3_yr} {#r_ScopedGlideElementDescriptorGetInternalType__table_scc_gv3_yr__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 요소의 내부 데이터 유형입니다. 가능한 값: * 부울 * 문자 * 수집 * 조건 * 날짜 * 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 * 비디오 * 워크플로우 {#r_ScopedGlideElementDescriptorGetInternalType__ul_g4m_znv_bkb} |
[표 6. 반환]

{#r_ScopedGlideElementDescriptorGetInternalType__table_scc_gv3_yr}  

    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() {#ariaid-title5}

요소의 레이블을 반환합니다.
{#r_ScopedGlideElementDescriptorGetLabel__table_ypm_sw3_yr__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 7. 매개변수]

{#r_ScopedGlideElementDescriptorGetLabel__table_ypm_sw3_yr} {#r_ScopedGlideElementDescriptorGetLabel__table_zpm_sw3_yr__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 요소의 레이블입니다. |
[표 8. 반환]

{#r_ScopedGlideElementDescriptorGetLabel__table_zpm_sw3_yr}  

    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() {#ariaid-title6}

요소의 길이를 반환합니다.
{#r_ScopedGlideElementDescriptorGetLength__table_hpy_3x3_yr__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 9. 매개변수]

{#r_ScopedGlideElementDescriptorGetLength__table_hpy_3x3_yr} {#r_ScopedGlideElementDescriptorGetLength__table_ipy_3x3_yr__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | 요소의 크기입니다. |
[표 10. 반환]

{#r_ScopedGlideElementDescriptorGetLength__table_ipy_3x3_yr}  

    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() {#ariaid-title7}

요소의 이름을 반환합니다.
{#r_ScopedGlideElementDescriptorGetName__table_sh3_zx3_yr__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 11. 매개변수]

{#r_ScopedGlideElementDescriptorGetName__table_sh3_zx3_yr} {#r_ScopedGlideElementDescriptorGetName__table_th3_zx3_yr__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 요소의 이름입니다. |
[표 12. 반환]

{#r_ScopedGlideElementDescriptorGetName__table_th3_zx3_yr}  

    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() {#ariaid-title8}

요소의 복수 레이블을 반환합니다.
{#r_SGED-getPlural__table_zqp_j1z_dv__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 13. 매개변수]

{#r_SGED-getPlural__table_zqp_j1z_dv} {#r_SGED-getPlural__table_arp_j1z_dv__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 요소의 복수 레이블입니다. |
[표 14. 반환]

{#r_SGED-getPlural__table_arp_j1z_dv}  

    var now_GR = new GlideRecord('incident');
    now_GR.query();
    var ed = now_GR.getED();
    gs.info(ed.getPlural());

출력:

    Incidents

## GlideElementDescriptor - hasAttachmentsEncrypted() {#ariaid-title9}

암호화된 첨부 파일이 테이블에 추가된 경우 예를 반환합니다.
이 방법은 플러그인과 에지 암호화 규칙 함께 사용하기 위한 것입니다.
{#r_ScopedGlideElementDescriptorHasAttachmentsEncrypted__table_pwt_1h4_yr__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 15. 매개변수]

{#r_ScopedGlideElementDescriptorHasAttachmentsEncrypted__table_pwt_1h4_yr} {#r_ScopedGlideElementDescriptorHasAttachmentsEncrypted__table_qwt_1h4_yr__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 암호화된 첨부 파일이 테이블에 추가된 경우 예를 반환합니다. |
[표 16. 반환]

{#r_ScopedGlideElementDescriptorHasAttachmentsEncrypted__table_qwt_1h4_yr}  

    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() {#ariaid-title10}

요소가 자동 생성 필드 또는 시스템 필드인 경우 예를 반환합니다.
자동으로 생성된 시스템 필드는 암호화할 수 없습니다. 이 방법은 플러그인과 에지 암호화 규칙 함께 사용하기 위한 것입니다.
{#r_ScopedGlideElementDescriptorIsAutoOrSysID__table_y3g_nd4_yr__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 17. 매개변수]

{#r_ScopedGlideElementDescriptorIsAutoOrSysID__table_y3g_nd4_yr} {#r_ScopedGlideElementDescriptorIsAutoOrSysID__table_z3g_nd4_yr__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 요소가 자동으로 생성되거나 시스템 필드인 경우 True입니다. |
[표 18. 반환]

{#r_ScopedGlideElementDescriptorIsAutoOrSysID__table_z3g_nd4_yr}  

    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() {#ariaid-title11}

요소가 사전 정의에서 드롭다운 선택으로 정의된 경우 예를 반환합니다.
선택 필드를 암호화할 수 없습니다.
{#r_ScopedGlideElementDescriptorIsChoiceTable__table_upl_31s_ls__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 19. 매개변수]

{#r_ScopedGlideElementDescriptorIsChoiceTable__table_upl_31s_ls} {#r_ScopedGlideElementDescriptorIsChoiceTable__table_vpl_31s_ls__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 요소가 드롭다운 선택으로 정의된 경우 예를 반환합니다. 선택 테이블에 정의된 항목이 없더라도 예를 반환합니다. 마지막 선택 유형인 제안은 true를 반환하지 않습니다. |
[표 20. 반환]

{#r_ScopedGlideElementDescriptorIsChoiceTable__table_vpl_31s_ls}  

    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() {#ariaid-title12}

요소가 암호화된 경우 예를 반환합니다.
이 방법은 플러그인과 에지 암호화 규칙 함께 사용하기 위한 것입니다.
{#r_ScopedGlideElementDescriptorIsEdgeEncrypted__table_jq2_gf4_yr__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 21. 매개변수]

{#r_ScopedGlideElementDescriptorIsEdgeEncrypted__table_jq2_gf4_yr} {#r_ScopedGlideElementDescriptorIsEdgeEncrypted__table_kq2_gf4_yr__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 요소가 암호화되면 예를 반환하고 그렇지 않으면 아니오를 반환합니다. |
[표 22. 반환]

{#r_ScopedGlideElementDescriptorIsEdgeEncrypted__table_kq2_gf4_yr}  

    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() {#ariaid-title13}

이 설명자로 표시되는 필드가 필드 암호화를 위해 구성되었는지 여부를 반환합니다.
이 방법을 사용하면 중요한 데이터를 읽거나 쓰기 전에 암호화된 필드를 프로그래밍 방식으로 탐지하거나 필드의 암호화 상태에 따라 접근 정책을 적용할 수 있습니다.

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

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 23. 매개변수]

{#SGED-isEncrypted__table_jx1_tmp_z3c} {#SGED-isEncrypted__table_kx1_tmp_z3c__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 필드가 필드 암호화를 위해 구성되어 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 필드가 필드 암호화를 위해 구성되어 있습니다. * 아니오: 필드가 암호화되지 않았거나 필드 암호화 스타터(com.glide.field.encryption.starter) 플러그인이 활성화되지 않았습니다. {#SGED-isEncrypted__ul_ent_dnp_z3c} |
[표 24. 반환]

{#SGED-isEncrypted__table_kx1_tmp_z3c}  
다음 서버 측 스크립트는 isEncrypted() 를 사용하여 값을 로깅하기 전에 인시던트 테이블의 short_description 필드가 암호화되었는지 확인합니다. 이를 인스턴스의 백그라운드 스크립트 또는 비즈니스 규칙에 복사하여 테스트합니다.  
주:  
또는 [범위가 지정된 GlideElement - getED()](https://servicenow-prod.fluidtopics.net/PCbdXkjulCk0Fa0LAh09zg#r_ScopedGlideElementGetED "필드의 요소 설명자를 반환합니다.") 메서드 [GlideRecord - getED()](https://servicenow-prod.fluidtopics.net/Q2N~KJ0CerSTV4yr_nWFJw#r_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() {#ariaid-title14}

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

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 25. 매개변수]

{#SGED-isMandatory__table_xxq_xwv_shb} {#SGED-isMandatory__table_yxq_xwv_shb__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 연결된 요소가 필수인지 여부를 나타내며 요소를 포함하는 기록을 저장하기 전에 값을 포함해야 합니다. 가능한 값: * true: 요소에 값이 포함되어야 합니다. 필수 필드 * 아니오: 요소에 값을 포함할 필요가 없음 {#SGED-isMandatory__ul_l1h_kxv_shb} |
[표 26. 반환]

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

    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() {#ariaid-title15}

요소가 가상 요소인 경우 예를 반환합니다.
가상 요소는 필드의 딕셔너리 정의에 의해 설정된 계산된 필드입니다. 가상 필드는 암호화할 수 없습니다.
{#r_ScopedGlideElementDescriptorIsVirtual__table_xzh_ybs_ls__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 27. 매개변수]

{#r_ScopedGlideElementDescriptorIsVirtual__table_xzh_ybs_ls} {#r_ScopedGlideElementDescriptorIsVirtual__table_yzh_ybs_ls__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 요소가 가상 요소인 경우 예를 반환합니다. |
[표 28. 반환]

{#r_ScopedGlideElementDescriptorIsVirtual__table_yzh_ybs_ls}  

    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