Guided Tour: UBL 2.1's package

La specifica UBL 2.1 è disponibile sottoforma di archivio (os-UBL-2.1.zip). La decompressione di questo archivio crea una directory chiamata UBL-2.1 contenente i file e le cartelle descritti nelle seguenti tabelle:

FILE DESCRIZIONE

Specifica UBL 2.1

Documento che definisce lo Universal Business Language, versione 2.1.
Il documento è disponibile solo in lingua inglese. Fornisce esempi di scenari d’uso, descrive i documenti, la struttura del package, etc.



DIRECTORY CONTENUTO
art/

Diagrammi e immagini utilizzate nel documento "Specifica UBL 2.1".

cl/

Code list in formato Genericode (Genericode è un formato standard OASIS, basato su XML, per la definizione di liste di valori codificati).

Le code list sono insiemi di codici, come ad esempio "FR" e "USD" che sono utilizzati per specificare un paese (FR=Francia) o una valuta (USD=dollaro americano), spesso utilizzati nei messaggi elettronici di business. UBL utilizza sia liste di codici standard pubblicate da organizzazioni come ISO e UN/CEFACT, che liste definite da UBL stesso; in ogni caso le code list sono fornite in formato Genericode (standard OASIS, basato su XML, specifico per la rappresentazione di code list). Struttura dettagliata della directory:

  • gc/default/: contiene le code list da usare per i tipi di dato qualificato. Queste code list sono valide ed utilizzabili nella maggior parte dei contesti applicativi;
  • gc/special-purpose: contiene delle code list valide ed utilizzabili solo in determinati contesti applicativi.
cva/

File cva che esprimono le associazioni tra code list e tipi di dato qualificati (CVA, Context/value association using genericode 1.0, è una specifica OASIS).

db/

Fogli di stile DocBook per la visualizzazione del file UBL-2.1.xml.

mod/

Spreadsheet dei documenti e dei componenti (i file sono disponibili sia in formato Excel (.xls) che in formato OASIS/ISO/IEC Open Document (.ods)) Contenuto della directory:

  • file UBL-ABIE-Reuse-Table-2.1.html: elenca i componenti aggregati (ABIE) che compongono la libreria UBL 2.1, indicando le associazioni che li legano;
  • file UBL-Entities-2.1.gc e UBL-Signature-Entities-2.1.gc: forniscono la lista completa dei componenti (BBIEs, ABIEs e ASBIEs) della libreria UBL 2.1, in formato Geniricode;
  • maindoc/: contiene gli spreadsheet dei documenti;
  • common/: contiene gli spreadsheet dei componenti.
  • summary/: contiene una breve guida alla navigazione degli spreadsheet (readme-Reports.html).

Gli spreadsheet sono un modo di rappresentare i modelli dei documenti e dei componenti. Fondamentalmente sono stati utilizzati per fornire i metadati richiesti dalle Core Components Technical Specification (specifica sulla quale si basa UBL).

rnc/

Versione in RELAX NG degli schemi UBL.

uml/

Diagrammi delle classi UML che rappresentano la struttura dei documenti e dei componenti.

val/

Software open source che può essere utilizzato per eseguire la validazione dei documenti UBL 2.1.

xml/

Esempi di istanze UBL 2.1.

xsd/

Maggiori info

Navigazione directory

XML Schema che definiscono la struttura dei documenti e dei componenti UBL 2.1.

NB: gli XML Schema sono l’unica rappresentazione normativa dei tipi di documento e della libreria dei componenti UBL 2.1.

xsdrt/

Runtime XML Schema (la directory ha stessi contenuti e struttura della directory xsd/).

Gli XML schema contenuti in questa directory si differenziano da quelli contenuti nella directory xsd/ solamente perchè non hanno le annotazioni.

NB: non sono normativi; sono stati definiti per agevolare gli utenti in fase di implementazione.