Berechnete Felder mit dem Formularentwickler hinzufügen

  Jedes Feld muss die unten beschriebene Syntax verwenden, wobei die einzelnen Feldnamen in geschweifte Klammern gesetzt werden müssen. Wenn Sie mit der Eingabe des Namens eines Felds beginnen, unterbreitet das System Vorschläge und Sie können einen Vorschlag auswählen, um ihn in Ihre Berechnung einzufügen. Wenn Sie Daten in einer Berechnung falsch eingeben, werden Sie durch eine Warnmeldung benachrichtigt. Sie können das Formular nur speichern, wenn Sie die Berechnung so bearbeiten, dass sie gültige Felder und einen gültigen berechneten Ausdruck enthält.

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

  **Feldnamen in der Umgebung mit geschweiften Klammern**

  * Wenn die Berechnung auf ein integriertes Feld verweisen soll, muss der Feldname 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 erscheinen.

    Navigieren Sie zum [Workfront API-Explorer](https://developer.adobe.com/workfront/api-explorer/) , um die Feldnamen zu identifizieren, die in Berechnungen verwendet werden können.

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

    Beispiel: `{DE:Profit}`

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

     * Wenn Sie möchten, dass die Berechnung auf ein Feld verweist, das Daten aus dem *parent* -Objekt, 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 das benutzerdefinierte Formular beispielsweise für Aufgaben konfiguriert ist und Sie möchten, dass das Feld den tatsächlichen Umsatz des übergeordneten Objekts berechnet, wenn das Formular an eine Aufgabe angehängt wird, müssen Sie Folgendes angeben: `Project` als Objekttyp des Felds:

    `{project}.{actualRevenue}`

    Oder, wenn es ein benutzerdefiniertes Feld ist:

    `{project}.{DE:profit}`

    **Separate Elemente mit Zeiträumen**

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

    Wenn Sie beispielsweise in einem benutzerdefinierten Formular vom Typ Aufgabe den Namen des Eigentümers des Portfolios in einem berechneten benutzerdefinierten Feld anzeigen möchten, geben Sie Folgendes ein:

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

    Dadurch wird Folgendes bestimmt: Über das Objekt des benutzerdefinierten Formulars (eine Aufgabe) können Sie auf das nächste Objekt zugreifen, das mit der Aufgabe verbunden ist (ein Projekt). Von dort können Sie auf das nächste verwandte Objekt zum Projekt (ein Portfolio) zugreifen und dann auf die Felder verweisen, die für das Portfolioobjekt definiert sind (der Eigentümer)

    **Namenssyntax für die Referenzierung eines benutzerdefinierten Felds**

    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 typeahead -Feld unterscheidet sich von der für andere Feldtypen, da Sie <code>:name</code> am Ende.</p>
    <p>Um beispielsweise auf die ausgewählte Option in einem benutzerdefinierten Typenvorfeld mit dem Namen &quot;Executive sponsor&quot;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 Objektarten mit mindestens einem Feld kompatibel sein, auf das in den berechneten benutzerdefinierten Feldern des Formulars verwiesen wird. Bei Feldern, die nicht mit dem Objekt kompatibel sind, wird im Formular &quot;K/A&quot;angezeigt.

    Um sicherzustellen, dass das berechnete Feld für alle Objektarten ein korrektes Ergebnis anzeigt, müssen Sie `$$OBJCODE` , 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>In einem Projekt zeigt das Feld &quot;Dies ist ein Projekt&quot;, in einer Aufgabe wird &quot;Dies ist eine Aufgabe&quot; und in einem Problem wird &quot;Dies ist ein Problem&quot; angezeigt.</p>
    </div>
    </div>


    <div class="extension info">
    <div>INFO</div>
    <div>
    <p><strong>Beispiel:</strong> Es gibt zwar kein Feld Zugeordneter Benutzer: Name in Projekten, es gibt jedoch ein integriertes Feld Inhaber (das automatisch mit dem Namen der Person ausgefüllt wird, die das Projekt erstellt hat, es sei denn, dies wird manuell geändert).</p>
    <p>In Ihrem benutzerdefinierten Feld &quot;In Charge&quot;können Sie also <code>$$OBJCODE</code> wie unten gezeigt, um auf das Feld Inhaber zu verweisen, wenn das benutzerdefinierte Formular an ein Projekt angehängt wird, und auf das Feld Zugeordneter 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 finden Sie unter `$$OBJCODE,` see [Übersicht über Wildcard-Filtervariablen](https://experienceleague.adobe.com/docs/workfront/quicksilver/reports-and-dashboards/reports/reporting-elements/understand-wildcard-filter-variables.html?lang=de).

    **Automatische Aktualisierung berechneter benutzerdefinierter Felder**

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

     * Es ändert sich etwas am Objekt, z. B. eine tägliche Timeline-Berechnung.
     * Jemand bearbeitet ein anderes Feld, das durch ein berechnetes benutzerdefiniertes Feld im Objekt referenziert wird.
     * Der berechnete Ausdruck ist leer und das Feld enthält einen Wert. Dadurch wird der Wert auf null gesetzt.

       <div class="extension note">
       <div>NOTE</div>
       <div>
       <div>In einem benutzerdefinierten Formular, das an ein Objekt angehängt ist, werden Datums- und Uhrzeitanweisungen in berechneten benutzerdefinierten Feldern von der koordinierten UTC (Universal Time) berechnet und gespeichert, nicht von den Zeitzonenkonfigurationen, die für die Instanz Ihres Unternehmens und Ihr Benutzerprofil festgelegt sind. Berechnungen in einem benutzerdefinierten Formular werden basierend auf den individuellen Zeitzonen der einzelnen Benutzer generiert.</div>
       </div>
       </div>

  <div class="extension tip">
  <div>TIP</div>
  <div>
  <p>Sie können eine der folgenden Aktionen ausführen, um Hilfe bei der Berechnung zu erhalten:</p>
  <ul>
  <li>Bewegen Sie den Mauszeiger über einen Ausdruck in Ihrer Berechnung, um eine Beschreibung, ein Beispiel, in dem gezeigt wird, wie er verwendet werden kann, und einen Link &quot;Mehr erfahren&quot;zu weiteren Informationen in diesem Artikel anzuzeigen. <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>.<br>
  <img src="assets/hover-expression-help-text.jpg" alt=""></li>
  <li>Verwenden Sie die Farbcodierung, um die hinzugefügten Komponenten zu identifizieren. Die Ausdrücke werden blau und die Felder grün angezeigt.<br>
  <img src="assets/colors-fields-expressions.jpg" alt=""></li>
  <li>Suchen Sie nach Berechnungsfehlern, die bei der Durchführung hervorgehoben sind. Sie können den Mauszeiger über einen hervorgehobenen Fehler bewegen, um eine kurze Beschreibung seiner Ursache anzuzeigen.<br>
  <img src="assets/error-help.png" alt=""></li>
  <li>Zeigen Sie im Bereich unter Ihrer Berechnung eine Vorschau der Ergebnisse an einem vorhandenen Workfront-Objekt 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=""></p>
  <ul>
  <li>Referenzausdrücke in einer langen Berechnung unter Verwendung der auf der linken Seite angezeigten Zeilennummern.</li>
  </ul>
  </div>
  </div>