DokumentationWorkfrontWorkfront-Handbuch

Referenzieren von Sammlungen in einem Bericht

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Benutzende

Durch das Erstellen eines Berichts in Adobe Workfront können Sie eine Reihe von Objekten, die entsprechenden Felder oder verknüpfte Objekte in einer Liste, einem Raster oder einem Diagrammformat anzeigen.

Weitere Informationen zum Erstellen eines Berichts in Workfront finden Sie unter Erstellen eines benutzerdefinierten Berichts.

Zugriffsanforderungen

Erweitern Sie , um die Zugriffsanforderungen für die -Funktion in diesem Artikel anzuzeigen.

Sie müssen über Folgendes verfügen:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront-Plan Beliebig
Adobe Workfront-Lizenz

Neu:

  • Standard

Aktuell:

  • Plan
Konfigurationen der Zugriffsebene

Zugriff auf Filter, Ansichten, Gruppierungen bearbeiten

Zugriff auf Berichte, Dashboards, Kalender bearbeiten
Objektberechtigungen

Verwalten von Berechtigungen für einen Bericht

Verwalten von Berechtigungen für Ansichten, Filter oder Gruppierungen

Weitere Informationen finden Sie unter Zugriffsanforderungen in der Dokumentation zu Workfront.

Grundlegendes zu Sammlungen

Eine Auflistung ist eine Liste von Objekten, die mit einem anderen Objekt verknüpft sind.

Es bestehen die folgenden beiden Beziehungen zwischen Objekten in Workfront:

  • Eins-zu-eins-: Ein Objekt kann jeweils nur mit einem anderen Objekt verknüpft werden.
    Beispielsweise kann ein Projekt jeweils nur mit einem Portfolio verknüpft werden.

  • Eins-zu-Viele-Beziehung: Ein Objekt kann gleichzeitig mit mehreren anderen Objekten verknüpft werden.
    Beispielsweise kann ein Projekt mehrere Aufgaben haben. In diesem Fall bildet die Liste der Aufgaben eine Sammlung für das Projekt.

IMPORTANT
Sie können mit dem standardmäßigen Report Builder einen Bericht erstellen, der die Eins-zu-eins-Beziehung zwischen Objekten anzeigt. Sie können jedoch nur einen Bericht erstellen, der die Eins-zu-Viele-Beziehung zwischen Objekten anzeigt, indem Sie die Textmodus-Schnittstelle in Report Builder verwenden.

Weitere Informationen zum Erstellen eines Berichts im standardmäßigen Report Builder finden Sie unter Erstellen eines benutzerdefinierten Berichts.

Weitere Informationen zum Erstellen eines Berichts mithilfe der Textmodusschnittstelle finden Sie unter:

Suchen nach Sammlungsobjekten und ihren Feldern im API-Explorer find-collection-objects-and-their-fields-in-the-api-explorer

Nicht alle Sammlungen können gemeldet werden.

Um zu verstehen, welche Objekte mit einer Sammlung anderer Objekte verknüpft werden können, müssen Sie den API-Explorer verwenden.
Weitere Informationen zur API Explorer-Tabelle finden Sie unter API Explorer.

So erfahren Sie, über welche Sammlungen berichtet werden kann:

  1. Navigieren Sie zum API-Explorer.

  2. Suchen Sie das Objekt Ihres Berichts.

  3. Wählen Sie die Sammlungen aus.

    note note
    NOTE
    Nur die auf dieser Registerkarte aufgelisteten Objekte können für das ausgewählte Objekt als Sammlung in einem Bericht dargestellt werden.

  4. Erweitern Sie das -Objekt Ihrer Sammlung, indem Sie darauf klicken.

  5. Klicken Sie auf den angezeigten Link, um zum Objekt Ihrer Sammlung zu gelangen.
    Dadurch wird die Felder für das Objekt Ihrer Sammlung geöffnet.

    note note
    NOTE
    Nur die auf dieser Registerkarte aufgeführten Felder können im Sammlungsbericht referenziert werden oder die Felder, die mit auf dieser Registerkarte aufgeführten Objekten verknüpft sind.

