DocumentationWorkfrontGuide Workfront

Collections de référence dans un rapport

Last update: Tue Sep 03 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Utilisateur ou utilisatrice

La création d’un rapport dans Adobe Workfront permet d’afficher un ensemble d’objets, leurs champs respectifs ou les objets liés sous la forme d’une liste, d’une grille ou d’un graphique.

Pour plus d’informations sur la création d’un rapport dans Workfront, voir la section Créer un rapport personnalisé.

Conditions d’accès

Développez pour afficher les exigences d’accès aux fonctionnalités de cet article.

Vous devez disposer des accès suivants pour effectuer les étapes décrites dans cet article :

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Formule Adobe Workfront* Tous
Licence Adobe Workfront* Plan
Configurations du niveau d’accès*

Modifier l’accès aux filtres, vues et groupes

Modifier l’accès aux rapports, tableaux de bord et calendriers

Remarque : si vous n’avez toujours pas d’accès, demandez à votre équipe d’administration Workfront s’il existe des restrictions supplémentaires à votre niveau d’accès. Pour plus d’informations sur la façon dont un administrateur ou une administratrice Workfront peut modifier votre niveau d’accès, voir Créer ou modifier des niveaux d’accès personnalisés.
Autorisations d’objet

Gérer les autorisations d’un rapport

Autorisations Gérer sur une vue, un filtre ou un regroupement

Pour plus d’informations sur la demande d’accès supplémentaire, voir Demander l’accès aux objets.

Pour connaître le plan, le type de licence ou l’accès dont vous disposez, contactez votre administrateur ou administratrice Workfront.

Fonctionnement des collections

Une collection est une liste d’objets liés à un autre objet.

Les deux relations suivantes existent entre les objets dans Workfront :

  • Relation un-à-un  : un objet ne peut être lié qu’à un seul autre objet à la fois.
    Par exemple, un projet ne peut être lié qu’à un portfolio à la fois.

  • Relation un-à-multiple  : un objet peut être lié à plusieurs autres objets à la fois.
    Par exemple, un projet peut comporter plusieurs tâches. Dans ce cas, la liste des tâches forme une collection pour le projet.

IMPORTANT
Vous pouvez créer un rapport montrant la relation un-à-un entre des objets à l’aide du Report Builder standard. Cependant, vous ne pouvez créer un rapport montrant la relation un-à-multiple entre des objets qu’en utilisant l’interface du mode texte du Report Builder.

Pour plus d’informations sur la création d’un rapport dans le Report Builder standard, voir la section Créer un rapport personnalisé.

Pour plus d’informations sur la création d’un rapport à l’aide de l’interface du mode texte, voir ce qui suit :

Rechercher des objets de collection et leurs champs dans l’explorateur d’API find-collection-objects-and-their-fields-in-the-api-explorer

Toutes les collections ne peuvent pas faire l’objet de rapports.

Pour connaître les objets qui peuvent être associés à une collection d’autres objets, vous devez utiliser l’explorateur d’API.
Pour plus d’informations sur le tableau de l’explorateur d’API, voir la section Explorateur d’API.

Pour établir les collections qui peuvent faire l’objet de rapports, procédez comme suit :

  1. Accédez à l’explorateur d’API.

  2. Recherchez l’objet de votre rapport.

  3. Sélectionnez l’onglet collections.

    note note
    NOTE
    Seuls les objets répertoriés dans cet onglet peuvent être représentés sous forme de collection dans un rapport pour l’objet que vous avez sélectionné.

  4. Développez l’objet de votre collection en cliquant dessus.

  5. Cliquez sur le lien affiché pour accéder à l’objet de votre collection.
    Cela ouvre l’onglet champs pour l’objet de votre collection.

    note note
    NOTE
    Seuls peuvent être référencés dans le rapport de collection les champs répertoriés dans cet onglet ou ceux associés aux objets répertoriés dans cet onglet.

Collections de référence dans les rapports

Vous pouvez référencer des objets d’une collection dans les éléments de rapport suivants :

  • Vues
  • Filtres
  • Invites

Vous ne pouvez pas référencer d’objets d’une collection dans les éléments de rapport suivants :

  • Regroupements
  • Graphique

