Ajouter des champs calculés à un formulaire

Nouveau : Standard

ou

Actuel : formule

  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 encadrés par des accolades**

  * Si vous souhaitez que le calcul référence un champ intégré, le nom du champ doit être entouré d’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é d’accolades et précédé de `DE:` entre les accolades.

    Par exemple : `{DE:Profit}`

    Le système répertorie tous les champs personnalisés que vous pouvez choisir lorsque vous saisissez `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 associé à un objet, vous devez précéder le nom du champ du type 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}`

    **Séparer des éléments par 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 (la personne 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 d’utilisation 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 saisie anticipée 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 Typeahead personnalisé nommé « Responsable de l’exécution », 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’objet 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é présente 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 « Ceci est un projet », sur une tâche « Ceci est une tâche » et sur un problème « Ceci est un problème ».</p>
    </div>
    </div>


    <div class="extension info">
    <div>INFO</div>
    <div>
    <p><strong>Exemple :</strong> bien qu’il n’existe pas de champ « Affecté à : 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 modifie manuellement ce champ).</p>
    <p>Ainsi, dans votre champ personnalisé « En charge », vous pouvez utiliser <code>$$OBJCODE</code> comme illustré ci-dessous pour faire référence au champ « Propriétaire » lorsque le formulaire personnalisé est joint à un projet, et au 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 [Vue d’ensemble des variables de filtre de caractères génériques](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 chronologie.
     * Une personne 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 organisation 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 personne.</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>Pointez sur une expression de votre calcul pour afficher une description, un exemple illustrant son utilisation et un lien « En savoir plus » 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">Vue d’ensemble des expressions de données calculées</a>.<br>
  <img src="assets/hover-expression-help-text.jpg" alt=""></li>
  <li>Utilisez les codes de couleurs 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>Référencez des expressions dans un calcul long à l’aide des numéros de ligne s’affichant sur la gauche.</li>
  </ul>
  </div>
  </div>