DokumentationWorkfrontWorkfront-Handbuch

Referenzieren von Sammlungen in einem Bericht

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

Erstellt für:

  • Benutzende

Wenn Sie einen Bericht in Adobe Workfront erstellen, können Sie eine Reihe von Objekten, Feldern oder verknüpften Objekten in einer Liste, einem Raster oder einem Diagrammformat anzeigen.

Weitere Informationen zum Erstellen eines Berichts in Workfront finden Sie unter Benutzerspezifischen Bericht erstellen.

Zugriffsanforderungen

Erweitern Sie , um die Zugriffsanforderungen für die Funktionalität in diesem Artikel anzuzeigen.

Sie müssen über folgenden Zugriff verfügen, um die Schritte in diesem Artikel ausführen zu können:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront-Plan* Alle
Adobe Workfront-Lizenz* Plan
Konfigurationen auf Zugriffsebene*

Zugriff auf Filter, Ansichten, Gruppierungen bearbeiten

Zugriff auf Berichte, Dashboards und Kalender bearbeiten

Hinweis: Wenn Sie immer noch keinen Zugriff haben, fragen Sie Ihren Workfront-Administrator, ob er zusätzliche Zugriffsbeschränkungen für Ihre Zugriffsebene festlegt. Informationen dazu, wie ein Workfront-Administrator Ihre Zugriffsebene ändern kann, finden Sie unter Benutzerdefinierte Zugriffsebenen erstellen oder ändern.
Objektberechtigungen

Berechtigungen für einen Bericht verwalten

Berechtigungen für Ansichten, Filter oder Gruppierungen verwalten

Weitere Informationen zum Anfordern von zusätzlichem Zugriff finden Sie unter Anfordern des Zugriffs auf Objekte.

Wenden Sie sich an Ihren Workfront-Administrator, um zu erfahren, welchen Plan, welchen Lizenztyp oder welchen Zugriff Sie haben.

Sammlungen

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

Sie haben die folgenden beiden Beziehungen zwischen Objekten in Workfront:

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

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

IMPORTANT
Mithilfe des standardmäßigen ReportBuilder können Sie 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-Oberfläche in ReportBuilder verwenden.

Weitere Informationen zum Erstellen eines Berichts in der standardmäßigen Berichterstellung finden Sie unter Benutzerspezifischen Bericht erstellen.

Weitere Informationen zum Erstellen eines Berichts mithilfe der Textmodus-Oberfläche finden Sie unter:

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

Es können nicht alle Sammlungen in Berichten aufgeführt 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 im API-Explorer.

Um herauszufinden, über welche Sammlungen berichtet werden kann, gehen Sie folgendermaßen vor:

  1. Wechseln Sie zum API-Explorer.

  2. Suchen Sie das Objekt Ihres Berichts.

  3. Wählen Sie die Registerkarte Sammlungen aus.

    note note
    NOTE
    Nur die auf dieser Registerkarte aufgelisteten Objekte können in einem Bericht für das ausgewählte Objekt als Sammlung 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 Registerkarte fields für das Objekt Ihrer Sammlung geöffnet.

    note note
    NOTE
    Nur die auf dieser Registerkarte aufgelisteten Felder können im Erfassungsbericht referenziert werden oder die Felder, die mit den auf dieser Registerkarte aufgelisteten Objekten verknüpft sind.

Referenzsammlungen in Berichten

Sie können in den folgenden Berichterstellungselementen auf Objekte aus einer Sammlung verweisen:

  • Ansichten
  • Filter
  • Prompts

Sie können in den folgenden Berichterstellungselementen nicht auf Objekte aus einer Sammlung verweisen:

  • Gruppierungen
  • Diagramm

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

Referenzieren einer Sammlung in der Berichtansicht reference-a-collection-in-the-view-of-a-report

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

Beispielsweise können Sie in einem Projektbericht Aufgaben- oder Probleminformationen anzeigen, indem Sie eine Kollektionsspalte für Aufgaben oder Probleme in der Berichtansicht erstellen.

Sie können Informationen zu Aufgaben oder Problemen wie Namen, Daten, primäre Zuweisung, prozentuale Abschlüsse usw. in der Sammlungsansicht anzeigen.

