DokumentationWorkfrontWorkfront-Handbuch

Referenzieren von Sammlungen in einem Bericht

Last update: Fri Jun 14 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 Benutzerdefinierten 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

Informationen zum Anfordern von zusätzlichem Zugriff finden Sie unter Zugriff auf Objekte anfordern.

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 Benutzerdefinierten 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 Tabelle "API Explorer"finden Sie in der API-Explorer.

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

  1. Navigieren Sie zu API-Explorer.

  2. Suchen Sie das Objekt Ihres Berichts.

  3. Wählen Sie die Sammlungen Registerkarte.

    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 fields -Registerkarte für das Objekt Ihrer Sammlung.

    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 Main Menü Klicken Sie auf Berichte.

  2. Klicks Neuer Bericht.

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

  4. Navigieren Sie weg von Ihrem Bericht und verwenden Sie die API-Explorerbestimmen, welche Sammlungen für das Objekt verfügbar sind, das Sie für den Bericht ausgewählt haben.

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

  5. Verwenden der API-Explorer, navigieren Sie 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 von 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 im Spalten (Ansicht) Registerkarte, klicken Spalte hinzufügen.

  7. Klicks In den Textmodus wechseln.

  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 Textmodus und entfernen Sie es. 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 mit dem Namen Ihrer Spalte im displayname Linie.

  11. Ersetzen Sammlungsobjektname mit dem Namen Ihres Sammlungsobjekts im listmethod in der API-Explorer.

  12. Ersetzen Sammlungsobjektfeld mit dem Namen des Felds des Kollektionsobjekts im valuefield in der API-Explorer.

    Sie können valueField mit valueExpression, 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 valuefield -Zeile, 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 issues für die listmethod Zeile anstatt opTasks : der Datenbankname für Probleme. Informationen darüber, wann Problem und wann opTask Wenn Sie auf Probleme verweisen, lesen Sie Verwenden Sie "opTask"und "issue", wenn Sie auf Probleme verweisen.

    • Wenn Sie eine Liste der Aufgaben in einem Projektbericht zusammen mit ihrem primären Verantwortlichen anzeigen möchten, verwenden Sie eine valueExpression -Zeile für die Referenzierung der Namen der Aufgaben, die an die Namen ihrer primären Bevollmächtigten angrenzen, anstelle von 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

    Klicks Speichern und 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. Es wird jedoch empfohlen, valueformat für eine Sammlungsliste HTML.
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 iteratebeim Erstellen einer Ansicht.
listdelimiter=<p>

Dies ist das Trennzeichen, mit dem die Werte in Ihrer Liste getrennt werden.
Wir empfehlen, <p> fügt einen Zeilenumbruch zwischen den Werten hinzu.

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. Die Werte der Kollektion werden durch einen Schrägstrich getrennt.
- = Bindestrich. 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 Kollektion hinzugefügt.

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

Diese Zeile definiert die Sammlung, auf die Sie verweisen.

Ersetzen Sammlungsobjektname mit dem Namen des Objekts, auf das Sie in Ihrer Sammlung verweisen, wie er in der API-Explorer. Dieser Wert ist normalerweise die Pluralform des Sammlungsobjektnamen.

valuefield=collection object field

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

Ersetzen  Sammlungsobjektfeld  mit dem Namen des Felds des Objekts, auf das Sie in Ihrer Sammlung verweisen, wie er in der API-Explorer.

Sie können diese Zeile durch Folgendes ersetzen:

valueExpression=berechnetes Sammlungsobjektfeld/-felder

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

Weitere Informationen zum Formatieren valueExpression Zeilen, siehe Übersicht über die Syntax der Textmodi.

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 Main Menü Klicken Sie auf Berichte.

  2. Klicks Neuer Bericht.

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

  4. Navigieren Sie weg von Ihrem Bericht und verwenden Sie die API-Explorerbestimmen, welche Sammlungen für das Objekt verfügbar sind, das Sie für den Bericht ausgewählt haben.

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

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

  5. Verwenden der API-Explorer, navigieren Sie 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 von 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 im Filter Registerkarte, klicken In den Textmodus wechseln.

  7. Im Festlegen von Filterregeln für Ihren Bericht den folgenden Code einfügen:

    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 Sammlungsobjektname mit dem Namen Ihres Sammlungsobjekts, wie er im API-Explorer. Dieser Wert ist normalerweise die Pluralform des Sammlungsobjektnamen.

  9. Ersetzen Sammlungsobjektfeld mit dem Namen des Felds Ihres Sammlungsobjekts in , wie er in der API-Explorer.

  10. Ersetzen Sammlungsobjektwert mit dem Wert des Sammlungsobjekts, wie er in Workfront angezeigt wird.

  11. Ersetzen Wert des Modifikators mit einem gültigen Modifikator.

    Eine Liste der Modifikatoren finden Sie unter Filter- und Bedingungs-Modifikatoren.
    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 issues für den Sammlungsobjektnamen anstelle von optask So werden Probleme im API Explorer angezeigt.

  13. Klicks Fertig.

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

    Oder

    Klicks Speichern und 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 Kollektion im Berichtsfilter in diesem Artikel.

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

  1. Klicken Sie auf Main Menü Klicken Sie auf  Berichte.

  2. Klicks  Neuer Bericht.

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

  4. Erstellen Sie einen Filter mit einem Sammlungsverweis, wie im Abschnitt beschrieben. Referenzieren einer Kollektion im Berichtsfilter in diesem Artikel.

  5. Klicks Berichtseinstellungen.

  6. Klicks Berichtsaufforderungen.

  7. Klicks Eingabeaufforderung hinzufügen.

  8. Klicks Benutzerdefinierte Aufforderung.

  9. Geben Sie den Namen der Aufforderung im  Feldname* -Feld.

  10. Geben Sie eine Dropdown-Elementbeschriftung.

  11. Geben Sie Folgendes in der Bedingung -Feld:

    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  Sammlungsobjektname  mit dem Namen Ihres Sammlungsobjekts, wie er im API-Explorer. Dieser Wert ist normalerweise die Pluralform des Sammlungsobjektnamen.

  14. Ersetzen  Sammlungsobjektfeld  mit dem Namen des Felds des Kollektionsobjekts, wie er im API-Explorer.

  15. Ersetzen  Sammlungsobjektwert  mit dem 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  mit  Marketing.

  16. Ersetzen  Wert des Modifikators  mit einem gültigen Modifikator.

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

    Beispiel: Um beispielsweise einen Projektbericht mit einer benutzerdefinierten Eingabeaufforderung zu erstellen, in der 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
    Sie können den Namen des primären Verantwortlichen ("Zugeordnetes Feld") einer Aufgabe nicht referenzieren, entsprechend dem API-Explorer. 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. Der API Explorer bietet derzeit keinen Sammlungsobjektnamen für Probleme.

  17. Klicks  Fertig.

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

    Oder

    Klicks  Speichern und schließen , um den Bericht zu speichern.

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