« Overcoming Ambiguities in SEC XBRL Filings | Main | Into to HL7 Video Can Help You Understand XBRL »

First Iteration of Comprehensive Example Available

The first iteration of what I call the "comprehensive example" is available on my web site. What the comprehensive example does is take all of the business use cases and puts them into one XBRL instance. The purpose of this is to test the interrelationships between the use cases and to provide something that looks enough like a financial statement so that it seems real, but is not as complex as a real financial statement so is easier to work with.

The comprehensive example puts all the issues of expressing information using an XBRL taxonomy and XBRL instance where you can see them. In its current form, you have to dig a bit because I have not provided a narrative which ties all the pieces together.  I have only provided the pieces themselves. But, should one roll up their sleeves and dig in, there is a lot to see and learn.

Here are the key points of this comprehensive example XBRL taxonomy and XBRL instance (all these are detailed on the overview page):

  • Use case: This is a visualization of the use caseI am trying to express in XBRL.
  • End result: This is the end result I was able to generated to meet the use case. This is what I call a "viewer" or a rendering of the exact same information auto-generated from only the XBRL taxonomy and XBRL instance.
  • Metapatterns: The comprehensive example has come full circle. I used to create XBRL taxonomies by keying XBRL syntax into an XBRL application. That is the wrong way to work with XBRL. The right way is to add a business semantics layer above XBRL.  This makes generating XBRL easier for business users and it yields higher quality XBRL. The comprehensive example and business use cases proves the metapatterns. The metapatterns were derived from the business use cases and the comprehensive example. Basically, work with metapatterns, not XBRL. Generate the XBRL automatically from the metapatterns.

All the other things support the process of getting from the use case to the end result. The "other things" overcome all of the issues that I have run across. For example, the comprehensive example has 53 different information components.  I needed to put them into a sequence. I used an XBRL taxonomy definition linkbase to create an ordering of the components.  I call this the "flow" of the business report. You can see that flow expressed here. This is far better than ordering the extended links using numbers in the extended link description.  They are not all done yet, but I will have 100% of the computations in the XBRL instance verified (i.e. the data integrity is checked) using business rules.  See the results here and here. That is just a taste of what you can see on the overview page if you care to look.  Eventually I will create a narrative which connects things together better.

The most important thing the comprehensive example shows me is how to make XBRL work soundly and safely when leveraging XBRLs extensibility. The keys are being explicit, being consistent, and having a sound architecture.

These ideas are not the only way to tame the XBRL beast to get it to effectively and efficiently serve your needs. But, they are the best accumulation of techniques that I could put together based on what I have learned over the years about working with XBRL.

Check back for updates, I am still plunking away at this as time permits.

PrintView Printer Friendly Version

EmailEmail Article to Friend

Reader Comments

There are no comments for this journal entry. To create a new comment, use the form below.

PostPost a New Comment

Enter your information below to add a new comment.

My response is on my own website »
Author Email (optional):
Author URL (optional):
All HTML will be escaped. Hyperlinks will be created for URLs automatically.