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
Liste des paramètres
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
Les valeurs de retour
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>