Mappare le informazioni da un modulo all’altro in Adobe Workfront Fusion
La mappatura è il processo di assegnazione degli output di un modulo, strutturati in elementi, ai campi di input di un altro modulo.
Il pannello di mappatura viene visualizzato quando si fa clic su un campo in cui si desidera inserire un valore generato da un modulo precedente in uno scenario. All’interno di un modulo, in qualsiasi campo disponibile per la mappatura, puoi creare una formula utilizzando qualsiasi combinazione di funzioni ed elementi mappati dal pannello di mappatura con testo statico digitato. Questi elementi possono essere nidificati l’uno nell’altro.
Requisiti di accesso
Per utilizzare le funzionalità di questo articolo, è necessario disporre dei seguenti diritti di accesso:
Per conoscere il piano, il tipo di licenza o l'accesso di cui si dispone, contattare Workfront amministratore.
Per informazioni su Adobe Workfront Fusion licenze, consulta Adobe Workfront Fusion licenze.
Bundle ed elementi
Il funzionamento di un modulo produce zero, uno o più bundle come output. Un bundle è costituito da uno o più elementi.
Per esplorare l’output di un modulo:
-
Clic Esegui una volta per eseguire il modulo.
-
Fai clic sulla bolla sopra il modulo.
Viene visualizzato un registro contenente tutte le fasi del modulo. Puoi trovare il bundle o i bundle generati dalla fase operativa di un modulo sotto Output intestazione. Ogni bundle contiene i relativi elementi e i valori di ciascun elemento.
Date
, Email ID (UID)
, size
e così via.Mappare un elemento
Dopo aver creato una sequenza di moduli collegandone due o più, ogni modulo può elaborare i valori degli elementi generati dai moduli che lo precedono.
Per assegnare gli elementi ai campi di input di un modulo:
-
Fai clic sul modulo che deve elaborare l’output del modulo o dei moduli precedenti.
-
Nel pannello Impostazioni modulo visualizzato, fai clic su un campo in cui desideri utilizzare il valore di un elemento prodotto da uno o più moduli precedenti.
Viene visualizzato il pannello di mappatura.
-
Fai clic su un elemento dal pannello di mappatura per inserirlo nel campo.
-
(Facoltativo) Per cercare un campo specifico nel pannello di mappatura, fate clic sulla barra di ricerca del pannello di mappatura e digitate il termine da cercare. Fare clic sul campo quando viene visualizzato nell'elenco.
I risultati della ricerca contengono il termine di ricerca e non fanno distinzione tra maiuscole e minuscole.
Per ulteriori informazioni, consulta Configurare le impostazioni di un modulo in Adobe Workfront Fusion.
Formule
Puoi mappare più elementi in un campo, combinarli con valori letterali (valori fissi) e utilizzare operatori e funzioni per creare formule complesse:
Puoi trovare le funzioni e gli operatori nel pannello di mappatura sotto una delle relative schede.
La prima scheda (mostrato all’apertura del pannello) mostra gli elementi che è possibile mappare da altri moduli.
Le altre schede contengono i seguenti tipi di funzioni:
-
Funzioni generali - Consulta Funzioni generali in Adobe Workfront Fusion per ulteriori informazioni.
-
Funzioni matematica - Consulta Funzioni matematiche in Adobe Workfront Fusion per ulteriori informazioni.
-
Funzioni di testo e binarie - Consulta Funzioni stringa in Adobe Workfront Fusion per ulteriori informazioni.
-
Data e ora - Consulta Funzioni data e ora in Adobe Workfront Fusion e gli articoli seguenti per ulteriori informazioni.
-
Funzioni per l'utilizzo degli array - Consulta Funzioni array in Adobe Workfront Fusion per ulteriori informazioni.
Per ulteriori informazioni sulla mappatura degli elementi tramite le funzioni, vedere Mappare gli elementi utilizzando le funzioni in Adobe Workfront Fusion.
Raccolte
Alcuni elementi possono contenere più valori di vari tipi. Si tratta di elementi di tipo raccolta.
È possibile identificare un raccolta digita l’elemento in base al piccolo rettangolo nero visualizzato a destra dell’etichetta dell’elemento e del relativo elenco di elementi secondari espanso automaticamente:
Per ulteriori informazioni sulle raccolte, consulta Tipi di dati degli elementi in Adobe Workfront Fusion
Array
Alcuni elementi possono contenere più elementi dello stesso tipo. Si tratta di elementi di tipo array.
È possibile identificare un elemento di tipo matrice tramite le parentesi quadre alla fine dell'etichetta dell'elemento. Fare clic sul piccolo rettangolo nero a destra dell'etichetta dell'elemento per visualizzare gli elementi dell'elemento:
Per ulteriori informazioni sugli array, vedere Tipi di dati degli elementi in Adobe Workfront Fusion
Mappare il primo elemento di un array
Se mappate i Recipient name
elemento, viene visualizzato nel campo come segue:
Il numero tra parentesi quadre è un indice che determina quale elemento della matrice verrà utilizzato. È impostato su 1 per impostazione predefinita.
Mappare l’elemento n-esimo di un array
Se desideri accedere a un altro elemento, fai clic sulle parentesi quadre e modifica il valore dell’indice:
Mappare l’elemento di un array con una determinata chiave
Alcuni array contengono diverse raccolte con elementi chiave e valore. Si tratta in genere di vari metadati, attributi e così via.
L’esempio seguente mostra l’output del Jira App.
In questo esempio, si ottiene un nome di file da un array di allegati per l’allegato specifico con un ID di 10108.
L’output di Jira ha un aspetto simile al seguente:
Il requisito tipico è quello di cercare un elemento in base al suo dato valore chiave e ottenere il valore corrispondente dall'elemento valore. Ciò può essere ottenuto con una formula che utilizza una combinazione di map()
e get()
funzioni.
Di seguito è riportata una ripartizione dettagliata della formula:
-
Il primo parametro del
map()
è l'intero elemento array. -
Il secondo parametro è il nome non elaborato dell'elemento valore. Per ottenere il nome non elaborato, passa il cursore del mouse sull’elemento nella mappatura pannello:
note note NOTE Tutti i parametri fanno distinzione tra maiuscole e minuscole. Anche se in questo particolare esempio l’etichetta dell’elemento differisce dal suo nome non elaborato solo in maiuscolo, è necessario utilizzare il nome non elaborato, che è tutto un valore minuscolo a differenza dell’etichetta Valore. -
Il terzo parametro è il nome non elaborato dell’elemento chiave:
-
Il quarto parametro rappresenta il valore chiave specificato.
Perché il map()
funzione restituisce un array (poiché potrebbero esserci più elementi con il valore chiave specificato), è necessario applicare il get()
funzione per ottenere il primo elemento:
-
Il primo parametro del
get()
funzione è il risultato dellamap()
funzione. -
Il secondo parametro è l’indice dell’elemento, ovvero uno.
Per ulteriori informazioni su map()
funzione, vedi Funzioni array in Adobe Workfront Fusion.
Per ulteriori informazioni su get()
funzione, vedi Funzioni generali in Adobe Workfront Fusion.
Conversione di elementi in una serie di bundle
Gli array possono essere convertiti in una serie di bundle utilizzando Iteratore modulo. Per ulteriori informazioni, consulta Iteratore modulo in Adobe Workfront Fusion.
Risoluzione dei problemi
Elementi mancanti nel pannello di mappatura
Per ogni modulo, il pannello di mappatura visualizza tutti gli elementi di output elencati dall’autore del modulo. In alcuni casi, l’elenco potrebbe essere incompleto per vari motivi e alcuni elementi potrebbero mancare. Workfront Fusion può rilevare automaticamente gli elementi di output mancanti quando esegui il modulo nell’editor di scenari. La procedura esatta varia leggermente a seconda del tipo di modulo:
Trigger istantaneo
-
Fai clic con il pulsante destro del mouse sul modulo, quindi fai clic su Esegui solo questo modulo nel menu visualizzato.
Se non sono presenti webhook in coda, il modulo attende l’elaborazione di un nuovo webhook.
-
Genera un webhook.
Ad esempio, il modulo webhook Slack>Ascolta nuovi eventi (ricerca di nuovi messaggi del canale in un canale) invia un messaggio al canale.
-
Al termine dell’esecuzione del modulo, fai clic sulla bolla sopra il modulo per esplorarne l’output completo.
Il pannello di mappatura contiene tutti gli elementi individuati nell’output del modulo.
Trigger di polling
-
Fai clic con il pulsante destro del mouse sul modulo, quindi fai clic su Esegui solo questo modulo nel menu visualizzato.
-
In assenza di output, fare clic su Scegli da dove iniziare e regolare le impostazioni.
-
Se non è presente alcun evento da elaborare, creane uno e torna al passaggio 2.
Ad esempio, il modulo webhook Gmail >Guarda le e-mail invia un’e-mail alla cartella che il modulo sta guardando.
-
Al termine dell’esecuzione del modulo, fai clic sulla bolla sopra il modulo per esplorarne l’output completo.
Il pannello di mappatura ora contiene tutti gli elementi individuati nell’output del modulo.
Altri moduli
Puoi scegliere di eseguire:
-
L'intero scenario (o solo la parte contenente il modulo)
Se lo scenario inizia con un trigger, consulta Trigger istantaneo o Trigger di polling sopra.
-
Solo il modulo singolo
Se scegli di eseguire solo il modulo singolo:
-
Fai clic con il pulsante destro del mouse sul modulo, quindi fai clic su Esegui solo questo modulo nel menu visualizzato.
-
Fornisci valori di esempio per gli elementi di input, quindi fai clic su OK .
-
Al termine dell’esecuzione del modulo, fai clic sulla bolla sopra il modulo per esplorarne l’output completo.
Il pannello di mappatura ora contiene tutti gli elementi individuati nell’output del modulo.