insérer

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

Tableau 1. Champs de sortie de la méthode Insérer

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.

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

Java Apache Axis2

Python