Hinzufügen berechneter Felder zu einem Formular

  Jedes Feld muss die unten beschriebene Syntax verwenden, wobei die einzelnen Feldnamen in geschweiften Klammern stehen müssen. Wenn Sie mit der Eingabe eines Feldnamens beginnen, macht das System Vorschläge, und Sie können einen auswählen, um ihn in Ihre Berechnung einzufügen. Wenn Sie Daten in eine Berechnung falsch eingeben, werden Sie durch eine Warnmeldung informiert. Das Formular kann erst gespeichert werden, wenn die Berechnung so bearbeitet wurde, dass sie gültige Felder und einen gültigen berechneten Ausdruck enthält.

  <div class="extension note">
  <div>NOTE</div>
  <div>
  <p>Derzeit macht das System Vorschläge nur, wenn Sie mit der Eingabe des Namens eines Felds beginnen, auf das Sie verweisen möchten, und zwar für ein Objekt, an das das benutzerdefinierte Formular angehängt wird. Felder aus dem übergeordneten Objekt werden nicht empfohlen.</p>
  </div>
  </div>

  **Umschließen von Feldnamen mit geschweiften Klammern**

  * Wenn die Berechnung auf ein integriertes Feld verweisen soll, muss der Name des Felds von geschweiften Klammern umgeben sein.

    Beispiel: `{actualRevenue}`

    Bei Feldnamen wird zwischen Groß- und Kleinschreibung unterschieden und sie müssen in der Berechnung genau so angezeigt werden, wie sie im Workfront-System angezeigt werden.

    Navigieren Sie zum [Workfront-API-](https://developer.adobe.com/workfront/api-explorer/), um die Feldnamen zu identifizieren, die Sie für Berechnungen verwenden können.

  * Wenn die Berechnung auf ein benutzerdefiniertes Feld verweisen soll, muss der Name des Felds von geschweiften Klammern umgeben sein und vor den `DE:` in den Klammern stehen.

    Beispiel: `{DE:Profit}`

    Das System listet alle benutzerdefinierten Felder auf, aus denen Sie bei der Eingabe von `DE:` auswählen können.

     * Wenn die Berechnung auf ein Feld verweisen soll, das Daten aus dem *übergeordneten* Objekt abruft, wenn das benutzerdefinierte Formular an ein Objekt angehängt wird, müssen Sie dem Feldnamen den Objekttyp des übergeordneten Objekts voranstellen, auch in geschweiften Klammern.

    Wenn beispielsweise das benutzerdefinierte Formular für die Verwendung mit Aufgaben konfiguriert ist und Sie möchten, dass das Feld den tatsächlichen Umsatz des übergeordneten Objekts berechnet, wenn das Formular mit einer Aufgabe verknüpft ist, müssen Sie `Project` als Objekttyp des Felds angeben:

    `{project}.{actualRevenue}`

    Oder, wenn es ein benutzerdefiniertes Feld ist:

    `{project}.{DE:profit}`

    **Elemente durch Punkte trennen**

    Wenn Sie in einem berechneten benutzerdefinierten Feld auf ein verwandtes Objekt verweisen, müssen Sie Objektnamen und Attribute durch Punkte trennen.

    Um beispielsweise in einem benutzerdefinierten Formular vom Typ Aufgabe den Namen des Feldinhabers in einem berechneten benutzerdefinierten Portfolio anzuzeigen, geben Sie Folgendes ein:

    `{project}.{porfolio}.{owner}`

    Dadurch würde Folgendes bestimmt: Über das Objekt des benutzerdefinierten Formulars (eine Aufgabe) können Sie auf das nächste Objekt zugreifen, das mit der Aufgabe verknüpft ist (ein Projekt). Dort können Sie auf das nächste mit dem Projekt verknüpfte Objekt (ein Portfolio) zugreifen und dann auf die Felder verweisen, die für das Portfolioobjekt (den Eigentümer) definiert sind

    **Namenssyntax für den Verweis auf ein benutzerdefiniertes Feld**

    Wenn Sie in einem berechneten benutzerdefinierten Feld auf ein anderes benutzerdefiniertes Feld verweisen, müssen Sie den Feldnamen so eingeben, wie er in der Benutzeroberfläche von Workfront angezeigt wird.

    Um beispielsweise auf die ausgewählte Option in einem benutzerdefinierten Feld mit der Bezeichnung „Executive Sponsor“ zu verweisen, geben Sie Folgendes ein:

    `{DE:Executive sponsor}`

    <div class="extension note">
    <div>NOTE</div>
    <div>
    <p>Die Syntax für ein Feld mit automatischer Textvervollständigung unterscheidet sich etwas von der für andere Feldtypen, da Sie am Ende <code>:name</code> hinzufügen müssen.</p>
    <p>Um beispielsweise auf die ausgewählte Option in einem benutzerdefinierten Feld mit automatischer Textvervollständigung mit dem Namen „Executive Sponsor“ zu verweisen, geben Sie Folgendes ein:</p>
    <p><code>{DE:Executive sponsor:name}</code></p>
    </div>
    </div>


    **Berechnete benutzerdefinierte Felder in benutzerdefinierten Formularen mit mehreren Objekten**

    In einem benutzerdefinierten Formular mit mehreren Objekten müssen die ausgewählten Objekttypen mit mindestens einem Feld kompatibel sein, auf das in den berechneten benutzerdefinierten Feldern des Formulars verwiesen wird. Felder, die nicht mit dem Objekt kompatibel sind, werden im Formular nicht angezeigt.

    Um sicherzustellen, dass das berechnete Feld ein korrektes Ergebnis für alle Objekttypen anzeigt, müssen Sie `$$OBJCODE` verwenden, um eine Berechnung für jeden Objekttyp zu definieren.

    <div class="extension info">
    <div>INFO</div>
    <div>
    <p><strong>Beispiel:</strong></p>
    <p>In einem benutzerdefinierten Formular, das für die Arbeit mit Projekten, Aufgaben und Problemen konfiguriert wurde, können Sie die folgende Formel verwenden, um den Objekttyp anzuzeigen:</p>
    <p><code>IF($$OBJCODE=&quot;PROJ&quot;,&quot;This is a project&quot;,IF($$OBJCODE=&quot;TASK&quot;,&quot;This is a task&quot;,&quot;This is an issue&quot;))</code></p>
    <p>Bei einem Projekt wird im Feld „Dies ist ein Projekt“ angezeigt, bei einer Aufgabe „Dies ist eine Aufgabe“ und bei einem Problem „Dies ist ein Problem“.</p>
    </div>
    </div>


    <div class="extension info">
    <div>INFO</div>
    <div>
    <p><strong>Beispiel:</strong> Obwohl es in Projekten kein Feld Zugewiesen an: Name gibt, gibt es ein integriertes Besitzerfeld (das automatisch mit dem Namen der Person ausgefüllt wird, die das Projekt erstellt hat, es sei denn, diese Person ändert dies manuell).</p>
    <p>In Ihrem benutzerdefinierten Feld „Verantwortlicher“ können Sie daher <code>$$OBJCODE</code> wie unten dargestellt verwenden, um auf das Feld „Verantwortlicher“ zu verweisen, wenn das benutzerdefinierte Formular an ein Projekt angehängt wird, und auf das Feld „Zugewiesen an: Name“, wenn das Formular an eine Aufgabe angehängt wird:</p>
    <p><code>IF($$OBJCODE=&quot;PROJ&quot;,{owner}.{name},{assignedTo}.{name})</code></p>
    </div>
    </div>

    Weitere Informationen zu Variablen wie `$$OBJCODE,` finden Sie unter [Übersicht über Platzhalterfiltervariablen](https://experienceleague.adobe.com/docs/workfront/quicksilver/reports-and-dashboards/reports/reporting-elements/understand-wildcard-filter-variables.html?lang=de).

    **Automatische Aktualisierungen berechneter benutzerdefinierter Felder**

    Berechnete benutzerdefinierte Felder eines Objekts werden automatisch neu berechnet, wenn Folgendes passiert:

     * Etwas im Objekt ändert sich, z. B. eine tägliche Zeitleistenberechnung.
     * Jemand bearbeitet ein anderes Feld, auf das ein berechnetes benutzerdefiniertes Feld im -Objekt verweist.
     * Der berechnete Ausdruck ist leer und das Feld enthält einen Wert. Dadurch wird der Wert auf null festgelegt.

       <div class="extension note">
       <div>NOTE</div>
       <div>
       <div>In einem benutzerdefinierten Formular, das an ein Objekt angehängt ist, werden Datums- und Zeitangaben in berechneten benutzerdefinierten Feldern durch die koordinierte Weltzeit (UTC) berechnet und gespeichert, nicht durch die Zeitzonenkonfigurationen, die für die Instanz Ihres Unternehmens und Ihr Benutzerprofil festgelegt sind. Berechnungen in einem benutzerdefinierten Formular, die auf der Grundlage der individuellen Zeitzonen der einzelnen Benutzenden erstellt werden.</div>
       </div>
       </div>

  <div class="extension tip">
  <div>TIP</div>
  <div>
  <p>Sie können einen der folgenden Schritte ausführen, um Hilfe bei Ihrer Berechnung zu erhalten:</p>
  <ul>
  <li>Bewegen Sie den Mauszeiger über einen Ausdruck in Ihrer Berechnung, um eine Beschreibung, ein Beispiel, das zeigt, wie er verwendet werden kann, und einen Link „Weitere Informationen“ zu weiteren Informationen im Artikel <a href="https://experienceleague.adobe.com/docs/workfront/quicksilver/reports-and-dashboards/reports/calc-cstm-data-reports/calculated-data-expressions.html?lang=de">Übersicht über berechnete Datenausdrücke</a> anzuzeigen.<br>
  <img src="assets/hover-expression-help-text.jpg" alt="Hilfetext für Ausdruck"></li>
  <li>Verwenden Sie die Farbcodierung, um die hinzugefügten Komponenten zu identifizieren. Ausdrücke werden in blauen und Felder in grün angezeigt.<br>
  <img src="assets/colors-fields-expressions.jpg" alt="Farben für Feldausdrücke"></li>
  <li>Suchen Sie nach Berechnungsfehlern, die Sie fortlaufend in Rosa markieren. Sie können den Mauszeiger über einen markierten Fehler bewegen, um eine kurze Beschreibung der Ursache anzuzeigen.<br>
  <img src="assets/error-help.png" alt="Hilfe zu Fehlern"></li>
  <li>Zeigen Sie im Bereich unterhalb Ihrer Berechnung die Ergebnisse eines vorhandenen Workfront-Objekts an.</li>
  </ul>
  <!--or by providing test values (NOT READY YET; CHANGE THIS SCREENSHOT WHEN IT IS)-->
  <p><img src="assets/preview-calc.jpg" alt="Vorschau der Berechnung"></p>
  <ul>
  <li>Referenzausdrücke in einer langen Berechnung unter Verwendung der Zeilennummern, die links angezeigt werden.</li>
  </ul>
  </div>
  </div>