Vue d’ensemble de la syntaxe du mode texte
Vous pouvez utiliser l’interface du mode texte pour créer des vues, des filtres, des regroupements et des invites plus complexes dans des listes et des rapports. En mode texte, vous pouvez accéder aux champs et à leurs attributs qui ne sont pas disponibles dans l’interface de mode standard.
Pour plus d’informations et de considérations sur le mode texte avant de commencer, voir Présentation du mode texte.
Pour obtenir la liste complète de tous nos champs à rapporter et de leurs attributs, consultez l’ API Explorer.
Pour plus d’informations sur la création de rapports en mode texte, y compris des classes, des vidéos et des tutoriels, consultez la section En savoir plus sur le site Adobe Experience League.
Considérations sur la syntaxe du mode texte
- Vous devez comprendre la syntaxe Adobe Workfront avant de pouvoir commencer à créer des éléments de reporting en mode texte. La syntaxe Workfront pour le mode texte est propre à cette application et possède des caractéristiques uniques que vous devez connaître.
- Avant de commencer à utiliser le mode texte dans vos rapports, nous vous recommandons vivement de suivre nos cours sur les rapports avancés, afin de mieux comprendre notre langage de mode texte.
- Vous pouvez personnaliser les vues, les filtres et les regroupements à l’aide de l’interface de mode standard. Cependant, vous ne pouvez créer des invites personnalisées qu’en mode texte.
Directives courantes pour la création d’éléments de rapport en mode texte
Voici des instructions courantes lors de la création d’un élément de rapport ou de liste en mode texte :
-
Utilisez toujours la casse chameau lorsque vous référencez des objets ou des attributs dans la base de données Workfront.
-
Gardez à l’esprit la hiérarchie des objets dans Workfront. Les différences suivantes existent entre les vues, les filtres et les regroupements :
- Vous pouvez afficher dans une vue un objet qui se trouve à trois objets du rapport ou de l’objet de liste.
- Vous ne pouvez pas référencer des objets situés à plus de 2 objets de l’objet principal dans une invite de regroupement, de filtrage ou personnalisée.
Exemple : Vous pouvez afficher le nom ou le GUID du propriétaire du Portfolio dans une vue de tâche :
valuefield=project:portfolio:ownerID
Vous ne pouvez pas regrouper, filtrer ou inviter le propriétaire du Portfolio dans une vue de tâche :
project:portfolio:ownerID=5808f4bc00790b270a9629dd128e63fa
Dans ces exemples, l’ID de propriétaire de Portfolio se trouve à trois objets de l’objet de la liste.
Pour plus d’informations sur la hiérarchie des objets dans Workfront, voir :
-
Lorsque cela est possible, utilisez des caractères génériques pour rendre vos rapports et listes plus dynamiques et évitez de les dupliquer pour différents utilisateurs et des chronologies similaires.
Présentation de la casse Camel
Lorsque vous référencez des champs Workfront ou leurs attributs en mode texte, Workfront vous demande de saisir leurs noms en majuscules. Dans ce cas, les champs à nom unique sont orthographiés en minuscules. Les champs composés sont orthographiés selon le modèle suivant :
camelCaseSyntax
Les caractéristiques de la casse sont les suivantes :
- Le premier mot commence toujours par une lettre minuscule.
- Les mots suivants commencent toujours par une lettre majuscule.
- Il n'y a pas d'espace entre les mots.
Exemple : Pour référencer la date d’achèvement réelle d’un projet, le nom du champ que vous utiliseriez lors de la création d’éléments de rapport en mode texte est :
actualCompletionDate
Syntaxe du mode texte pour divers éléments de reporting
Les similitudes suivantes existent entre la syntaxe des ensembles d’éléments de reporting ci-dessous, lors de leur création en mode texte :
-
Les lignes de code et de syntaxe sont similaires pour les vues et les regroupements.
Pour plus d’informations sur les lignes clés de codes pour les vues et les regroupements lors de leur création en mode texte, voir :
-
Les lignes de code et de syntaxe sont similaires pour les filtres et les invites personnalisées.
Pour plus d’informations, voir :
Syntaxe des vues et des regroupements
Les lignes de code lors de la création de vues et de regroupements sont similaires.
Pour plus d’informations sur la création de vues et de regroupements, consultez les articles suivants :
La ligne de code la plus importante pour une vue ou un regroupement est la ligne qui identifie l’objet référencé dans la colonne de la vue ou dans le regroupement. Cette ligne de code peut commencer par valuefield
ou valueexpression
selon que ce champ est une référence directe à un champ de la base de données Workfront ou un calcul entre plusieurs champs.
Le tableau suivant répertorie les lignes de codes les plus courantes dans une vue ou un regroupement :
valuefield
valueexpression
valueformat
width
stretch
-
Bien que les lignes de code dans les exemples ci-dessous soient similaires entre les vues et les regroupements, n’oubliez pas que chaque ligne de code pour un regroupement commence par le numéro de regroupement.
Pour regrouper par nom de projet dans une liste de projets ou un rapport, utilisez la ligne suivante pour le groupement de premier niveau :
group.0.valuefield=name
-
Si vous modifiez plusieurs colonnes dans une même colonne (comme c’est le cas pour les colonnes partagées), n’oubliez pas que chaque ligne de code pour chaque colonne commence par le numéro de colonne.
Utilisez le format suivant pour identifier la première colonne d’une vue :
column.0.valuefield=name
Pour plus d'informations sur le partage de colonnes, voir Affichage : fusionner les informations de plusieurs colonnes dans une seule colonne partagée.
Présentation de la syntaxe Valuefield
pour les vues et les groupes
Valuefield=
est une ligne de code clé dans les vues et les regroupements qui identifie l’objet que vous référencez directement.
La syntaxe des champs de référencement direct est identique pour les regroupements et les vues.
Les règles suivantes s’appliquent lors du référencement d’objets Workfront à l’aide d’une ligne valuefield
:
-
Utilisez la casse chameau pour référencer directement les champs.
Exemple : Pour référencer la date de fin de la tâche dans une vue de tâche, utilisez la ligne suivante :
valuefield=actualCompletionDate
-
Utilisez des majuscules et des deux-points pour séparer les champs les uns liés aux autres pour le même objet.
Exemple : Pour référencer la date de fin planifiée du projet dans une vue de tâche, utilisez la ligne suivante :
valuefield=project:plannedCompletionDate
Pour plus d’informations sur la façon dont les objets se référencent dans la base de données Workfront, voir l’ API Explorer.
-
Lorsque vous référencez un champ personnalisé, utilisez le nom du champ tel qu’il apparaît dans l’interface.
Exemple : Pour référencer un champ personnalisé de projet intitulé Détails supplémentaires dans une vue de tâche, utilisez la ligne suivante :
valuefield=project:Additional Details
Présentation de la syntaxe Valueexpression
pour les vues et les groupes
Vous pouvez remplacer la ligne de code valuefield=
par valueexpression=
lors de la création de vues et de regroupements en mode texte lorsque vous souhaitez référencer un calcul entre 2 champs ou plus.
La création d'un groupement calculé est similaire à la création d'une colonne calculée dans une vue.
Les règles suivantes s’appliquent lors du référencement d’objets Workfront à l’aide d’une ligne valueexpression
:
-
Utilisez la casse chameau pour référencer directement les champs et placez chaque champ entre accolades.
Exemple : Pour afficher le champ Nom de la tâche dans une colonne de tâche à l’aide de
valueexpression
, utilisez la ligne suivante :valueexpression={name}
-
Utilisez la casse chameau et les points pour séparer les champs les uns liés aux autres.
Exemple : Pour afficher le nom d’un projet concaténé avec le nom de la tâche dans un rapport de tâche, utilisez les lignes suivantes :
-
Dans une vue :
valueexpression=CONCAT({project}.{name},' - ',{name})
-
Dans un groupement :
group.0.valueexpression=CONCAT({project}.{name},' - ',{name})
Pour plus d’informations sur la façon dont les objets se référencent dans la base de données Workfront, voir l’ API Explorer.
-
-
Lors du référencement d’un champ personnalisé, utilisez les règles suivantes :
- Utilisez le nom du champ tel qu’il apparaît dans l’interface.
- Précisez le nom du champ avec "DE:".
- Placez le champ entre accolades.
- Séparez les champs associés à l’objet par des points.
Exemple : Pour afficher le champ personnalisé du projet Détails supplémentaires dans une vue de tâche dans une ligne d’expression de valeur, utilisez la ligne suivante :
valueexpression={project}.{DE:Additional Details}
-
Vous pouvez utiliser un caractère générique dans une ligne
valueexpression
mais pas dans une lignevaluefield
.Pour plus d’informations sur les caractères génériques, voir Présentation des variables de filtre générique.
Valueformat
- Aperçu pour les vues et les groupes
La deuxième ligne de code la plus importante dans une vue ou un regroupement est la ligne valueformat=
. Cela indique à Workfront dans quel format renvoyer la valeur que vous spécifiez dans les lignes valuefield
ou valueexpression
. Bien que vous puissiez utiliser différents formats pour les lignes valueformat
, nous vous recommandons de toujours utiliser la valeur suivante lors de l’utilisation de valueexpression
:
valueformat=HTML
Pour les valeurs valueformat
supplémentaires, reportez-vous également aux articles suivants :
width
- Aperçu pour les vues
width=
est la ligne de code dans laquelle vous pouvez spécifier la largeur de chaque colonne en pixels. Workfront fournit une largeur suggérée pour chaque champ. Cependant, selon le type de champ et le format, vous pouvez effectuer des ajustements.
Vous devez utiliser la ligne de code usewidths=true
supplémentaire pour appliquer la largeur spécifiée pour la colonne.
Exemple : Pour afficher une colonne d’une largeur de 80 pixels, utilisez les lignes suivantes :
width=80
usewidths=true
stretch
- Aperçu pour les vues
Le stretch
est utilisé pour identifier les colonnes qui occupent un espace supplémentaire non nécessaire à la vue. La largeur de l’interface utilisateur de l’espace de travail d’un utilisateur type est d’environ 850 pixels. Cela signifie que si vous disposez d’une vue de quatre colonnes (150 pixels chacune), votre vue occupe 600 de 850 pixels. L’interface utilisateur contient 250 pixels supplémentaires qui seront ajoutés aux colonnes pour lesquelles un pourcentage d’étirement est fourni.
L'étirement d'une colonne est appliqué lorsque vous utilisez la ligne de code supplémentaire : usewidths=true
pour au moins une des colonnes de la vue.
Exemple : Pour indiquer qu’une colonne peut utiliser 70 % de l’espace vide dans une vue, utilisez les lignes suivantes :
stretch=70
usewidths=true
Syntaxe des filtres et des invites personnalisées
La syntaxe de création de filtres est similaire à celle de création d’invites personnalisées.
Pour plus d’informations sur la création de filtres et d’invites personnalisées, voir :
Pour plus d’informations sur la création de filtres en mode texte, voir Modification d’un filtre à l’aide du mode texte.
Vous pouvez utiliser les éléments suivants pour créer des filtres et des invites personnalisés en mode texte :
-
Ligne de code référençant l’objet de l’instruction de filtre. Utilisez la casse chameau pour l’objet de filtre.
-
Ligne de code faisant référence à l’objet de filtre et au modificateur correspondant à la valeur de l’objet de filtre. Utilisez la casse chameau pour l’objet de filtre de cette ligne.
note tip TIP Lorsque vous référencez des plages, deux lignes de modificateur sont nécessaires. -
Un connecteur d’instructions qui connecte plusieurs instructions de filtre :
-
ET
Il s’agit du connecteur par défaut entre les instructions de filtre.
-
OU
note tip TIP Les connecteurs d’instructions sont sensibles à la casse et toujours en majuscules. "AND" peut être omis en mode texte.
-
-
Caractères génériques pour rendre les filtres plus dynamiques et les personnaliser pour l’heure actuelle ou pour l’utilisateur connecté. Pour plus d’informations sur les caractères génériques, voir Présentation des variables de filtre générique.