Moduli JSON

L'app Adobe Workfront Fusion JSON fornisce moduli per elaborare i dati in formato JSON in modo che Adobe Workfront Fusion possa lavorare ulteriormente con il contenuto dei dati o creare nuovi contenuti JSON.

Requisiti di accesso

Espandi per visualizzare i requisiti di accesso per la funzionalità descritta in questo articolo.
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Pacchetto Adobe Workfront

Qualsiasi pacchetto Workflow di Adobe Workfront, e qualsiasi pacchetto Automation and Integration di Adobe Workfront.

Workfront Ultimate

Pacchetti Workfront Prime e Select, con un ulteriore acquisto di Workfront Fusion.

Licenze Adobe Workfront

Standard

Work o successiva

Prodotto Se la tua organizzazione dispone di un pacchetto Workfront Select o Prime che non include Workfront Automation and Integration, dovrà acquistare Adobe Workfront Fusion.

Per ulteriori dettagli sulle informazioni contenute in questa tabella, consulta Requisiti di accesso nella documentazione.

Considerazioni durante l’analisi del codice JSON

Struttura dei dati

La struttura dati descrive come sono organizzati i dati JSON e consente la mappatura di singoli elementi JSON ad altri moduli nello scenario. Se non fornisci la struttura Dati, puoi eseguire manualmente il modulo e Workfront Fusion ne creerà la struttura dal JSON fornito:

  1. Add the Parse JSON module to a scenario.
  2. In the JSON String field, enter the JSON from which you want to build a data structure.
  3. Do not connect other modules to the Parse JSON module yet. Poiché Workfront Fusion non conosce ancora la struttura dei dati JSON, non è ancora possibile mappare i dati dal modulo Parse JSON ad altri moduli nello scenario.
  4. Esegui manualmente lo scenario. Questo consente al modulo Analizza JSON di identificare la struttura JSON dal JSON fornito.
  5. You can now connect following modules. The items from the Parse JSON module are now available for mapping.

For more information, see Data structures in Adobe Workfront Fusion.

Collection vs. Array

If the JSON string field contains a collection { ... }, The output is a single bundle containing the items of the collection.

recommendation-more-help

Esempio:

{
    "name" : "Peter",

    "ID" : 1>}

Raccolta JSON

Se il campo stringa JSON contiene un array [ ... ], l'output è una serie di bundle. ogni bundle contiene un elemento dell’array.

Esempio:

[
  {
    "name" : "Peter",
    "ID" : 1
  },

  {
    "name" : "Mike",
    "ID" : 2
  }
]

Array JSON

Moduli JSON e relativi campi

Quando configuri i moduli JSON, in Workfront Fusion vengono visualizzati i campi elencati di seguito. Insieme a questi, potrebbero essere visualizzati campi JSON aggiuntivi, a seconda di fattori come il livello di accesso nell’app o nel servizio. Un titolo in grassetto in un modulo indica un campo obbligatorio.

Se visualizzi il pulsante Map (Mappa) sopra un campo o una funzione, puoi utilizzarlo per impostare variabili e funzioni per tale campo. Per ulteriori informazioni, consulta Mappare le informazioni da un modulo a un altro.

Pulsante di attivazione/disattivazione Mappa

Aggregatori

Aggrega a JSON

Questo modulo aggregatore aggrega l’output di un modulo precedente in JSON.

Modulo Source
Seleziona il modulo che restituisce i dati da aggregare in JSON.
Struttura dati
Seleziona la struttura dati da utilizzare per creare JSON. La struttura dati determina quali altri campi sono disponibili in questo modulo. Per ulteriori informazioni, vedere Struttura dati in questo articolo.
Rientro
Seleziona se desideri applicare un rientro al JSON utilizzando schede, due spazi o quattro spazi.
Raggruppa per
Definire un'espressione in base alla quale raggruppare l'output aggregato. Questa espressione può contenere uno o più elementi mappati. I dati aggregati vengono quindi separati in gruppi utilizzando il valore di questa espressione. Ogni gruppo produce come bundle separato con una chiave (l’espressione valutata) e un valore (il testo aggregato). Puoi utilizzare la chiave come filtro nei moduli successivi.
Interrompi elaborazione dopo un'aggregazione vuota
Abilita questa opzione per interrompere lo scenario quando non ci sono risultati.

