330 likes | 521 Views
ACG 4401. XML Schemas XML Namespaces XLink. The XML Foundation. Many participants – an extended family! XML Instance documents – carry data in context Each must be parsed into its component parts XML Schemas – define the rules a class of documents must follow
E N D
ACG 4401 XML Schemas XML Namespaces XLink
The XML Foundation • Many participants – an extended family! • XML Instance documents – carry data in context • Each must be parsed into its component parts • XML Schemas – define the rules a class of documents must follow • Can be used to validate documents & contents • XSLT – provide processing instructions • Can be used to process XML documents • Xlink (will discuss briefly, but its an important feature) • Namespaces – qualify elements & attributes • Differentiate & associate them with a URI
XML Schema Language • Language (Vocabulary) used to create Schema Documents • Schema • Used to define the structure and content of Instance documents • Well-formed XML document • Definition: “provide a means for defining the structure, content and semantics of XML documents.” (W3C) • Defines structure and contents of Instance Document • Similar to an ER-Diagram for databases • Defines Each Element and Attribute • Its Structure • Includes Business Rules • Cardinalities • Used to Validate Instance Document • Means Instance Document conforms to Schema Rules
XML Schema • .xsdextension • But won’t open in IE so use .xml if using that browser • Defines each attribute and element
Vocabularies & Schemas • XBRL & UBL are vocabularies • XBRL for Financial Reporting • UBL for Business Documents • Vocabularies are designed using • Agreed upon element names • Agreed upon element types • Agreed upon element sequence/structure • Defined by Schemas
Namespaces • Each XML Vocabulary is associated with a unique NameSpace • A unique identifier (think, primary key) • Universal Resource Identifier (URI) • Local Name (e.g. TeeTimeResevations.xml) • URL (http://www……) • Used to prevent naming collisions (more later)
Vocabularies and Namespaces • Namespace • A Unique Identifier • Unique Prefix refers to URI • Points to where information in an XML Document can be found. (URI) • Attribute of Root Element • Definition: “XML namespace: In XML, a namespace is a collection of names, identified by a URI reference, that are used in XML documents as element types and attribute names. In order for XML documents to be able to use elements and attributes that have the same name but come from different sources, there must be a way to differentiate between the markup elements that come from the different sources.” (Webopeida) (Technical Information from W3.org) • Used to preclude naming collisions • Method for distinguishing between the same element name for different elements • <inv:id>10001</inv:id> ... • <employee:id>18897</employee:id>
Element Types How to Describe Elements in a Schema
Types of Elements • Simple • contain only data <SalesOrderID>98765</SalesOrderID> • Complex • contain other elements (i.e. Root & Parent) <PartyName> <Name>Bicycles Online, Inc.</Name> </PartyName> • contain attributes <PriceAmountcurrencyID="USD">730.55</PriceAmount>
Simple Element Definition • Declare Name • Declare Type • <ID>abc12345</ID> <xs:element name=“ID” type=“xs:string”/> • Type= • Defines the data type: • string • Integer • date • decimal • other types
Complex Element (Parent) • Declares Name • Declares type • Declares Structure <Instructor> <Name>Dr. Hornik</Name> </Instructor>
Complex Element (Parent) xml <xs:element name=”Instructor"> <xs:complexType> <xs:sequence> <xs:element name=“Name” type=“string”/> </xs:sequence> </xs:complexType> </xs:element>
Complex Element (attribute) • Declare Name • Declare Type • Define element and attribute(s) • For example: • <cbc:PriceAmountcurrencyID="USD">730.55</cbc:PriceAmount>
Complex (Attribute) xml <xs:element name="PriceAmount"> <xs:complexType> <xs:simpleContent> <xs:extension base="xs:decimal"> <xs:attribute name="currencyID" type="xs:string” use="required"/> </xs:extension> </xs:simpleContent> </xs:complexType> </xs:element>
Create a Schema from a non-vocabulary instance document • Identify types of elements • Simple • Complex – Parent • Complex – Attribute • Create Prolog • Create Root element • Work down from 1st element to last
Root Element of Schema Document • Root element is used to declare namespace(s) • <xs:schemaxmlns:xs=“http://www.w3.org/2001/XMLSchema”> • xs: = namespace prefix • xmlns:xs defines prefix to use for namespace • “http:www.w3.org/2001/XMLSchema” location of Namespace, where the dictionary is • Prefix is used before each tag xs:tagname
Creating Schema from Instance Document PizzaOrders
Identify Element Types • PizzaOrder.xml
UBL Schemas • Schemas for each document type • Common Basic Components (allchild elements) • Defines Simple Elements • Defines Complex (attribute) Elements • Prefix: cbc (Namespace prefix) • Common Aggregate Components • Defines Complex (Parent) Elements • Prefix: cac (Namespace prefix)
Creating UBL Document Schemas • Declare NameSpaces and qualifiers • Import necessary Schemas • Define Root Element • Reference Reusable data components • Declare Cardinalities
Declaring a Namespace (in the UBLInstancedocument) <Catalogue xmlns="UBLCatalogueDocument" xmlns:cbc="UBLCommonBasicComponents" xmlns:cac="UBLCommonAggregateComponents"> • Since UBLCatalogueDocument does NOT have a prefix any element in the instance document without a prefix relates to this namespace. • UBL Catalogue Instance with namespaces
1. UBL Namespace Declaration in Root Element <?xml version="1.0" encoding="UTF-8"?> <xs:schemaxmlns:xs="http://www.w3.org/2001/XMLSchema" targetNamespace="UBLCatalogueDocument" xmlns="UBLCatalogueDocument" xmlns:cbc="UBLCommonBasicComponents" xmlns:cac="UBLCommonAggregateComponents" elementFormDefault="qualified" attributeFormDefault="unqualified">
Namespace Clarification • targetNamespace="UBLCatalogueDocument“ • The schema being created/used is applied to the UBLCatalogueDocument namespace • elementFormDefault="qualified“ • Element names will use a namespace prefix • CAC: • CBC: • attributeFormDefault="unqualified“ • Attribute names will not use a namespace prefix
2. UBL Import <xs:importnamespace="UBLCommonBasicComponents" schemaLocation="http://www.buec.udel.edu/whitec/UBLCommonBasicComponents/UBLCommonBasicComponentsSchema.xsd"/> <xs:importnamespace="UBLCommonAggregateComponents" schemaLocation="http://www.buec.udel.edu/whitec/UBLCommonAggregateComponents/UBLCommonAggregateComponentsSchema.xsd"/>
3. UBL Root Element (Catalogue) <xs:element name="Catalogue"> <xs:complexType> <xs:sequence> <xs:elementref="cbc:ID" minOccurs="1" maxOccurs="1"/> <xs:element ref="cbc:Name" minOccurs="1" maxOccurs="1"/> <xs:element ref="cbc:IssueDate" minOccurs="1" maxOccurs="1"/> <xs:element ref="cac:ProviderParty" minOccurs="1" maxOccurs="1"/> <xs:element ref="cac:ReceiverParty" minOccurs="1" maxOccurs="1"/> <xs:element ref="cac:CatalogueLine" minOccurs=”1” maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element> Put it all together: The Entire Schema
Validating XML • Ensure that Instance Document • Follows business rules • Data types are correct • Data is properly sequenced
Schemas and Vocabularies UBL Vs. XBRL
UBL • Schema defines: • Elements • Attributes, and • UBL Documents (i.e. Order, Invoice, DespatchAdvice, etc.)
XBRL • Schema Defines: • Elements • Attributes • Structure of XBRL documents • Taxonomies • Commercial and Industrial • Banking and Savings • IFRS • Management Discussion and Analysis Report • etc.
XML Linking Language • Xlink • Another XML foundation language • Allows attributes of an element in an XML document to establish links with other documents/elements • Simple: HTML type links (unidirectional/outbound) • Extended: More complex Relationship links (multidirectional)
Simple links • Unidirectional and always Outbound • From element within Instance document to an outside resource • Link to list of approved Vendor <InventoryItemxlink:type”simple” xlink:href=“http://….”/>
Extended Links • Attributes: • xlink:type=“extended” • Used in Parent element • Xlink:type=“locator” • Remote resource • In Child element • Xlink:href=“http://….” • In Child Element <Orders xlink:type=“extended”> <Purchase id=“12345” xlink:type=“locator” xlink:href= http://PurchaseOrders.xml/> <Receiving id=“34567” xlink:type=“locator” xlink:href= http://ReceivingRpts.xml/> <Voucher id=“456789” xlink:type=“locator” xlink:href= http://Vouchers.xml/> </Orders>