DocumentationWorkfrontGuide Workfront

Référencer des collections dans un rapport

Last update: Fri Jun 14 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 Création d’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 de cet article :

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Forfait Adobe Workfront* N’importe quelle
Licence Adobe Workfront* Plan
Configurations des niveau d’accès*

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

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

Remarque : Si vous n’avez toujours pas accès à , demandez à votre administrateur Workfront s’il définit 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 les niveaux d’accès personnalisés.
Autorisations d’objet

Gestion des autorisations d’un rapport

Gestion des autorisations d’un affichage, d’un filtre ou d’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 Workfront.

Présentation des collections

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

Vous avez les deux relations suivantes entre les objets dans Workfront :

  • Une 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 portefeuille à la fois.

  • Une relation de type "un à plusieurs": 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 les objets à l’aide du créateur de rapports standard. Cependant, vous pouvez uniquement créer un rapport montrant la relation un-à-plusieurs entre les objets à l’aide de l’interface du mode texte du créateur de rapports.

Pour plus d’informations sur la création d’un rapport dans le créateur de rapports standard, voir Création d’un rapport personnalisé.

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

Recherche d’objets de collection et de 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 comprendre 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 savoir sur quelles collections peuvent faire l’objet de rapports :

  1. Accédez au Explorateur d’API.

  2. Recherchez l’objet de votre rapport.

  3. Sélectionnez la variable collections .

    note note
    NOTE
    Seuls les objets répertoriés dans cet onglet peuvent être représentés en tant que 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 la fenêtre fields pour l’objet de votre collection.

    note note
    NOTE
    Seuls les champs répertoriés dans cet onglet peuvent être référencés dans le rapport de collection, ou les champs 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 des objets d’une collection dans les éléments de rapport suivants :

  • Regroupements
  • Graphique

Par exemple, vous pouvez référencer la tâche ou publier des collections à partir d’un rapport de projet pour afficher des informations sur la tâche ou la publication au niveau du projet.

Référencer une collection dans l’affichage 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 l’affichage du rapport.

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

L’affichage affiche les informations sur les tâches ou les problèmes sous la forme d’une 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

Ajout d’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 :

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

  2. Cliquez sur Nouveau rapport.

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

  4. Vous pouvez quitter votre rapport et utiliser la variable 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 Recherche d’objets de collection et de leurs champs dans l’explorateur d’API dans cet article.
    Notez le nom de l’objet de la collection.

  5. En utilisant la variable 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 Recherche d’objets de collection et de 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 le Colonnes (affichage) , cliquez sur Ajouter une colonne.

  7. Cliquez sur Passer en mode Texte.

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

  9. Sélectionner tout le texte dans la Mode texte et supprimez-la, 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. Remplacer Nom de la colonne avec le nom de votre colonne dans la variable displayname ligne.

  11. Remplacer nom de l’objet de collection avec le nom de votre objet de collection dans la variable listmethod , comme il apparaît dans la section Explorateur d’API.

  12. Remplacer Champ d’objet de collection avec le nom du champ de votre objet de collection dans la variable valuefield , comme il apparaît dans la section Explorateur d’API.

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

    Pour plus d’informations sur les expressions personnalisées calculées, voir Présentation 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 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 Problèmes pour le listmethod ligne, au lieu de opTasks qui est le nom de la base de données pour les problèmes. Pour plus d’informations sur le moment d’utiliser issue et quand utiliser opTask lorsque vous faites référence à des problèmes, voir 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 leur responsable principal, vous pouvez utiliser une valeur expression pour référencer les noms des tâches adjacentes aux noms de leurs principaux responsables 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 responsables :

  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 de 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
La variable 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 :

‍ (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 de barre oblique. Les valeurs de la collection sont séparées par une barre oblique.
- = séparateur de 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
Remplacer 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.

Remplacer 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 la variable 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.

Remplacer  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 la variable Explorateur d’API.

Vous pouvez remplacer cette ligne par :

valeur expression=Champ/champ d’objet de collection calculé

Utilisation valeur expression, vous pouvez afficher une expression personnalisée calculée dans la colonne.

Pour plus d’informations sur le format valeur expression lignes, voir Présentation de la syntaxe du mode texte.

Limites de la vue d’une collection limitations-of-a-collection-view

Tenez compte des restrictions 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 faire d’un objet d’une collection un lien cliquable.
  • Vous ne pouvez pas créer une vue de collection d’une autre collection.
    Par exemple, vous ne pouvez pas afficher tous les personnes désignées pour chaque tâche dans un rapport de projet. Vous ne pouvez afficher que la personne désignée 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 bouton Principal menu , puis cliquez sur Rapports.

  2. Cliquez sur Nouveau rapport.

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

  4. Vous pouvez quitter votre rapport et utiliser la variable 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 Recherche d’objets de collection et de leurs champs dans l’explorateur d’API dans cet article.

    Notez le nom de l’objet de la collection.

  5. En utilisant la variable 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 Recherche d’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 le Filtres , cliquez sur Passer en mode Texte.

  7. Dans le Définition de 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. Remplacer nom de l’objet de collection avec le nom de votre objet de collection tel qu’il apparaît dans la variable Explorateur d’API. Cette valeur correspond généralement à la forme plurielle du nom de l’objet de collection.

  9. Remplacer Champ d’objet de collection avec le nom du champ de votre objet de collection dans, tel qu’il apparaît dans la variable Explorateur d’API.

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

  11. Remplacer 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 le rapport.

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 instructions sont jointes par des symboles d’esperluette. Nous vous recommandons de créer votre instruction dans un filtre, d’abord, puis de joindre les lignes des instructions avec des esperluettes.

Pour plus d’informations sur la création d’une instruction 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 bouton Principal menu , 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 Invite de rapports.

  7. Cliquez sur Ajouter une invite.

  8. Cliquez sur Invite personnalisée.

  9. Indiquez le nom de l’invite dans la variable  Field ​ name champ .

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

  11. Spécifiez les éléments suivants dans la variable Condition field :

    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. Remplacer  nom de l’objet de collection  avec le nom de votre objet de collection tel qu’il apparaît dans la variable Explorateur d’API. Cette valeur correspond généralement à la forme plurielle du nom de l’objet de collection.

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

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

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

  16. Remplacer  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 à un utilisateur 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 à l’utilisateur dont le GUID est 57cf1b7a000077c9f02f66cb09c8f86c.

    note note
    NOTE
    Vous ne pouvez pas référencer le nom de la personne désignée principale (champ "Affectée à") d’une tâche, selon la variable Explorateur d’API. Vous ne pouvez référencer que l’ID de la personne désignée principale.

    Par exemple, pour filtrer les projets pour lesquels l’un des problèmes de projet est assigné à un utilisateur 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 assigné à l’utilisateur 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