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


---

# XMLNode - 범위 지정, 전역

# XMLNode - 범위 지정, 전역 {#ariaid-title1}

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

XMLNode API는 XML 노드에서 값을 쿼리하는 메서드를 제공합니다. XML 문자열을 포함하는 XMLDocument2 객체에서 XMLNode가 추출됩니다.

XMLNode 객체의 독립 실행형 인스턴스를 만들기 위한 생성자는 없습니다. 대신 기존 문서에 노드를 추가하는 [XMLDocument2](https://servicenow-prod.fluidtopics.net/87uFltOv4Ut2KvtpZW6zSQ#c_XMLDocument2ScopedAPI "XMLDocument2 API는 XML 문자열에서 XML 데이터를 구문 분석하고 추출하기 위한 JavaScript 객체 래퍼입니다.")의 createElement() 메서드를 사용합니다.

## 범위가 지정된 XMLNode - getAttribute(문자열 속성) {#ariaid-title2}

속성의 값을 가져옵니다.
{#r_ScopedXMLNodeGetAttribute_String__table_ir2_12p_1r__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 속성 | 문자열 | 속성의 이름입니다. |
[표 1. 매개변수]

{#r_ScopedXMLNodeGetAttribute_String__table_ir2_12p_1r} {#r_ScopedXMLNodeGetAttribute_String__table_kr2_12p_1r__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 속성의 값입니다. |
[표 2. 반환]

{#r_ScopedXMLNodeGetAttribute_String__table_kr2_12p_1r}  

    var xmlString = "<test>" +
                    "  <one>" +
                    "    <two att=\"xxx\">abcd1234</two>" +
                    "    <three boo=\"yah\" att=\"yyy\">1234abcd</three>" +
                    "    <two>another</two>" +
                    "  </one>" +
                    "  <number>1234</number>" +
                    "</test>";
    var xmlDoc = new XMLDocument2();
    xmlDoc.parseXML(xmlString);
    var node = xmlDoc.getNode('//two');
    gs.info(node.getAttribute('att'));

출력:

    xxx

## 범위가 지정된 XMLNode - getAttributes() {#ariaid-title3}

노드의 속성을 값이 있는 속성으로 포함하는 객체를 반환합니다.
{#r_SXMLN_getAttributes__table_bk3_rjy_3x__entry__3}

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

{#r_SXMLN_getAttributes__table_bk3_rjy_3x} {#r_SXMLN_getAttributes__table_ck3_rjy_3x__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 이름이 속성이고 값이 속성의 값인 이름-값 쌍을 포함합니다. |
[표 4. 반환]

{#r_SXMLN_getAttributes__table_ck3_rjy_3x}

## 범위가 지정된 XMLNode - getChildNodeIterator() {#ariaid-title4}

하위 노드 목록을 안내하는 데 사용할 수 있는 XMLNodeIterator 객체를 가져옵니다.
{#r_ScopedXMLNodeGetChildNodeIterator__table_ng3_xfc_2r__entry__3}

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

{#r_ScopedXMLNodeGetChildNodeIterator__table_ng3_xfc_2r} {#r_ScopedXMLNodeGetChildNodeIterator__table_brm_x2p_1r__entry__2}

| 유형 | 설명 |
|-|-|
| XMLNode반복기 | 노드 반복기 객체입니다. |
[표 6. 반환]

{#r_ScopedXMLNodeGetChildNodeIterator__table_brm_x2p_1r}  

    var xmlString = "<test>" +
                    "  <one>" +
                    "    <two att=\"xxx\">abcd1234</two>" +
                    "    <three boo=\"yah\" att=\"yyy\">1234abcd</three>" +
                    "    <two>another</two>" +
                    "  </one>" +
                    "  <number>1234</number>" +
                    "</test>";
    var xmlDoc = new XMLDocument2();
    xmlDoc.parseXML(xmlString);
    var node = xmlDoc.getNode('//one');
    var iter= node.getChildNodeIterator();
    gs.info(iter.hasNext());

## 범위가 지정된 XMLNode - getFirstChild() {#ariaid-title5}

노드의 첫 번째 하위 노드를 가져옵니다.
{#r_ScopedXMLNodeGetFirstChild__table_wbb_wfc_2r__entry__3}

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

{#r_ScopedXMLNodeGetFirstChild__table_wbb_wfc_2r} {#r_ScopedXMLNodeGetFirstChild__table_ecg_ccp_1r__entry__2}

| 유형 | 설명 |
|-|-|
| XML 노드 | 노드의 첫 번째 하위 노드입니다. |
[표 8. 반환]

{#r_ScopedXMLNodeGetFirstChild__table_ecg_ccp_1r}  

    var xmlString = "<test>" +
                    "<one>" +
                    "<two att=\"xxx\">abcd1234</two>" +
                    "<three boo=\"yah\" att=\"yyy\">1234abcd</three>" +
                    "<two>another</two>" +
                    "</one>" +
                    "<number>1234</number>" +
                    "</test>";
    var xmlDoc = new XMLDocument2();
    xmlDoc.parseXML(xmlString);
    var node = xmlDoc.getNode('//one');
    gs.info(node.getFirstChild());

출력:

    <two att="xxx">abcd1234</two>

## 범위가 지정된 XMLNode - getLastChild() {#ariaid-title6}

노드의 마지막 하위 노드를 가져옵니다.
{#r_ScopedXMLNodeGetLastChild__table_gw2_vfc_2r__entry__3}

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

{#r_ScopedXMLNodeGetLastChild__table_gw2_vfc_2r} {#r_ScopedXMLNodeGetLastChild__table_kgc_pbp_1r__entry__2}

| 유형 | 설명 |
|-|-|
| XML 노드 | 노드의 마지막 하위 노드입니다. |
[표 10. 반환]

{#r_ScopedXMLNodeGetLastChild__table_kgc_pbp_1r}  

    var xmlString = "<test>" +
                    "<one>" +
                    "<two att=\"xxx\">abcd1234</two>" +
                    "<three boo=\"yah\" att=\"yyy\">1234abcd</three>" +
                    "<two>another</two>" +
                    "</one>" +
                    "<number>1234</number>" +
                    "</test>";
    var xmlDoc = new XMLDocument2();
    xmlDoc.parseXML(xmlString);
    var node = xmlDoc.getNode('//one');
     
    gs.info(node.getLastChild());

출력:

    <two>another</two>

## 범위가 지정된 XMLNode - getNodeName() {#ariaid-title7}

노드의 이름을 가져옵니다. 노드의 이름은 노드 유형에 따라 결정됩니다. 문서 요소 노드의 이름은 #document입니다. 텍스트 노드의 이름은 #text입니다. 요소 노드의 이름은 요소의 이름입니다.
{#r_ScopedXMLNodeGetNodeName__table_oxk_vfc_2r__entry__3}

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

{#r_ScopedXMLNodeGetNodeName__table_oxk_vfc_2r} {#r_ScopedXMLNodeGetNodeName__table_ftf_1dp_1r__entry__2}

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

{#r_ScopedXMLNodeGetNodeName__table_ftf_1dp_1r}  

    var xmlString = "<test>" +
                    "  <one>" +
                    "    <two att=\"xxx\">abcd1234</two>" +
                    "    <three boo=\"yah\" att=\"yyy\">1234abcd</three>" +
                    "    <two>another</two>" +
                    "  </one>" +
                    "  <number>1234</number>" +
                    "</test>";
    var xmlDoc = new XMLDocument2();
    xmlDoc.parseXML(xmlString);
    var node = xmlDoc.getNode('//two');
    gs.info(node.getNodeName());

출력:

    two

## 범위가 지정된 XMLNode - getNodeValue() {#ariaid-title8}

노드의 값을 가져옵니다. 노드의 값은 노드 유형에 따라 결정됩니다. 요소 및 문서-요소 노드는 null을 반환합니다.
{#r_ScopedXMLNodeGetNodeValue__table_jbm_tfc_2r__entry__3}

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

{#r_ScopedXMLNodeGetNodeValue__table_jbm_tfc_2r} {#r_ScopedXMLNodeGetNodeValue__table_djn_4cp_1r__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 노드의 값입니다. |
[표 14. 반환]

{#r_ScopedXMLNodeGetNodeValue__table_djn_4cp_1r}  

    var xmlString = "<test>" +
                    "  <one>" +
                    "    <two att=\"xxx\">abcd1234</two>" +
                    "    <three boo=\"yah\" att=\"yyy\">1234abcd</three>" +
                    "    <two>another</two>" +
                    "  </one>" +
                    "  <number>1234</number>" +
                    "</test>";
    var xmlDoc = new XMLDocument2();
    xmlDoc.parseXML(xmlString);
    var node = xmlDoc.getNode('//two');
    gs.info(node.getNodeValue());

출력:

    null

## 범위가 지정된 XMLNode - getTextContent() {#ariaid-title9}

현재 노드의 텍스트 내용을 가져옵니다. 노드의 텍스트 콘텐츠는 노드의 모든 하위 텍스트 노드로 구성됩니다.
{#r_ScopedXMLNodeGetTextContent__table_g21_tfc_2r__entry__3}

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

{#r_ScopedXMLNodeGetTextContent__table_g21_tfc_2r} {#r_ScopedXMLNodeGetTextContent__table_igr_z1p_1r__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 현재 노드의 텍스트 내용입니다. |
[표 16. 반환]

{#r_ScopedXMLNodeGetTextContent__table_igr_z1p_1r}  

    var xmlString = "<test>" +
                    "  <one>" +
                    "    <two att=\"xxx\">abcd1234</two>" +
                    "    <three boo=\"yah\" att=\"yyy\">1234abcd</three>" +
                    "    <two>another</two>" +
                    "  </one>" +
                    "  <number>1234</number>" +
                    "</test>";
    var xmldoc = new XMLDocument2();
    xmldoc.parseXML(xmlString);
    var node = xmldoc.getNode('//one/two');
    gs.info(node.getTextContent());

출력:

    abcd1234

## 범위가 지정된 XMLNode - hasAttribute(문자열 속성) {#ariaid-title10}

노드에 지정된 속성이 있는지 여부를 결정합니다.
{#r_ScopedXMLNodeHasAttribute_String__table_art_mdp_1r__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 속성 | 문자열 | 확인할 속성의 이름입니다. |
[표 17. 매개변수]

{#r_ScopedXMLNodeHasAttribute_String__table_art_mdp_1r} {#r_ScopedXMLNodeHasAttribute_String__table_crt_mdp_1r__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 노드에 속성이 있는 경우 True입니다. |
[표 18. 반환]

{#r_ScopedXMLNodeHasAttribute_String__table_crt_mdp_1r}  

    var xmlString = "<test>" +
                    "  <one>" +
                    "    <two att=\"xxx\">abcd1234</two>" +
                    "    <three boo=\"yah\" att=\"yyy\">1234abcd</three>" +
                    "    <two>another</two>" +
                    "  </one>" +
                    "  <number>1234</number>" +
                    "</test>";
    var xmlDoc = new XMLDocument2();
    xmlDoc.parseXML(xmlString);
    var node = xmlDoc.getNode('//two');
    gs.info(node.hasAttribute('att'));

출력:

    true

## 범위가 지정된 XMLNode - isCDATANode() {#ariaid-title11}

CDATA 노드가 별도의 노드로 유지되는지 여부를 나타냅니다.
이 메서드를 [범위가 지정된 XMLDocument2 - setEnableCDATAReporting(부울 활성화)](https://servicenow-prod.fluidtopics.net/87uFltOv4Ut2KvtpZW6zSQ#SXMLD_setEnableCDATAReporting_B "구문 분석 후 노드를 CDATA 또는 일반 텍스트로 처리할지 여부를 설정합니다. CDATA 보고는 기본적으로 비활성화되어 있습니다.") 사용하여 CDATA 노드가 보존되고 텍스트로 처리되지 않도록 합니다.
{#SXMLN_isCDATANode__table_bk3_rjy_3x__entry__3}

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

{#SXMLN_isCDATANode__table_bk3_rjy_3x} {#SXMLN_isCDATANode__table_ck3_rjy_3x__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 쿼리된 노드가 CDATA인지 일반 텍스트인지를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 쿼리된 노드는 CDATA입니다. * false: 쿼리된 노드가 일반 텍스트입니다. {#SXMLN_isCDATANode__ul_fj4_svh_lzb} |
[표 20. 반환]

{#SXMLN_isCDATANode__table_ck3_rjy_3x}  
다음 예제에서는 를 사용하여 [범위가 지정된 XMLDocument2 - setEnableCDATAReporting(부울 활성화)](https://servicenow-prod.fluidtopics.net/87uFltOv4Ut2KvtpZW6zSQ#SXMLD_setEnableCDATAReporting_B "구문 분석 후 노드를 CDATA 또는 일반 텍스트로 처리할지 여부를 설정합니다. CDATA 보고는 기본적으로 비활성화되어 있습니다.")CDATA 보고를 사용하도록 설정하여 XML 문자열을 구문 분석하는 방법을 보여줍니다. 이 코드는 isCDATANode() 를 사용하여 XML 문자열에서 쿼리된 첫 번째 노드가 CDATA 노드임을 보여줍니다.

    var xmlString = "<test>" +
      "  <one>" +
      "    <two att=\"xxx\">abcd1234</two>" +
      "    <three boo=\"yah\" att=\"yyy\">1234abcd</three>"+
      "    <four><![CDATA[another]]>element</four>" +
      "  </one>" +
      "  <number>1234</number>" +
      "</test>";
    var xmlDoc = new XMLDocument2();
    xmlDoc.setEnableCDATAReporting(true); // Enables CDATA reporting
    xmlDoc.parseXML(xmlString);
    var content = xmlDoc.getFirstNode('/test/one/four');
    gs.info(content.getFirstChild().isCDATANode());

출력:

    true

## 범위가 지정된 XMLNode - toString() {#ariaid-title12}

현재 노드의 문자열 값을 반환합니다.
{#r_ScopedXMLNodeToString__table_jjy_pfc_2r__entry__3}

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

{#r_ScopedXMLNodeToString__table_jjy_pfc_2r} {#r_ScopedXMLNodeToString__table_bqm_nfp_1r__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 현재 노드의 문자열 값입니다. |
[표 22. 반환]

{#r_ScopedXMLNodeToString__table_bqm_nfp_1r}  

    var xmlString = "<test>" +
                    "  <one>" +
                    "    <two att=\"xxx\">abcd1234</two>" +
                    "    <three boo=\"yah\" att=\"yyy\">1234abcd</three>" +
                    "    <two>another</two>" +
                    "  </one>" +
                    "  <number>1234</number>" +
                    "</test>";
    var xmlDoc = new XMLDocument2();
    xmlDoc.parseXML(xmlString);
    var node = xmlDoc.getNode('//one');
    gs.info(node.toString());

출력: 출력에 줄 바꿈이 추가되었습니다.

    <one>    
    <two att="xxx">abcd1234</two>    
    <three att="yyy" boo="yah">1234abcd</three>    
    <two>another</two>  
    </one>