Die Ansicht zeigt Aufgaben- oder Probleminformationen in einem Listenformat an, wobei jede Zeile der Liste Informationen über eine Aufgabe oder ein Problem darstellt. Die Liste der Aufgaben oder Probleme und ihre Felder werden in derselben Zeile angezeigt wie das Projekt, zu dem die Aufgaben oder Probleme gehören.
issue_and_tasks_collections_in_reports.png

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

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

  1. Klicken Sie auf das Menü Main und dann auf Berichte.

  2. Klicken Sie auf Neuer Bericht.

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

  4. Navigieren Sie von Ihrem Bericht weg und bestimmen Sie mithilfe des API Explorer, welche Sammlungen für das für Ihren Bericht ausgewählte Objekt verfügbar sind.

    Weitere Informationen zum Auswählen des Objekts Ihrer Sammlung finden Sie im Abschnitt Suchen von Sammlungsobjekten und deren Feldern im API Explorer in diesem Artikel.
    Notieren Sie sich den Namen des Objekts für die Sammlung.

  5. Rufen Sie mit dem API Explorer die Liste der Felder für das Objekt auf, das in der Sammlung angezeigt werden soll.

    Weitere Informationen zum Suchen der Felder des Objekts Ihrer Sammlung finden Sie im Abschnitt Suchen von Sammlungsobjekten und deren 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 auf Wechseln zum Textmodus.

  8. Bewegen Sie den Mauszeiger über das Dialogfeld und klicken Sie auf Klicken, um Text zu bearbeiten.

  9. Wählen Sie den gesamten Text im Dialogfeld Textmodus aus und entfernen Sie ihn. 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 Sie Spaltenname durch den Namen Ihrer Spalte in der Zeile displayname .

  11. Ersetzen Sie den Sammlungsobjektnamen durch den Namen Ihres Sammlungsobjekts in der Zeile listmethod, wie er im API-Explorer angezeigt wird.

  12. Ersetzen Sie das Sammlungsobjektfeld durch den Namen des Felds Ihres Sammlungsobjekts in der Zeile valuefield, wie er im API-Explorer angezeigt wird.

    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.

    Beispiel: Sie möchten eine Liste der Aufgaben in einem Projektbericht anzeigen. Diese Sammlung verwendet eine Zeile valuefield , um auf die Namen der Aufgaben zu verweisen.

    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 Sammlung für die Zeile listmethod issues anstelle von opTasks verwenden müssen, der Datenbankname für Probleme ist. Informationen dazu, wann Problem verwendet werden soll und wann opTask verwendet werden soll, wenn auf Probleme verwiesen wird, finden Sie unter Verwenden von "opTask"und "issue"beim Referenzieren von Problemen.

    • Wenn Sie eine Liste der Aufgaben in einem Projektbericht zusammen mit ihrem primären Verantwortlichen anzeigen möchten, verwenden Sie eine Zeile mit dem Wert valueExpression , um auf die Namen der Aufgaben zu verweisen, die an die Namen ihrer primären Verantwortlichen angrenzen, 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 den einzelnen Projekten zusammen mit ihren primären Verantwortlichen auf:

  14. Klicken Sie auf Speichern.

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

    Oder

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

Machen Sie sich mit den Zeilen einer Sammlungsansicht im Textmodus vertraut

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

Beispielzeile
Beschreibung
valueformat=HTML
Sie können für diese Zeile verschiedene Werte verwenden. Wir empfehlen jedoch, valueformat für eine Sammlungsliste HTML zu verwenden.
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
Die type einer Liste ist immer iterate, wenn eine Ansicht erstellt wird.
listdelimiter=<p>

Dies ist das Trennzeichen, mit dem die Werte in Ihrer Liste getrennt werden.
Wir empfehlen die Verwendung von <p> , wodurch ein Zeilenumbruch zwischen den Werten hinzugefügt wird.

Sie können auch Folgendes verwenden:

‍ (Joiner mit Nullbreite). Die Werte der Kollektion unterscheiden sich nicht zwischen ihnen.
, =Kommatrennzeichen. Die Werte der Kollektion werden durch Kommas getrennt, gefolgt von Leerzeichen.
/ = Schrägstrich-Trennzeichen. Die Werte der Kollektion werden durch einen Schrägstrich getrennt.
- = Bindestrich-Trennzeichen. Die Werte der Kollektion werden durch einen Bindestrich voneinander getrennt.
Wenn Sie diese Zeile leer lassen, wird standardmäßig ein Komma und danach ein Leerzeichen zwischen den Werten der Sammlung hinzugefügt.

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

Diese Zeile definiert die Sammlung, auf die Sie verweisen.

Ersetzen Sie den Namen des Sammlungsobjekts durch den Namen des Objekts, auf das Sie in Ihrer Sammlung verweisen, wie er im API-Explorer angezeigt wird. Dieser Wert ist normalerweise die Pluralform des Sammlungsobjektnamen.

valuefield=collection object field

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

Ersetzen Sie das Sammlungsobjektfeld durch den Namen des Felds des Objekts, auf das Sie in Ihrer Sammlung verweisen, wie er im API-Explorer angezeigt wird.

Sie können diese Zeile durch Folgendes ersetzen:

valueExpression=calculated collection object field/ fields

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