Referenzieren von Sammlungen in Berichten

In den folgenden Berichtelementen können Sie auf Objekte aus einer Sammlung verweisen:

  • Ansichten
  • Filter
  • Prompts

In den folgenden Berichtelementen können Sie nicht auf Objekte aus einer Sammlung verweisen:

  • Gruppierungen
  • Diagramm

Sie können beispielsweise auf die Aufgaben- oder Problemkollektionen in einem Projektbericht verweisen, um Aufgaben- oder Probleminformationen auf Projektebene anzuzeigen.

Referenzieren einer Sammlung in der Ansicht eines Berichts reference-a-collection-in-the-view-of-a-report

In der Ansicht eines Berichts können Sie auf eine Auflistung von Objekten verweisen, um Attribute von Objekten anzuzeigen, die mit dem Objekt des Berichts verknüpft sind.

Sie können beispielsweise Aufgaben- oder Probleminformationen in einem Projektbericht anzeigen, indem Sie eine Sammlungsspalte für Aufgaben oder Probleme in der Ansicht des Berichts erstellen.

Sie können Informationen zu den Aufgaben oder Problemen, wie Namen, Daten, primäre Beauftragte, Prozent abgeschlossen usw., in der Sammlungsansicht anzeigen.

Die Ansicht zeigt Aufgaben- oder Probleminformationen in einem Listenformat an, wobei jede Zeile der Liste Informationen zu einer Aufgabe oder einem Problem darstellt. Die Liste der Aufgaben oder Probleme und deren Felder wird in derselben Zeile wie das Projekt angezeigt, zu dem die Aufgaben oder Probleme gehören.

issue_and_tasks_collections_in_reports.png {width="400"}

Hinzufügen einer Sammlungsspalte in einer Berichtsansicht add-a-collection-column-in-a-report-view

