ui.refreshRibbon (référence de l’API client)
Indique au ruban d’évaluer à nouveau les données qui contrôlent le contenu de l’affichage.
Syntaxe
formContext.ui.refreshRibbon(refreshAll);
Paramètre
Nom | Type | Requise | Description |
---|---|---|---|
refreshAll |
Valeur booléenne | Non | Indique si toutes les barres de commande de ruban de la page active sont actualisées. Si vous spécifiez la valeur false, seule la barre de commande de ruban au niveau de la page est actualisée. Si vous ne spécifiez pas ce paramètre, la valeur false est transmise par défaut. |
Remarques
Remarques : cette fonctionnalité est généralement utilisée lorsqu’une action de ruban JavaScriptFunction
(RibbonDiffXml) change les données dans le formulaire. Par exemple, changement d’état de l’enregistrement via une action de ruban. Une fois que votre code a modifié les données utilisées par une règle, utilisez cette méthode pour forcer le ruban à réévaluer les données du formulaire afin que la règle soit appliquée à nouveau.
Recommandation
Pour des performances optimales de vos chargements de formulaire, vous ne devez pas utiliser cette fonction dans EnableRule
(RibbonDiffXml) ou onLoad
(FormXml). Le chargement du formulaire lui-même déclenche l’évaluation des règles de toutes les actions du ruban. Si vous souhaitez contrôler la visibilité d’une action de ruban, utilisez des promesses et un modèle asynchrone dans EnableRule
.
Articles associés
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é).