Link a group of facts to <link:roleType> element in taxonomy

Jul 9, 2012 at 2:01 PM

Hello Jeff,

First thank you for your effort to create and support this library. Currently I have a task to create a simple xbrl instance/taxonomy viewer based on Gepsio object model. The required functionality should be similar to XBRL Cloud viewer containing only the basics. The issue I have is that I cannot link a facts group which represents some report to the <link:roleType> elements in the taxonomy (a child node of <annotation><appinfo>) that is related to these facts. See the screens taken from the Cloud viewer and the contents of the zip file.

The "Contents" section list is created from these items and when an item in the menu is selected the related facts are displayed.



    <link:roleType roleURI="" id="FinancialHighlightsSchedule">

      <link:definition>Schedule AA, Part 1: Financial Highlights</link:definition>




I saw in Gepsio's code that you read the annotations in XbrlSchema class, method ReadAnnotations(XmlNode AnnotationNode) but the method processes only the linkbase documents. My question is: is it possible to extend Gepsio to support the "Contents" section to be linked with the facts as in the Cloud viewer?

Thanks in advance,

Jul 9, 2012 at 2:29 PM
Edited Jul 9, 2012 at 2:29 PM

I don't see why that wouldn't be possible. I will take a look at this this evening; I am due to release a new CTP anyway. Keep your eye on this thread; I will most likely write up a blog post explaining how to get at the information you ask, and I will supply the URL of the blog post in this thread.

Thank you very much for providing a sample document ... samples are extremely helpful!

Jul 9, 2012 at 2:47 PM

Thank you for the fast response! I will watch the thread. 

Aug 20, 2012 at 8:24 PM

I'm also interested in this feature as wel. Can you show us a way on how to achieve this?

Aug 21, 2012 at 12:37 PM

I'm looking into this for all of you, and will have more soon. At one point, I thought that I had a property which exposed the <annotation> tag as an XmlNode that you could parse. I don't see it in the code, though. You will indeed to have this node exposed to you, and I will get a fix out to you soon. I'll have more information in a bit, but wanted to send out an update now.

Aug 21, 2012 at 12:59 PM

Gepsio currently reads schema <appinfo> nodes, but only processes the <linkbaseRef> nodes found in the namespace. Gepsio currently silently overlooks the <roleType> child nodes in the namespace. I can add that support pretty easily. Please let me know if you would like me to add this in the next week or so.

Aug 21, 2012 at 5:10 PM

That would be great :)

Aug 22, 2012 at 1:04 PM

It would be nice to have the contents grouping in Gepsio. This functionality will make Gepsio a convenient object model for XBRL instance viewers.

Aug 22, 2012 at 3:23 PM

Thanks for the feedback. This will be my next implementation effort in Gepsio (my philosophy is if users ask for it, then it's important) and it should be out in the next week or so. I'll be sure to post a message when this work is completed. Check the Facebook page at or the blog at for updates.

Thanks for the feedback. You feedback is what makes Gepsio better. Keep it coming, and thank you for using Gepsio!

Aug 23, 2012 at 2:37 PM

I just created an issue for this item so that I can track it. You can see it here. You should be able to subscribe to updates for the issue, if you like, so that you can review its progress.