Partager via

setSubmitMode (référence de l’API client)

  • Article

Définit si les données de la colonne seront soumises pendant l’enregistrement de l’enregistrement.

Types de colonne pris en charge

Tout

Syntaxe

formContext.getAttribute(arg).setSubmitMode(mode)

Paramètres

Type : Chaîne.

Description : Elle doit être définie sur l’un des modes suivants :

  • always : les données sont toujours envoyées avec un enregistrement.
  • never : les données ne sont jamais envoyées avec un enregistrement. Lorsque cette valeur est utilisée, les colonnes du formulaire pour cette colonne ne peuvent pas être modifiées.
  • dirty : comportement par défaut. Les données sont envoyées avec l’enregistrement lorsqu’elles ont changé.

Remarques

Utilisez cette méthode pour contrôler le moment où les données d’une colonne sont soumises lors de la création ou de la sauvegarde d’un enregistrement. Par exemple, vous pouvez avoir une colonne sur le formulaire qui est uniquement destinée à contrôler la logique dans le formulaire. Vous n’êtes pas prêt à capturer les données dans celui-ci. Vous pouvez faire en sorte que les données ne soient pas enregistrées. Vous pouvez disposer d’un plug-in qui dépend toujours de la valeur incluse. Vous souhaiterez peut-être définir la colonne de manière à ce qu’elle soit toujours incluse.

Notes

Les données d’une colonne seront toujours actualisées après l’opération de sauvegarde, même si le mode d’envoi de la colonne est défini sur never. Par exemple, si la valeur d’une colonne dans le serveur est null, que le mode d’envoi de la colonne est défini sur never, et que la colonne est modifiée avec une certaine valeur par l’utilisateur, une fois que l’utilisateur a enregistré le formulaire, la valeur de la colonne est remplacée par une valeur de type null.

Les colonnes qui ne sont pas mises à jour après la sauvegarde initiale de l’enregistrement, telles que createdby, sont définies de manière à ne pas être soumises lors de la sauvegarde. Pour forcer la soumission d’une valeur de colonne, qu’elle ait été modifiée ou non, utilisez cette méthode avec le paramètre mode défini sur always.

getSubmitMode (référence de l’API client)

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).