So fügen Sie eine Sammlungsspalte in einer Berichtsansicht hinzu:

  1. Klicken Sie auf das Hauptmenü ( - ) und dann auf Berichte.

  2. Klicken Sie Neuer Bericht.

  3. Wählen Sie das Objekt Ihres Berichts aus.

  4. Navigieren Sie weg von Ihrem Bericht und ermitteln Sie mithilfe des API-Explorers, welche Sammlungen für das Objekt verfügbar sind, das Sie für Ihren Bericht ausgewählt haben.

    Weitere Informationen zum Auswählen des Objekts Ihrer Sammlung finden Sie im Abschnitt Suchen nach Sammlungsobjekten und ihren Feldern im API-Explorer in diesem Artikel.

    Notieren Sie sich den Namen des -Objekts für die Auflistung.

  5. Navigieren Sie mithilfe API-Explorers zur Liste der Felder für das Objekt, das Sie in der Sammlung anzeigen möchten.

    Weitere Informationen zum Suchen der Felder des -Objekts Ihrer Sammlung finden Sie im Abschnitt Suchen nach Sammlungsobjekten und ihren Feldern im API-Explorer in diesem Artikel.

    Notieren Sie sich den Namen des Felds, das Sie in der Sammlung anzeigen möchten.

  6. Navigieren Sie zurück zu Ihrem Bericht und klicken Sie auf der Registerkarte Spalten (Ansicht auf Spalte hinzufügen.

  7. Klicken Sie In Textmodus wechseln.

  8. Klicken Sie Textmodus bearbeiten.

  9. Wählen Sie den gesamten Text im Textmodus-Dialogfeld aus, entfernen Sie ihn und fügen Sie dann den folgenden Code ein, wenn Sie auf ein Feld des Sammlungsobjekts verweisen:

    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. Ersetzen Spaltenname durch den Namen Ihrer Spalte in der displayname.

  11. Ersetzen Sie Sammlungsobjektname durch den Namen Ihres Sammlungsobjekts in der listmethod, wie er im API-Explorer).

  12. Ersetzen Sie Feld des Sammlungsobjekts durch den Namen des Felds Ihres Sammlungsobjekts in der valuefield, wie er im API-Explorer).

    Sie können valueField durch valueExpression ersetzen, wenn Sie einen benutzerdefinierten Ausdruck in Ihrer Ansicht erstellen möchten.

    Weitere Informationen zu berechneten benutzerdefinierten Ausdrücken finden Sie unter Übersicht über berechnete Datenausdrücke.

    Wenn Sie beispielsweise eine Liste der Aufgaben in einem Projektbericht anzeigen möchten. Diese Sammlung verwendet eine valuefield zum Referenzieren der Namen der Aufgaben.

    Führen Sie einen der folgenden Schritte aus:

    • Verwenden Sie den folgenden Code, um Ihre Spalte zu erstellen:

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

    • Verwenden Sie den folgenden Code, um eine Liste der Probleme im Bericht anzuzeigen:

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

      Beachten Sie, dass Sie in einer Auflistung Probleme für die listMethod-Zeile anstelle von opTasks verwenden müssen, dem Datenbanknamen für Probleme. Informationen dazu, wann "" und "" beim von Problemen verwendet werden sollten, finden unter „Verwenden von „OpTask“ und „Problem“ beim Referenzieren von Problemen.

    • Wenn Sie eine Liste der Aufgaben in einem Projektbericht zusammen mit dem primären Bearbeiter anzeigen möchten, verwenden Sie eine valueExpression-Zeile, um auf die Namen der Aufgaben neben den Namen des primären Beauftragten zu verweisen, anstatt auf valueField.

      Verwenden Sie den folgenden Code, um Ihre Spalte zu erstellen:

      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. Die folgende Spalte wird im Projektbericht angezeigt und listet alle Aufgaben in jedem Projekt neben ihren primären Beauftragten auf:

    Projektbericht mit Aufgaben- und Empfängersammlung {width="400"}

  14. Klicken Sie auf Speichern.

  15. (Optional) Fahren Sie mit der Bearbeitung des Berichts fort.

    Oder

    Klicken Sie Speichern + Schließen, um den Bericht zu speichern.

Die Zeilen einer Sammlungsansicht im Textmodus verstehen

Die Zeilen in einer Textmodusansicht für eine Sammlung sind in der folgenden Tabelle aufgeführt:

Beispielzeile
Beschreibung
valueformat=HTML
Sie können verschiedene Werte für diese Zeile verwenden. Es wird jedoch empfohlen, dass der valueformat für eine Sammlungsliste HTML lautet
textmode=true
Diese Zeile zeigt an, dass die Spalte im Textmodus konfiguriert wurde. Wenn Sie diese Zeile entfernen, fügt Workfront sie standardmäßig wieder hinzu.
type=iterate
Der type einer Liste wird beim Erstellen einer Ansicht immer iterate.
listdelimiter=<p>

Dies ist das Trennzeichen, das verwendet wird, um die Werte in Ihrer Liste zu trennen.
Es wird empfohlen, <p> zu verwenden, das einen Zeilenumbruch zwischen den Werten hinzufügt.

Sie können auch Folgendes verwenden:

‍ (Joiner mit Nullbreite). Die Werte der Sammlung sind nicht voneinander getrennt.
, =Kommatrennzeichen. Die Werte der Sammlung werden durch ein Komma getrennt, gefolgt von keinem Leerzeichen.
/ = Schrägstrich-Trennzeichen. Die Werte der Sammlung werden durch einen Schrägstrich getrennt.
- = Bindestrich-Trennzeichen. Die Werte der Sammlung werden durch einen Bindestrich getrennt.
Wenn diese Zeile leer gelassen wird, wird standardmäßig ein Komma gefolgt von einem Leerzeichen zwischen den Werten der Sammlung hinzugefügt.

