Execute

Description

Cette opération permet d'envoyer une requête à SIMAXService quand le client n'a à sa disposition que l'identifiant de l'action ou la phrase qui déclenche l'action.
Execute est utilisée principalement quand on passe par un menu ou un bouton. Dans ces cas cas là, on n'a que l'identifiant ou la phrase de l'action qui se cache derrière le menu ou le bouton.

Requête

SIMAXService peut éxécuter une action si elle a au moins son identifiant ou sa phrase.
Si vous souhaitez que l'action soit lancée directement car vous savez que les paramètres sont correctement remplis, vous avez la possibilité d'indiquer le AutoValidate à 1.
Remarque : Le client n'ayant aucune information sur l'action au premier appel du execute il ne peut donc pas fournir les valeurs des paramètres de cette action dans ParamXML.Un deuxième appel sera trés certainement nécessaire pour compléter les paramètres de l'action. C'est pour cela, que la requête "Execute" peut être appelée avec les paramètres "SpecialParamList", "CheckSum" et "CallingColumn" car on ne sait pas ce que déclenche l'action.

Liste des entêtes

Entête
AutoValidate
CustomerInfos
SessionToken
UsernameToken
OptionDialogue
ActionContext
APIUser
APIUUID

Liste des paramètres

Paramètre
DisplayMode
CheckSum
CallingColumn
ParamXML
Sentence
ID
SpecialParamList

Exemple

=> Executer l'action d'identifiant 1484 en précisant une pagination au cas où ce serait une liste

<Execute>
<ID>1484</ID>
<Sentence />
<ParamXML />
<SpecialParamList>
<First>0</First>
<Length>20</Length>
</SpecialParamList>
</Execute>

Réponse

La réponse d'un Execute dépend du type de l'action caché derrière l'identifiant ou la phrase.
remarque : si l'execute provient d'un clic bouton et si le bouton a l'attribut columnToUpdate alors c'est qu'une colonne doit être mise à jour après l'exécution de l'action du bouton.

Liste des entêtes

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

Les valeurs de retour

Xml

Exemple

<ExecuteResponse>
<Xml> .....</Xml>
</ExecuteResponse>




Exemple de header avec les informations sur les modes d'affichage de la liste demandée :

<PossibleDisplayMode>List|ChartData</PossibleDisplayMode>
<DefaultDisplayMode>List</DefaultDisplayMode>