European XBRL Reporting Entities handbook

From XBRLWiki

(Difference between revisions)
Jump to: navigation, search
Revision as of 05:50, 16 March 2013 (edit)
Iboixo (Talk | contribs)
(Namespaces)
← Previous diff
Revision as of 05:55, 16 March 2013 (edit)
Iboixo (Talk | contribs)
(Namespaces and prefixes)
Next diff →
Line 212: Line 212:
===Namespaces and prefixes=== ===Namespaces and prefixes===
-<span style="background-color:yellow">The use of prefixes is further being elaborated during the Workshop with the input from the other project teams.</span><br />+For readability purposes within an XML document, each full namespace identifier is replaced with prefixes. The association between prefixes and its corresponding namespaces are usually set at the root node. The association between prefixes and namespaces is done with a special attribute: xmlns:[prefix]="Namespace". This is illustrated with an example below:
 +<code>
 +<br/>
 + <?xml version="1.0" encoding="UTF-8"><br/>
 + <bk:book-collection xmlns:bk="http://www.book.org"> <br/>
 + <bk:book author="Norman Davies" language="English">Europe: A History</bk:book><br/>
 + <bk:book author="Homeros" language="Greek">Ilias</bk:book><br/>
 + <bk:book author="Jonathan Litell" language="French">Les Bienveillantes</bk:book><br/>
 + </bk:book-collection><br/>
 +</code>
 + 
 +In the above example document, the element "bk:book" has "book" as local name, and "http://www.book.org" as namespace. This namespace uses "bk" as prefix.
===UNICODE=== ===UNICODE===

Revision as of 05:55, 16 March 2013

CEN Workshop Agreement

Status: Working Group Working Draft


Editing rules

Editorial comments should be highlighted as follows: A comment

Text or rules in discussion (white): Some text

Text or rules already aligned (green): Some text

Text or rules to be deleted (red): Some text

Text to be delivered (blue): Some text

Contents




Foreword


This document is a working document.
This document has been prepared by CEN/WS XBRL, the secretariat of which is held by NEN.
This document is a working document.



Introduction

The set of recommendations included in this document aim to facilitate the implementation of European National Supervisors to adopt XBRL in any of the reporting frameworks. The following chapters will provide guidance on the use, understanding, preparation, and extension of their filings in eXtensible Business Reporting Language (XBRL).

This guidance is in the form of notes in association with the pertaining requirements clause and uses the terms “should” (recommendation), “may” (allowance) and “can” (possibility). Organizations wishing to implement this CWA would be expected to consider all recommendations where the term “should”is used.




Scope

COREP, FINREP (and Solvency II or other future) XBRL taxonomies are offered to European regulators for national implementation. The first releases (2006) of the COREP and FINREP XBRL frameworks have proven that a standardized technical roll-out package is needed to increase the adoption rate and avoid implementation variances, which have a detrimental effect on the overall cross-border effectiveness of using one reporting standard. This roll-out guide tries as well to promote the economies of scale of a better adoption.

This CWA have divided the work/deliveries in two difference parts:

i) An XBRL supervisory roll-out guide: this is oriented towards national regulators on how to implement, extend and manage XBRL taxonomies
ii) An XBRL handbook for declarers: this is a roll-out guide or reference handbook would give a general introduction to XBRL and serve as a help to preparers of XBRL (reporting entities)


The scope of the current document is on the second part of the CWA; the XBRL handbook for declarers.
[DRAFT]

Normative references

The following referenced documents are indispensable for the application of this document. For dated references, only the edition cited applies. For undated references, the latest edition of the referenced document (including any amendments) applies.
EN xyz:199x, Title of the european standard.
EN ab c:199x, General title of series of parts — Part c: Title of part.

Terms and definitions

For the purposes of this document, the following terms and definitions apply / the terms and definitions given in … and the following apply.

Term1 
description on text for term1
Term2 
description on text for term2


How to start with XBRL from the declarer's perspective

XBRL stands for eXtensible Business Reporting Language. It is a language for the electronic communication of business information, providing major benefits in the preparation, analysis and communication of business information. It offers cost savings, greater efficiency and improved accuracy and reliability to all those involved in supplying or using business information.

XBRL is increasingly adopted as communication standard by more and more regulators around the world. The entities which are providing this information to the regulators might initially see XBRL as just another way or format of the required information. However, XBRL provides many benefits for the declarer as well. All types of organisations can use XBRL to save costs and improve efficiency in handling business and financial information. Because XBRL is extensible and flexible, it can be adapted to a wide variety of different requirements. All participants in the financial information supply chain can benefit, whether they are preparers, transmitters or users of business data.

XBRL can be used with the help of various software tools, in a way that the user doesn't need to understand or even see the XBRL itself. However, a basic understanding of the basic components of XBRL allows the user to better grasp the potential benefits of XBRL.

The ambition of this document is to explain the basic underpinnings of the XBRL standard. Although these aspects might seem technical at first, all topics will be addressed in a general, comprehensible way.


