Delete

Description

Cette opération permet de demander la suppression d'un enregistrement.
Remarque : La validation est automatique.

Requête

SIMAXService a besoin du formulaire de l'enregistrement à supprimer ainsi que des paramètres de l'action de suppression correspondante qui contient au moins l'identifiant de l'enregistrement à supprimer.
Remarque : quand on supprime un enregistrement qui a une colonne de type invalide, l'enregistrement passe en invalide et ce ne sera qu'à la 2ième suppression qu'il sera vraiment supprimé de la base de données. C'est pour cela qu'une suppression peut correspond à une modification.
Aucun contexte d'action n'est obligatoire pour cette opération.

Liste des entêtes

Entête
AutoValidate
CustomerInfos
SessionToken
UsernameToken
OptionDialogue
ActionContext
APIUser
APIUUID

Liste des paramètres

Paramètre
ParamXML
Table

Exemple

=> Supprimer le contact dont l'identifiant est 98765432.....

<Delete>
<Table>contact</Table>
<ParamXML>
<contact>98765432...</contact>
</ParamXML>
</Delete>

Réponse

La réponse d'un Delete correspond à la réponse d'un Validate car les suppressions sont automatiquement validées.
Remarque : la plupart du temps, les actions de type suppression dans SIMAX sont à confirmer. Vous recevrez donc une question de SIMAXService, vous demandant de confirmer la suppression de l'enregistrement (cf ReturnType "MessageBox").

Liste des entêtes

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

Les valeurs de retour

Xml

Exemple

=> soit on a supprimé l'enregistrement et ça n'a rien déclenché

<Header>
<ReturnType>Empty</ReturnType>
</Header>
<Body>
<DeleteResponse/>
</Body>


=> soit on a supprimé l'enregistrement et on doit confirmer cette suppression

<Header>
<ReturnType>MessageBox</ReturnType>
</Header>
<Body>
<DeleteResponse>
<xml>
<MessageBox>
<Message>La question ....</Message>
<ButtonList>
<TypeConfirmation title="Ok">1</TypeConfirmation>
<TypeConfirmation title="Cancel">2</TypeConfirmation>
</ButtonList>
</MessageBox>
</xml>
</DeleteResponse>
</Body>

=> soit la suppression a déclenché des automatismes avec ouverture d'IHM, par exemple une modification

<Header>
<ReturnType>Record</ReturnType>
</Header>
<Body>
<DeleteResponse>
<xml>
...xml de l'élement à modifier ...
</xml>
</DeleteResponse>
</Body>