Vue d’ensemble des instructions « IF »
Vous pouvez utiliser des instructions « IF » dans des langages de programmation généraux. Dans Adobe Workfront, les instructions « IF » vous permettent de comparer, formater et associer des champs de données à des fins de création de rapports et de données personnalisées. En outre, la réflexion mathématique sur les instructions « IF » conduit à une meilleure compréhension conceptuelle puisque les variables pour les expressions sont généralement utilisées.
Recommandations pour les instructions « IF »
Tenez compte des points suivants avant de créer une instruction « IF » :
-
Nous recommandons une compréhension de base de tout langage de programmation général, mais nous n’en avons pas besoin pour ce guide.
-
Nous avons besoin d’une compréhension avancée de la syntaxe du mode texte de Workfront. Cela permet de comprendre la terminologie de l’API Workfront et la syntaxe des données personnalisées dans ces formats spécifiques.
Pour plus d’informations sur l’API Workfront, voir Principes de base des API.
Pour plus d’informations sur l’utilisation du mode texte, voir Vue d’ensemble du mode texte.
-
Vous pouvez créer des instructions « IF » pour les éléments Workfront suivants :
- Vues
- Regroupements
- Champs personnalisés calculés
-
Vous ne pouvez pas créer d’instructions « IF » pour les filtres. Une erreur « Oups » s’afficherait alors dans Workfront.
-
Notre équipe de support n’aide pas à créer des données personnalisées. Vous pouvez contacter l’équipe de support après avoir créé les champs ou colonnes personnalisés et ne pas obtenir les résultats escomptés. Pour obtenir de l’aide pour la création d’une expression, contactez la personne chargée de la gestion de votre compte pour obtenir des renseignements au sujet de nos options de conseil.
-
Nous vous recommandons d’écrire d’abord ces expressions dans un éditeur de texte, tel que Sublime ou Visual Studio Code, qui vous permettra d’afficher les données plus clairement que dans Workfront.
Composants d’une instruction « IF »
Vous pouvez créer des instructions « IF » dans Workfront au format suivant :
IF(Condition,True Expression,False Expression)
-
IF = il s’agit de l’expression de données calculées Workfront pour la « fonction ». Tout comme les expressions SUM et PROD, cela indique tout d’abord au système de comprendre la fonction en tant qu’instruction « IF ». Utilisez toujours des majuscules pour « IF » dans cette instruction.
Pour obtenir la liste de toutes les expressions de données calculées, voir Vue d’ensemble des expressions de données calculées. -
Condition = il s’agit de la condition que la variable Workfront doit remplir et qui est la base de cette équation. Tout ce qui peut être spécifié ultérieurement dans l’équation dépend de la condition. Vous pouvez utiliser un certain nombre de références, comparaisons ou expressions mathématiques pour commencer une équation. Voici quelques exemples de conditions :
- Une date est supérieure à une autre date sur un objet spécifié.
- Un statut est égal à l’un des statuts disponibles sur un objet spécifié.
- Le pourcentage terminé d’une tâche est inférieur ou supérieur à un certain pourcentage.
-
Opérateur de condition = il s’agit de l’opérateur qui vous aide à créer la condition de votre instruction « IF ». Par exemple, « est égal à » ou « est supérieur à » sont des opérateurs de condition. Pour obtenir la liste des opérateurs de condition que vous pouvez utiliser dans les instructions, voir Opérateurs de condition dans les expressions personnalisées calculées.
-
Expression****True = il s’agit de la variable « True », qui indique à l’équation quel indicateur afficher une fois que les critères de la condition sont satisfaits (indicateurs True).
-
Expression False = il s’agit de la variable « False », qui indique à l’équation quel indicateur afficher lorsque les critères de la condition ne sont pas satisfaits (indicateurs False).
Dans l’exemple suivant, le format d’instruction original est utilisé pour écrire une expression de données simple pour une instruction « IF ». L’expression compare deux champs de date différents dans Workfront, suivis d’un résultat True/False sous la forme d’une chaîne de données :
IF({projectedCompletionDate}>{plannedCompletionDate},"Off Track","On Track")
Dans le langage de tous les jours, cette instruction signifie : si la date d’achèvement prévisionnelle de mon objet est « supérieure à » la date d’achèvement prévue du même objet, alors affichez le mot « retard » dans ce champ. Dans le cas contraire, affichez les mots « en bonne voie ».
Créer des champs calculés dans des formulaires personnalisés ou des colonnes personnalisées à l’aide d’instructions « IF »
Vous pouvez créer des instructions « IF » dans un champ calculé dans un formulaire personnalisé ou dans une colonne personnalisée.
Il existe une différence entre la syntaxe que vous utilisez dans un formulaire personnalisé calculé et celle d’une colonne personnalisée calculée. Reportez-vous aux exemples suivants :
Instructions « IF » uniques single-if-statements
Voici des exemples d’un champ personnalisé calculé et de sa colonne correspondante à l’aide d’une instruction « IF » :
- Champ personnalisé calculé :
Lors de la création d’un champ personnalisé, utilisez la syntaxe suivante pour une instruction « IF » :
IF({Projected Completion Date}>{Planned Completion Date},"Off Track","On Track")
- Colonne personnalisée calculée :
Lors de la création d’une colonne personnalisée, vous devez utiliser la syntaxe suivante pour l’instruction « IF » dans la ligne d’expression de valeur :
valueexpression=IF({projectedCompletionDate}>{plannedCompletionDate},"Off Track","On Track")
Plusieurs instructions « IF » multiple-if-statements
Vous pouvez assembler plusieurs instructions « IF » avec l’instruction suivante pour créer une expression plus complexe et dynamique :
IF(Condition1,True Expression,IF(Condition2,True Expression,False Expression))
Vous trouverez ci-dessous des exemples d’un champ personnalisé calculé et de sa colonne personnalisée correspondante à l’aide de plusieurs instructions « IF » :
-
Champ personnalisé calculé :
code language-none IF({projectedCompletionDate}>{plannedCompletionDate},"Off Track",IF({plannedCompletionDate}>{projectedCompletionDate},"Off Track","On Track")) -
Colonne personnalisée calculée :
valueexpression=IF({"projectedCompletionDate"}>{"plannedCompletionDate"},"Off Track",IF({plannedCompletionDate}>{projectedCompletionDate},"Off Track","On Track"))
Dans cet exemple, la même chose a été accomplie en assemblant deux variables de critères différentes.
Vous pouvez explorer ces options plus en détail en recréant ces exemples dans votre propre environnement.
La meilleure façon d’apprendre est d’expérimenter avec différents champs et scénarios. Familiarisez-vous également avec l’explorateur d’API, qui révèle les noms des champs qui peuvent être utilisés. Pour plus d’informations sur l’explorateur d’API, consultez Explorateur d’API.
Pour plus d’informations sur la syntaxe Workfront des expressions de données calculées, consultez Vue d’ensemble des expressions de données calculées.