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


---

# insérer

# insérer {#ariaid-title1}

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

Crée un nouvel enregistrement pour la table ciblée dans l'URL.

## Champs d'entrée

Tous les champs de la table ciblée, à l'exception des champs système. Les champs configurés comme obligatoires dans le dictionnaire système sont reflétés dans le WSDL avec l'attribut `minOccurs=1`.

## Champs de sortie

{#r_Insert__table_nohead_insert__entry__2}

| Type de table | Champs de sortie |
|-|-|
| Régulier | Le champ sys_id et la valeur d'affichage de la table cible (`table`) sont renvoyés. |
| Jeu d'importation | sys_id de la ligne du jeu d'importation, nom de la table cible transformée (`table`), display_name de la table cible transformée, display_value de la ligne cible transformée et champ d'état qui peut contenir inséré,mis à jour ou erreur. Il peut y avoir un champ status_message facultatif ou une valeur de champ error_message lorsque `status=error`. Lorsqu'une insertion n'a pas entraîné la transformation d'une ligne cible (omission car aucune valeur de clé n'est spécifiée), le champ de sys_id contient le sys_id de la ligne du jeu d'importation, plutôt que la table de transformation ciblée. |
| Jeu d'importation avec plusieurs transformations | La réponse de ce type d'insertion contiendra plusieurs ensembles de champs de la table d'ensembles d'importation standard insert enveloppés dans un élément parent `multiInsertResponse` . Chaque ensemble contiendra un champ de carte , indiquant quelle carte de transformation a créé la réponse. |
[Tableau 1. Champs de sortie de la méthode Insérer]

{#r_Insert__table_insert}

## Exemples de messages SOAP pour une table normale

L'exemple suivant montre une insertion qui spécifie uniquement la description brève :  

    <?xml version="1.0" encoding="ISO-8859-1"?>
    <SOAP-ENV:Envelope xmlns:tns="http://www.service-now.com/incident" 
      xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
      xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" 
      xmlns:m="http://www.service-now.com"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
    SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
        <SOAP-ENV:Body>
            <insert xmlns="http://www.service-now.com">
                <short_description xsi:type="xsd:string">This is a test</short_description>
            </insert>
        </SOAP-ENV:Body>
    </SOAP-ENV:Envelope>

La réponse qui en résulte ressemble à ceci :  

    <?xml version="1.0" encoding="ISO-8859-1"?>
    <SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" 
      xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" 
      xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" 
      xmlns:m="http://www.service-now.com" 
      xmlns:tns="http://www.service-now.com/incident" xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <SOAP-ENV:Body>
            <insertResponse xmlns="http://www.service-now.com">
                <sys_id>6b06494fc611227d00b5f87caf618831</sys_id>
            </insertResponse>
        </SOAP-ENV:Body>
    </SOAP-ENV:Envelope>

## Exemples de messages spécifiques à la langue

Pour des exemples d'insertions spécifiques à une langue, consultez les rubriques suivantes :

[Perl SOAP ::Lite](https://servicenow-prod.fluidtopics.net/URoitbzAoP8Nn9uuQA6KnA#c_PerlWebServicesClientExamples__insert)

[Java Apache Axis2](https://servicenow-prod.fluidtopics.net/YF764v1bEQRBGWINA~7weg "Exemple de classe pour insérer un enregistrement d’incident.")

[Python](https://servicenow-prod.fluidtopics.net/oTvyuXrrbGPcuij3~Wpm2A#c_PythonWebServicesClientExamples__insert)