This section is further being elaborated during the Workshop with the input from the other project teams.


XML and XBRL: Introduction to its technological building blocks

This chapter aims to give an overview of the basic technologies that underpin XBRL. Our aim is to give a general introduction of each component in order to obtain a better understanding of this reporting language. Since XBRL is built upon the XML language, the this chapter will focus on the basics of the XML standard, in particular the XML components which are also used by XBRL.

XML

XML, or eXtensible Markup Language, is a W3C standard which enables the representation of structured data in the form of flat text. This simple and flexible text format is both machine readable and human readable. The XML specification, which is a derivative of SGML1 , uses elements and attributes in order to structure content. Although originally designed for the publication of information, XML is increasingly important in facilitating electronic communications.

In the chapters further below, we'll elaborate on the following topics:

  • How XML is a markup language
  • How XML enables the structuring of information
  • What are the main components of an XML document
  • Namespaces and prefixes
  • Unicode
  • XML benefits


1 SGML (or Standard Generalized Markup Language) is an ISO-standard technology for defining generalized markup languages for documents. SGML itself descends from GML (Generalized Markup Language), which is developed by IBM in the 1960s.


XML as a markup language

Simply put, one can say that XML is a language for the codification of structured information. This coding, which is done via the use of "tags", is the main reason why XML is commonly referred as a markup language. As a basic example, the list below represents a list of books:

   <book>On the Road</book>
   <book>The Catcher in the Rye</book>
   <book>The Hobbit</book>
   <book>The Name of the Rose</book>

The name of each book is delimited by two marks. The first mark contains an identifier enclosed in angle-brackets (<book>), indicating the beginning of a field. The second mark is equal to the first, but also contains a closing bracket (</book>), which indicates the end of a field. As a result, the content of each element of <book> is delimited by the opening and closing tags. With this method, a system that processes this information can easily identify the subject and aim of the provided information.

XML structures information

In the previous example, only the element <book> was provided. The XML information model is however hierarchical: an element can contain other elements, which in turn can also contain other elements. This is made clear with the following example:


<library>  
  <book>
    <title>On the Road</title>
    <author>Jack Kerouac</author>
  </book>
  <book>
  <book>
    <title>The Catcher in the Rye</title>
    <author>J. D. Salinger</author>
  </book>
  <book>
  <book>
    <title>The Name of the Rose</title>
    <author>Umberto Eco</author>
  </book>
  <book>
</library>


In the example above, the "library" element contains a set of "book" elements. Each of these "book" elements contains a "title" and an "author" element.


Components of an XML document

The most important components of an XML documents are the elements. Elements are defined by their name, their content (the value which is between the angled brackets, which can be null) and an indefinite number attributes. The example below shows an element with two attributes:

 <element attribute1="attr-value1" attribute2="attr-value2">content</element>

An XML document may start with an XML declaration, where the used XML version is identified (typically 1.0) as well as the character encoding. This is followed by the first element. This element is called root element. This will have a number of undetermined "children" elements.

 <?xml version="1.0" encoding="UTF-8"> 
<library>
<!-- other items -->
</library>

The example above shows an XML document which uses version 1.0, has UTF-8 encoding and has "library" as root element.

The XML specification defines an XML document as a text that is well-formed, i.e., it satisfies a list of syntax rules provided in the specification. This list is fairly lengthy, but some key points are:

  • Only properly encoded legal Unicode characters are allowed.
  • None of the special syntax characters such as "<" and "&" appear except when performing their markup-delineation roles.
  • The begin, end, and empty-element tags that delimit the elements are correctly nested, with none missing and none overlapping.
  • The element tags are case-sensitive; the beginning and end tags must match exactly.
  • There is a single "root" element that contains all the other elements.

It is also possible to include comments in XML documents. These comments are not processed by applications and allow the inclusion of clarifications in the text document when deemed appropriate. Comments begin with the characters "<!-" and end with the characters "->".


Namespaces

The naming scheme that is described above is relatively limited, as it can lead to conflicts between elements. Consider the following two examples:

 <?xml version="1.0" encoding="UTF-8"> 
<library>
<book author="J.R.R. Tolkien" language="English">The Lord of the Rings</book>
<book author="Molière" language="French">Tartuffe</book>
</library>


 <?xml version="1.0" encoding="UTF-8"> 
<xml-apps>
<tool name="xmlstarlet" language="c"/>
<tool name="trang" language="java"/>
<tool name="xmldiff" language="python"/>
</xml-apps>

The first document contains a representation of a collection of books. One of the attributes of each book is the language in which it is written. In the second document a small collection of XML applications is shown. In this case the language attribute is also used, but here it is referring to the programming language, which has a distinct meaning.

In principle, a human person would have little difficulty in distinguishing the use of the same attribute in different contexts. In order to facilitate the automatic processing of information by a machine, ambiguities must be avoided as much as possible

