Guida al File di Trasformazione EDI

1. Panoramica

Il File di Trasformazione definisce come l'XML strutturato—creato utilizzando il File Descrittore della Struttura—viene convertito in un formato XML personalizzato che corrisponde ai requisiti specifici del tipo di documento o modulo della tua organizzazione.

Questa trasformazione viene eseguita utilizzando XSLT (Extensible Stylesheet Language Transformations), che può essere creato e mantenuto attraverso l'Editor XSLT nell'interfaccia di DocBits.

2. Scopo e Funzione

  • Trasforma l'XML intermedio (output dal Descrittore della Struttura) in un XML finale allineato con lo schema del tuo documento.

  • Consente flessibilità per adattarsi ai formati dei partner EDI e ai requisiti interni del sistema.

  • Creato utilizzando le regole XSLT, che ti permettono di definire mappature, formattazione dei valori, logica condizionale e struttura.

3. Accesso e Modifica di Base

Accesso al File

  1. Vai su Impostazioni → Tipo di Documento → [Il Tuo Documento (es. Ordine di Acquisto)] → E-Doc.

  2. Sotto la scheda E-Doc, seleziona il tuo formato (es. EDI).

  3. Clicca su Trasformazione per visualizzare o modificare.

Gestione delle Bozze

  • Crea una Bozza: Clicca sull'icona della ✏️ matita.

  • Elimina Bozze: Usa l'icona del 🗑️ cestino per rimuovere le bozze non utilizzate.

  • Attiva le Modifiche: Clicca sul segno di spunta ✅ per pubblicare una versione.

    • Nota: Attivando una nuova versione si disattiverà automaticamente la precedente.

4. Editor XSLT

Il File di Trasformazione viene modificato utilizzando un Editor XSLT integrato che supporta l'evidenziazione della sintassi e la validazione.

  • Aggiungi modelli per mappare percorsi specifici dall'XML di input alla struttura desiderata.

  • Utilizza la logica condizionale (es. <xsl:if>, <xsl:choose>) per gestire formati di dati opzionali o variabili.

  • Applica funzioni di formattazione secondo necessità (es. manipolazione di stringhe, formattazione delle date).

5. Funzione Anteprima (Anteprima XML Trasformato)

La Funzione Anteprima ti permette di testare e visualizzare come un file EDI caricato viene elaborato utilizzando il corrente File di Trasformazione.

Utilizzo

  • Carica un file EDI tramite il flusso di caricamento standard.

  • Copia l'ID del Documento del file caricato.

  • Vai all'interfaccia del File di Trasformazione.

  • Apri la Funzione Anteprima.

  • Inserisci l'ID del Documento nel campo e premi Test.

  • Verrà visualizzato l'output XML trasformato risultante.

Questo è particolarmente utile per il debug delle mappature XSLT e per garantire che la struttura XML finale soddisfi i requisiti del tuo formato.

6. Video Guida

Una guida video per questo tipo di file è disponibile nella pagina dei Video. Utilizzala per seguire la configurazione, la modifica e l'anteprima.

Last updated