displayname=Spaltenname
Ersetzen Spaltenname durch den tatsächlichen Namen der neuen Spalte.
listmethod=nested(collection object name).list

Diese Zeile definiert die Sammlung, auf die Sie verweisen.

Ersetzen Sie Sammlungsobjektname durch den Namen des Objekts, auf das Sie in Ihrer Sammlung verweisen, wie er im API-Explorer). Dieser Wert ist normalerweise die Pluralform des Sammlungsobjektnamens.

valuefield=collection object field

Diese Zeile definiert, auf welches Feld Sie vom Sammlungsobjekt verweisen.

Ersetzen Sie Feld des Sammlungsobjekts durch den Namen des Felds des Objekts, auf das Sie in Ihrer Sammlung verweisen, wie es im API-Explorer).

Sie können diese Zeile ersetzen durch:

valueExpression=Feld/Felder des berechneten Sammlungsobjekts

Mit valueExpression können Sie  Zeigt einen berechneten benutzerdefinierten Ausdruck in der Spalte an.

Weitere Informationen zum Formatieren von valueExpression-Zeilen finden Sie unter Übersicht über die Textmodus-Syntax.

Einschränkungen einer Sammlungsansicht limitations-of-a-collection-view

Beachten Sie beim Erstellen einer Sammlungsansicht die folgenden Einschränkungen:

  • Sie können nicht steuern, in welcher Reihenfolge die Sammlungsdaten angezeigt werden.
  • Bedingte Formatierung kann nicht auf eine Sammlungsansicht angewendet werden.
  • Sie können ein Objekt in einer Sammlung nicht zu einem anklickbaren Link machen.
  • Sie können keine Sammlungsansicht einer anderen Sammlung erstellen.
    Beispielsweise können Sie nicht alle Bevollmächtigten für jede Aufgabe in einem Projektbericht anzeigen. Sie können den primären Beauftragten nur für jede Aufgabe in einer Projektansicht anzeigen.

Referenzieren einer Sammlung im Filter eines Berichts reference-a-collection-in-the-filter-of-a-report

Sie können im Filter eines Berichts auf eine Auflistung von Objekten verweisen, um nach den Attributen von Objekten zu filtern, die mit dem Objekt des Berichts verknüpft sind.

Sie können beispielsweise nach Aufgaben- oder Probleminformationen in einem Projektbericht filtern, indem Sie in der Filteranweisung auf die Attribute von Aufgaben oder Problemen des Projekts verweisen.

NOTE
Wenn der Filter auf Felder angewendet wird, die mehrere Werte enthalten (z. B. eine Sammlung von Notizen innerhalb eines Projekts), bestimmt er die Einbeziehung wie folgt:
  • Wenn alle Elemente in einer Sammlung den angegebenen Wert enthalten, wird der gesamte Datensatz aus den Ergebnissen ausgeschlossen.
  • Wenn mindestens ein Element in der Sammlung nicht den angegebenen Wert enthält, bleibt der Datensatz in den Ergebnissen.

