Partager via

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

  • Article

L’événement se produit dans les situations suivantes : OnChange

  • 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 ne se produit pas si la colonne est modifiée par programmation à l’aide de la méthode OnChange attribute.setValue . Si vous souhaitez que les gestionnaires d’événements pour l’événement s’exécutent après avoir défini la valeur, vous devez utiliser la méthode OnChange fireOnchange formContext.data.entity attribute.dans votre code. L’événement ne se produit pas non plus si la colonne est modifiée par programmation lors de l’annulation des modifications si l’utilisateur quitte un formulaire sale. OnChange

Note

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

Note

OnChange les événements sont synchrones. Vous ne devez pas utiliser de code asynchrone dans un gestionnaire d’événements qui nécessite qu’une action soit effectuée ou gérée lors de la résolution du code asynchrone. OnChange 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

Il existe trois méthodes que vous pouvez utiliser pour travailler avec l’événement pour une colonne : OnChange

Colonnes (référence API client)
Événements (référence API client)
Événements dans les formulaires et les grilles dans les applications pilotées par modèle