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


---

# SystemDocumentVersion - 범위, 전역

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

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

SystemDocumentVersion API는 Versions \[ds_document_version\] 테이블에서 문서의 원본 버전 값을 설정하는 메서드를 제공합니다.

이 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) 참조하세요.

문서 버전을 만들려면 [DocumentVersionService API](https://servicenow-prod.fluidtopics.net/jE1b3O2auOp8~XnRj3QULA#DocumentVersionServiceBothAPI "DocumentVersionService API는 문서 버전을 만들고 삭제하는 서비스를 제공합니다. 각 버전은 문서 콘텐츠를 포함하는 요소이며 단일 URL 또는 첨부 파일을 사용하여 제공됩니다. 첨부 파일은 문서 버전 [ds_document_version] 테이블 UI에서만 추가할 수 있으며 API를 사용하면 추가할 수 없습니다.")를 사용합니다.

## SystemDocumentVersion - SystemDocumentVersion(문자열 docSysId) {#ariaid-title2}

SystemDocumentVersion 개체를 인스턴스화합니다.
{#SysDocVer-SystemDocumentVersion_S__table_o12_jrk_spb__entry__3}{#SysDocVer-SystemDocumentVersion_S__ph_docserv_parm_docID}

| 이름 | 유형 | 설명 |
|-|-|-|
| docSysId | 문자열 | 문서 \[ds_document\] 테이블에 있는 문서 기록의 Sys_id입니다. |
[표 1. 매개변수]

{#SysDocVer-SystemDocumentVersion_S__table_o12_jrk_spb} {#SysDocVer-SystemDocumentVersion_S__table_p12_jrk_spb__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 2. 반환]

{#SysDocVer-SystemDocumentVersion_S__table_p12_jrk_spb}  
다음 예제에서는 SystemDocumentVersion 개체를 인스턴스화하고 문서 버전을 만드는 방법을 보여 줍니다. [DocumentVersionService](https://servicenow-prod.fluidtopics.net/jE1b3O2auOp8~XnRj3QULA#DocumentVersionServiceBothAPI "DocumentVersionService API는 문서 버전을 만들고 삭제하는 서비스를 제공합니다. 각 버전은 문서 콘텐츠를 포함하는 요소이며 단일 URL 또는 첨부 파일을 사용하여 제공됩니다. 첨부 파일은 문서 버전 [ds_document_version] 테이블 UI에서만 추가할 수 있으며 API를 사용하면 추가할 수 없습니다.")도 참조하십시오.

    var versionDefinition = new sn_doc_services.SystemDocumentVersion('491efbee24187410f877a6fed1c2b0a9');

    versionDefinition.type('url');
    versionDefinition.url('http://one/1.0');

    var versionSvc = new sn_doc_services.DocumentVersionService();
    gs.info(JSON.stringify(versionSvc.createDocumentVersion(versionDefinition), null, 2));

출력:

    {
      "message": "Adding an entry to DocumentVersion for the given docId : 491efbee24187410f877a6fed1c2b0a9, sysId : d5a340d9242cf810f877a6fed1c2b069 is successful.",
      "request_id": "d5a340d9242cf810f877a6fed1c2b069",
      "status": "success"
    }

## SystemDocumentVersion - 문서(문자열 docSysId) {#ariaid-title3}

이 버전에 대한 문서 기록을 지정합니다.
주:  
또는 SystemDocumentVersion() 생성자에서 이름을 매개변수로 설정할 수 있습니다.
{#SysDocVer-document_S__table_o12_jrk_spb__entry__3}{#SysDocVer-document_S__ph_docserv_parm_docID}

| 이름 | 유형 | 설명 |
|-|-|-|
| docSysId | 문자열 | 문서 \[ds_document\] 테이블에 있는 문서 기록의 Sys_id입니다. |
[표 3. 매개변수]

{#SysDocVer-document_S__table_o12_jrk_spb} {#SysDocVer-document_S__table_p12_jrk_spb__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 4. 반환]

{#SysDocVer-document_S__table_p12_jrk_spb}  
다음 예는 문서 버전의 이름 필드를 설정하는 방법을 보여줍니다. DocumentVersionService -- [createDocumentVersion()](https://servicenow-prod.fluidtopics.net/jE1b3O2auOp8~XnRj3QULA#DocVersSvc-createDocumentVersion_O "버전 [ds_document_version] 테이블에 문서 버전 기록을 만듭니다.")도 참조하십시오.

    var versionDefinition = new sn_doc_services.SystemDocumentVersion();

    versionDefinition.document('491efbee24187410f877a6fed1c2b0a9');

    var versionSvc = new sn_doc_services.DocumentVersionService();
    gs.info(JSON.stringify(versionSvc.createDocumentVersion(versionDefinition), null, 2));

출력:

    {
      "message": "Adding an entry to DocumentVersion for the given docId : 491efbee24187410f877a6fed1c2b0a9, sysId : 1c504c91242cf810f877a6fed1c2b08b is successful.",
      "request_id": "1c504c91242cf810f877a6fed1c2b08b",
      "status": "success"
    }

## SystemDocumentVersion - 유형(문자열 docType) {#ariaid-title4}

문서 버전의 유형 필드를 설정합니다.
{#SysDocVer-type_S__table_o12_jrk_spb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| docType | 문자열 | 문서 소스 유형입니다. 유효한 값은 다음과 같습니다. * URL * 첨부 파일 {#SysDocVer-type_S__ul_xzq_qsl_spb}기본값: 첨부 파일 주: 첨부 파일은 현재 문서 버전 \[ds_document_version\] 테이블 UI에서만 추가할 수 있으며 API에는 추가할 수 없습니다. |
[표 5. 매개변수]

{#SysDocVer-type_S__table_o12_jrk_spb} {#SysDocVer-type_S__table_p12_jrk_spb__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 6. 반환]

{#SysDocVer-type_S__table_p12_jrk_spb}  
다음 예제에서는 유형 필드를 설정하고 문서 버전을 만드는 방법을 보여줍니다. [DocumentVersionService](https://servicenow-prod.fluidtopics.net/jE1b3O2auOp8~XnRj3QULA#DocumentVersionServiceBothAPI "DocumentVersionService API는 문서 버전을 만들고 삭제하는 서비스를 제공합니다. 각 버전은 문서 콘텐츠를 포함하는 요소이며 단일 URL 또는 첨부 파일을 사용하여 제공됩니다. 첨부 파일은 문서 버전 [ds_document_version] 테이블 UI에서만 추가할 수 있으며 API를 사용하면 추가할 수 없습니다.")도 참조하십시오.

    var versionDefinition = new sn_doc_services.SystemDocumentVersion('491efbee24187410f877a6fed1c2b0a9');

    versionDefinition.type('url');
    versionDefinition.url('http://one/1.0');

    var versionSvc = new sn_doc_services.DocumentVersionService();
    gs.info(JSON.stringify(versionSvc.createDocumentVersion(versionDefinition), null, 2));

    {
      "message": "Adding an entry to DocumentVersion for the given docId : 491efbee24187410f877a6fed1c2b0a9, sysId : d5a340d9242cf810f877a6fed1c2b069 is successful.",
      "request_id": "d5a340d9242cf810f877a6fed1c2b069",
      "status": "success"
    }

## SystemDocumentVersion - url(문자열 URL) {#ariaid-title5}

문서 버전의 URL을 설정합니다.
{#SysDocVer-url_S__table_o12_jrk_spb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| URL | 문자열 | 이 버전에 대한 소스 문서의 URL입니다. |
[표 7. 매개변수]

{#SysDocVer-url_S__table_o12_jrk_spb} {#SysDocVer-url_S__table_p12_jrk_spb__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 8. 반환]

{#SysDocVer-url_S__table_p12_jrk_spb}  
다음 예는 URL 필드를 문서 버전의 소스로 설정하는 방법을 보여줍니다. [DocumentVersionService](https://servicenow-prod.fluidtopics.net/jE1b3O2auOp8~XnRj3QULA#DocumentVersionServiceBothAPI "DocumentVersionService API는 문서 버전을 만들고 삭제하는 서비스를 제공합니다. 각 버전은 문서 콘텐츠를 포함하는 요소이며 단일 URL 또는 첨부 파일을 사용하여 제공됩니다. 첨부 파일은 문서 버전 [ds_document_version] 테이블 UI에서만 추가할 수 있으며 API를 사용하면 추가할 수 없습니다.")도 참조하십시오.

    var versionDefinition = new sn_doc_services.SystemDocumentVersion('491efbee24187410f877a6fed1c2b0a9');

    versionDefinition.type('url');
    versionDefinition.url('http://one/1.0');

    var versionSvc = new sn_doc_services.DocumentVersionService();
    gs.info(JSON.stringify(versionSvc.createDocumentVersion(versionDefinition), null, 2));

    {
      "message": "Adding an entry to DocumentVersion for the given docId : 491efbee24187410f877a6fed1c2b0a9, sysId : d5a340d9242cf810f877a6fed1c2b069 is successful.",
      "request_id": "d5a340d9242cf810f877a6fed1c2b069",
      "status": "success"
    }

## SystemDocumentVersion - versionNumber(Number versionNumber) {#ariaid-title6}

문서 버전의 수를 설정합니다.
{#SysDocVer-versionNumber_N__table_o12_jrk_spb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| versionNumber | 번호 | 이 문서의 버전 번호입니다. |
[표 9. 매개변수]

{#SysDocVer-versionNumber_N__table_o12_jrk_spb} {#SysDocVer-versionNumber_N__table_p12_jrk_spb__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 10. 반환]

{#SysDocVer-versionNumber_N__table_p12_jrk_spb}  
다음 예제에서는 버전 번호를 설정하고 문서 버전을 만드는 방법을 보여줍니다. [DocumentVersionService](https://servicenow-prod.fluidtopics.net/jE1b3O2auOp8~XnRj3QULA#DocumentVersionServiceBothAPI "DocumentVersionService API는 문서 버전을 만들고 삭제하는 서비스를 제공합니다. 각 버전은 문서 콘텐츠를 포함하는 요소이며 단일 URL 또는 첨부 파일을 사용하여 제공됩니다. 첨부 파일은 문서 버전 [ds_document_version] 테이블 UI에서만 추가할 수 있으며 API를 사용하면 추가할 수 없습니다.")도 참조하십시오.

    var versionDefinition = new sn_doc_services.SystemDocumentVersion('491efbee24187410f877a6fed1c2b0a9');

    versionDefinition.type('url');
    versionDefinition.url('http://one/1.0');
    versionDefinition.versionNumber(5);

    var versionSvc = new sn_doc_services.DocumentVersionService();
    gs.info(JSON.stringify(versionSvc.createDocumentVersion(versionDefinition), null, 2));

출력:

    {
      "message": "Adding an entry to DocumentVersion for the given docId : 491efbee24187410f877a6fed1c2b0a9, sysId : ff47449d242cf810f877a6fed1c2b06c is successful.",
      "request_id": "ff47449d242cf810f877a6fed1c2b06c",
      "status": "success"
    }