Par exemple, vous pouvez référencer les collections de tâches ou de problèmes à partir d’un rapport de projet pour afficher des informations sur la tâche ou le problème au niveau du projet.

Référencer une collection dans la vue d’un rapport reference-a-collection-in-the-view-of-a-report

Vous pouvez référencer une collection d’objets dans la vue d’un rapport pour afficher les attributs des objets associés à l’objet du rapport.

Vous pouvez, par exemple, afficher les informations sur une tâche ou un problème dans un rapport de projet en créant une colonne de collection pour les tâches ou les problèmes dans la vue du rapport.

Vous pouvez afficher des informations sur les tâches ou les problèmes, tels que les noms, les dates, les personnes cessionnaires principales, le pourcentage d’achèvement, etc., dans la vue Collection.

La vue affiche des informations sur les tâches ou les problèmes sous forme de liste, chaque ligne de la liste représentant des informations sur une tâche ou un problème. La liste des tâches ou des problèmes et de leurs champs s’affiche sur la même ligne que le projet auquel appartiennent les tâches ou les problèmes.
issue_and_tasks_collections_in_reports.png

Ajouter une colonne de collection dans une vue de rapport add-a-collection-column-in-a-report-view

Pour ajouter une colonne de collection dans une vue de rapport, procédez comme suit :

  1. Cliquez sur le menu Principal , puis sur Rapports.

  2. Cliquez sur Nouveau rapport.

  3. Sélectionnez l’objet de votre rapport.

  4. Sortez du rapport et, à l’aide de l’explorateur d’API, déterminez les collections disponibles pour l’objet sélectionné pour votre rapport.

    Pour plus d’informations sur la sélection de l’objet de votre collection, voir la section Rechercher des objets de collection et leurs champs dans l’explorateur d’API dans cet article.
    Notez le nom de l’objet de la collection.

  5. En utilisant l’explorateur d’API, accédez à la liste des champs de l’objet que vous souhaitez afficher dans la collection.

    Pour plus d’informations sur la recherche des champs de l’objet de votre collection, voir la section Trouver des objets de collection et leurs champs dans l’explorateur d’API dans cet article.

    Notez le nom du champ que vous souhaitez afficher dans la collection.

  6. Revenez à votre rapport et, dans l’onglet Colonnes (Affichage), cliquez sur Ajouter une colonne.

  7. Cliquez sur Basculer en mode texte.

  8. Pointez la souris sur la boîte de dialogue, puis cliquez sur Cliquez pour modifier le texte.

  9. Sélectionnez tout le texte dans la boîte de dialogue Mode texte et supprimez-le, puis collez le code suivant si vous référencez un champ de l’objet de collection :

    code language-none 
    valueformat=HTML
textmode=true
type=iterate
listdelimiter=<p>
displayname=Column Name
listmethod=nested(collection object name).lists
valuefield=collection object field

  10. Remplacez Nom de la colonne par le nom de votre colonne dans la ligne displayname.

  11. Remplacez le nom de l’objet de collection par le nom de votre objet de collection dans la ligne listmethod, tel qu’il apparaît dans l’explorateur d’API.

  12. Remplacez le champ d’objet de collection par le nom du champ de votre objet de collection dans la ligne valuefield, tel qu’il apparaît dans l’explorateur d’API.

    Vous pouvez remplacer valuefield par valueexpression, si vous souhaitez créer une expression personnalisée dans votre vue.

    Pour plus d’informations sur les expressions personnalisées calculées, voir la section Vue d’ensemble des expressions de données calculées.

    Par exemple, si vous souhaitez afficher une liste des tâches dans un rapport de projet. Cette collection utilise une ligne valuefield pour référencer les noms des tâches.

    Utilisez l’une des méthodes suivantes :

    • Utilisez le code suivant pour créer votre colonne :

      code language-none 
      valueformat=HTML
textmode=true
type=iterate
listdelimiter=<p>
displayname=Project Tasks Names
listmethod=nested(tasks).lists
valuefield=name

    • Utilisez le code suivant pour afficher la liste des problèmes du rapport :

      code language-none 
      displayname=Project Issues Names
