XML (extensible Markup Language)

Transcript

1 Supporto On Line Allegato FAQ FAQ n.ro MAN-8HVCNU5634 Data ultima modifica 16/06/2011 Prodotto Dichiarazioni fiscali 2011 Modulo Generica DF Oggetto: Modello IRAP 2011 XML - XMLNotepad: Guida all uso e controlli sui file telematici L Agenzia delle Entrate ha scelto di adottare, per la definizione della fornitura relativa alle dichiarazioni IRAP 2011, il linguaggio XML. XML (extensible Markup Language) L XML è un metalinguaggio, ossia una grammatica per la costruzione di documenti. E un insieme di regole sintattiche mediante le quali viene definita la struttura di un documento. Il documento è composto da elementi sintattici chiamati tag, ossia sequenze di caratteri delimitate da questi simboli '<' e '>'. Ogni elemento deve avere un tagdi chiusura </. >. Concretamente, un file XML è un file di testo costituito da diversi elementi individuati dai tag. Gli elementi sono organizzati secondo una struttura gerarchica ad albero :»Elementi (tag)»attributi»testo ES : All interno dell elemento Fornitura sono stati definiti i sottoelementi Intestazione e DichiarazioneIRAP. Figura 1 XML Schema XML fornisce le regole per la logica del documento. Mentre la struttura della fornitura xml è descritta mediante l XML Schema. L XML Schema è a sua volta un documento XML (schema document) che descrive la grammatica di un linguaggio XML, utilizzando un linguaggio di markup specifico (definito dal W3C: consorzio che definisce gli standard del web.) Il file contenente lo schema è identificato dall estensione XSD ( XML Schema Definition) Quando un file XML segue le regole definite dal XSD di dice che è Well-formed(ben formato) Wolters Kluwer Italia Srl Help Desk Software Pagina 1 di 5

2 XML Schema IRAP La modellazione della fornitura delle dichiarazioni IRAP 2011 è stata realizzata definendo una radice denominata proprio Fornitura, che rappresenta una generica fornitura trasmessa telematicamente. All interno dell elemento Fornitura sono stati definiti i sottoelementi Intestazione e DichiarazioneIRAP. L elemento Intestazione raccoglie i dati identificativi della fornitura e del soggetto responsabile dell invio telematico, informazioni che nel tracciato telematico tradizionale erano esposte nel record di tipo A. L elemento DichiarazioneIRAP contiene i due sottoelementi denominati Frontespizio e DatiContabili: il primo raccoglie le informazioni che nel tracciato telematico tradizionale erano esposte nel record di tipo B, il secondo contiene i dati contabili relativi alla dichiarazione IRAP, precedentemente esposti nel record di tipo I. I simboli principali del XML Schema IRAP sono: Figura 2 XMLNotepad XmlNotepad è uno strumento che fornisce un interfaccia, semplice ed intuitiva, lato utente e permette di esplorare ed editare i documenti in formato XML. Caratteristiche\Funzionalità: - Visualizzazione dei dati in una struttura ad albero - Ricerca incrementale (Ctrl + I) - Taglia/copia/incolla - Drag/drop (trascina e rilascia) di elementi o nodi anche su 2 differenti documenti XML - Find/replace (trova e sostituisci) delle varie espressioni - Ottime performance in apertura e visualizzazioni di documenti XML di notevoli dimensioni - Istantanea validazione con l XML schema mentre si edita il documento - Supporto contestuale per editor personalizzati sui tipi date, datetime e datatypes. - Barra degli strumenti pratica che permette rapidi spostamenti dei nodi in alto e in basso all interno della struttura ad albero. - Possibilità di visualizzare il file in HTML - Help interattivo di compilazione basato su XSD Per maggiori dettagli sulle singole funzionalità all interno del software XMLNotepad è presente un Help in linea disponibile nella barra dei menù. Wolters Kluwer Italia Srl Help Desk Software Pagina 2 di 5

