Update

Description

Cette opération permet d'avertir SIMAXService qu'un ou des champs ont été modifiés en envoyant les nouvelles valeurs.
SIMAX peut alors lancer les mises à jour de calcul, les transmissions et renvoyer l'enregistrement mis à jour.

Remarque : Cet appel peut engendrer des créations et des modifications qui nécessitent des confirmations ou des informations supplémentaires.
Une optimisation est de n'appeler cette méthode que quand on sort d'un champ possédant l'attribut "link" car seuls ces champs peuvent déclencher des modifications.

Remarque :
Seuls les champs à modifier doivent être présents dans la requête Update.
Si vous envoyez des balises sans valeur, les colonnes correspondantes seront vidées.
L'identifiant du contexte d'action à mettre dans l'Update est celui fournit par SIMAXService en réponse au Create ou au Modify que vous avez envoyé précedemment.

L'update peut être validé automatiquement (c'est à dire sans appeler la methode Validate) en ajoutant la balise AutoValidate à 1 dans le header.
Si on demande une validation automatique, la reponse de l'update sera finalement équivalente à celle d'un validate.



Requête

Envoyer les nouvelles valeurs de colonne (Dans UpdateData) au service afin de récupérer l'enregistrement mis à jour.

Liste des entêtes

Entête
AutoValidate
CustomerInfos
SessionToken
UsernameToken
OptionDialogue
ActionContext
APIUser
APIUUID

Liste des paramètres

Paramètre
Table
ParamXML
Complete
UpdateData

Exemple

=> on modifie les colonnes nom, prenom, telephone d'un client particulier

<Update>
<Table>client particulier</Table>
<ParamXML>
<client_particulier>269961792...</client_particulier>
</ParamXML>
<UpdateData>
<xml VERSION="1" VERSION_LECTECRIT="1" VERSION_LECTURE="1" DATEHEURE="2008072913211996"
xmlns:simax="http://www.nout.fr/XML/">
<client_particulier simax:id="269961792..." simax:title="Client particulier">
<nom>Dupont</nom>
<prenom>Pierre</prenom>
<telephone>0612....</telephone>
</client_particulier>
</xml>
</UpdateData>
</Update>

Réponse

On reçoit la description de l'enregistrement mis à jour suite aux modifications

Liste des entêtes

Entête
ReturnType
Count
CustomerInfos
ValidateError
XSDSchema
Element
Filter
Action
Form
ActionContext

Les valeurs de retour

Xml

Exemple

=> on récupère la description complète du client particulier mis à jour

<UpdateResponse>
<xml>
<client_particulier simax:id="269961792..." simax:title="Client particulier">
<id._unique>269961792...</id._unique>
<civilite/>
<nom>Dupont</nom>
<prenom>Pierre</prenom>
<telephone>0612....</telephone>
<adresse_email>DupontPierre@toto.fr</adresse_email>
<type_de_client>45326123574406</type_de_client>
<date_de_naissance/>
<commercial/>
<adresse/>
<code_postal>34000</code_postal>
<ville/>
<pays>139728866165270</pays>
</xml>
</UpdateResponse>