So fügen Sie einen Verweis auf eine Sammlung in einem Berichtsfilter hinzu:

  1. Klicken Sie auf das Hauptmenü ( - ) und dann auf Berichte.

  2. Klicken Sie Neuer Bericht.

  3. Wählen Sie das Objekt Ihres Berichts aus.

  4. Navigieren Sie weg von Ihrem Bericht und ermitteln Sie mithilfe des API-Explorers, welche Sammlungen für das Objekt verfügbar sind, das Sie für Ihren Bericht ausgewählt haben.

    Weitere Informationen zum Auswählen des Objekts Ihrer Sammlung finden Sie im Abschnitt Suchen nach Sammlungsobjekten und ihren Feldern im API-Explorer in diesem Artikel.

    Notieren Sie sich den Namen des -Objekts für die Auflistung.

  5. Navigieren Sie mithilfe API-Explorers zur Liste der Felder für das Objekt, das Sie in der Sammlung anzeigen möchten.

    Weitere Informationen zum Suchen der Felder des -Objekts Ihrer Sammlung finden Sie im Abschnitt Suchen nach Sammlungsobjekten und ihren Feldern im API-Explorer in diesem Artikel.

    Notieren Sie sich das Feld, das Sie in der Sammlung anzeigen möchten.

  6. Navigieren Sie zurück zu Ihrem Bericht und klicken Sie auf der Registerkarte Filter auf In Textmodus wechseln und dann Textmodus bearbeiten.

  7. Fügen im Bereich Filterregeln für Ihren Bericht folgenden Code ein:

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

  8. Ersetzen Sie Sammlungsobjektname durch den Namen Ihres Sammlungsobjekts, wie er im API-Explorer). Dieser Wert ist normalerweise die Pluralform des Sammlungsobjektnamens.

  9. Ersetzen Sie Feld des Sammlungsobjekts durch den Namen des Felds Ihres Sammlungsobjekts in , wie er im API-Explorer).

  10. Ersetzen Sie Wert des Sammlungsobjekts durch den Wert des Sammlungsobjekts, wie er in Workfront angezeigt wird.

  11. Ersetzen Sie Wert des Modifikators durch einen gültigen Modifikator.

    Eine Liste der Modifikatoren finden Sie unter Filter- und Bedingungsmodifikatoren.
    Um beispielsweise einen Projektbericht zu erstellen, der nur Projekte mit Aufgaben anzeigt, deren Name „Marketing“ enthält, verwenden Sie den folgenden Code:

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

    Dieser Bericht zeigt nur Projekte an, die mindestens eine Aufgabe mit dem Wort „Marketing“ in ihrem Namen haben.

    Nur Marketing-Aufgaben im Projekt {width="400"}

  12. Verwenden Sie den folgenden Code, um nach dem Namen eines Problems zu filtern:

    code language-none 
    issues:name=Marketing
issues:name_Mod=cicontains
    note tip
    TIP
    Beachten Sie, dass Sie issues für den Namen des Sammlungsobjekts verwenden müssen, anstatt optask zu verwenden, wie Probleme im API-Explorer angezeigt werden.

  13. Klicken Sie Fertig.

  14. (Optional) Fahren Sie mit der Bearbeitung des Berichts fort.

    Oder

    Klicken Sie Speichern + Schließen, um den Bericht zu speichern.

Referenzieren einer Sammlung in der benutzerdefinierten Eingabeaufforderung eines Berichts reference-a-collection-in-the-custom-prompt-of-a-report

Sie können in der benutzerdefinierten Eingabeaufforderung eines Berichts auf eine Auflistung von Objekten verweisen, um die Ergebnisse des Berichts nach den Attributen von Objekten zu filtern, die mit dem Objekt des Berichts verknüpft sind.

Sie können beispielsweise in einem Projektbericht auffordern, Aufgabeninformationen anzugeben, indem Sie in der benutzerdefinierten Eingabeaufforderung des Berichts einen Verweis auf die Attribute von Aufgaben für das Projekt verwenden.

NOTE
Sie können in einer Standardaufforderung nicht auf Sammlungen verweisen.

Eine benutzerdefinierte Eingabeaufforderung ist ein benutzerdefinierter Filter, bei dem die Anweisungen durch kaufmännische Und-Zeichen verbunden werden. Es wird empfohlen, die Anweisung zunächst in einem Filter zu erstellen und dann die Zeilen der Anweisungen mit kaufmännischen Und-Zeichen zu verbinden.

Weitere Informationen zum Erstellen einer Filteranweisung mit einer Sammlungsreferenz finden Sie im Abschnitt Referenzieren einer Sammlung im Filter eines Berichts in diesem Artikel.

