Partager via

Événement OnChange de colonne (référence de l’API client)

  • Article

L’événement OnChange se produit dans les cas suivants :

  • Les données d’une colonne de formulaire ont changé et le focus est perdu. Il existe une exception à ce comportement qui s’applique aux colonnes Oui / Non formatées pour utiliser des cases d’option ou des cases à cocher. Dans ces cas, l’événement se produit immédiatement.
  • Les modifications de données sur le serveur sont récupérées pour mettre à jour une colonne lorsque le formulaire est actualisé, par exemple après la sauvegarde d’un enregistrement.
  • La méthode attribute.fireOnchange est utilisée.

Toutes les colonnes prennent en charge l’événement OnChange. Les données de la colonne sont validées avant et après l’événement OnChange.

L’événement OnChange ne se produit pas si la colonne est modifiée par programme à l’aide de la méthode attribute.setValue. Si vous souhaitez que les gestionnaires de l’événement OnChange s’exécutent une fois que vous avez défini la valeur, vous devez utiliser la méthode formContext.data.entity attribute.fireOnchange dans votre code. L’événement OnChange ne se produit pas non plus si la colonne est modifiée par programme pendant la suppression des modifications si l’utilisateur navigue hors d’un formulaire incorrect.

Notes

Bien que la colonne Statut prenne en charge l’événement OnChange, la colonne est en lecture seule sur le formulaire afin que l’événement ne puisse pas se produire via une interaction de l’utilisateur. Un autre script peut provoquer cet événement en utilisant la méthode fireOnchange.

Notes

Les événements OnChange sont synchrones. Vous ne devez pas utiliser du code asynchrone dans un gestionnaire d’événements OnChange nécessitant de prendre ou gérer une action pour la résolution du code asynchrone. Cela provoque des problèmes si le gestionnaire de résolution s’attend à ce que le contexte de l’application reste le même qu’au moment du démarrage du code asynchrone. Vous ne devez pas non plus effectuer de requêtes réseau synchrones dans un gestionnaire d’événements OnChange. Cela peut entraîner l’absence de réponse de l’application.

Méthodes prises en charge pour cet événement

Vous pouvez utiliser trois méthodes pour travailler avec l’événement OnChange pour une colonne :

Articles associés

Colonnes (référence d’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é).