Partager via


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.

formContext.ui
formContext

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é).