DokumentationWorkfrontWorkfront-Handbuch

Übersicht über die Syntax der Textmodi

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

Erstellt für:

  • Benutzende

Sie können die Textmodus-Oberfläche verwenden, um komplexere Ansichten, Filter, Gruppierungen und benutzerdefinierte Eingabeaufforderungen in Listen und Berichten zu erstellen. Mithilfe des Textmodus können Sie auf Felder und deren Attribute zugreifen, die in der Benutzeroberfläche des Standardmodus nicht verfügbar sind.

Informationen und Überlegungen zum Textmodus vor dem Start finden Sie unter Textmodus - Übersicht.

Eine vollständige Liste aller in Berichten enthaltenen Felder und deren Attribute finden Sie im API-Explorer.

Weitere Informationen zum Erstellen von Berichten im Textmodus, einschließlich Klassen, Videos und Tutorials, finden Sie im Abschnitt "Lernen"auf der Adobe Experience League-Site.

Überlegungen zur Syntax des Textmodus

  • Sie müssen die Adobe Workfront-Syntax verstehen, bevor Sie mit der Erstellung von Berichterstellungselementen im Textmodus beginnen können. Die Workfront-Syntax für den Textmodus ist für diese Anwendung eindeutig und weist eindeutige Merkmale auf, mit denen Sie vertraut sein müssen.
  • Bevor Sie mit der Verwendung des Textmodus in Ihren Berichten beginnen, empfehlen wir dringend, unsere Klassen für erweiterte Berichte zu verwenden, um ein tieferes Verständnis unserer Textmodussprache zu erhalten.
  • Sie können Ansichten, Filter und Gruppierungen mithilfe der Benutzeroberfläche des Standardmodus anpassen. Sie können jedoch nur im Textmodus benutzerdefinierte Eingabeaufforderungen erstellen.

Allgemeine Richtlinien zum Erstellen von Berichterstellungselementen im Textmodus

Die folgenden allgemeinen Richtlinien gelten beim Erstellen von Berichterstellungs- oder Listenelementen im Textmodus:

  • Verwenden Sie beim Referenzieren von Objekten oder Attributen in der Workfront-Datenbank immer die Binnenmajuskel-Schreibweise.

  • Beachten Sie die Hierarchie der Objekte in Workfront. Die folgenden Unterschiede bestehen zwischen Ansichten, Filtern und Gruppierungen:

    • Sie können ein Objekt anzeigen, das sich in einer Ansicht aus drei Objekten außerhalb des Berichts oder Listenobjekts befindet.
    • Sie können in einer Gruppierungs-, Filter- oder benutzerdefinierten Eingabeaufforderung nicht auf Objekte verweisen, die mehr als zwei Objekte vom Hauptobjekt entfernt sind.

    Beispiel: Sie können den Namen oder die GUID des Portfolio-Eigentümers in einer Aufgabenansicht anzeigen:

    valuefield=project:portfolio:ownerID

    Sie können in einer Aufgabenansicht keine Portfolio Owner gruppieren, filtern oder auffordern:

    project:portfolio:ownerID=5808f4bc00790b270a9629dd128e63fa

    In diesen Beispielen befindet sich die Portfolio Owner ID drei Objekte vom Listenobjekt entfernt.

    Informationen zur Hierarchie von Objekten in Workfront finden Sie unter:

  • Verwenden Sie nach Möglichkeit Platzhalter, um Ihre Berichte und Listen dynamischer zu gestalten und zu vermeiden, dass sie für verschiedene Benutzer und ähnliche Zeitpläne dupliziert werden.

Überblick über Fälle in Camel

Beim Referenzieren von Workfront-Feldern oder ihren Attributen im Textmodus müssen Sie in Workfront deren Namen in Binnenmajuskel-Schreibweise eingeben. In diesem Fall werden die Felder mit einem Namen in Kleinbuchstaben geschrieben. Zusammengesetzte Felder werden nach folgendem Muster geschrieben:

camelCaseSyntax

IMPORTANT
Alle Berichterstellungselemente folgen diesem Groß-/Kleinschreibung.

