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 disponibili, contattare l'amministratore Workfront.
Per informazioni sulle Adobe Workfront Fusion licenze, vedere 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:
-
Fare clic su 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 l'intestazione Output. 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, vedere 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.
Nella prima scheda (visualizzata all'apertura del pannello) vengono visualizzati gli elementi che è possibile mappare da altri moduli.
Le altre schede contengono i seguenti tipi di funzioni:
-
Funzioni generali - Per ulteriori informazioni, vedere Funzioni generali in Adobe Workfront Fusion.
-
Funzioni matematiche . Per ulteriori informazioni, vedere Funzioni matematiche in Adobe Workfront Fusion.
-
Funzioni testo e binarie . Per ulteriori informazioni, vedere Funzioni stringa in Adobe Workfront Fusion.
-
Data e ora - Per ulteriori informazioni, consulta le Funzioni data e ora in Adobe Workfront Fusion e gli articoli seguenti.
-
Funzioni per l'utilizzo degli array . Per ulteriori informazioni, vedere Funzioni array in Adobe Workfront Fusion.
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 elemento di tipo raccolta dal piccolo rettangolo nero visualizzato a destra dell'etichetta dell'elemento e dal relativo elenco di elementi secondari espanso automaticamente:
Per ulteriori informazioni sulle raccolte, vedere Tipi di dati elemento 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 elemento in Adobe Workfront Fusion
Mappare il primo elemento di un array
Se mappi l'elemento Recipient name
di un array, questo 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.
Nell'esempio seguente viene illustrato l'output dell'app Jira.
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 è 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. È possibile ottenere questo risultato con una formula che utilizza una combinazione delle funzioni map()
e get()
.
Di seguito è riportata una ripartizione dettagliata della formula:
-
Il primo parametro della funzione
map()
è l'intero elemento dell'array. -
Il secondo parametro è il nome non elaborato dell'elemento valore. Per ottenere il nome non elaborato, passa il cursore sull'elemento nel pannello mapping:
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.
Poiché la funzione map()
restituisce un array (poiché potrebbero essere presenti più elementi con il valore chiave specificato), è necessario applicare la funzione get()
per ottenere il primo elemento:
-
Il primo parametro della funzione
get()
è il risultato della funzionemap()
. -
Il secondo parametro è l’indice dell’elemento, ovvero uno.
Per ulteriori informazioni sulla funzione map()
, vedere Funzioni array in Adobe Workfront Fusion.
Per ulteriori informazioni sulla funzione get()
, vedere 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 il modulo Iterator. Per ulteriori informazioni, vedere il modulo Iterator 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
-
Fare clic con il pulsante destro del mouse sul modulo, quindi scegliere Esegui solo il 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 (che controlla i 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
-
Fare clic con il pulsante destro del mouse sul modulo, quindi scegliere Esegui solo il modulo nel menu visualizzato.
-
Se non è presente alcun output, fare clic su Scegliere la posizione da cui iniziare e modificare 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 la sezione precedente del trigger istantaneo o del trigger di polling.
-
Solo il modulo singolo
Se scegli di eseguire solo il modulo singolo:
-
Fare clic con il pulsante destro del mouse sul modulo, quindi scegliere Esegui solo il modulo nel menu visualizzato.
-
Fornire valori di esempio per gli elementi di input, quindi fare 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.