Create

Description

Cette opération permet de demander la création d'un nouvel élément dans un formulaire.

Cette opération peut être suivie par les opérations suivantes :
- un ou plusieurs update pour demander une mise à jour des champs de l'enregistrement suite à une modification de champ.
- un cancel pour annuler la création.

Pour être effective en base de données, cette opération a besoin d'être validée : appel à la méthode Validate ou passage de AutoValidate à 1 dans l'opération directement

Requête

Le paramètre "Table" (libellé ou identifiant) est indispensable pour connaître le formulaire correspondant au type d'enregistrement que l'on souhaite créer.
Si le formulaire donné en paramètre est abstrait, SIMAXService enverra une réponse du type "AmbiguousAction" avec la liste des formulaires fils sur lesquels il est possible de crééer un nouvel enregistrement. Il faudra alors répondre par un SelectForm pour en sélectionner un et pouvoir continuer le Create.

Liste des entêtes

Entête
AutoValidate
CustomerInfos
SessionToken
UsernameToken
OptionDialogue
ActionContext
APIUser
APIUUID

Liste des paramètres

Paramètre
IDMessage
Table
ParamXML

Exemple

<Create>
<Table>client particulier</Table>
</Create>

Réponse

Le retour de cette action est la description de l'élément avec les valeurs par défaut des colonnes s'il y en a au format XMLSIMAX.

Liste des entêtes

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

Les valeurs de retour

Xml

Exemple

<CreateResponse>
<xml>
<client_particulier simax:id="34697055626258" simax:title="Client particulier">
<id._unique>34697055626258</id._unique>
<civilite/>
<nom/>
<prenom/>
<numero_de_telephone/>
<adresse_email/>
<type_de_client>45326123574406</type_de_client>
<adresse/>
<code_postal/>
<ville/>
<pays>139728866165270</pays>
<date_de_relance>20080807</date_de_relance>
<delai_de_paiement>38690680149299</delai_de_paiement>
<type_de_tarif/>
<tva>50586720796034</tva>
<taux_de_tva>19.600000</taux_de_tva>
</client_particulier>
<type_de_client simax:id="45326123574406" simax:title="Prospect passif"/>
<pays simax:id="139728866165270" simax:title="France"/>
<delai_de_paiement simax:id="38690680149299" simax:title="Comptant"/>
<tva simax:id="50586720796034" simax:title="TVA Normale (19,6%)"/>
<compte_de_tiers simax:id="37779755811939" simax:title="411000 Clients"/>
</xml>
</CreateResponse>