listdelimiter=<p>
listmethod=nested(issues).lists
textmode=true
type=iterate
valuefield=name
valueformat=HTML

      Notez que, dans une collection, vous devez utiliser issues pour la ligne listmethod, au lieu de opTasks qui est le nom de la base de données pour les problèmes. Pour connaître le moment où il convient d’utiliser issue ou opTask lorsque vous faites référence à des problèmes, voir la section Utiliser « opTask » et « issue » lors de la référence à des problèmes.

    • Si vous souhaitez afficher une liste des tâches dans un rapport de projet avec la personne cessionnaire principale, vous pouvez utiliser une ligne valueexpression pour référencer les noms des tâches à côté des noms de leurs personnes cessionnaires principales, au lieu de valuefield.

      Utilisez le code suivant pour créer votre colonne :

      code language-none 
      valueformat=HTML
textmode=true
type=iterate
listdelimiter=<p>
displayname=Tasks Names - Primary Assignee
listmethod=nested(tasks).lists
valueexpression=CONCAT({name},' - ',{assignedTo}.{name})

  13. La colonne suivante s’affiche dans le rapport de projet, répertoriant toutes les tâches de chaque projet avec leurs principaux et principales cessionnaires :

  14. Cliquer sur Enregistrer.

  15. (Facultatif) Poursuivez la modification du rapport.

    Ou

    Cliquez sur Enregistrer + Fermer pour enregistrer le rapport.

Présentation des lignes d’une vue de collection en mode Texte

Les lignes d’une collection en mode Texte sont décrites dans le tableau suivant :

Exemple de ligne
Description
valueformat=HTML
Vous pouvez utiliser différentes valeurs pour cette ligne, mais nous vous recommandons que le valueformat pour qu’une liste de collections soit HTML.
textmode=true
Cette ligne indique que la colonne a été paramétrée en mode Texte. Si vous supprimez cette ligne, Workfront la réajoute par défaut.
type=iterate
Le type d’une liste est toujours iterate, lors de la création d’une vue.
listdelimiter=<p>

Il s’agit du délimiteur utilisé pour séparer les valeurs de votre liste.
Nous vous recommandons d’utiliser <p> qui ajoute un saut de ligne entre les valeurs.

Vous pouvez également utiliser les éléments suivants :

&zwj; (jointure à largeur nulle).Les valeurs de la collection ne sont pas séparées entre elles.
, =séparateur Virgule.Les valeurs de la collection sont séparées par une virgule suivie d’un espace vide.
/ = séparateur Barre oblique.Les valeurs de la collection sont séparées par une barre oblique.
- = séparateur Tiret. Les valeurs de la collection sont séparées par un tiret.
Si vous laissez cette ligne vide, une virgule est ajoutée, suivie par défaut d’un espace entre les valeurs de la collection.

displayname=Nom de la.colonne
Remplacez le Nom de la colonne avec le nom réel de votre nouvelle colonne.
listmethod=nested(collection object name).list

Cette ligne définit la collection à laquelle vous faites référence.

Remplacez le nom de l’objet de collection avec le nom de l’objet que vous référencez dans votre collection, tel qu’il apparaît dans l’Explorateur d’API. Cette valeur correspond généralement à la forme plurielle du nom de l’objet de collection.

valuefield=collection object field

Cette ligne définit le champ que vous référencez à partir de l’objet de collection.

Remplacez le Champ d’objet de collection avec le nom du champ de l’objet que vous référencez dans votre collection, tel qu’il apparaît dans l’Explorateur d’API.

Vous pouvez remplacer cette ligne par :

valueexpression=Champ/champs d’objet de collection calculé

Grâce à valueexpression, vous pouvez afficher une expression personnalisée calculée dans la colonne.

Pour plus d’informations sur le format des lignes valueexpression, voir Vue d’ensemble de la syntaxe du mode Texte.

Limites de la vue de collection limitations-of-a-collection-view

