Créer et modifier des règles métier
Une règle métier vous permet d’appliquer une validation aux objets Workfront et d’empêcher les utilisateurs de créer, modifier ou supprimer un objet lorsque certaines conditions sont remplies. La validation des règles métier permet d’améliorer la qualité des données et l’efficacité opérationnelle en empêchant les actions susceptibles de compromettre l’intégrité des données.
Une seule règle métier ne peut être affectée qu'à un seul objet. Par exemple, si vous créez une règle métier pour ne pas modifier les projets sous certaines conditions, vous ne pouvez pas appliquer la même règle aux tâches. Vous devez créer une règle métier distincte avec les mêmes conditions pour les tâches.
Les niveaux d’accès et le partage d’objets ont une priorité supérieure aux règles métier lorsqu’un utilisateur interagit avec un objet. Par exemple, si un utilisateur dispose d’un niveau d’accès ou d’une autorisation qui ne permet pas de modifier un projet, ils sont prioritaires sur une règle métier qui permet de modifier un projet sous certaines conditions.
Lorsque plusieurs règles métier s’appliquent à un objet , elles sont toutes suivies, mais ne sont pas appliquées dans un certain ordre. Par exemple, vous disposez de deux règles métier. L’une limite la création de dépenses au mois de février. La seconde empêche de modifier un projet lorsque son statut est Terminé. Si un utilisateur ou une utilisatrice tente d’ajouter une dépense à un projet terminé en juin, la dépense ne peut pas être ajoutée, car elle a déclenché la deuxième règle.
Les règles métier s’appliquent à la création, à la modification et à la suppression d’objets par le biais de l’API ainsi que dans l’interface Workfront.
Conditions d’accès
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
|---|---|
| Package Adobe Workfront |
Validation des règles métier :
Automatisation des règles métier :
|
| Licence Adobe Workfront | Standard |
| Configurations des niveaux d’accès | Administrateur ou administratrice système |
Pour plus d’informations, voir Conditions d’accès requises dans la documentation Workfront.
Scénarios pour les règles métier
Scénarios de validation des règles métier
Le format de validation d’une règle métier est le suivant : « SI la condition définie est remplie, l’utilisateur ne peut pas agir sur l’objet et le message s’affiche. »
La syntaxe des propriétés et autres fonctions d'une règle métier est identique à celle d'un champ calculé dans un formulaire personnalisé. Pour plus d’informations sur la syntaxe, voir Ajouter des champs calculés avec le concepteur de formulaire .
Pour plus d’informations sur les instructions IF, consultez présentation des instructions « IF » et Opérateurs de condition dans les champs calculés personnalisés.
Pour plus d’informations sur les caractères génériques basés sur l’utilisateur, voir Utilisation de caractères génériques basés sur l’utilisateur pour généraliser les rapports.
Pour plus d’informations sur les caractères génériques basés sur la date, voir Utilisation de caractères génériques basés sur la date pour généraliser les rapports.
Un caractère générique d’API est également disponible dans les règles métier. Utilisez $$ISAPI pour déclencher la règle uniquement dans l’API. Utilisez !$$ISAPI pour appliquer la règle uniquement dans l’interface utilisateur et permettre aux utilisateurs de contourner la règle via l’API.
-
Par exemple, cette règle interdit aux utilisateurs de modifier des projets terminés via l’API. Si le caractère générique n’était pas utilisé, la règle bloquait l’action à la fois dans l’interface utilisateur et dans l’API.
code language-none IF({status} = "CPL" && $$ISAPI, "You cannot edit completed projects through the API.")
Les caractères génériques $$BEFORE_STATE et $$AFTER_STATE sont utilisés dans les expressions pour accéder aux valeurs de champ de l’objet avant et après toute modification.
- Ces deux caractères génériques sont disponibles pour le déclencheur de modification. L’état par défaut du déclencheur de modification (si aucun état n’est inclus dans l’expression) est le
$$AFTER_STATE. - Le déclencheur de création d’objet autorise uniquement le
$$AFTER_STATE, car l’état « before » n’existe pas. - Le déclencheur de suppression d’objet autorise uniquement le
$$BEFORE_STATE, car l’état après n’existe pas.
Voici quelques scénarios de règles métier simples :
-
Les utilisateurs ne peuvent pas ajouter de nouvelles dépenses pendant la dernière semaine de février. Cette formule pourrait se présenter comme suit :
code language-none IF(MONTH($$TODAY) = 2 && DAYOFMONTH($$TODAY) >= 22, "You cannot add new expenses during the last week of February.") -
Les utilisateurs ne peuvent pas modifier le nom d’un projet dont le statut est défini sur Terminé. Cette formule pourrait se présenter comme suit :
code language-none IF({status} = "CPL" && {name} != $$BEFORE_STATE.{name}, "You cannot edit the project name.")
Le système autorise une règle métier par objet et par déclencheur. Par exemple, une règle de déclenchement de modification est autorisée pour les problèmes. Cependant, vous pouvez inclure plusieurs règles dans une formule avec des instructions IF imbriquées.
Un scénario avec des instructions IF imbriquées est le suivant :
Les utilisateurs ne peuvent pas modifier les projets terminés et ne peuvent pas modifier les projets dont la date d’achèvement est planifiée en mars. Cette formule pourrait se présenter comme suit :
IF(
$$AFTER_STATE.{status}="CPL",
"You cannot edit a completed project",
IF(
MONTH({plannedCompletionDate})=3,
"You cannot edit a project with a planned completion date in March")
)
Activer la localisation dans une règle métier
Si votre organisation utilise la localisation personnalisée, vous devez activer la traduction d’un message de règle métier dans la règle métier. Si la traduction n’est pas activée, le message s’affiche en anglais pour le lecteur, même si le texte du message se trouve dans la liste Localisation et que le navigateur de l’utilisateur est défini sur la langue appropriée.
Lors de la configuration de la règle, insérez le mot TRANSLATE avant le message et placez le message entre parenthèses.
Exemple :
Cet exemple suppose que le message « Vous ne pouvez pas modifier les projets terminés » est inclus dans la zone de localisation de la Configuration et que le navigateur de l’utilisateur est défini sur la langue localisée.
IF({status} = "CPL", "You cannot edit completed projects.")
Le message s’affiche en anglais.IF({status} = "CPL", TRANSLATE("You cannot edit completed projects."))
Le message s’affiche dans la langue localisée.
Pour plus d’informations sur la localisation personnalisée, voir Configurer la localisation personnalisée.
Scénarios d’automatisation des règles métier
Le format d’une automatisation de règle métier est « SI la condition définie est remplie, l’automatisation sélectionnée est déclenchée ».
Les formules d’automatisation des règles métier ne nécessitent pas de message d’erreur
Pour vous assurer qu’une automatisation s’exécute chaque fois que l’objet et l’action sélectionnés se produisent, par exemple lors de la création d’un projet, utilisez la formule suivante :
IF(true, true)
Pour partager un projet uniquement si son projet a été approuvé, utilisez une formule comme celle-ci :
IF({status} = "APR", true)
Vous pouvez utiliser des caractères génériques dans les actions de règle métier, comme décrit dans la section Scénarios de validation de règle métier.
Ajouter une nouvelle règle métier
-
Cliquez sur l’icône Menu principal
-
Cliquez sur Règles métier dans le panneau de gauche.
-
Cliquez sur Nouvelle règle métier.
-
Saisissez le Nom de la règle métier dans la boîte de dialogue Créateur de règles.
-
Dans le champ Est actif, indiquez si la règle doit être active lorsque vous l’enregistrez.
Si vous sélectionnez Non, la règle est enregistrée comme inactive et vous pouvez l’activer ultérieurement.
-
(Facultatif) Saisissez une Description de la règle métier et de ce qui se passe lorsqu’elle est appliquée.
-
Sélectionnez le type d'objet auquel affecter la règle métier.
Vous pouvez appliquer des règles métier aux objets suivants :
- Projet
- Tâche
- Problème/Demande
- Portfolio
- Document
- Programme
- Frais
- Entreprise
- Itération
- Enregistrement de facturation
- Groupe
- Ressource non liée à la main-d’œuvre
- Risque
- Carte tarifaire
- Affectation
- l’utilisateur ou de l’utilisatrice
- Rôle
- Heure
- Modèle
- Congés
- Pool de ressources
- Fonction
- Catégorie de ressource non liée à la main d’œuvre
- Pool de ressources
- Congés
- Heure
- Plan des effectifs
- Modèle
- Ressource du plan des effectifs
-
Saisissez le Nom de la règle métier dans la boîte de dialogue Créateur de règles.
-
Dans le champ Est actif, indiquez si la règle doit être active lorsque vous l’enregistrez.
Si vous sélectionnez Non, la règle est enregistrée comme inactive et vous pouvez l’activer ultérieurement.
-
Sélectionnez un Déclencheur pour la règle métier. Les options sont les suivantes :
- Créée La règle est appliquée lorsqu’un utilisateur tente de créer un objet.
- Modifié La règle est appliquée lorsqu’un utilisateur tente de modifier un objet.
- Supprimé La règle est appliquée lorsqu’un utilisateur tente de supprimer un objet.
-
Créez la formule dans l’éditeur de formules, au centre de la boîte de dialogue des règles métier.
Le format d’une règle métier est « SI la condition définie est remplie, l’utilisateur ne peut pas agir sur l’objet et le message s’affiche ».
Dans la zone de formule, les parties de la règle métier que vous créez sont la condition et le message qui s’affiche dans Workfront lorsque la condition est remplie.
-
L'« objet » est le type d'objet que vous avez sélectionné lors de la création de la règle métier. Elle s’affiche dans l’en-tête de la boîte de dialogue.
-
L’« action » est le déclencheur que vous avez sélectionné pour la règle : créer, modifier ou supprimer l’objet.
-
Comme l’objet et l’action sont déjà définis, vous ne les incluez pas dans la formule.
-
Le message d’erreur personnalisé n’est inclus que si la règle est à des fins de validation ets’affiche pour l’utilisateur ou l’utilisatrice lorsqu’il ou elle déclenche la règle métier. Il doit fournir des instructions claires sur ce qui s’est passé et sur la manière de corriger le problème.
Vous pouvez inclure une URL statique dans le message d’erreur pour créer un lien vers la documentation ou d’autres pages utiles afin de guider l’utilisateur ou l’utilisatrice sur la manière de modifier son action dans la contrainte de la règle.
Dans cet exemple, « En savoir plus » renvoie vers l’URL.
"You are not allowed to add a new project in November.[Learn more](http://url)"L’URL doit être entre parenthèses, mais le texte du lien entre crochets n’est pas obligatoire. Vous pouvez afficher l’URL complète sous la forme d’un lien cliquable.
Cet exemple illustre une règle métier pour les projets. Si le mois en cours est novembre, les utilisateurs ne sont pas autorisés à créer de nouveaux projets, ce que le message explique.
Pour plus d’exemples de règles métier, voir Scénarios de règles métier dans cet article.
-
-
(Facultatif) Utilisez la formule Expressions et Champs dans le panneau de droite pour faciliter la création de la règle.
Recherchez une expression ou un champ pour affiner la liste des éléments disponibles.
La liste des champs disponibles est limitée aux champs liés au type d'objet de la règle métier.
-
(Conditionnel) Si vous validez l’action et que votre organisation se trouve sur le package Workfront Ultimate, dans la zone Alors , sélectionnez Valider l’objet.
Pour les autres packages, cette option est présélectionnée.
-
(Conditionnel) Pour automatiser une autre action, sélectionnez l’action.
Pour plus d’informations sur ces actions, consultez la section Options d’automatisation des règles métier dans cet article.
note note NOTE Votre organisation doit être sur le package Workflow Ultimate pour utiliser des actions en plus de la validation. Si ces autres options ne s’affichent pas, votre organisation ne figure pas dans le package Workflow Ultimate. -
Cliquez sur Enregistrer lorsque vous avez terminé de créer la règle métier.
Options d’automatisation des règles métier
Vous pouvez définir ces actions pour automatiser le déclenchement de la règle métier. Les actions disponibles dépendent du type d’objet sélectionné.
Activer une règle métier
Lorsqu’une règle métier est inactive, le champ Est actif dans la liste des règles métier affiche False. Vous ne pouvez pas mettre à jour le statut de la règle dans la vue Liste.
Pour activer une règle métier :
- Sélectionnez la règle métier dans la liste des règles et cliquez sur l'icône Modifier .
- Sélectionnez Oui pour Est actif dans la boîte de dialogue des règles métier.
- Cliquer sur Enregistrer.