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. Insérer les champs de sortie de la méthode

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	Le sys_id de la ligne de jeu d’importation, le nom de la table cible transformée (table), l’display_name de la table cible transformée, l’display_value de la ligne cible transformée et un champ d’état , qui peut contenir inserted, updated ou error. Il peut y avoir un champ status_message facultatif ou une valeur de champ error_message lorsque état=erreur. Lorsqu’une insertion n’a pas provoqué la transformation d’une ligne cible (ignorée, car une valeur de clé n’est pas spécifiée), le champ sys_id contient le sys_id de la ligne de 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 à partir de l’insertion de la table de jeu d’importation standard inséré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 classique

L’exemple suivant montre un encart 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’insertion spécifiques au langage, consultez les rubriques suivantes :

Perl SOAP ::Lite

Axe Apache Java 2

Python