Die Eigenschaften des Kamelschachtes sind:

  • Das erste Wort beginnt immer mit einem Kleinbuchstaben.
  • Die folgenden Wörter beginnen immer mit einem Großbuchstaben.
  • Zwischen den Wörtern gibt es keine Leerzeichen.

Beispiel: Um auf das tatsächliche Abschlussdatum eines Projekts zu verweisen, lautet der Name des Felds, das Sie beim Erstellen von Berichterstellungselementen im Textmodus verwenden würden

actualCompletionDate

Textmodussyntax für verschiedene Berichterstellungselemente

Die folgenden Syntaxsätze der unten aufgeführten Berichterstellungselemente weisen bei ihrer Erstellung im Textmodus Ähnlichkeiten auf:

Syntax für Ansichten und Gruppierungen

Die Codezeilen beim Erstellen von Ansichten und Gruppierungen sind ähnlich.

Informationen zum Erstellen von Ansichten und Gruppierungen finden Sie in den folgenden Artikeln:

Die wichtigste Codezeile für eine Ansicht oder Gruppierung ist die Zeile, die das in der Ansichtsspalte oder in der Gruppierung referenzierte Objekt angibt. Diese Codezeile kann mit valuefield oder valueexpression beginnen, je nachdem, ob dieses Feld eine direkte Referenz auf ein Workfront-Datenbankfeld oder eine Berechnung zwischen mehreren Feldern ist.

In der folgenden Tabelle sind die gängigsten Codezeilen in einer Ansicht oder Gruppierung aufgeführt:

Codezeile
Beschreibung
valuefield
Identifiziert das in der Ansichtsspalte oder Gruppierung referenzierte Objekt. Dies ist ein direkter Verweis auf das referenzierte Objekt.
valueexpression
Identifiziert das in der Ansichtsspalte oder Gruppierung referenzierte Objekt. Dies ist eine Berechnung zwischen mehreren Feldern.
valueformat
Gibt das Format an, in dem Workfront den Wert zurückgibt, der in den Ausdruckszeilen "value"oder "value"angegeben ist.
width
Gibt die Breite einer Spalte in Pixel an.
stretch
Gibt an, welche Spalten zusätzlichen Speicherplatz belegen, der für die Ansicht nicht benötigt wird.
TIP

  • Obwohl die Codezeilen in den Beispielen unten zwischen Ansichten und Gruppierungen ähnlich sind, sollten Sie immer daran denken, dass jede Codezeile für eine Gruppierung mit der Gruppierungsnummer beginnt.

    Um in einer Projektliste oder einem Bericht nach Projektname zu gruppieren, verwenden Sie die folgende Zeile für die Gruppierung der ersten Ebene:

    group.0.valuefield=name

  • Wenn Sie mehrere Spalten in einer Ansicht in derselben Spalte bearbeiten (wie es bei gemeinsamen Spalten der Fall ist), beachten Sie, dass jede Codezeile für jede Spalte mit der Spaltennummer beginnt.

    Verwenden Sie das folgende Format, um die erste Spalte einer Ansicht zu identifizieren:

    column.0.valuefield=name

    Informationen zum Freigeben von Spalten finden Sie unter Anzeigen: Zusammenführen von Informationen aus mehreren Spalten in einer gemeinsamen Spalte.

Valuefield Syntaxübersicht für Ansichten und Gruppierungen

Valuefield= ist eine Schlüsselzeile des Codes in Ansichten und Gruppierungen, die das Objekt identifiziert, auf das Sie direkt verweisen.

Die Syntax für direkt referenzierende Felder ist für Gruppierungen und Ansichten identisch.

