DocumentationWorkfrontGuide Workfront

Vue d’ensemble de la syntaxe du mode texte

Last update: Wed Jul 17 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Utilisateur ou utilisatrice

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

IMPORTANT
Tous les éléments de création de rapports suivent ce modèle de casse.

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 :

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 :

Ligne de code
Description
valuefield
Identifie l’objet référencé dans la colonne de la vue ou dans le regroupement. Il s’agit d’une référence directe à l’objet référencé.
valueexpression
Identifie l’objet référencé dans la colonne de la vue ou dans le regroupement. Il s'agit d'un calcul entre plusieurs champs.
valueformat
Identifie le format dans lequel Workfront renvoie la valeur spécifiée dans le champ de valeur ou les lignes d’expression de valeur.
width
Identifie la largeur d’une colonne en pixels.
stretch
Identifie les colonnes qui occupent un espace supplémentaire non nécessaire à la vue.
TIP

  • 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.

TIP
Bien que vous puissiez créer des champs calculés que vous pouvez afficher dans les rapports, les vues et les regroupements calculés sont plus dynamiques. Les vues calculées et les regroupements s’actualisent avec de nouvelles informations chaque fois que vous exécutez le rapport ou affichez une liste.
Pour plus d’informations sur la création de colonnes calculées dans une vue, voir Champs personnalisés calculés par rapport aux colonnes calculées.

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 ligne valuefield.

    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.

TIP
Vous pouvez créer une invite personnalisée en créant d’abord un filtre pour l’instruction que vous souhaitez inclure dans l’invite. Connectez toutes les lignes de code d’un filtre de "&" sans espaces entre les lignes et qui devient votre invite personnalisée.

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.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43