Panoramica sulle istruzioni “IF”
È possibile utilizzare le istruzioni "IF" nei linguaggi di programmazione generale. In Adobe Workfront, le istruzioni "IF" consentono di confrontare, formattare e stringere insieme campi di dati a scopo di reporting e di dati personalizzati. Inoltre, pensare matematicamente alle istruzioni "IF" porta a una migliore comprensione concettuale, dal momento che le variabili per le espressioni sono comunemente utilizzate.
Raccomandazioni per le istruzioni "IF"
Prima di creare un'istruzione "IF", considera quanto segue:
-
Per questa guida si consiglia di conoscere tutti i linguaggi di programmazione generali, ma non è necessario conoscerli.
-
È necessaria una comprensione avanzata della sintassi della modalità testo di Workfront. Questo aiuta a comprendere la terminologia dell’API di Workfront e la sintassi dei dati personalizzati in questi formati specifici.
Per informazioni sull'API Workfront, consulta Nozioni di base sull'API.
Per informazioni sull'utilizzo della modalità testo, vedere Panoramica della modalità testo.
-
È possibile creare istruzioni "IF" per i seguenti elementi di Workfront:
- Viste
- Raggruppamenti
- Configurare campi personalizzati
-
Non è possibile creare istruzioni "IF" per i filtri. Ciò genera un errore "Whoops" in Workfront.
-
Il team di supporto non è in grado di creare dati personalizzati. È possibile contattare il team di supporto dopo aver compilato i campi o le colonne personalizzati e dopo aver ottenuto i risultati desiderati. Per assistenza nella creazione di un'espressione, contatta il tuo Account Executive per richiedere informazioni sulle nostre opzioni di consulenza.
-
È consigliabile scrivere queste espressioni innanzitutto in un editor di testo, ad esempio Sublime o Visual Studio Code, in quanto consente di visualizzare i dati in modo più chiaro rispetto a quanto risulterebbe in Workfront.
Componenti di un'istruzione "IF"
Puoi creare istruzioni "IF" in Workfront utilizzando il seguente formato:
IF(Condizione,Espressione reale,Espressione falsa)
-
IF = Espressione dei dati calcolata da Workfront per "function". Analogamente alle espressioni SUM e PROD, in questo modo il sistema interpreta la funzione come un'istruzione "IF". Utilizzare sempre lettere maiuscole per "IF" in questa istruzione.
Per un elenco di tutte le espressioni di dati calcolati, vedere Panoramica delle espressioni di dati calcolati. -
Condizione = Questa è la condizione che la variabile Workfront deve soddisfare ed è la base per questa equazione. Tutto ciò che può essere successivamente specificato nell'equazione dipende dalla condizione. È possibile utilizzare una serie di riferimenti, confronti o espressioni matematiche per avviare un'equazione. Alcuni esempi di condizioni sono:
- Una data è successiva a un'altra data su un oggetto specificato.
- Uno stato è uguale a uno degli stati disponibili su un oggetto specificato.
- La percentuale di completamento di un'attività è minore o maggiore di una determinata percentuale.
-
Operatore condizione = si tratta dell'operatore che consente di creare la condizione dell'istruzione "IF". Ad esempio, "è uguale a" o "è maggiore di" sono operatori di condizione. Per un elenco degli operatori di condizioni utilizzabili nelle istruzioni, vedere Operatori di condizioni nelle espressioni personalizzate calcolate.
-
TrueExpression = Si tratta della variabile "True", che indica all'equazione quale indicatore visualizzare una volta soddisfatti i criteri della condizione (indicatori true).
-
Espressione False = Si tratta della variabile "False", che indica all'equazione quale indicatore visualizzare quando i criteri della condizione non sono soddisfatti (indicatori falsi).
Nell'esempio seguente viene utilizzato il formato di istruzione originale per scrivere un'espressione dati semplice per un'istruzione "IF". L'espressione confronta due diversi campi data in Workfront seguiti da un risultato Vero/Falso come stringa di dati:
IF({projectedCompletionDate}>{plannedCompletionDate},"Off Track","On Track")
Nel linguaggio quotidiano, questa affermazione significherebbe: Se la Data di completamento prevista del mio oggetto è "Maggiore di" la Data di completamento pianificata del mio stesso oggetto, visualizzare le parole "Fuori traccia" in questo campo. In caso contrario, visualizzare le parole "On Track".
Generare campi calcolati in moduli personalizzati o colonne personalizzate utilizzando istruzioni "IF"
È possibile creare istruzioni "IF" in un campo calcolato in un modulo personalizzato o in una colonna personalizzata.
Esiste una differenza nella sintassi utilizzata in un modulo personalizzato calcolato rispetto a una colonna personalizzata calcolata. Consulta i seguenti esempi:
Istruzioni "IF" singole single-if-statements
Di seguito sono riportati alcuni esempi di un campo personalizzato calcolato e della colonna corrispondente che utilizza un'istruzione "IF":
- Campo personalizzato calcolato:
Quando si crea un campo personalizzato, utilizzare la sintassi seguente per un'istruzione "IF":
IF({Projected Completion Date}>{Planned Completion Date},"Off Track","On Track")
- Colonna personalizzata calcolata:
Quando si crea una colonna personalizzata, è necessario utilizzare la sintassi seguente per l'istruzione "IF" nella riga dell'espressione di valore:
valueexpression=IF({projectedCompletionDate}>{plannedCompletionDate},"Off Track","On Track")
Istruzioni "IF" multiple multiple-if-statements
È possibile unire più istruzioni "IF" con la seguente istruzione per creare un'espressione più complessa e dinamica:
IF(Condizione1,Espressione True,IF(Condizione2,Espressione True,Espressione False))
Di seguito sono riportati alcuni esempi di un campo personalizzato calcolato e della corrispondente colonna personalizzata che utilizza più istruzioni "IF":
-
Campo personalizzato calcolato:
code language-none IF({projectedCompletionDate}>{plannedCompletionDate},"Off Track",IF({plannedCompletionDate}>{projectedCompletionDate},"Off Track","On Track")) -
Colonna personalizzata calcolata:
valueexpression=IF({"projectedCompletionDate"}>{"plannedCompletionDate"},"Off Track",IF({plannedCompletionDate}>{projectedCompletionDate},"Off Track","On Track"))
In questo esempio, lo stesso risultato è stato ottenuto mettendo insieme due variabili di criteri diverse.
Puoi esplorare ulteriormente queste opzioni ricostruendo questi esempi nel tuo ambiente.
Il modo migliore per imparare questo è sperimentare con vari campi e scenari. Acquisisci inoltre familiarità con API Explorer, che rivela i nomi dei campi che possono essere utilizzati. Per informazioni su API Explorer, consulta API Explorer.
Per ulteriori informazioni sulla sintassi Workfront delle espressioni di dati calcolati, vedere Panoramica sulle espressioni di dati calcolati.