Modifier le mode texte dans un regroupement
Vous pouvez modifier un regroupement dans une liste ou un rapport à l’aide du mode texte afin d’accéder aux champs non disponibles dans l’interface standard et créer des regroupements plus complexes.
Conditions d’accès
Vous devez disposer des accès suivants pour effectuer les étapes décrites dans cet article :
*Pour connaître le forfait, le type de licence ou l’accès dont vous disposez, contactez votre administrateur ou administratrice Workfront.
Conditions préalables
Avant de commencer à utiliser le mode texte dans un rapport ou une liste, assurez-vous toujours de bien connaître la syntaxe du mode texte Workfront.
Pour plus d’informations, voir :
Modifier le mode texte dans un regroupement
La modification d’un regroupement en mode texte est identique pour les rapports et les listes. L’accès au regroupement à partir d’un rapport ou d’une liste diffère.
Pour plus d’informations sur la création de regroupements, voir Créer des regroupements dans Adobe Workfront.
Pour plus d’informations sur la création d’un rapport, voir Créer un rapport personnalisé.
-
Utilisez l’une des méthodes suivantes :
-
Pour accéder au regroupement à partir d’un rapport, accédez au rapport, puis cliquez sur l’onglet Actions de rapport > Modifier > Regroupements.
-
Pour accéder au regroupement à partir d’une liste, accédez à la liste et dans le menu déroulant du Regroupement, placez le pointeur de la souris sur le regroupement à modifier, puis cliquez sur le l’icône Modifier .
Le créateur de regroupement s’ouvre.
-
-
Cliquez sur Ajouter un regroupement pour ajouter les regroupements, puis cliquez sur Passer en mode texte dans le coin supérieur droit du créateur.
note tip TIP Vous pouvez ajouter jusqu’à 3 regroupements dans l’interface standard. Vous pouvez ajouter un 4ème regroupement uniquement en mode texte et vous ne pouvez pas avoir plus de 4 niveaux de regroupement dans Workfront. -
Commencez à saisir le nom d’un champ en fonction duquel vous souhaitez effectuer un regroupement.
Sélectionnez le nom du champ lorsque vous le voyez dans la liste.
-
Cliquez sur Passer en mode Texte dans le coin supérieur droit du créateur.
Le regroupement est alors affiché en mode texte.
Lorsque vous éditez un regroupement en mode texte, Workfront ajoute la
code language-none textmode=true
ligne de code au regroupement. Cela indique que le regroupement est modifié en mode texte.
Exemple : pour regrouper une liste de tâches par nom de projet, puis par nom du cessionnaire principal, votre regroupement doit ressembler à ce qui suit, en mode texte.
code language-none textmode=true<br>group.0.linkedname=project<br>group.0.namekey=view.relatedcolumn<br><strong>group.0.valuefield=project:name</strong><br>group.0.namekeyargkey.0=project<br>group.0.namekeyargkey.1=name<br><strong>group.0.valueformat=string</strong><br>group.1.linkedname=assignedTo<br>group.1.namekey=view.relatedcolumn<br><strong>group.1.valuefield=assignedTo:name</strong><br>group.1.namekeyargkey.0=assignedTo<br>group.1.namekeyargkey.1=name<br><strong>group.1.valueformat=string</strong>
note important IMPORTANT Les lignes en gras sont obligatoires. Chaque champ du regroupement comporte plusieurs lignes de code qui font référence à ce champ.
Le tableau ci-dessous décrit les lignes clés d’un regroupement en mode texte.
note tip TIP Les lignes clés d’un regroupement en mode texte sont similaires aux lignes requises pour créer des vues en mode texte. table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto Exemple de ligne Description group.<nombre>. Chaque ligne de code est précédée de ce texte. Les lignes de code qui font référence au même champ sélectionné dans le regroupement sont numérotées du même nombre, comme suit :
- Le premier regroupement du rapport a un nombre de groupe de 0. Toutes les lignes faisant référence au premier regroupement commencent par
group.0
. - Le second regroupement du rapport a un numéro de groupe de 1. Toutes les lignes faisant référence au second regroupement commencent par
group.1
. - Le troisième regroupement du rapport a un nombre de groupe de 2. Toutes les lignes faisant référence au troisième regroupement commencent par
group.2
. - En mode texte uniquement, vous pouvez ajouter un nombre de groupe de 3, pour un quatrième regroupement. Toutes les lignes faisant référence au quatrième regroupement commencent par
group.3
.
Remarque : 4 regroupements ne sont pas pris en charge dans le créateur. Ils ne sont pris en charge que lorsque vous utilisez le mode texte. Workfront ne prend pas en charge plus de 4 niveaux de regroupements.
valuefield= Il s’agit du nom de l’objet ou du champ tel qu’il apparaît dans la base de données. Pour plus d’informations sur l’affichage des objets et des champs dans la base de données, voir Explorateur d’API.
Les scénarios suivants sont possibles :
-
Si le nom du champ que vous affichez est une expression au lieu d’un nom unique, vous devez utiliser la syntaxe « camel case » pour le
valuefield
. Par exemple, pour la Date de début prévue d’une tâche, le code est :Exemple :
group.0.valuefield=plannedStartDate
-
Si vous souhaitez afficher un champ personnalisé, la valeur
valuefield
est le nom réel du champ, comme vous le voyez dans l’interface. Par exemple, pour un champ personnalisé nommé « Plus d’informations », le code est :Exemple :
group.0.valuefield=More information
-
Si vous souhaitez regrouper des objets associés à d’autres objets à l’aide de la ligne de code
valuefield
, les noms et attributs des objets sont séparés par des deux-points.Par exemple, un regroupement par nom de portfolio pour une liste de tâches a la valeur suivante pour la ligne de champ de valeur :
Exemple :
group.0.valuefield=project:portfolio:name
Cela indique qu’à partir de l’objet du rapport (tâche), vous pouvez accéder à l’objet associé suivant (projet). À partir de là, vous pouvez accéder à l’objet associé suivant à partir du projet (portfolio), puis au nom du portfolio (nom).
Pour plus d’informations sur la façon dont les objets se connectent les uns aux autres, voir la section Interdépendance et hiérarchie des objets dans Présentation des objets dans Adobe Workfront.
Note : si vous choisissez un champ en mode texte non valide dans l’interface standard et passez à l’interface standard, le regroupement est supprimé.
valueformat= Cette ligne représente le format utilisé pour afficher
valuefield
. Levalueformat
identifie si un objet ou un champ s’affiche sous forme de texte, de nombre, de pourcentage ou de date.Nous vous recommandons d’utiliser
HTML
pour votrevalueformat
, en particulier lors de l’utilisation d’valueexpression
, afin d’assurer l’affichage le plus précis de vos informations.Pour plus d’informations sur les valeurs supplémentaires de cette ligne, voir Utiliser la mise en forme conditionnelle en mode texte.
valueexpression= Vous pouvez ajouter cette ligne pour remplacer
valuefield
, si vous souhaitez associer votre liste par un calcul entre plusieurs champs.Vous devez joindre le
valuefield
des objets entre accolades chaque fois que vous l’utilisez dans unevalueexpression
.Les scénarios suivants sont possibles :
-
Si vous souhaitez afficher le nom d’un regroupement en majuscules, procédez comme suit :
Exemple :
group.0.valueexpression=UPPER({valuefield})
Le
valuefield
de l’objet est orthographié tel qu’il apparaît dans l’explorateur d’API. -
Si vous souhaitez ajouter plusieurs
valuefields
en les reliant dans une lignevalueexpression
, vous devez les séparer par un point.Par exemple, si vous souhaitez afficher le nom du portfolio en majuscules dans une liste de tâches, vous utiliserez le code suivant dans la ligne
valueexpression
:Exemple :
group.0.valueexpression=UPPER({project}.{portfolio}.{name})
Si vous souhaitez utiliser un champ personnalisé dans une ligne
valueexpression
, vous devez faire précéder le nom du champ parDE:
pour indiquer qu’il s’agit d’un champ personnalisé. Le nom du champ est orthographié tel qu’il apparaît dans l’interface.Important : lorsque vous utilisez un champ personnalisé placé dans une section de formulaire personnalisé dotée d’autorisations restreintes pour certaines personnes, le calcul de l’
valueexpression
est vide lorsque ces personnes affichent ce calcul dans un rapport. Pour plus d'informations sur l'ajustement des autorisations sur les sections de formulaire personnalisées, voir Création d'un formulaire personnalisé.Par exemple, si vous disposez d’un champ personnalisé intitulé « Nom du développeur ou de la développeuse » et que vous souhaitez le regrouper en fonction de ce champ et l’afficher en majuscules, vous pouvez utiliser
valueexpression
pour l’indiquer :Exemple :
group.0.valueexpression=UPPER({DE:Developer Name}
)Lors du référencement d’un champ personnalisé de type saisie semi-automatique, utilisez l’expression suivante pour référencer le nom de l’objet sélectionné dans un champ intitulé « Nom du développeur ou de la développeuse » :
valueexpression=UPPER({DE:Developer Name:name})
namekey= / name= Cette ligne définit le libellé du regroupement. Dans ce cas, il utilise la valeur abrégée en fonction de la clé.
Si vous souhaitez modifier le nom du regroupement, vous pouvez modifier cette valeur, comme suit :
Exemple :
group.0.name=Your Value
Name
permet de saisir n’importe quel texte pour le nom du regroupement, tandis quenamekey
a besoin d’une clé qui est utilisée pour traduire le nom d’un regroupement.Pour modifier le nom du regroupement, vous pouvez également ajouter la ligne
displayname
, si elle n’est pas déjà présente.displayname = Vous pouvez ajouter la ligne suivante pour modifier le nom d’une colonne, ce qui remplace la valeur
namekey/name
:Exemple :
group.0.displayname=Your Value
Nous vous recommandons de supprimer toutes les lignes qui contiennent
name
lorsque vous renommez un regroupement. - Le premier regroupement du rapport a un nombre de groupe de 0. Toutes les lignes faisant référence au premier regroupement commencent par
-
(Facultatif) Ajoutez l’une des lignes de code suivantes à un regroupement quelconque pour indiquer si les résultats du regroupement doivent s’afficher dans une liste développée ou réduite. Par défaut, les regroupements s’affichent de manière étendue :
code language-none group.0.iscollapsed=true
si vous souhaitez que le regroupement s’affiche avec les résultats réduits ;
code language-none group.0.iscollapsed=false
si vous souhaitez que le regroupement s’affiche avec les résultats développés.
note tip TIP - Lorsque vous ajustez manuellement les regroupements lors de l’affichage d’une liste, Workfront mémorise vos préférences manuelles jusqu’à ce que vous vous déconnectiez. Lorsque vous vous reconnectez, la liste s’affiche en fonction de ce paramètre.
- Les résultats d’un regroupement s’affichent toujours développés après que l’on y a accédé à partir d’un élément de graphique.
-
Cliquez sur Terminé si vous souhaitez enregistrer vos modifications et continuer à modifier le regroupement ou le rapport.
-
Cliquez sur Enregistrer le regroupement dans une liste ou Enregistrer et Fermer pour enregistrer votre rapport.