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

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideElementDynamicAttributeStore - 전역

# GlideElementDynamicAttributeStore - 전역 {#ariaid-title1}

* 릴리스 버전: Xanadu
* 
* 업데이트 날짜 2024년 08월 01일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 14분

GlideElementDynamicAttributeStore API는 현재 Glide 기록의 동적 속성을 관리하기 위한 편리한 스크립트 메서드를 제공합니다. 이러한 메서드를 GlideRecord API와 함께 사용하여 정의된 동적 속성 값을 가져오고 설정합니다.

이 API를 사용하여 동적 속성을 작성하려면 dynamic_schema_writer 역할이 있어야 합니다. 이 API를 사용하여 동적 데이터를 읽으려면 dynamic_schema_reader 역할이 있어야 합니다.

이 API는 API를 확장합니다 [GlideElement - 전역](https://servicenow-prod.fluidtopics.net/hE0KJK8peIQKsRrbnOj7cA#c_GlideElementAPI "GlideElement API는 필드와 해당 값을 처리하기 위한 여러 가지 편리한 스크립트 메서드를 제공합니다. GlideElement 메서드는 현재 Glide 기록의 필드에 사용할 수 있습니다.") .

동적 속성에 대한 자세한 내용은 을 참조하십시오 [Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US).

## GlideElementDynamicAttributeStore - getDynamicAttribute(문자열 attributePath) {#ariaid-title2}

지정된 동적 속성 경로에 있는 동적 속성을 나타내는 GlideElementDynamicAttribute 객체를 반환합니다.
{#GEDAS-getDynamicAttribute_S__table_gzs_jld_bbc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| attributePath | 문자열 | 연결된 동적 스키마 속성을 찾는 데 사용할 속성 경로입니다. 형식: `"group_name->attr_name"` * `group_name`: 속성이 연결된 그룹의 이름입니다. 동적 속성 그룹 \[dynamic_attribute_group\] 테이블의 이름 필드 또는 동적 속성 \[dynamic_attribute\] 테이블의 그룹 필드에 있습니다. * `attr_name`: 동적 그룹 내의 동적 속성 이름입니다. 동적 속성 \[dynamic_attribute\] 테이블의 이름 필드에 있습니다. 예: `"car->color"` |
[표 1. 매개변수]

{#GEDAS-getDynamicAttribute_S__table_gzs_jld_bbc} {#GEDAS-getDynamicAttribute_S__table_hzs_jld_bbc__entry__2}

| 유형 | 설명 |
|-|-|
| GlideElementDynamicAttribute | 지정된 동적 속성을 포함하는 객체입니다. 매개 변수에 attributePath 잘못된 정보가 포함되어 있으면 null을 반환합니다. |
[표 2. 반환]

{#GEDAS-getDynamicAttribute_S__table_hzs_jld_bbc}  
다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    //Gets all the values of the make attribute from the u_inc_dynamic_schema dynamic attribute store column on the incident table
    var gr_Inc = new GlideRecord('incident');
    gr_Inc.query();
    while(gr_Inc.next()) {
        var attr = gr.getDynamicAttribute('inc_dynamic_schema->cars->make');
        gs.info(attr.getValue());
    }

    //You can also use if(gr_Inc.next()) if you don't want all the values
    var gr_Inc = new GlideRecord('incident');
    gr_Inc.query();
    if(gr_Inc.next()) {
        var attr = gr_Inc.getDynamicAttribute('inc_dynamic_schema->cars->make');
        gs.info(attr.getValue());
    }

## GlideElementDynamicAttributeStore - getDynamicAttributeDisplayValue(문자열 attributePath) {#ariaid-title3}

동적 특성 저장소 내의 지정된 특성 경로에 있는 동적 특성의 표시 값을 반환합니다. 표시 값을 사용할 수 없는 경우 내부 값을 반환합니다.
{#GEDAS-getDynamicAttributeDisplayValue_S__table_zn3_1md_bbc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| attributePath | 문자열 | 연결된 동적 스키마 속성을 찾는 데 사용할 속성 경로입니다. 형식: `"group_name->attr_name"` * `group_name`: 속성이 연결된 그룹의 이름입니다. 동적 속성 그룹 \[dynamic_attribute_group\] 테이블의 이름 필드 또는 동적 속성 \[dynamic_attribute\] 테이블의 그룹 필드에 있습니다. * `attr_name`: 동적 그룹 내의 동적 속성 이름입니다. 동적 속성 \[dynamic_attribute\] 테이블의 이름 필드에 있습니다. 예: `"car->color"` |
[표 3. 매개변수]

{#GEDAS-getDynamicAttributeDisplayValue_S__table_zn3_1md_bbc} {#GEDAS-getDynamicAttributeDisplayValue_S__table_a43_1md_bbc__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 사용자가 읽을 수 있는 형식의 연결된 동적 속성 값입니다. 매개 변수에 attributePath 잘못된 정보가 포함되어 있으면 null을 반환합니다. |
[표 4. 반환]

{#GEDAS-getDynamicAttributeDisplayValue_S__table_a43_1md_bbc}  
다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    //Gets all the display values of the luxury attribute from the inc_dynamic_schema dynamic attribute store column on the incident table
    var gr_Inc = new GlideRecord('incident');
    gr_Inc.query();
    while(gr_Inc.next()) {
        var attr = gr_Inc.getDynamicAttributeDisplayValue('inc_dynamic_schema->cars->luxury');
        gs.info(attr);
    }

    //You can also use if(gr.next()) if you don't want all the values
    var gr_Inc = new GlideRecord('incident');
    gr_Inc.query();

    if(gr_Inc.next()) {
        var attr = gr_Inc.getDynamicAttributeDisplayValue('inc_dynamic_schema->cars->luxury');
        gs.info(attr);
    }

## GlideElementDynamicAttributeStore - getDynamicAttributeValue(문자열 attributePath) {#ariaid-title4}

동적 특성 저장소 내에서 전달된 특성 경로가 가리키는 동적 특성의 내부 값을 반환합니다.
동적 속성에 대한 자세한 내용은 을 참조하십시오 [Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US).
{#GEDAS-getDynamicAttributeValue_S__table_tnp_rld_bbc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| attributePath | 문자열 | 연결된 동적 스키마 속성을 찾는 데 사용할 속성 경로입니다. 형식: `"group_name->attr_name"` * `group_name`: 속성이 연결된 그룹의 이름입니다. 동적 속성 그룹 \[dynamic_attribute_group\] 테이블의 이름 필드 또는 동적 속성 \[dynamic_attribute\] 테이블의 그룹 필드에 있습니다. * `attr_name`: 동적 그룹 내의 동적 속성 이름입니다. 동적 속성 \[dynamic_attribute\] 테이블의 이름 필드에 있습니다. 예: `"car->color"` |
[표 5. 매개변수]

{#GEDAS-getDynamicAttributeValue_S__table_tnp_rld_bbc} {#GEDAS-getDynamicAttributeValue_S__table_unp_rld_bbc__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 전달된 속성 경로가 가리키는 동적 속성의 값입니다. 매개 변수에 attributePath 잘못된 정보가 포함되어 있으면 null을 반환합니다. |
[표 6. 반환]

{#GEDAS-getDynamicAttributeValue_S__table_unp_rld_bbc}  
다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    var gr_Inc = new GlideRecord('incident');
    gr_Inc.query();

    while(gr_Inc.next()) {
        var attr = gr_Inc.getDynamicAttributeValue('inc_dynamic_schema->cars->luxury');
        gs.info(attr);
    }

출력:


    *** Script: 1

## GlideElementDynamicAttributeStore - setDynamicAttributeValue(문자열, attributePath, 객체 값) {#ariaid-title5}

동적 특성 저장소의 지정된 특성 경로가 가리키는 특성을 지정된 값으로 설정합니다.
동적 속성에 대한 자세한 내용은 을 참조하십시오 [Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US).
{#GEDAS-setDynamicAttributeValue_S__table_aj2_vmd_bbc__entry__3}{#GEDAS-setDynamicAttributeValue_S__DynS-value-entry}

| 이름 | 유형 | 설명 |
|-|-|-|
| attributePath | 문자열 | 연결된 동적 스키마 속성을 찾는 데 사용할 속성 경로입니다. 형식: `"group_name->attr_name"` * `group_name`: 속성이 연결된 그룹의 이름입니다. 동적 속성 그룹 \[dynamic_attribute_group\] 테이블의 이름 필드 또는 동적 속성 \[dynamic_attribute\] 테이블의 그룹 필드에 있습니다. * `attr_name`: 동적 그룹 내의 동적 속성 이름입니다. 동적 속성 \[dynamic_attribute\] 테이블의 이름 필드에 있습니다. 예: `"car->color"` |
| 값 | 객체 | 지정된 속성에서 설정할 값입니다. 주: 동적 속성의 경우 다음 데이터 유형만 지원됩니다. * 부울(예/아니오) * 10진수 * 부동 소수점 숫자 * GlideDate * GlideDateTime * 정수 * 문자열 |
[표 7. 매개변수]

{#GEDAS-setDynamicAttributeValue_S__table_aj2_vmd_bbc} {#GEDAS-setDynamicAttributeValue_S__table_bj2_vmd_bbc__entry__2}

| 유형 | 설명 |
|-|-|
| GlideElementDynamicAttributeStore | 지정된 값을 포함하는 GlideElementDynamicAttributeStore 객체를 반환합니다. 매개 변수에 groupAttributePath 잘못된 정보가 포함되어 있으면 속성이 업데이트되지 않습니다. |
[표 8. 반환]

{#GEDAS-setDynamicAttributeValue_S__table_bj2_vmd_bbc}  
다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    //This simple example inserts a make attribute on the inc_dynamic_schema column where the value of the make attribute is Ford.
    var gr_Inc = new GlideRecord('incident');
    gr_Inc.setDynamicAttributeValue('inc_dynamic_schema->cars->make', 'Ford');
    gr_Inc.insert();

## GlideElementDynamicAttributeStore - setDynamicAttributeValues(GlideDynamicAttributeStore 값) {#ariaid-title6}

현재 GlideRecord 요소의 동적 속성 저장소에서 전달된 GlideElementDynamicAttrbuteStore 객체에 지정된 값을 설정합니다. 현재 요소의 데이터 유형은 동적 속성 저장소로 설정되어야 합니다.
동적 속성에 대한 자세한 내용은 을 참조하십시오 [Dynamic Schema](https://www.servicenow.com/docs/access?context=dynamic-schema&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US).
{#GEDAS-setDynamicAttributeValues_O__table_ojl_snd_bbc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 값 | [GlideDynamicAttributeStore](https://servicenow-prod.fluidtopics.net/zEXAwSJsvE0OWVJGq2u3Xw#GlideDynamicAttStoreAPI "GlideDynamicAttributeStore API는 문자열, 날짜 또는 날짜/시간과 같은 다른 데이터 유형과 유사한 새로운 기본 제공 동적 속성 저장소 데이터 유형에 대한 액세스를 제공합니다.") | 현재 요소의 동적 스키마에서 설정할 값을 포함하는 객체입니다. 이 객체에 지정되지 않은 값은 업데이트되지 않습니다. |
[표 9. 매개변수]

{#GEDAS-setDynamicAttributeValues_O__table_ojl_snd_bbc} {#GEDAS-setDynamicAttributeValues_O__table_pjl_snd_bbc__entry__2}

| 유형 | 설명 |
|-|-|
| GlideElementDynamicAttributeStore | GlideElementDynamicAttributeStore 개체를 업데이트했습니다. |
[표 10. 반환]

{#GEDAS-setDynamicAttributeValues_O__table_pjl_snd_bbc}  
다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    var gr_Inc = new GlideRecord('incident');
    var das = new GlideDynamicAttributeStore();
    das.setDynamicAttributeValue("cars->color", "black");
    das.setDynamicAttributeValue("cars->make","Honda");
    das.setDynamicAttributeValue("cars->model","CRV");
    gr_Inc.setDynamicAttributeValues('inc_dynamic_schema', das);
    gr_Inc.insert();

이 코드 예제에서는 u_inc_dynamic_schema 열에 다음을 삽입합니다.

    {
      "cars" : {
        "color" : "black",
        "make" : "Honda",
        "model" : "CRV"
      }
    }

## GlideElementDynamicAttributeStore - setDynamicAttributeDisplayValue(문자열 attributePath) {#ariaid-title7}

현재 GlideRecord 요소의 동적 속성 저장소 내 지정된 경로에 있는 동적 속성의 표시 값을 설정합니다.
{#GEDAS-setDynAttributeDisplayValue_S__table_bfg_2nd_bbc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| attributePath | 문자열 | 연결된 동적 스키마 속성을 찾는 데 사용할 속성 경로입니다. 형식: `"group_name->attr_name"` * `group_name`: 속성이 연결된 그룹의 이름입니다. 동적 속성 그룹 \[dynamic_attribute_group\] 테이블의 이름 필드 또는 동적 속성 \[dynamic_attribute\] 테이블의 그룹 필드에 있습니다. * `attr_name`: 동적 그룹 내의 동적 속성 이름입니다. 동적 속성 \[dynamic_attribute\] 테이블의 이름 필드에 있습니다. 예: `"car->color"` |
| 값 | 객체 | 현재 동적 특성 요소에서 설정할 값입니다. 전달된 값은 다음 데이터 유형 중 하나여야 합니다. * 부울(예/아니오) * 10진수 * 부동 소수점 숫자 * GlideDate * GlideDateTime * 정수 * 문자열 {#GEDAS-setDynAttributeDisplayValue_S__DynS-valid_data_types-ul} |
[표 11. 매개변수]

{#GEDAS-setDynAttributeDisplayValue_S__table_bfg_2nd_bbc} {#GEDAS-setDynAttributeDisplayValue_S__table_cfg_2nd_bbc__entry__2}

| 유형 | 설명 |
|-|-|
| GlideElementDynamicAttributeStore | 업데이트된 Glide 요소를 포함하는 객체입니다. |
[표 12. 반환]

{#GEDAS-setDynAttributeDisplayValue_S__table_cfg_2nd_bbc}  
다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    var grFleet = new GlideRecord('u_car_fleet');
    grFleet.setDynamicAttributeValue('u_dyn_attr_store', 'car->color', 'Yellow');
    grFleet.setDynamicAttributeValue('u_dyn_attr_store', 'car->make', 'Ford');
    var sysId = grFleet.insert();
    gs.info("Inserted: " + grFleet.u_dyn_attr_store);

    var daStore = new GlideDynamicAttributeStore();
    daStore.setDynamicAttributeValue('car->color', 'Green');
    daStore.setDynamicAttributeValue('car->model', 'Bronco');

    var geDynAttrStore = grFleet.getElement('u_dyn_attr_store');
    geDynAttrStore.setDynamicAttributeDisplayValues(daStore);
    grFleet.update();
    gs.info("Updated:  " + grFleet.u_dyn_attr_store);

출력:

    *** Script: Inserted: {"car":{"color":"Yellow","make":"Ford"}}
    *** Script: Updated:  {"car":{"color":"Green","make":"Ford","model":"Bronco"}}

다음 코드 예제에서는 부울 표시 값이 "1"로 저장되지만 다시 "true"로 전달되는 방법을 보여 줍니다.

     var gr_Inc = new GlideRecord('incident');
    gr_Inc.setDynamicAttributeDisplayValue('u_inc_dynamic_schema->u_cars->u_luxury', '1');
    gr_Inc.insert()

반환된 값:

    {
      "u_cars" : {
        "u_luxury" : "true"
      }
    }

## GlideElementDynamicAttributeStore - setDynamicAttributeDisplayValues(GlideDynamicAttributeStore 값) {#ariaid-title8}

현재 GlideRecord 요소의 동적 속성에서 전달된 GlideDynamicAttrbuteStore 객체에 지정된 표시 값을 설정합니다. 현재 요소의 데이터 유형은 연결된 테이블에서 동적 특성 저장소 로 설정되어야 합니다.
{#GEDAS-setDynAttributeDisplayValues_O__table_o32_b4d_bbc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 값 | [GlideDynamicAttributeStore](https://servicenow-prod.fluidtopics.net/zEXAwSJsvE0OWVJGq2u3Xw#GlideDynamicAttStoreAPI "GlideDynamicAttributeStore API는 문자열, 날짜 또는 날짜/시간과 같은 다른 데이터 유형과 유사한 새로운 기본 제공 동적 속성 저장소 데이터 유형에 대한 액세스를 제공합니다.") | 현재 요소의 동적 속성 저장소에서 설정할 표시 값을 포함하는 객체입니다. 이 객체에 지정되지 않은 표시 값은 업데이트되지 않습니다. 이 객체에는 저장할 각 특성의 특성 경로와 표시 값이 모두 포함되어야 합니다. 예: { "car":{ "color":"Blue", "make":"Ford", "model":"Mustang" } } |
[표 13. 매개변수]

{#GEDAS-setDynAttributeDisplayValues_O__table_o32_b4d_bbc} {#GEDAS-setDynAttributeDisplayValues_O__table_p32_b4d_bbc__entry__2}

| 유형 | 설명 |
|-|-|
| GlideElementDynamicAttributeStore | 업데이트된 Glide 요소를 포함하는 객체입니다. |
[표 14. 반환]

{#GEDAS-setDynAttributeDisplayValues_O__table_p32_b4d_bbc}  
다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    var daStore = new GlideDynamicAttributeStore();
    daStore.setDynamicAttributeValue('car->make', 'Ford');
    daStore.setDynamicAttributeValue('car->model', 'Mustang');
    daStore.setDynamicAttributeValue('car->color', 'Blue');
    gs.info("daStore: " + daStore);

    var gr_Car = new GlideRecord('u_car_fleet');
    gr_Car.query();
    while(gr_Car.next()) {
      var glideElement = gr_Car.getElement('u_dyn_attr_store');
      glideElement.setDynamicAttributeValues(daStore);
      gr_Car.update();
    }