Die folgenden Regeln gelten beim Referenzieren von Workfront-Objekten mit einer Zeile valuefield :

  • Verwenden Sie die Binnenmajuskel-Groß-/Kleinschreibung, um direkt auf Felder zu verweisen.

    Beispiel: Verwenden Sie die folgende Zeile, um auf das tatsächliche Abschlussdatum der Aufgabe in einer Aufgabenansicht zu verweisen:

    valuefield=actualCompletionDate

  • Verwenden Sie die Groß-/Kleinschreibung und Doppelpunkte, um Felder zu trennen, die für dasselbe Objekt miteinander in Beziehung stehen.

    Beispiel: Verwenden Sie die folgende Zeile, um auf das geplante Abschlussdatum des Projekts in einer Aufgabenansicht zu verweisen:

    valuefield=project:plannedCompletionDate

    Informationen dazu, wie Objekte in der Workfront-Datenbank aufeinander verweisen, finden Sie im API-Explorer.

  • Verwenden Sie beim Referenzieren eines benutzerdefinierten Felds den Namen des Felds genau so, wie er in der Benutzeroberfläche angezeigt wird.

    Beispiel: Verwenden Sie die folgende Zeile, um auf ein benutzerdefiniertes Projekt mit der Bezeichnung Zusätzliche Details in einer Aufgabenansicht zu verweisen:

    valuefield=project:Additional Details

Valueexpression Syntaxübersicht für Ansichten und Gruppierungen

Sie können die Codezeile valuefield= durch valueexpression= ersetzen, wenn Sie Ansichten und Gruppierungen im Textmodus erstellen und eine Berechnung zwischen zwei oder mehr Feldern referenzieren möchten.

TIP
Sie können berechnete Felder erstellen, die in Berichten angezeigt werden können. Berechnete Ansichten und Gruppierungen sind jedoch dynamischer. Berechnete Ansichten und Gruppierungen werden jedes Mal, wenn Sie den Bericht ausführen oder eine Liste anzeigen, mit neuen Informationen aktualisiert.
Informationen zum Erstellen berechneter Spalten in einer Ansicht finden Sie unter Berechnete benutzerdefinierte Felder vs. berechnete Spalten.

Das Erstellen einer berechneten Gruppierung ähnelt dem Erstellen einer berechneten Spalte in einer Ansicht.

Die folgenden Regeln gelten beim Referenzieren von Workfront-Objekten mit einer Zeile valueexpression :

  • Verwenden Sie die Binnenmajuskel-Schreibweise, um direkt auf Felder zu verweisen und jedes Feld in geschweifte Klammern einzuschließen.

    Beispiel: Verwenden Sie die folgende Zeile, um das Feld "Task Name"in einer Aufgabenspalte mit valueexpression anzuzeigen:

    valueexpression={name}

  • Verwenden Sie Kamelgehäuse und Punkte, um miteinander verknüpfte Felder voneinander zu trennen.

    Beispiel: Verwenden Sie die folgenden Zeilen, um den Namen eines mit dem Namen der Aufgabe verketteten Projekts in einem Aufgabenbericht anzuzeigen:

    • In einer Ansicht:

      valueexpression=CONCAT({project}.{name},' - ',{name})

    • Gruppierung:

      group.0.valueexpression=CONCAT({project}.{name},' - ',{name})

    Informationen dazu, wie Objekte in der Workfront-Datenbank aufeinander verweisen, finden Sie im API-Explorer.

  • Verwenden Sie beim Referenzieren eines benutzerdefinierten Felds die folgenden Regeln:

    • Verwenden Sie den Namen des Felds genau so, wie er in der Benutzeroberfläche angezeigt wird.
    • Stellen Sie dem Namen des Felds "DE:"voran.
    • Schließen Sie das Feld in geschweifte Klammern ein.
    • Trennen Sie die mit dem Objekt verknüpften Felder durch Punkte.

    Beispiel: Verwenden Sie die folgende Zeile, um das benutzerdefinierte Feld "Zusätzliches Detailprojekt"in einer Aufgabenansicht in einer Ausdruckszeile für Werte anzuzeigen:

    valueexpression={project}.{DE:Additional Details}

  • Sie können einen Platzhalter in einer valueexpression-Zeile, aber nicht in einer valuefield-Zeile verwenden.

    Informationen zu Platzhaltern finden Sie unter Übersicht über Wildcard-Filtervariablen.

Valueformat Übersicht über Ansichten und Gruppierungen