Tenez compte des limites suivantes lorsque vous créez une vue de collection :

  • Vous ne pouvez pas contrôler l’ordre d’affichage des données de collection.
  • Vous ne pouvez pas appliquer de mise en forme conditionnelle à une vue de collection.
  • Vous ne pouvez pas transformer un objet d’une collection en un lien cliquable.
  • Vous ne pouvez pas créer une vue de collection d’une autre collection.
    Par exemple, vous ne pouvez pas afficher toutes et tous les cessionnaires pour chaque tâche dans un rapport de projet. Vous ne pouvez afficher que le cessionnaire principal ou la cessionnaire principale pour chaque tâche dans une vue de projet.

Référencer une collection dans le filtre d’un rapport reference-a-collection-in-the-filter-of-a-report

Vous pouvez référencer une collection d’objets dans le filtre d’un rapport afin de filtrer les attributs des objets associés à l’objet du rapport.

Vous pouvez, par exemple, filtrer les informations de tâche ou de problème dans un rapport de projet en utilisant une référence aux attributs des tâches ou des problèmes du projet dans l’instruction de filtre.

Pour ajouter une référence à une collection dans un filtre de rapport :

  1. Cliquez sur le menu Principal , puis cliquez sur Rapports.

  2. Cliquez sur Nouveau rapport.

  3. Sélectionnez l’objet de votre rapport.

  4. Sortez du rapport et, à l’aide de l’explorateur d’API, déterminez les collections disponibles pour l’objet sélectionné pour votre rapport.

    Pour plus d’informations sur la sélection de l’objet de votre collection, voir la section Rechercher des objets de collection et leurs champs dans l’explorateur d’API dans cet article.

    Notez le nom de l’objet de la collection.

  5. En utilisant l’explorateur d’API, accédez à la liste des champs de l’objet que vous souhaitez afficher dans la collection.

    Pour plus d’informations sur la recherche des champs de l’objet de votre collection, voir la section Rechercher des objets de collection et de leurs champs dans l’explorateur d’API dans cet article.

    Notez le champ que vous souhaitez afficher dans la collection.

  6. Revenez à votre rapport et dans l’onglet Filtres, cliquez sur Passer en mode Texte.

  7. Dans la zone Définir des règles de filtrage pour votre rapport, collez le code suivant :

    code language-none 
    collection object name:collection object field=collection object value
collection object name:collection object field_Mod=value of the modifier

  8. Remplacez le nom de l’objet de collection avec le nom de votre objet de collection tel qu’il apparaît dans l’Explorateur d’API. Cette valeur correspond généralement à la forme plurielle du nom de l’objet de collection.

  9. Remplacez le Champ de l’objet de collection avec le nom du champ de votre objet de collection tel qu’il apparaît dans l’Explorateur d’API.

  10. Remplacez la valeur de l’objet de collection avec la valeur de l’objet de collection tel qu’elle apparaît dans Workfront.

  11. Remplacez la valeur du modificateur avec un modificateur valide.

    Pour obtenir la liste des modificateurs, voir Modificateurs de filtre et de condition.
    Par exemple, pour créer un rapport de projet qui affiche uniquement les projets dont le nom contient « Marketing », utilisez le code suivant :

    code language-none 
    tasks:name=Marketing
tasks:name_Mod=cicontains

    Ce rapport affiche uniquement les projets dont le nom contient au moins une tâche portant le mot « marketing ».

  12. Pour filtrer le nom d’un problème, utilisez le code suivant :

    code language-none 
    issues:name=Marketing
issues:name_Mod=cicontains
    note tip
    TIP
    Notez que vous devez utiliser issues pour le nom de l’objet de collection, au lieu de optask qui permet d’afficher les problèmes dans l’explorateur d’API.

  13. Cliquez sur Terminé.

  14. (Facultatif) Poursuivez la modification du rapport.

    Ou

    Cliquez sur Enregistrer + Fermer pour enregistrer la vue.

Référencer une collection dans l’invite personnalisée d’un rapport reference-a-collection-in-the-custom-prompt-of-a-report

Vous pouvez référencer une collection d’objets dans l’invite personnalisée d’un rapport afin de filtrer les résultats du rapport en fonction des attributs des objets associés à l’objet du rapport.

Par exemple, vous pouvez demander des informations sur la tâche dans un rapport de projet en utilisant une référence aux attributs des tâches du projet dans l’invite personnalisée du rapport.