Weitere Informationen zum Formatieren von Zeilen mit Werteausdruck finden Sie unter Übersicht über die Syntax im Textmodus.

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

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

  • Die Reihenfolge, in der die Kollektionsdaten angezeigt werden, lässt sich nicht steuern.
  • Sie können eine Sammlungsansicht nicht mit bedingter Formatierung versehen.
  • Sie können ein Objekt in einer Sammlung nicht zu einem anklickbaren Link machen.
  • Sie können keine Sammlungsansicht einer anderen Sammlung erstellen.
    Sie können beispielsweise nicht alle Bevollmächtigten für jede Aufgabe in einem Projektbericht anzeigen. Sie können den primären Verantwortlichen nur für jede Aufgabe in einer Projektansicht anzeigen.

Referenzieren einer Kollektion im Berichtsfilter reference-a-collection-in-the-filter-of-a-report

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

Beispielsweise können Sie in einem Projektbericht nach Aufgaben- oder Probleminformationen filtern, indem Sie in der Filteranweisung einen Verweis auf die Attribute von Aufgaben oder Problemen im Projekt verwenden.

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

  1. Klicken Sie auf das Menü Main und dann auf Berichte.

  2. Klicken Sie auf Neuer Bericht.

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

  4. Navigieren Sie von Ihrem Bericht weg und bestimmen Sie mithilfe des API Explorer, welche Sammlungen für das für Ihren Bericht ausgewählte Objekt verfügbar sind.

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

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

  5. Rufen Sie mit dem API Explorer die Liste der Felder für das Objekt auf, das in der Sammlung angezeigt werden soll.

    Weitere Informationen zum Suchen der Felder des Objekts Ihrer Sammlung finden Sie im Abschnitt Suchen von Sammlungsobjekten und deren 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 den Textmodus wechseln.

  7. Fügen Sie im Bereich Filterregeln für Ihren Bericht festlegen den 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 den Sammlungsobjektnamen durch den Namen Ihres Sammlungsobjekts, wie er im API-Explorer angezeigt wird. Dieser Wert ist normalerweise die Pluralform des Sammlungsobjektnamen.

  9. Ersetzen Sie das Sammlungsobjektfeld durch den Namen des Felds Ihres Sammlungsobjekts in , wie er im API-Explorer angezeigt wird.

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

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

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

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

    Dieser Bericht zeigt nur Projekte an, deren Name mindestens eine Aufgabe enthält, deren Name das Wort "Marketing"enthält.

  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 für den Namen des Sammlungsobjekts "issues"anstelle von "optask"verwenden müssen, da Probleme im API Explorer angezeigt werden.

  13. Klicken Sie auf Fertig.

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

    Oder

    Klicken Sie auf 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 Sammlung von Objekten verweisen, um die Ergebnisse des Berichts nach den Attributen der Objekte zu filtern, die mit dem Objekt des Berichts verknüpft sind.

Beispielsweise können Sie in einem Projektbericht zur Eingabe von Aufgabeninformationen auffordern, indem Sie in der benutzerdefinierten Eingabeaufforderung des Berichts einen Verweis auf die Attribute der Aufgaben im Projekt verwenden.

NOTE
In einer Standardaufforderung können Sie 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, dass Sie Ihre Anweisung in einem Filter erstellen und dann zunächst die Zeilen der Anweisungen mit Und-Zeichen verbinden.

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

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

  1. Klicken Sie auf das Menü Main und dann auf Berichte.

  2. Klicken Sie auf 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 auf Berichtseinstellungen.

  6. Klicken Sie auf Berichtaufforderungen.

  7. Klicken Sie auf Aufforderung hinzufügen.

  8. Klicken Sie auf Benutzerdefinierte Aufforderung.

  9. Geben Sie den Namen der Eingabeaufforderung im Feld Feldname* an.

  10. Geben Sie eine Bezeichnung für Dropdown-Elemente 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 den Sammlungsobjektnamen durch den Namen Ihres Sammlungsobjekts, wie er im API-Explorer angezeigt wird. Dieser Wert ist normalerweise die Pluralform des Sammlungsobjektnamen.

  14. Ersetzen Sie das Sammlungsobjektfeld durch den Namen des Felds Ihres Sammlungsobjekts, wie er im API-Explorer angezeigt wird.

  15. Ersetzen Sie den 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 den Wert des Kollektionsobjekts durch den Wert marketing .

  16. Ersetzen Sie den 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 dem Sie nur Projekte anzeigen möchten, denen mindestens eine Aufgabe 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 57cf1b7a00077c9f02f66cb09c8f86c lautet.

    note note
    NOTE
    Gemäß dem API Explorer können Sie nicht auf den Namen des primären Verantwortlichen ( Feld "Zugeordnet zu") einer Aufgabe verweisen. Sie können nur auf die ID des primären Verantwortlichen verweisen.

    Um beispielsweise nach Projekten zu filtern, bei denen einem bestimmten Benutzer eines der Projektprobleme 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 zugewiesen ist, dessen GUID 57cf1b7a00077c9f02f66cb09c8f86c lautet.

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

  17. Klicken Sie auf Fertig.

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

    Oder

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

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