DocumentazioneWorkfrontGuida di Workfront

XML

Last update: Thu Nov 21 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Utente

L'app XML consente di analizzare un testo in formato XML tramite il modulo XML > Analizza XML e convertirlo in un bundle per rendere i dati disponibili ad altri moduli. È inoltre possibile convertire un bundle in un testo in formato XML tramite il modulo XML > Crea XML

Requisiti di accesso

Per utilizzare le funzionalità di questo articolo, è necessario disporre dei seguenti diritti di accesso:

Adobe Workfront piano*
Pro o versione successiva
Adobe Workfront licenza*
Plan, Work
Adobe Workfront Fusion licenza**

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 disponi del piano Select o Prime Adobe Workfront, la tua 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.

Analisi XML

Il modulo XML > Analizza XML analizza un testo in formato XML e genera un singolo bundle contenente tutte le informazioni estratte dal codice XML.

Struttura dati

La struttura dati descrive la struttura del codice XML per rendere disponibile l'output del modulo nel pannello di mappatura per i moduli seguenti.

Se si dispone di un esempio del codice XML che si desidera analizzare, è possibile utilizzarlo per generare la struttura dati:

  1. Fare clic sul pulsante Add.

  2. Fare clic sul pulsante Generator.

  3. Copiare e incollare l'esempio XML nel campo Sample data.

  4. Fare clic su Save.

  5. Verifica che la struttura dati sia stata generata correttamente.

  6. Fare clic sul pulsante Salva per salvare la struttura dati.

    Puoi saltare i passaggi da 2 a 5 per fornire una struttura di dati vuota. Se la struttura dati è vuota, l’output del modulo non è disponibile nel pannello di mappatura finché il modulo non viene eseguito almeno una volta.

Per ulteriori informazioni, vedere Strutture dati in Adobe Workfront Fusion.

Mantieni numeri come testo
Abilita questa opzione per garantire che i numeri rimangano come valori di testo (stringa). In caso contrario, i numeri vengono assegnati ai valori numerici.
XML

Immettere o associare il testo in formato XML da analizzare.

Se si utilizza una formula, verificare che il tipo di valore del risultato sia o possa essere automaticamente assegnato al tipo di dati Text.

Se il tipo di valore del risultato è Buffer (dati binari), utilizzare la funzione toString() per convertirlo nel tipo di dati Testo. Per ulteriori informazioni, vedere Tipi di coercizione in Adobe Workfront Fusion e Tipi di dati elemento in Adobe Workfront Fusion.

