---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# SystemDocumentVersion : inclus, global

# SystemDocumentVersion : inclus, global {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes de lecture

L'API SystemDocumentVersion fournit des méthodes pour définir les valeurs de la version source d'un document dans la table Versions \[ds_document_version\].

Cette API nécessite le module d'extension Document Management (com.snc.platform_document_management) et est fournie dans l'espace de noms `sn_doc_services` . Pour plus d'informations, consultez [Services documentaires](https://www.servicenow.com/docs/access?context=document-services-landing-page&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US).

Pour créer une version de document, utilisez [l'API DocumentVersionService](https://servicenow-prod.fluidtopics.net/fdPq_WHYlYYdg~a1uSua_A#DocumentVersionServiceBothAPI "L’API DocumentVersionService fournit un service permettant de créer et de supprimer des versions de documents. chaque version est un élément contenant le contenu du document et est fournie à l’aide d’une URL unique ou d’une pièce jointe. Une pièce jointe ne peut être ajoutée que dans l’interface utilisateur de la table Versions de documents [ds_document_version] et non avec l’API.").

## SystemDocumentVersion : SystemDocumentVersion(String docSysId) {#ariaid-title2}

Instancie un objet SystemDocumentVersion .
{#SysDocVer-SystemDocumentVersion_S__table_o12_jrk_spb__entry__3}{#SysDocVer-SystemDocumentVersion_S__ph_docserv_parm_docID}

| Nom | Type | Description |
|-|-|-|
| ID docSysId | Chaîne | Sys_id d'un enregistrement de document dans la table Documents \[ds_document\]. |
[Tableau 1. Paramètres]

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

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 2. Renvoie]

{#SysDocVer-SystemDocumentVersion_S__table_p12_jrk_spb}  
L'exemple suivant montre comment instancier un objet SystemDocumentVersion et créer une version de document. Voir aussi [DocumentVersionService](https://servicenow-prod.fluidtopics.net/fdPq_WHYlYYdg~a1uSua_A#DocumentVersionServiceBothAPI "L’API DocumentVersionService fournit un service permettant de créer et de supprimer des versions de documents. chaque version est un élément contenant le contenu du document et est fournie à l’aide d’une URL unique ou d’une pièce jointe. Une pièce jointe ne peut être ajoutée que dans l’interface utilisateur de la table Versions de documents [ds_document_version] et non avec l’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));

Sortie :

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

## SystemDocumentVersion : document(String docSysId) {#ariaid-title3}

Spécifie l'enregistrement de document pour cette version.
Remarque :  
Vous pouvez également définir le nom en tant que paramètre dans le constructeur SystemDocumentVersion().
{#SysDocVer-document_S__table_o12_jrk_spb__entry__3}{#SysDocVer-document_S__ph_docserv_parm_docID}

| Nom | Type | Description |
|-|-|-|
| ID docSysId | Chaîne | Sys_id d'un enregistrement de document dans la table Documents \[ds_document\]. |
[Tableau 3. Paramètres]

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

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 4. Renvoie]

{#SysDocVer-document_S__table_p12_jrk_spb}  
L'exemple suivant montre comment définir le champ nom d'une version de document. Voir aussi DocumentVersionService -- [createDocumentVersion().](https://servicenow-prod.fluidtopics.net/fdPq_WHYlYYdg~a1uSua_A#DocVersSvc-createDocumentVersion_O "Crée un enregistrement de version de document dans la table Versions [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));

Sortie :

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

## SystemDocumentVersion : type(String docType) {#ariaid-title4}

Définit le champ Type d'une version de document.
{#SysDocVer-type_S__table_o12_jrk_spb__entry__3}

| Nom | Type | Description |
|-|-|-|
| docType | Chaîne | Type de source du document. Valeurs valides : * URL * attachment {#SysDocVer-type_S__ul_xzq_qsl_spb}Par défaut : pièce jointe Remarque : Une pièce jointe ne peut actuellement être ajoutée que dans l'interface utilisateur de la table Versions de documents \[ds_document_version\] et non avec l'API. |
[Tableau 5. Paramètres]

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

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 6. Renvoie]

{#SysDocVer-type_S__table_p12_jrk_spb}  
L'exemple suivant montre comment définir le champ type et créer une version de document. Voir aussi [DocumentVersionService](https://servicenow-prod.fluidtopics.net/fdPq_WHYlYYdg~a1uSua_A#DocumentVersionServiceBothAPI "L’API DocumentVersionService fournit un service permettant de créer et de supprimer des versions de documents. chaque version est un élément contenant le contenu du document et est fournie à l’aide d’une URL unique ou d’une pièce jointe. Une pièce jointe ne peut être ajoutée que dans l’interface utilisateur de la table Versions de documents [ds_document_version] et non avec l’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 de chaîne) {#ariaid-title5}

Définit l'URL d'une version de document.
{#SysDocVer-url_S__table_o12_jrk_spb__entry__3}

| Nom | Type | Description |
|-|-|-|
| URL | Chaîne | URL du document source pour cette version. |
[Tableau 7. Paramètres]

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

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 8. Renvoie]

{#SysDocVer-url_S__table_p12_jrk_spb}  
L'exemple suivant montre comment définir le champ URL comme source d'une version de document. Voir aussi [DocumentVersionService](https://servicenow-prod.fluidtopics.net/fdPq_WHYlYYdg~a1uSua_A#DocumentVersionServiceBothAPI "L’API DocumentVersionService fournit un service permettant de créer et de supprimer des versions de documents. chaque version est un élément contenant le contenu du document et est fournie à l’aide d’une URL unique ou d’une pièce jointe. Une pièce jointe ne peut être ajoutée que dans l’interface utilisateur de la table Versions de documents [ds_document_version] et non avec l’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}

Définit le numéro d'une version de document.
{#SysDocVer-versionNumber_N__table_o12_jrk_spb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Numéro de version | Numéro | Numéro de version de ce document. |
[Tableau 9. Paramètres]

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

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 10. Renvoie]

{#SysDocVer-versionNumber_N__table_p12_jrk_spb}  
L'exemple suivant montre comment définir le numéro de version et créer une version de document. Voir aussi [DocumentVersionService](https://servicenow-prod.fluidtopics.net/fdPq_WHYlYYdg~a1uSua_A#DocumentVersionServiceBothAPI "L’API DocumentVersionService fournit un service permettant de créer et de supprimer des versions de documents. chaque version est un élément contenant le contenu du document et est fournie à l’aide d’une URL unique ou d’une pièce jointe. Une pièce jointe ne peut être ajoutée que dans l’interface utilisateur de la table Versions de documents [ds_document_version] et non avec l’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));

Sortie :

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