Ajouter des champs calculés à un formulaire

  Chaque champ doit utiliser la syntaxe expliquée ci-dessous, avec des accolades autour de chaque nom de champ. Lorsque vous commencez à saisir le nom d’un champ, le système fait des suggestions et vous pouvez en sélectionner une pour l’insérer dans votre calcul. Si vous saisissez incorrectement des données dans un calcul, un message d’avertissement vous en informe. Vous ne pouvez pas enregistrer le formulaire à moins de modifier votre calcul pour qu’il contienne des champs valides et une expression calculée valide.

  <div class="extension note">
  <div>NOTE</div>
  <div>
  <p>Actuellement, le système ne fait des suggestions que lorsque vous commencez à saisir le nom d’un champ que vous souhaitez référencer sur un objet auquel le formulaire personnalisé sera joint. Les champs de l’objet parent ne sont pas suggérés.</p>
  </div>
  </div>

  **Noms de champ entouré de accolades**

  * Si vous souhaitez que le calcul référence un champ intégré, le nom du champ doit être entouré de accolades.

    Par exemple : `{actualRevenue}`

    Les noms de champ sont sensibles à la casse et doivent apparaître dans le calcul exactement comme ils apparaissent dans le système Workfront.

    Accédez à l’[ explorateur d’API Workfront](https://developer.adobe.com/workfront/api-explorer/) pour identifier les noms de champ qui peuvent être utilisés dans les calculs.

  * Si vous souhaitez que le calcul référence un champ personnalisé, le nom du champ doit être entouré de accolades et précédé de `DE:` entre les crochets.

    Par exemple : `{DE:Profit}`

    Le système répertorie tous les champs personnalisés que vous pouvez choisir lorsque vous tapez `DE:`.

     * Si vous souhaitez que le calcul référence un champ qui extrait les données de l’objet *parent* lorsque le formulaire personnalisé est joint à un objet, vous devez précéder le nom du champ du type d’objet de l’objet parent, également entre accolades.

    Par exemple, si le formulaire personnalisé est configuré pour fonctionner avec des tâches et que vous souhaitez que le champ calcule le revenu réel de l’objet parent lorsque le formulaire est joint à une tâche, vous devez indiquer `Project` comme type d’objet du champ :

    `{project}.{actualRevenue}`

    Ou, s’il s’agit d’un champ personnalisé :

    `{project}.{DE:profit}`

    **Éléments distincts avec des points**

    Lorsque vous référencez un objet associé dans un champ personnalisé calculé, vous devez séparer les noms et les attributs des objets par des points.

    Par exemple, dans un formulaire personnalisé de type tâche, pour afficher le nom du propriétaire du Portfolio dans un champ personnalisé calculé, vous devez saisir ce qui suit :

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

    Cela détermine ce qui suit : à partir de l’objet du formulaire personnalisé (une tâche), vous pouvez accéder à l’objet suivant associé à la tâche (un projet). De là, vous pouvez accéder à l’objet associé suivant au projet (un portfolio), puis référencer les champs définis pour l’objet de portfolio (le propriétaire).

    **Syntaxe du nom pour référencer un champ personnalisé**

    Lorsque vous référencez un autre champ personnalisé dans un champ personnalisé calculé, vous devez saisir le nom du champ tel qu’il s’affiche dans l’interface utilisateur de Workfront.

    Par exemple, pour référencer l’option sélectionnée dans un champ personnalisé intitulé Responsable de l’exécution, saisissez ce qui suit :

    `{DE:Executive sponsor}`

    <div class="extension note">
    <div>NOTE</div>
    <div>
    <p>La syntaxe d’un champ de type est légèrement différente de celle des autres types de champs, car vous devez ajouter <code>:name</code> à la fin.</p>
    <p>Par exemple, pour référencer l’option sélectionnée dans un champ de type personnalisé nommé &quot;Responsable de l’exécution&quot;, saisissez :</p>
    <p><code>{DE:Executive sponsor:name}</code></p>
    </div>
    </div>


    **Champs personnalisés calculés dans des formulaires personnalisés à plusieurs objets**

    Dans un formulaire personnalisé à plusieurs objets, les types d’objets sélectionnés doivent être compatibles avec au moins un champ référencé dans les champs personnalisés calculés du formulaire. Les champs non compatibles avec l’objet s’affichent sous la forme N/A.

    Pour vous assurer que le champ calculé affiche un résultat correct pour tous les types d’objets, vous devez utiliser `$$OBJCODE` pour définir un calcul pour chaque type d’objet.

    <div class="extension info">
    <div>INFO</div>
    <div>
    <p><strong>Exemple :</strong></p>
    <p>Dans un formulaire personnalisé configuré pour fonctionner avec des projets, des tâches et des problèmes, vous pouvez utiliser la formule suivante pour afficher le type d’objet :</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>Sur un projet, le champ affiche &quot;Ceci est un projet&quot;, sur une tâche, &quot;Ceci est une tâche&quot;, et sur un problème, &quot;Ceci est un problème&quot;.</p>
    </div>
    </div>


    <div class="extension info">
    <div>INFO</div>
    <div>
    <p><strong>Exemple :</strong> Bien qu’il n’existe pas de champ Attribué à : nom dans les projets, il existe un champ Propriétaire intégré (qui renseigne automatiquement le nom de la personne qui a créé le projet, sauf si quelqu’un le modifie manuellement).</p>
    <p>Ainsi, dans votre champ personnalisé En charge , vous pouvez utiliser <code>$$OBJCODE</code> comme illustré ci-dessous pour référencer le champ Propriétaire lorsque le formulaire personnalisé est joint à un projet, et le champ Affecté à : Nom lorsque le formulaire est joint à une tâche :</p>
    <p><code>IF($$OBJCODE=&quot;PROJ&quot;,{owner}.{name},{assignedTo}.{name})</code></p>
    </div>
    </div>

    Pour plus d’informations sur les variables telles que `$$OBJCODE,`, voir [Présentation des variables de filtre générique](https://experienceleague.adobe.com/docs/workfront/quicksilver/reports-and-dashboards/reports/reporting-elements/understand-wildcard-filter-variables.html?lang=fr).

    **Mises à jour automatiques des champs personnalisés calculés**

    Les champs personnalisés calculés sur un objet sont automatiquement recalculés lorsque les événements suivants se produisent :

     * Un élément de l’objet change, tel qu’un calcul quotidien de la chronologie.
     * Quelqu’un modifie un autre champ qui est référencé par un champ personnalisé calculé sur l’objet.
     * L’expression calculée est vide et le champ contient une valeur : elle définit la valeur sur null.

       <div class="extension note">
       <div>NOTE</div>
       <div>
       <div>Dans un formulaire personnalisé joint à un objet, les instructions de date et d’heure dans les champs personnalisés calculés sont traitées et enregistrées en fonction du temps universel coordonné (UTC), et non en fonction des configurations de fuseau horaire définies pour l’instance de votre entreprise et votre profil d’utilisateur ou d’utilisatrice. Les calculs dans un formulaire personnalisé sont générés en fonction des fuseaux horaires individuels de chaque utilisateur.</div>
       </div>
       </div>

  <div class="extension tip">
  <div>TIP</div>
  <div>
  <p>Vous pouvez effectuer l’une des opérations suivantes pour obtenir de l’aide sur votre calcul :</p>
  <ul>
  <li>Passez la souris sur une expression de votre calcul pour afficher une description, un exemple montrant comment l’utiliser et un lien &quot;En savoir plus&quot; pour plus d’informations dans l’article <a href="https://experienceleague.adobe.com/docs/workfront/quicksilver/reports-and-dashboards/reports/calc-cstm-data-reports/calculated-data-expressions.html?lang=fr">Présentation des expressions de données calculées</a>.<br>
  <img src="assets/hover-expression-help-text.jpg" alt=""></li>
  <li>Utilisez le codage colorimétrique pour identifier les composants que vous avez ajoutés. Les expressions s’affichent en bleu et les champs en vert.<br>
  <img src="assets/colors-fields-expressions.jpg" alt=""></li>
  <li>Recherchez les erreurs de calcul, surlignées en rose, au fur et à mesure. Vous pouvez pointer sur une erreur mise en surbrillance pour afficher une brève description de sa cause.<br>
  <img src="assets/error-help.png" alt=""></li>
  <li>Dans la zone située sous votre calcul, prévisualisez les résultats sur un objet Workfront existant.</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>Expressions de référence dans un calcul long à l’aide des numéros de ligne qui s’affichent sur la gauche.</li>
  </ul>
  </div>
  </div>