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


---

# DocumentListService - 범위, 전역

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

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

DocumentListService API는 문서 목록을 만들고, 삭제하고, 업데이트하는 메서드를 제공합니다.

이 API에는 플러그인(com.snc.platform_document_management)이 문서 관리 필요하며 `sn_doc_services` 네임스페이스 내에서 제공됩니다. 자세한 내용은 [문서 서비스를](https://www.servicenow.com/docs/access?context=document-services-landing-page&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) 참조하세요.  
플러그인은 문서 관리 문서와 연결할 문서 템플릿 목록 만들기도 지원합니다. 예를 들어, 졸업장, 신분증 또는 여권과 같은 여러 문서가 필요한 입사 지원서입니다. 문서 목록을 추가한 후 문서 템플릿을 추가할 수 있습니다.

* [SystemDocumentListEntry](https://servicenow-prod.fluidtopics.net/vdy8TZ7dCBBjcHRQm6Kpug#SystemDocumentListEntryBothAPI "SystemDocumentListEntry API는 문서 목록 항목 [ds_document_list_entry] 테이블의 레코드 필드를 설정하는 메서드를 제공합니다.") -- 문서 템플릿 목록 항목을 정의합니다.
* [DocumentListEntryService](https://servicenow-prod.fluidtopics.net/luidtTjV4QoxW0J3bVM6ig#DocumentListEntryServiceBothAPI "DocumentListEntryService API는 문서 목록에서 문서 템플릿을 유지 관리하는 메서드를 제공합니다.") -- 문서 템플릿 목록 항목을 추가하거나 제거합니다.
{#DocumentListServiceBothAPI__ul_asn_gjg_vpb}  
문서를 템플릿으로 정의하려면 다음을 수행합니다.

* [SystemDocument -- template()](https://servicenow-prod.fluidtopics.net/reZNZT8Ui7E5wcvlJaQn1g#SystemDoc-template_S "문서 기록이 템플릿인지 여부를 지정합니다.") 메서드를 true로 설정하는 문서 객체를 정의합니다. [DocumentService](https://servicenow-prod.fluidtopics.net/1MgobtqeeRleFdkS5DkxGQ#DocumentServiceBothAPI "DocumentService API는 문서를 만들고, 삭제하고, 업데이트하는 메서드를 제공합니다.") API의 메서드를 사용하여 문서 기록을 만들거나 업데이트합니다.
* 문서 \[ds_document\] 테이블에서 문서의 템플릿 확인란을 선택합니다.
{#DocumentListServiceBothAPI__ul_b12_5zv_wpb}  
다음 API를 사용하여 문서를 정의하고 관리할 수 있습니다.

* [SystemDocument](https://servicenow-prod.fluidtopics.net/reZNZT8Ui7E5wcvlJaQn1g#SystemDocumentBothAPI "SystemDocument API는 문서 [ds_document] 테이블에서 기록의 필드를 설정하는 메서드를 제공합니다.") -- 문서 객체를 정의합니다.
* [DocumentService](https://servicenow-prod.fluidtopics.net/1MgobtqeeRleFdkS5DkxGQ#DocumentServiceBothAPI "DocumentService API는 문서를 만들고, 삭제하고, 업데이트하는 메서드를 제공합니다.") -- 문서를 추가, 업데이트 또는 삭제합니다.
{#DocumentListServiceBothAPI__ul_krc_vmf_vpb}  
문서를 템플릿으로 정의하려면 다음을 수행합니다.

* [SystemDocument -- template()](https://servicenow-prod.fluidtopics.net/reZNZT8Ui7E5wcvlJaQn1g#SystemDoc-template_S "문서 기록이 템플릿인지 여부를 지정합니다.") 메서드를 true로 설정하는 문서 객체를 정의합니다. [DocumentService](https://servicenow-prod.fluidtopics.net/1MgobtqeeRleFdkS5DkxGQ#DocumentServiceBothAPI "DocumentService API는 문서를 만들고, 삭제하고, 업데이트하는 메서드를 제공합니다.") API의 메서드를 사용하여 문서 기록을 만들거나 업데이트합니다.
* 문서 \[ds_document\] 테이블에서 문서의 템플릿 확인란을 선택합니다.
{#DocumentListServiceBothAPI__d4001e141}

[SystemDocumentList](https://servicenow-prod.fluidtopics.net/gmYT5QJdBpuKIbY_q48pIQ#SystemDocumentListBothAPI "SystemDocumentList API는 문서 목록 [ds_document_lists] 테이블의 레코드 필드를 설정하는 메서드를 제공합니다.")도 참조하세요.

## DocumentListService - DocumentListService() {#ariaid-title2}

DocumentListService 개체를 인스턴스화합니다.
{#DLS-DocumentListService__table_zw5_mcg_tpb__entry__3}

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

{#DLS-DocumentListService__table_zw5_mcg_tpb}  
다음 예제에서는 DocumentListService 개체를 인스턴스화하는 방법을 보여 줍니다. [SystemDocumentList](https://servicenow-prod.fluidtopics.net/gmYT5QJdBpuKIbY_q48pIQ#SystemDocumentListBothAPI "SystemDocumentList API는 문서 목록 [ds_document_lists] 테이블의 레코드 필드를 설정하는 메서드를 제공합니다.")도 참조하세요.

    var s = new sn_doc_services.DocumentListService();

## DocumentListService - createDocumentList(SystemDocumentList 문서) {#ariaid-title3}

문서 목록 \[ds_document_lists\] 테이블에 문서 목록을 만듭니다.
플러그인은 문서 관리 문서와 연결할 문서 템플릿 목록 만들기도 지원합니다. 예를 들어, 졸업장, 신분증 또는 여권과 같은 여러 문서가 필요한 입사 지원서입니다. 문서 목록을 추가한 후 문서 템플릿을 추가할 수 있습니다.

* [SystemDocumentListEntry](https://servicenow-prod.fluidtopics.net/vdy8TZ7dCBBjcHRQm6Kpug#SystemDocumentListEntryBothAPI "SystemDocumentListEntry API는 문서 목록 항목 [ds_document_list_entry] 테이블의 레코드 필드를 설정하는 메서드를 제공합니다.") -- 문서 템플릿 목록 항목을 정의합니다.
* [DocumentListEntryService](https://servicenow-prod.fluidtopics.net/luidtTjV4QoxW0J3bVM6ig#DocumentListEntryServiceBothAPI "DocumentListEntryService API는 문서 목록에서 문서 템플릿을 유지 관리하는 메서드를 제공합니다.") -- 문서 템플릿 목록 항목을 추가하거나 제거합니다.
{#DLS-createDocumentList_O__ul_asn_gjg_vpb}

[createDocumentsFromList()](https://servicenow-prod.fluidtopics.net/FT3IxeBMpdXaM0h0q_9c2A#DLS-createDocumentsFromList_S_S_S "문서 템플릿 목록에서 문서를 만듭니다.") 메서드를 사용하여 문서 템플릿 목록에서 문서를 만듭니다.
{#DLS-createDocumentList_O__table_w4z_2cg_tpb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 문서 | [시스템 문서 목록](https://servicenow-prod.fluidtopics.net/gmYT5QJdBpuKIbY_q48pIQ#SystemDocumentListBothAPI "SystemDocumentList API는 문서 목록 [ds_document_lists] 테이블의 레코드 필드를 설정하는 메서드를 제공합니다.") | 새 기록의 필드를 나타내는 하나 이상의 속성입니다. name 속성은 필수이며 SystemDocumentList 생성자 또는 name() 메서드를 사용하여 설정할 수 있습니다. |
[표 2. 매개변수]

{#DLS-createDocumentList_O__table_w4z_2cg_tpb} {#DLS-createDocumentList_O__table_tj4_p5j_34b__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 문서 목록 \[ds_document_lists\] 테이블에서 성공 메시지가 있는 새 기록 Sys_id. 그렇지 않은 경우 오류 메시지입니다. { "message": "String", "request_id": "String", "status": "String" } |
| \<Object\>.메시지 | 성공 또는 오류를 확인하는 메시지입니다. 데이터 유형: 문자열 |
| \<Object\>.request_id | 문서 목록 \[ds_document_lists\] 테이블의 기록 Sys_id입니다. 데이터 유형: 문자열 |
| \<Object\>.status | 운영의 성공 여부를 나타내는 상태입니다. 가능한 값: * 성공 - 운영이 성공했습니다. * 실패 -- 운영이 성공하지 못했습니다. 에서는 message 상세 정보를 제공합니다. {#DLS-createDocumentList_O__ul_rlv_5cv_j4b} 데이터 유형: 문자열 |
[표 3. 반환]

{#DLS-createDocumentList_O__table_tj4_p5j_34b}  
다음 예는 문서 목록을 만드는 방법을 보여줍니다. [SystemDocumentList](https://servicenow-prod.fluidtopics.net/gmYT5QJdBpuKIbY_q48pIQ#SystemDocumentListBothAPI "SystemDocumentList API는 문서 목록 [ds_document_lists] 테이블의 레코드 필드를 설정하는 메서드를 제공합니다.")도 참조하세요.

    var dL = new sn_doc_services.SystemDocumentList('My document list');

    // Define the document list field
    dL.description('description');

    var docList = new sn_doc_services.DocumentListService();
    gs.info(JSON.stringify(docList.createDocumentList(dL), null, 2));

출력:

    {
      "message": "Create List for the given name : My document list, List sysId : b2c021a924683c10f877a6fed1c2b0b1 is successful.",
      "request_id": "b2c021a924683c10f877a6fed1c2b0b1",
      "status": "success"
    }

## DocumentListService - createDocumentsFromList(String listSysId, String tableName, String tableSysId) {#ariaid-title4}

문서 템플릿 목록에서 문서를 만듭니다.
주:  
이 메서드를 사용하기 전에 [createDocumentList()](https://servicenow-prod.fluidtopics.net/FT3IxeBMpdXaM0h0q_9c2A#DLS-createDocumentList_O "문서 목록 [ds_document_lists] 테이블에 문서 목록을 만듭니다.") 메서드를 사용하여 문서 템플릿 목록을 생성합니다.
{#DLS-createDocumentsFromList_S_S_S__table_w4z_2cg_tpb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 목록 시스템 ID | 문자열 | 문서 목록 \[ds_document_lists\] 테이블에 있는 문서 목록 기록의 Sys_id입니다. |
| tableName | 문자열 | 문서 템플릿 참조 목록을 추가하는 기록이 포함된 테이블의 이름입니다. |
| tableSysId | 문자열 | 문서 템플릿 참조 목록을 추가할 콘텐츠가 포함된 기록의 Sys_id입니다. |
[표 4. 매개변수]

{#DLS-createDocumentsFromList_S_S_S__table_w4z_2cg_tpb} {#DLS-createDocumentsFromList_S_S_S__table_tj4_p5j_34b__entry__2}{#DLS-createDocumentsFromList_S_S_S__ph-docserv-ret-obj-basic}{#DLS-createDocumentsFromList_S_S_S__row_pdfgen_ret_msgCnv}

| 유형 | 설명 |
|-|-|
| 객체 | 성공 또는 오류 메시지입니다. { "message": "String", "request_id": "String", "status": "String" } {#DLS-createDocumentsFromList_S_S_S__api_docserv_codeblock_dets} |
| \<Object\>.메시지 | 문서 목록에 있는 문서 템플릿의 수를 포함하는 메시지입니다. 데이터 유형: 문자열 |
| \<Object\>.request_id | 문서 목록 \[ds_document_lists\] 테이블의 기록 Sys_id입니다. 데이터 유형: 문자열 |
| \<Object\>.status | 운영의 성공 여부를 나타내는 상태입니다. 가능한 값: * 성공 - 운영이 성공했습니다. * 실패 -- 운영이 성공하지 못했습니다. 에서는 message 상세 정보를 제공합니다. {#DLS-createDocumentsFromList_S_S_S__ul_rlv_5cv_j4b} 데이터 유형: 문자열 |
[표 5. 반환]

{#DLS-createDocumentsFromList_S_S_S__table_tj4_p5j_34b}  
다음 예는 기록에 문서 템플릿 참조 목록을 추가하는 방법을 보여줍니다. 설명서가 인시던트 \[incident\] 테이블의 기록에 추가됩니다.

    var result = new sn_doc_services.DocumentListService().createDocumentsFromList('21afddea2460fc10f877a6fed1c2b0dd', 'incident', 'd7158da0c0a8016700eef46c8d1f3661');
    gs.info(JSON.stringify(result, null, 2));

출력:

    {
      "message": "Created 1 document references for the given table name: incident, table sysId : d7158da0c0a8016700eef46c8d1f3661 with list SysId 21afddea2460fc10f877a6fed1c2b0dd",
      "request_id": "21afddea2460fc10f877a6fed1c2b0dd",
      "status": "success"
    }

## DocumentListService - deleteDocumentList(문자열 listSysId) {#ariaid-title5}

문서 목록 \[ds_document_lists\] 테이블에서 문서 기록을 제거합니다.
{#DLS-deleteDocumentList_S__table_w4z_2cg_tpb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 목록 시스템 ID | 문자열 | 문서 목록 \[ds_document_lists\] 테이블에 있는 문서 목록 기록의 Sys_id입니다. |
[표 6. 매개변수]

{#DLS-deleteDocumentList_S__table_w4z_2cg_tpb} {#DLS-deleteDocumentList_S__table_x4z_2cg_tpb__entry__2}{#DLS-deleteDocumentList_S__ph-docserv-ret-obj-basic}

| 유형 | 설명 |
|-|-|
| 객체 | 성공 또는 오류 메시지입니다. { "message": "String", "request_id": "String", "status": "String" } {#DLS-deleteDocumentList_S__api_docserv_codeblock_dets} |
| \<Object\>.메시지 | 성공 또는 오류를 확인하는 메시지입니다. 데이터 유형: 문자열 |
| \<Object\>.request_id | 문서 목록 \[ds_document_lists\] 테이블의 기록 Sys_id입니다. 데이터 유형: 문자열 |
| \<Object\>.status | 운영의 성공 여부를 나타내는 상태입니다. 가능한 값: * 성공 - 운영이 성공했습니다. * 실패 -- 운영이 성공하지 못했습니다. 에서는 message 상세 정보를 제공합니다. {#DLS-deleteDocumentList_S__ul_rlv_5cv_j4b} 데이터 유형: 문자열 |
[표 7. 반환]

{#DLS-deleteDocumentList_S__table_x4z_2cg_tpb}  
다음 예는 문서 목록 기록을 삭제하는 방법을 보여줍니다. [SystemDocumentList](https://servicenow-prod.fluidtopics.net/gmYT5QJdBpuKIbY_q48pIQ#SystemDocumentListBothAPI "SystemDocumentList API는 문서 목록 [ds_document_lists] 테이블의 레코드 필드를 설정하는 메서드를 제공합니다.")도 참조하세요.

    var docListID = 'b2c021a924683c10f877a6fed1c2b0b1';

    var docListSvc = new sn_doc_services.DocumentListService();
    gs.info(JSON.stringify(docListSvc.deleteDocumentList(docListID), null, 2));

출력:

    {
      "message": "Delete List for the given sysId : b2c021a924683c10f877a6fed1c2b0b1 is successful.",
      "request_id": "b2c021a924683c10f877a6fed1c2b0b1",
      "status": "success"
    }

## DocumentListService - updateDocumentList(문자열 docSysId, SystemDocumentList 문서) {#ariaid-title6}

기존 문서 목록의 필드 값을 업데이트합니다.
{#DLS-updateDocumentList_S_O__table_w4z_2cg_tpb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 목록 시스템 ID | 문자열 | 문서 목록 \[ds_document_lists\] 테이블에 있는 문서 목록 기록의 Sys_id입니다. |
| 문서 | [시스템 문서](https://servicenow-prod.fluidtopics.net/reZNZT8Ui7E5wcvlJaQn1g#SystemDocumentBothAPI "SystemDocument API는 문서 [ds_document] 테이블에서 기록의 필드를 설정하는 메서드를 제공합니다.") | 업데이트할 문서 목록 필드를 나타내는 하나 이상의 속성입니다. |
[표 8. 매개변수]

{#DLS-updateDocumentList_S_O__table_w4z_2cg_tpb} {#DLS-updateDocumentList_S_O__table_x4z_2cg_tpb__entry__2}{#DLS-updateDocumentList_S_O__ph-docserv-ret-obj-basic}

| 유형 | 설명 |
|-|-|
| 객체 | 성공 또는 오류 메시지입니다. { "message": "String", "request_id": "String", "status": "String" } {#DLS-updateDocumentList_S_O__api_docserv_codeblock_dets} |
| \<Object\>.메시지 | 성공 또는 오류를 확인하는 메시지입니다. 데이터 유형: 문자열 |
| \<Object\>.request_id | 문서 목록 \[ds_document_lists\] 테이블의 기록 Sys_id입니다. 데이터 유형: 문자열 |
| \<Object\>.status | 운영의 성공 여부를 나타내는 상태입니다. 가능한 값: * 성공 - 운영이 성공했습니다. * 실패 -- 운영이 성공하지 못했습니다. 에서는 message 상세 정보를 제공합니다. {#DLS-updateDocumentList_S_O__ul_rlv_5cv_j4b} 데이터 유형: 문자열 |
[표 9. 반환]

{#DLS-updateDocumentList_S_O__table_x4z_2cg_tpb}  
다음 예는 문서 목록 이름 및 설명을 업데이트하는 방법을 보여줍니다. [SystemDocumentList](https://servicenow-prod.fluidtopics.net/gmYT5QJdBpuKIbY_q48pIQ#SystemDocumentListBothAPI "SystemDocumentList API는 문서 목록 [ds_document_lists] 테이블의 레코드 필드를 설정하는 메서드를 제공합니다.")도 참조하세요.

    var docListID = 'b2c021a924683c10f877a6fed1c2b0b1';

    var docListUpdate = new sn_doc_services.SystemDocumentList();
    docListUpdate.name('name change');
    docListUpdate.description('description update');

    var docListSvc = new sn_doc_services.DocumentListService();
    gs.info(JSON.stringify(docListSvc.updateDocumentList(docListID , docListUpdate), null, 2));

출력:

    {
      "message": "Update List for the given sysId : b2c021a924683c10f877a6fed1c2b0b1 is successful.",
      "request_id": "b2c021a924683c10f877a6fed1c2b0b1",
      "status": "success"
    }