So fügen Sie in der benutzerdefinierten Eingabeaufforderung eines Berichts einen Verweis auf eine Sammlung hinzu:

  1. Klicken Sie auf das Hauptmenü ( - ) und dann auf Berichte.

  2. Klicken Sie Neuer Bericht.

  3. Wählen Sie das Objekt Ihres Berichts aus.

  4. Erstellen Sie einen Filter mit einer Sammlungsreferenz, wie im Abschnitt Referenzieren einer Sammlung im Filter eines Berichts in diesem Artikel beschrieben.

  5. Klicken Sie Berichteinstellungen.

  6. Klicken Sie Eingabeaufforderungen melden.

  7. Klicken Sie Eingabeaufforderung hinzufügen.

  8. Klicken Sie Benutzerdefinierte Eingabeaufforderung.

  9. Geben Sie den Namen der Eingabeaufforderung im Feld field ​ name an.

  10. Geben Sie eine Dropdown-Elementbezeichnung an.

  11. Geben Sie Folgendes im Feld Bedingung an:

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

  12. (Optional) Geben Sie an, ob diese Auswahl in der Eingabeaufforderung standardmäßig angezeigt wird.

  13. Ersetzen Sie Sammlungsobjektname durch den Namen Ihres Sammlungsobjekts, wie er im API-Explorer). Dieser Wert ist normalerweise die Pluralform des Sammlungsobjektnamens.

  14. Ersetzen Sie Feld des Sammlungsobjekts durch den Namen des Felds Ihres Sammlungsobjekts, wie es im API-Explorer).

  15. Ersetzen Sie Wert des Sammlungsobjekts durch den Wert des Sammlungsobjekts, wie er in Workfront angezeigt wird.

    Wenn Sie beispielsweise nach Projekten filtern, in denen der Name der Aufgabe „Marketing“ enthält, ersetzen Sie Sammlungsobjektwert durch Marketing.

  16. Ersetzen Sie Wert des Modifikators durch einen gültigen Modifikator.

    Eine Liste der Modifikatoren finden Sie unter Filter- und Bedingungsmodifikatoren.

    Beispiel Um beispielsweise einen Projektbericht mit einer benutzerdefinierten Eingabeaufforderung zu erstellen, in der Sie nur Projekte anzeigen möchten, denen mindestens eine Aufgabe einem bestimmten Benutzer zugewiesen ist, verwenden Sie den folgenden Code:

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

    Dadurch wird ein Bericht generiert, in dem allen aufgelisteten Projekten mindestens eine Aufgabe zugewiesen ist, deren GUID 57cf1b7a000077c9f02f66cb09c8f86c lautet.

    note note
    NOTE
    Sie können nicht auf den Namen des primären Verantwortlichen (Feld „Zugewiesen an„) einer Aufgabe verweisen, wie im API-Explorer angegeben. Sie können nur auf die ID des primären Verantwortlichen verweisen.

    Um beispielsweise nach Projekten zu filtern, bei denen eines der Projektprobleme einem bestimmten Benutzer zugewiesen ist, verwenden Sie den folgenden Code für Ihre benutzerdefinierte Eingabeaufforderung:

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

    Dadurch wird ein Bericht generiert, in dem allen aufgelisteten Projekten mindestens ein Problem dem Benutzer zugewiesen ist, dessen GUID 57cf1b7a000077c9f02f66cb09c8f86c lautet.

    note note
    NOTE
    Beachten Sie, dass Sie Probleme für den Sammlungsobjektnamen verwenden müssen. Der API-Explorer bietet derzeit keinen Sammlungsobjektnamen für Probleme.

  17. Klicken Sie Fertig.

  18. (Optional) Fahren Sie mit der Bearbeitung des Berichts fort.

    Oder

    Klicken Sie Speichern + Schließen, um den Bericht zu speichern.

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