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:

Adobe Workfront piano*
Pro o superiore
Adobe Workfront licenza*
Plan, Work
Licenza Adobe Workfront Fusion**

Requisiti di licenza correnti: nessun requisito di licenza Workfront Fusion.

Oppure

Requisito licenza legacy: Workfront Fusion per automazione e integrazione del lavoro

Prodotto

Fabbisogno prodotto corrente: se si dispone del piano Select o Prime Adobe Workfront, l'organizzazione deve acquistare Adobe Workfront Fusion e Adobe Workfront per utilizzare le funzionalità descritte in questo articolo. Workfront Fusion è incluso nel piano Ultimate Workfront.

Oppure

Requisiti del prodotto legacy: la tua organizzazione deve acquistare Adobe Workfront Fusion e Adobe Workfront per utilizzare le funzionalità descritte in questo articolo.

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:

  1. Fare clic su Esegui una volta per eseguire il modulo.

  2. 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.

INFO
Esempio: Questo esempio mostra il modulo E-mail > E-mail da guardare. È possibile vedere che ha eseguito 1 operazione producendo un singolo bundle che contiene vari elementi come Date, Email ID (UID), size e così via.
NOTE
Gli output dei moduli racchiusi tra un Iterator e Aggregator non sono accessibili oltre il modulo Aggregator.

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:

  1. Fai clic sul modulo che deve elaborare l’output del modulo o dei moduli precedenti.

  2. 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.

  3. Fai clic su un elemento dal pannello di mappatura per inserirlo nel campo.

  4. (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:

TIP
Quando si crea una formula complessa che si desidera riutilizzare in un altro campo, è possibile fare clic sul campo che contiene la combinazione, utilizzare Comando-A o Ctrl-A per selezionarla, quindi copiarla e incollarla nell'altro campo.

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:

NOTE
Nella maggior parte dei casi, è possibile mappare gli elementi secondari della raccolta anziché l'elemento che rappresenta l'intera raccolta.

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:

  1. Il primo parametro della funzione map() è l'intero elemento dell'array.

  2. 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.
  3. Il terzo parametro è il nome non elaborato dell’elemento chiave:

  4. 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 funzione map().

  • 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

  1. 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.

  2. 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.

  3. 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

  1. Fare clic con il pulsante destro del mouse sul modulo, quindi scegliere Esegui solo il modulo nel menu visualizzato.

  2. Se non è presente alcun output, fare clic su Scegliere la posizione da cui iniziare e modificare le impostazioni.

  3. 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.

  4. 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:

  1. Fare clic con il pulsante destro del mouse sul modulo, quindi scegliere Esegui solo il modulo nel menu visualizzato.

  2. Fornire valori di esempio per gli elementi di input, quindi fare clic su OK.

  3. 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.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43