insérer

Crée un nouvel enregistrement pour la table ciblée par 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 d’insertion

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 un champ d’état, lequel peut contenir inserté, 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 (ignorée, car une valeur de clé n’est pas spécifiée), le champ de sys_id contiendra le sys_id de la ligne du jeu d’importation, plutôt que la table de transformation ciblée.
Jeu d’importation avec transformations multiples	La réponse de ce type d’insertion contiendra plusieurs ensembles de champs de l’insertion de table de jeux d’importation standard encapsulée 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 brève description :

<?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 est la suivante :

<?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 à la langue, consultez les rubriques suivantes :

Perl SOAP ::Lite

Java Apache Axis2

Python