Trasformatori

Converti JSON in XML

Questo modulo di azione converte una stringa JSON in XML.

JSON string
Immetti o mappa il JSON da convertire in XML.

Crea JSON

Questo modulo di azione crea JSON da una struttura di dati.

Struttura dei dati
Seleziona la struttura dati da utilizzare per creare JSON. Per ulteriori informazioni, vedere Struttura dati in questo articolo.
Rientro
Seleziona il rientro da utilizzare per questo JSON.

Analizza JSON

Questo modulo di azione analizza una stringa JSON in una struttura di dati, consentendo di accedere ai dati all’interno della stringa JSON.

Struttura dati
Seleziona la struttura dati da utilizzare per creare JSON. Per ulteriori informazioni, vedere Struttura dati in questo articolo.
JSON string
Enter or map the JSON that you want to parse.

Trasforma JSON

Questo modulo di azione trasforma un oggetto in una stringa json.

Rientro
Select the indentation you want to use for this JSON.
Oggetto
Enter or map the object that you want to transform into JSON.

Transforming data records to JSON

Esempio: Nell'esempio seguente viene illustrato come trasformare i record di dati da Google Sheets in formato JSON:

  1. Inserisci il modulo Google Sheets > Seleziona righe nello scenario per recuperare i dati. Configurare il modulo per recuperare le righe dal foglio di calcolo Google. Impostare il numero massimo di righe restituite su un numero ridotto, ma maggiore di uno a scopo di test (ad esempio, tre). Eseguire il modulo Google Sheets facendo clic con il pulsante destro del mouse e scegliendo "Esegui solo il modulo." Verifica l’output del modulo.

  2. Connetti il modulo Array Aggregator dopo il modulo Google Sheets. Nella configurazione del modulo, scegli il modulo Google Sheets nel campo nodo Source. Lascia gli altri campi così come sono per il momento.

  3. Connetti JSON > Crea modulo JSON dopo il modulo Array Aggregator. La configurazione del modulo richiede una struttura dati che descriva il formato JSON. Fai clic su Aggiungi per aprire la configurazione della struttura dati. Il modo più semplice per creare questa struttura dati è generarla automaticamente da un campione JSON. Fai clic su Generatore e incolla il tuo esempio JSON nel campo Dati di esempio:

    Esempio:

    code language-none
    {
    "books": [
    {
    "id": "ID",
    "title": "Title",
    "author": "Author"
    }
    ]
    }
    
  4. Fai clic su Salva. Il campo Specifica nella struttura dati contiene ora la struttura generata.

  5. Modifica il nome della struttura dati specificando qualcosa di più specifico e fai clic su Salva. Un campo corrispondente all’attributo dell’array principale viene visualizzato come campo mappabile nella configurazione del modulo JSON.

  6. Fare clic sul pulsante Mappa accanto al campo e mappare l'elemento Array[] dell'output dell'aggregatore di matrici su di esso.

  7. Fai clic su OK per chiudere la configurazione del modulo JSON.

  8. Aprire la configurazione del modulo Array Aggregator. Cambia la struttura di destinazione ​da Personalizzato al campo del modulo JSON corrispondente all'attributo dell'array principale. Mappare gli elementi dal modulo Google Sheets ai campi appropriati.

  9. Fare clic su OK per chiudere la configurazione del modulo Aggregator.

  10. Esegui lo scenario.

    Il modulo JSON restituisce il formato JSON corretto.

  11. Apri la configurazione del modulo Google Sheets e aumenta il numero Massimo di righe restituite affinché sia maggiore del numero di righe nel foglio di calcolo per elaborare tutti i dati.

Risoluzione dei problemi

Impossibile mappare i dati dal modulo Analizza JSON

Verificare che il contenuto JSON sia mappato correttamente nel modulo Analizza JSON e che la struttura dati sia definita correttamente. Per ulteriori informazioni, vedere Trasformazione dei record di dati in JSON in questo articolo.

Il modulo genera un errore quando si utilizzano istruzioni condizionali in JSON

Quando utilizzi istruzioni condizionali come if nel codice JSON, racchiudi l’istruzione condizionale tra virgolette.

Esempio:

Virgolette in JSON

7e1891ad-4d59-4355-88ab-a2e62ed7d1a3