INFO
Esempio: Per scaricare un file XML da un URL e analizzarne il contenuto:

  1. Crea un nuovo scenario.

  2. Inserisci HTTP > Ottieni un file modulo

  3. Apri la configurazione del modulo e configurala come segue:

    URL: URL del file XML (esempio: https://siftrss.com/f/rqLy05ayMBJ)

  4. Fare clic su OK ​per salvare e chiudere la configurazione del modulo.

  5. Aggiungi XML > Analizza il modulo XML, connettilo dopo il modulo HTTP > Ottieni un file e configuralo come segue:

table 0-row-2 1-row-2 layout-auto html-authored no-header
Struttura dati

>

  1. > Fare clic sul pulsante Add.
  2. > Fare clic sul pulsante Generator.
  3. > Nel browser Web aprire una nuova scheda o finestra.
  4. > Inserisci l’URL utilizzato nel terzo passaggio nella barra degli indirizzi e recupera il file XML.
  5. > Selezionare tutto il testo XML e copiarlo negli Appunti.
  6. > Chiudi la scheda o la finestra e torna allo scenario.
  7. > Incollare il testo XML copiato nel campo Dati di esempio.
  8. > Fare clic su Save.
  9. > Verifica che la struttura dati sia stata generata correttamente.
  10. > Fare clic su Salva per salvare la struttura dati. >

Puoi saltare i passaggi da 2 a 9 per fornire una struttura di dati vuota. Se la struttura dati è vuota, l’output del modulo non è disponibile nel pannello di mappatura finché il modulo non viene eseguito almeno una volta.
XML

Mappa l'elemento Data dall'output del modulo HTTP > Ottieni un file nel campo. Utilizzare la funzione toString() per convertire il relativo valore dal tipo di buffer (dati binari) al tipo di dati Text.

È possibile copiare e incollare il codice della formula nel campo: {{toString(1.data)}}

Per ulteriori informazioni sui tipi di dati Buffer e Testo, vedere Tipi di dati elemento in Adobe Workfront Fusion.

Analisi degli attributi XML

Per impostazione predefinita, il modulo XML > Analizza XML inserisce gli attributi in una raccolta speciale _attributes come figlio del nodo che dispone di tali attributi. Se il nodo è un nodo di testo e dispone di attributi, vengono aggiunte due proprietà speciali: _attributes per gli attributi e _value per il contenuto di testo del nodo.

INFO
Esempio: Questo XML:
<root attr="1">
<node attr="ABC">Hello, World</node>
</root>

viene convertito in questo bundle:

Crea XML

Il modulo XML > Crea XML converte un bundle in un testo in formato XML.

Struttura dati

La struttura Dati descrive la struttura del codice XML risultante. Se si dispone di un esempio del codice XML che si desidera creare, è possibile utilizzarlo per generare la struttura dati:

  1. Fare clic sul pulsante Add.
  2. Fare clic sul pulsante Generator.
  3. Copiare e incollare l'esempio XML nel campo Dati di esempio.
  4. Fare clic sul pulsante Save.
  5. Verifica che la struttura dati sia stata generata correttamente.
  6. Fare clic su Salva per salvare la struttura dati.
Nome elemento principale
Immettere il nome dell'elemento principale dell'XML. Il valore predefinito è root.
Doctype SYSTEM ID
Immettere il nome del file da utilizzare nella dichiarazione !DOCTYPE SYSTEM
Doctype PUBLIC ID
Immettere il nome del file da utilizzare nella dichiarazione !DOCTYPE PUBLIC
Strip Dichiarazione Xml
Abilitare questa opzione per rimuovere la dichiarazione XML <?xml ... ?> e <!DOCTYPE ... > e lasciare solo l'elemento radice XML e il relativo contenuto.
INFO
Esempio:
Un caso d'uso tipico consiste nel trasformare i dati da un foglio di calcolo Google in XML.
  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. Imposta 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 il modulo XML > Crea XML dopo il modulo Array Aggregator.
La configurazione del modulo richiede una struttura di dati che descriva la struttura dell'output XML. Fai clic sul pulsante Aggiungi per aprire la configurazione della struttura dati. Il modo più semplice per creare questa struttura dati consiste nel generarla automaticamente da un esempio XML.
  1. Fai clic sul pulsante Generatore e incolla il tuo esempio XML nel campo Dati di esempio:
  1. Fai clic su Salva. Il campo Specification (Specifica) nella struttura Data (Dati) ora contiene la struttura generata.
  2. 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.
  3. Fai clic sul pulsante Mappa accanto al campo e mappa l'elemento Array[] dell'output Array aggregator su di esso:
  4. Fare clic su OK per chiudere la configurazione del modulo XML.
  5. Aprire la configurazione del modulo Array Aggregator. Modificare la struttura di destinazione da Personalizzato nel campo di un modulo XML corrispondente agli elementi XML padre.Mappare gli elementi del modulo Google Sheets nei campi appropriati.
  6. Fare clic su OK per chiudere la configurazione del modulo Aggregator della matrice.
  7. Esegui lo scenario.
Il modulo XML restituisce il file XML corretto.
  1. 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.
L'XML risultante può essere salvato in Dropbox, inviato come allegato tramite e-mail, caricato tramite FTP su un server e così via.

Aggiunta di attributi XML

Se si desidera aggiungere attributi a un nodo complesso (un nodo che conterrà altri nodi), è necessario aggiungere una raccolta con il nome _attributes per la nota complessa nella struttura dati personalizzata. Questa raccolta verrà mappata agli attributi del nodo. Se si desidera aggiungere attributi a un nodo di testo (ad esempio: <node attr="1">abc</node>), è necessario aggiungere una raccolta _attributes per gli attributi e una proprietà di testo _value per il valore del nodo per questo nodo nella struttura dati personalizzata.

{
   "name": "node",
   "type": "collection",
   "spec": [
      {
         "name": "_attributes",
         "type": "collection"
         "spec": [
            {
               "name": "attr1",
               "type": "text"
            }
         ]
      },
      {
         "name": "_value",
         "type": "text"
      }
   ]
}

Risoluzione dei problemi: impossibile mappare i dati dal modulo Analizza XML

Assicurati che la struttura dati sia definita correttamente. In alternativa, è possibile utilizzare una struttura dati vuota ed eseguire il modulo almeno una volta per elaborare un input XML.

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