NOTE
Vous ne pouvez pas référencer des collections dans une invite standard.

Une invite personnalisée est un filtre personnalisé où les déclarations sont jointes par des symboles d’esperluette. Nous vous recommandons de créer votre déclaration dans un filtre, d’abord, puis de joindre les lignes des déclarations avec des esperluettes.

Pour plus d’informations sur la création d’une déclaration de filtre avec une référence de collection, voir la section Référencer une collection dans le filtre d’un rapport dans cet article.

Pour ajouter une référence à une collection dans l’invite personnalisée d’un rapport :

  1. Cliquez sur le menu Principal , puis cliquez sur Rapports.

  2. Cliquez sur Nouveau rapport.

  3. Sélectionnez l’objet de votre rapport.

  4. Créez un filtre avec une référence de collection comme décrit dans la section Référencer une collection dans le filtre d’un rapport dans cet article.

  5. Cliquez sur Paramètres des rapports.

  6. Cliquez sur Invites de rapports.

  7. Cliquez sur Ajouter une invite.

  8. Cliquez sur Invite personnalisée.

  9. Indiquez le nom de l’invite dans le champ Nom****champ.

  10. Indiquez un Libellé de l’élément de liste déroulante.

  11. Indiquez les éléments suivants dans le champ Condition  :

    code language-none 
    collection object name:collection object field_Mod=value of the modifier

  12. (Facultatif) Indiquez si ce choix est affiché par défaut dans l’invite.

  13. Remplacez le nom de l’objet de collection avec le nom de votre objet de collection tel qu’il apparaît dans l’Explorateur d’API.Cette valeur correspond généralement à la forme plurielle du nom de l’objet de collection.

  14. Remplacez le Champ de l’objet de collection le avec le nom du champ de votre objet de collection, tel qu’il apparaît dans l’Explorateur d’API.

  15. Remplacez la valeur de l’objet de collection avec la valeur de l’objet de collection tel qu’elle apparaît dans Workfront.

    Par exemple, si vous filtrez les projets dont le nom de la tâche contient « Marketing », remplacez la valeur de l’objet de collection par marketing.

  16. Remplacez la valeur du modificateur avec un modificateur valide.

    Pour obtenir la liste des modificateurs, voir Modificateurs de filtre et de condition.

    Exemple : par exemple, pour créer un rapport de projet avec une invite personnalisée dans laquelle vous souhaitez afficher uniquement les projets pour lesquels au moins une tâche est affectée à une personne spécifique, utilisez le code ci-dessous :

    code language-none 
    tasks:assignedToID=57cf1b7a000077c9f02f66cb09c8f86c&tasks:assignedToID_Mod=in

    Cela génère un rapport dans lequel tous les projets répertoriés comportent au moins une tâche affectée à la personne dont le GUID est 57cf1b7a000077c9f02f66cb09c8f86c.

    note note
    NOTE
    Vous ne pouvez pas référencer le nom du cessionnaire principal ou de la cessionnaire principale (champ « Affectée à ») d’une tâche, selon l’Explorateur d’API. Vous ne pouvez référencer que l’identifiant du cessionnaire principal ou de la cessionnaire principale.

    Par exemple, pour filtrer les projets pour lesquels l’un des problèmes de projet est affecté à une personne spécifique, utilisez le code suivant pour votre invite personnalisée :

    code language-none 
    issues:assignedToID=57cf1b7a000077c9f02f66cb09c8f86c&issues:assignedToID_Mod=in

    Cela génère un rapport dans lequel tous les projets répertoriés comportent au moins un problème affecté à la personne dont le GUID est 57cf1b7a000077c9f02f66cb09c8f86c.

    note note
    NOTE
    Notez que vous devez utiliser Problèmes pour le nom de l’objet de collection. Pour l’instant, l’explorateur d’API ne propose pas de nom d’objet de collection pour les problèmes.

  17. Cliquez sur Terminé.

  18. (Facultatif) Poursuivez la modification du rapport.

    Ou

    Cliquez sur Enregistrer + Fermer pour enregistrer le rapport.

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