Aggiungere campi calcolati con il progettista del modulo

  Ogni campo deve utilizzare la sintassi illustrata di seguito, con parentesi graffe intorno al nome di ogni campo. Quando si inizia a digitare il nome di un campo, il sistema formula dei suggerimenti ed è possibile selezionarne uno per inserirlo nel calcolo. Se si immettono dati in un calcolo in modo errato, viene visualizzato un messaggio di avviso. Non è possibile salvare il modulo a meno che non si modifichi il calcolo in modo che contenga campi validi e un'espressione calcolata valida.

  <div class="extension note">
  <div>NOTE</div>
  <div>
  <p>Attualmente, il sistema formula suggerimenti solo quando si inizia a digitare il nome di un campo a cui si desidera fare riferimento in un oggetto a cui verrà allegato il modulo personalizzato. I campi dell&#39;oggetto padre non sono consigliati.</p>
  </div>
  </div>

  **Racchiudi nomi campi con parentesi graffe**

  * Se si desidera che il calcolo faccia riferimento a un campo incorporato, il nome del campo deve essere racchiuso tra parentesi graffe.

    Ad esempio: `{actualRevenue}`

    I nomi dei campi fanno distinzione tra maiuscole e minuscole e devono essere visualizzati nel calcolo esattamente come appaiono nel sistema Workfront.

    Accedi a [Esplora API di Workfront](https://developer.adobe.com/workfront/api-explorer/) per identificare i nomi dei campi che possono essere utilizzati nei calcoli.

  * Se si desidera che il calcolo faccia riferimento a un campo personalizzato, il nome del campo deve essere racchiuso tra parentesi graffe e preceduto da `DE:` tra parentesi.

    Ad esempio: `{DE:Profit}`

    Il sistema elenca tutti i campi personalizzati tra cui è possibile scegliere quando si digita `DE:`.

     * Se vuoi che il calcolo faccia riferimento a un campo che estrae dati da *principale* oggetto quando il modulo personalizzato viene allegato a un oggetto, è necessario anteporre al nome del campo il tipo di oggetto dell&#39;oggetto padre, tra parentesi graffe.

    Ad esempio, se il modulo personalizzato è configurato per l&#39;utilizzo con le attività e si desidera che il campo calcoli le entrate effettive dell&#39;oggetto padre quando il modulo viene allegato a un&#39;attività, è necessario indicare `Project` come tipo di oggetto del campo:

    `{project}.{actualRevenue}`

    Oppure, se si tratta di un campo personalizzato:

    `{project}.{DE:profit}`

    **Separa elementi con periodi**

    Quando si fa riferimento a un oggetto correlato in un campo personalizzato calcolato, è necessario separare i nomi degli oggetti e gli attributi con i punti.

    In un modulo personalizzato di tipo attività, ad esempio, per visualizzare il nome del proprietario del Portfolio in un campo personalizzato calcolato, digitare quanto segue:

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

    Questo determinerebbe quanto segue: Dall’oggetto del modulo personalizzato (un’attività), è possibile accedere all’oggetto successivo correlato all’attività (un progetto). Da qui, puoi accedere al successivo oggetto correlato al progetto (un portfolio), quindi fare riferimento ai campi definiti per l’oggetto portfolio (il proprietario)

    **Sintassi del nome per il riferimento a un campo personalizzato**

    Quando si fa riferimento a un altro campo personalizzato in un campo personalizzato calcolato, è necessario immettere il nome del campo visualizzato nell&#39;interfaccia utente di Workfront.

    Ad esempio, per fare riferimento all’opzione selezionata in un campo personalizzato denominato Executive sponsor, digita quanto segue:

    `{DE:Executive sponsor}`

    <div class="extension note">
    <div>NOTE</div>
    <div>
    <p>La sintassi di un campo typeahead è leggermente diversa da quella di altri tipi di campi, in quanto è necessario aggiungere <code>:name</code> alla fine.</p>
    <p>Ad esempio, per fare riferimento all’opzione selezionata in un campo typeahead personalizzato denominato &quot;Executive sponsor&quot;, digita:</p>
    <p><code>{DE:Executive sponsor:name}</code></p>
    </div>
    </div>


    **Campi personalizzati calcolati nei moduli personalizzati con più oggetti**

    In un modulo personalizzato con più oggetti, i tipi di oggetto selezionati devono essere compatibili con almeno un campo a cui si fa riferimento nei campi personalizzati calcolati del modulo. I campi non compatibili con l’oggetto visualizzeranno N/D nel modulo.

    Per garantire che il campo calcolato visualizzi un risultato corretto per tutti i tipi di oggetto, è necessario utilizzare `$$OBJCODE` per definire un calcolo per ciascun tipo di oggetto.

    <div class="extension info">
    <div>INFO</div>
    <div>
    <p><strong>Esempio:</strong></p>
    <p>In un modulo personalizzato configurato per l’utilizzo con progetti, attività e problemi, è possibile utilizzare la formula seguente per visualizzare il tipo di oggetto:</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>Su un progetto, il campo mostra &quot;Questo è un progetto&quot;, su un’attività mostra &quot;Questa è un’attività&quot; e su un problema dice &quot;Questo è un problema&quot;.</p>
    </div>
    </div>


    <div class="extension info">
    <div>INFO</div>
    <div>
    <p><strong>Esempio:</strong> Sebbene nei progetti non sia presente il campo Assegnato a: Nome, è disponibile un campo Proprietario predefinito che viene automaticamente compilato con il nome della persona che ha creato il progetto, a meno che questa impostazione non venga modificata manualmente.</p>
    <p>Quindi, nel campo personalizzato In carica, puoi utilizzare <code>$$OBJCODE</code> come mostrato di seguito per fare riferimento al campo Proprietario quando il modulo personalizzato è allegato a un progetto e al campo Assegnato a: Nome quando il modulo è allegato a un’attività:</p>
    <p><code>IF($$OBJCODE=&quot;PROJ&quot;,{owner}.{name},{assignedTo}.{name})</code></p>
    </div>
    </div>

    Per ulteriori informazioni su variabili come `$$OBJCODE,` vedi [Panoramica delle variabili filtro con caratteri jolly](https://experienceleague.adobe.com/docs/workfront/quicksilver/reports-and-dashboards/reports/reporting-elements/understand-wildcard-filter-variables.html?lang=it).

    **Aggiornamenti automatici dei campi personalizzati calcolati**

    I campi personalizzati calcolati su un oggetto vengono ricalcolati automaticamente quando si verificano le seguenti condizioni:

     * Un elemento nell’oggetto cambia, ad esempio un calcolo della sequenza temporale giornaliera.
     * Qualcuno modifica un altro campo a cui fa riferimento un campo personalizzato calcolato sull’oggetto.
     * L&#39;espressione calcolata è vuota e il campo contiene un valore, che imposta il valore su null.

       <div class="extension note">
       <div>NOTE</div>
       <div>
       <div>In un modulo personalizzato allegato a un oggetto, le istruzioni di data e ora nei campi personalizzati calcolati vengono calcolate e salvate in base al tempo UTC (Coordinated Universal Time) e non in base alle configurazioni del fuso orario impostate per l’istanza della tua organizzazione e il tuo profilo utente. I calcoli in un modulo personalizzato vengono generati in base ai singoli fusi orari degli utenti.</div>
       </div>
       </div>

  <div class="extension tip">
  <div>TIP</div>
  <div>
  <p>Per ottenere informazioni sui calcoli, eseguire una delle operazioni seguenti:</p>
  <ul>
  <li>Passa il puntatore del mouse su un&#39;espressione nel calcolo per visualizzare una descrizione, un esempio che mostra come può essere utilizzata e un collegamento &quot;Ulteriori informazioni&quot; per ulteriori informazioni nell&#39;articolo <a href="https://experienceleague.adobe.com/docs/workfront/quicksilver/reports-and-dashboards/reports/calc-cstm-data-reports/calculated-data-expressions.html?lang=it">Panoramica delle espressioni di dati calcolati</a>.<br>
  <img src="assets/hover-expression-help-text.jpg" alt=""></li>
  <li>Utilizza la codifica a colori per identificare i componenti aggiunti. Le espressioni vengono visualizzate in blu e i campi in verde.<br>
  <img src="assets/colors-fields-expressions.jpg" alt=""></li>
  <li>Individuare gli errori di calcolo, evidenziati in rosa. Puoi passare il cursore del mouse su un errore evidenziato per visualizzarne una breve descrizione della causa.<br>
  <img src="assets/error-help.png" alt=""></li>
  <li>Nell&#39;area sottostante il calcolo, visualizzare in anteprima i risultati di un oggetto Workfront esistente.</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>Riferimento alle espressioni in un calcolo lungo utilizzando i numeri di riga visualizzati a sinistra.</li>
  </ul>
  </div>
  </div>