3 Caso pratico. Dopo aver installato l eseguibile XmlNotepad.msi, per aprire un file XML è sufficiente fare tasto destro Apri con e scegliere dall elenco dei programmi installati XmlNotepad. Ecco come si presenta un file XML con XMLNotepad: Barra dei Menù Help in linea Percorso del file Valore del Nodo/Elemento Nome Nodo/Elemento Figura 3 La struttura ad albero visualizzata rispetta le Specifiche tecniche modello IRAP 2011 rilasciate dal ministero. Controllo Entratel di un file IRAP XML Errori di SCHEMA XML Sottoponendo a controllo Entratel un file IRAP XML che non rispetta lo SCHEMA IRAP, la dichiarazione viene scartata con errori bloccanti e nell esito verrà riportata la seguente segnalazione di errore: Presenza di segnalazioni relative alla dichiarazione con identificativo (****) La dichiarazione non è conforme allo schema dichiarazioneirap11_v1.xsd. L'errore determina lo scarto della fornitura, nella cartella dell'archivio sottoposto a controllo è reso disponibile un file contenente il dettaglio degli errori. Per tanto per conoscere l errore che determina lo scarto della fornitura è necessario accedere al percorso dove risiede il file controllato e analizzare il file di log LogErroriSchema.txt. Wolters Kluwer Italia Srl Help Desk Software Pagina 3 di 5

4 Un esempio di errore sullo schema riportato nel log è il seguente: La validazione della dichiarazione con identificativo ha generato i seguenti messaggi di errore: sc:comune - messaggio: Il valore 'SANDONADIPIAVE' non e' valido rispetto alla espressione regolare '[0-9A-Z\- ]{1}([0-9A-Z] ' \- \. &, \s / \^ \( \))*' per il tipo 'DatoAN_Type'. - Riga:14 Colonna:49 sc:comune - messaggio: Il valore 'SANDONADIPIAVE' dell'elemento 'sc:comune' non e' valido. - Riga:14 Colonna:49 In tal caso il Comune indicato non è previsto nella tabella dei comuni presenti nello schema dell IRAP o è scritto in modo errato. Per identificare l elemento padre del sottoelemento indicato nel log si può far riferimento alle specifiche tecniche ministeriali. Una volta identificato il nome dell elemento, si può accedere al file IRAP XML tramite XMLNotepad e verificare\modificare il valore del elemento. Errori di contenuto\compilazione Sottoponendo a controllo Entratel un file IRAP XML con errori di compilazione l esito conterrà i messaggi di errore, come avviene per gli altri file telematici (es UNICO PF). Un esempio di errore di compilazione è il seguente: Dichiarazione relativa a: PRVFNT71R08E379C (***) Dati del Frontespizio: Codice fiscale del soggetto dichiarante - Codice Fiscale errato Valore dichiarato: PRVFNT71R08E379C (***) Quadro IP Modulo 1 Valore della produzione - Calcolo errato Valore dichiarato: Valore corretto : (***C) Quadro IP Modulo 1 Valore della produzione (Sez.I) - La somma algebrica dei valori della produzione indicati in colonna 1 della Sezione 'Valore della produzione netta' deve essere uguale alla somma algebrica dell'importo indicato nel campo 'Recupero delle deduzioni extracontabili' e dei valori della produzione derivanti dalle diverse sezioni Valore dichiarato: Valore corretto : Anche in tal caso si può ricorrere alle specifiche tecniche ministeriali sia per l identificazione del nodo\elemento, che per i controlli di corrispondenza dei valori. Wolters Kluwer Italia Srl Help Desk Software Pagina 4 di 5

5 Dal sommario cercare l elemento in questione es Frontespizio Figura 4 Poi cliccare su Frontespizio, cosi viene visualizzato il contenuto dell elemento e i sottoelementi che ne fanno parte: Figura 5 Andando oltre nella lettura delle specifiche per ciascun elemento c è una breve descrizione e il relativo controllo previsto, es: Figura 6 Altri controlli sugli importi e sulla compilazione si possono effettuare con l aiuto delle istruzioni ministeriali. Alla fine del specifiche tecniche ministeriali sono riportati tutti gli Schema Documents dei vari elementi es File fornitura_v1.xsd, File dichiarazioneirap11_v1.xsd. Wolters Kluwer Italia Srl Help Desk Software Pagina 5 di 5