XML namespaces are used for providing uniquely named elements and attributes in an XML document. A namespace defines a grouping of concepts. Within a namespace, each concept is identified uniquely by its local name. Globally, each concept is identified uniquely by its local name plus the identifier of its namespace (or qualified name). With the earlier two examples, could thus be represented in the following way:


NamespaceLocal NameDescription
LiteratureLanguageLanguage, speech
Computer SciencesLanguageProgramming language


But how to ensure that there is no naming conflict at the namespace level? How to ensure, for example, that there are different interpretations of the namespace "literature"? The unique identification of a namespace is achieved with the use of an URI (or Unique Resource Identifier).

A namespace is identified by a URI (Uniform Resource Identifier), which as an example can look like this:

            http://www.acme.org/products


The fundamental idea of namespaces is that they incorporate an internet domain as part of its identifier. The use of namespaces allows the use of uniquely identified concepts. This is in an important aspect of the XBRL standard

Namespaces and prefixes

For readability purposes within an XML document, each full namespace identifier is replaced with prefixes. The association between prefixes and its corresponding namespaces are usually set at the root node. The association between prefixes and namespaces is done with a special attribute: xmlns:[prefix]="Namespace". This is illustrated with an example below:

    <?xml version="1.0" encoding="UTF-8">
<bk:book-collection xmlns:bk="http://www.book.org">
<bk:book author="Norman Davies" language="English">Europe: A History</bk:book>
<bk:book author="Homeros" language="Greek">Ilias</bk:book>
<bk:book author="Jonathan Litell" language="French">Les Bienveillantes</bk:book>
</bk:book-collection>

In the above example document, the element "bk:book" has "book" as local name, and "http://www.book.org" as namespace. This namespace uses "bk" as prefix.

UNICODE

The use of unicode is further being elaborated during the Workshop with the input from the other project teams.

XML Benefits

This section is further being elaborated during the Workshop with the input from the other project teams.

XML Schemas

This section is further being elaborated during the Workshop with the input from the other project teams.

XML Schema Components

Explain: types, attributes, groups of attributes and elements, importing and including schemas, substitution groups, …

Benefits of using XML Schema

This section is further being elaborated during the Workshop with the input from the other project teams.

XLink

This section is further being elaborated during the Workshop with the input from the other project teams.

Technological components used by XML and by XBRL

XPath

This section is further being elaborated during the Workshop with the input from the other project teams.

XSLT

This section is further being elaborated during the Workshop with the input from the other project teams.

XQuery

This section is further being elaborated during the Workshop with the input from the other project teams.

XBRL: Extensible Business Reporting Language

High level description

How to structure reporting data?

Before starting to explain XBRL, we would like to show via an example why the structuring of reported data can be useful. Reported financial data tend to be represented a table format. For example, the COREP Capital Adequacy table looks this:

Such a representation of information is very human-readable. However, it is not ideal for machine interpretation, as it is not very structured. As a result, the following question comes to mind: How to structure this information, so that it can be transmitted and interpreted in a consistent way? For the purpose of this example, we’ll focus on the “Eligible Capital” line, which is highlighted in yellow in the above example. A first step would be to tag the amount of Eligible Capital in a way that it is directly linked to the concept of Eligible Capital:

<p-ca:EligibleCapital>215</p-ca:EligibleCapital>

Although this information is already quite structured, some contextual information is missing. Information like the currency of the amount:

<p-ca:EligibleCapital unitRef=”EUR”>215</p-ca:EligibleCapital>

And finally, the reporting period:

<p-ca:EligibleCapital unitRef=”EUR” contextRef=”2012-12-31”>215</p-ca:EligibleCapital>

The above example shows, in a nutshell, how XBRL allows to structure reporting data.

XBRL Introduction

XBRL, or eXtensible Business Reporting Language, is a communication standard developed in order to simplify the exchange of business and financial data.
XBRL normalises the format of data (via the use of XML techniques) en the validation of data (via XBRL taxonomies).

Image:XBRL-LanguageDiagram.jpg


XBRL also provides among others:
  • Standard validation rules (mathematical and logical rules)
  • The use of label linkbases (which allows multi-lingual taxonomies)
  • The possibility to provide rendering
  • Standard toolset which allow to work with XBRL

XBRL Taxonomies

This section is further being elaborated during the Workshop with the input from the other project teams.

Schemas

This section is further being elaborated during the Workshop with the input from the other project teams.

Linkbases

This section is further being elaborated during the Workshop with the input from the other project teams.

Extensibility

This section is further being elaborated during the Workshop with the input from the other project teams.

Taxonomy Extensions

Creating new relationships

Dimensions

This section is further being elaborated during the Workshop with the input from the other project teams.

The multidimensional model

XBRL dimensions

This section is further being elaborated during the Workshop with the input from the other project teams.

Formulas

This section is further being elaborated during the Workshop with the input from the other project teams.

XBRL Reporting: Instance documents

This section is further being elaborated during the Workshop with the input from the other project teams.

Validation of XBRL reports

This section is further being elaborated during the Workshop with the input from the other project teams.




Bibliography

[1] :xxx
[2] :xxx