formContext.data.save (référence de l’API client)
Enregistre l’enregistrement de manière asynchrone avec la possibilité de définir des fonctions de rappel à exécuter une fois l’opération d’enregistrement terminée.
Vous pouvez également définir un objet pour contrôler la façon dont les enregistrements rendez-vous, rendez-vous périodique ou activité de service sont gérés.
Syntaxe
formContext.data.save(saveOptions).then(successCallback, errorCallback);
Paramètres
| Nom | Type | Requise | Description |
|---|---|---|---|
saveOptions |
Object | Non | Objet pour spécifier des options pour sauvegarder l’enregistrement. L’objet a les paramètres suivants : - saveMode : (Facultatif) Nombre. Spécifiez une valeur indiquant comment l’événement de sauvegarde a été initié. Pour obtenir la liste des valeurs prises en charge, voir la valeur renvoyée par la méthode getSaveMode. Notez que saveMode n’effectue pas l’action correspondante ; sa fonction est uniquement de fournir des informations aux gestionnaires d’événements OnSave quant à la raison de l’opération de sauvegarde.- useSchedulingEngine : (Facultatif) Booléen. Indiquez si vous souhaitez utiliser les messages Book ou Reschedule plutôt que les messages Create ou Update. Cette option s’applique seulement lorsqu’elle est utilisée avec les enregistrements rendez-vous, rendez-vous périodique ou activité de service.REMARQUE : La propriété useSchedulingEngine n’est pas prise en charge dans Unified Interface. |
successCallback |
Function | Non | Fonctionnalité à appeler lorsque l’opération aboutit. |
errorCallback |
Function | Non | Fonction à appeler lorsque l’opération échoue. Un objet avec les propriétés suivantes est transmis : - errorCode : Nombre. Code d’erreur.- message : Chaine. Message d'erreur localisé. |
Note
Lorsque vous travaillez avec des formulaires et que vous appelez la méthode formContext.data.save, assurez-vous d’appeler également la méthode preventDefault pour garantir qu’aucune opération d’enregistrement par défaut n’est déclenchée lorsqu’un utilisateur enregistre le formulaire.