Die zweitwichtigste Codezeile in einer Ansicht oder Gruppierung ist die Zeile valueformat=. Dadurch wird Workfront mitgeteilt, in welchem Format der in den Zeilen valuefield oder valueexpression angegebene Wert zurückgegeben werden soll. Obwohl Sie für die valueformat -Zeilen verschiedene Formate verwenden können, sollten Sie bei Verwendung von valueexpression immer den folgenden Wert verwenden:

valueformat=HTML

Weitere valueformat -Werte finden Sie in den folgenden Artikeln:

width Übersicht für Ansichten

width= ist die Codezeile, in der Sie die Breite jeder Spalte in Pixel angeben können. Workfront bietet für jedes Feld eine empfohlene Breite. Je nach Feldtyp und -format können Sie jedoch Anpassungen vornehmen.

Sie müssen die zusätzliche Codezeile usewidths=true verwenden, um die für die Spalte angegebene Breite zu erzwingen.

Beispiel: Verwenden Sie die folgenden Zeilen, um eine Spalte mit einer Breite von 80 Pixel anzuzeigen:

width=80

usewidths=true

stretch Übersicht für Ansichten

Mit dem stretch wird ermittelt, welche Spalten zusätzlichen Platz belegen, der für die Ansicht nicht benötigt wird. Die Breite der Benutzeroberfläche des Arbeitsbereichs für einen typischen Benutzer beträgt etwa 850 Pixel. Das bedeutet, dass Ihre Ansicht bei einer Ansicht mit vier Spalten (jeweils 150 Pixel) 600 von 850 Pixel umfasst. Die Benutzeroberfläche enthält 250 zusätzliche Pixel, die zu den Spalten hinzugefügt werden, für die ein gestreckter Prozentsatz bereitgestellt wird.

Der Abschnitt einer Spalte wird erzwungen, wenn Sie die zusätzliche Codezeile verwenden: usewidths=true für mindestens eine der Spalten in der Ansicht.

Beispiel: Verwenden Sie die folgenden Zeilen, um anzugeben, dass eine Spalte 70 % des leeren Bereichs in einer Ansicht verwenden kann:

stretch=70

usewidths=true

Syntax für Filter und benutzerdefinierte Eingabeaufforderungen

Die Syntax zum Erstellen von Filtern ähnelt der zum Erstellen von benutzerdefinierten Aufforderungen.

TIP
Sie können eine benutzerdefinierte Eingabeaufforderung erstellen, indem Sie zunächst einen Filter für die Anweisung erstellen, die Sie in die Eingabeaufforderung aufnehmen möchten. Verbinden Sie alle Codezeilen in einem Filter mit "&"ohne Leerzeichen zwischen den Zeilen und der benutzerdefinierten Eingabeaufforderung.

Informationen zum Erstellen von Filtern und benutzerdefinierten Eingabeaufforderungen finden Sie unter:

Informationen zum Erstellen von Filtern im Textmodus finden Sie unter Bearbeiten eines Filters mit dem Textmodus.

Sie können die folgenden Elemente verwenden, um Filter und benutzerdefinierte Eingabeaufforderungen im Textmodus zu erstellen:

  • Eine Codezeile, die auf das Objekt der Filteranweisung verweist. Verwenden Sie die Binnenmajuskel-Schreibweise für das Filterobjekt.

  • Eine Codezeile, die auf das Filterobjekt und den Modifikator für den Wert des Filterobjekts verweist. Verwenden Sie für das Filterobjekt in dieser Zeile die Binnenmajuskel-Schreibweise.

    note tip
    TIP
    Beim Referenzieren von Bereichen sind dafür 2 Modifikatorlinien erforderlich.

  • Ein Statement-Connector, der mehrere Filteranweisungen verbindet:

    • UND

      Dies ist der Standard-Connector zwischen Filteranweisungen.

    • ODER

      note tip
      TIP
      Bei Anweisungs-Connectoren wird zwischen Groß- und Kleinschreibung unterschieden. "AND"kann im Textmodus weggelassen werden.

  • Platzhalter, um Filter dynamischer zu gestalten und für die aktuelle Zeit oder den angemeldeten Benutzer anzupassen. Informationen zu Platzhaltern finden Sie unter Übersicht über Wildcard-Filtervariablen.

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