Aspect Rule Axis 1.0

Public Working Draft 19 October 2011

This version:: <http://www.xbrl.org/Specification/aspect-rule-axis/PWD-2011-10-19/aspect-rule-axis-PWD-2011-10-19.html>
Editors:: Herm Fischer, Mark V Systems <fischer@markv.com>; Victor Morilla, Banco de España <victor.morilla@bde.es>
Contributors:: Geoff Shuetrim, Galexy Pty. <geoff@galexy.com>; Masatomo Goto, Fujitsu Ltd. <mg@jp.fujitsu.com>; Roland Hommes, RHOCON <roland@rhocon.nl>; Bartosz Ochocki, BRAG <bartosz.ochocki@br-ag.eu>; Hugh Wallis, Standard Dimensions <hugh@standarddimensions.com>

Status

Circulation of this Public Working Draft is unrestricted. This document is normative. Other documents may supersede this document. Recipients are invited to submit comments to rendering-feedback@xbrl.org, and to submit notification of any relevant patent rights of which they are aware and provide supporting documentation.

Abstract

This document specifies semantics and syntax constraints for aspect rule axes. Aspect rule axes provide an implementation of predefined axes, as defined in the table specification.

Comment

1 Herm Fischer:Note to reviewers: please indicate if there is a use case for labels to be constrained to specific link roles, such as to match the composition of a table.

1 Introduction

This document specifies semantics and syntax constraints for aspect rule axes. Aspect rule axes provide an implementation of predefined axes, as defined in the table specification.

2 Definitions

The figure below provides a model of the aspect rule axis.

Figure 1: Aspect Rule Axis Model

An aspect rule axis is an implementation of a predefined axis whose set of coordinates is expressed in terms of a tree of members. The aspect rule axis may have aspect rules.

An aspect rule axis member is an implementation of a predefined axis member that may have aspect rules.

3 Aspect Rules

The aspect rules of a coordinate are defined by formulae aspect rules in the corresponding axis or axis member. In the context of the Formulae specification, aspect rules specify aspect values that the output fact is required to match. In this specification, aspect rules will be used to specify the aspect values that facts that correspond to that coordinate MUST match.

The aspect rules of a member use as source aspect values the required aspect values of its ancestor members. Where the formula specification makes reference to input instances for SAV and output instances for RAV, in this specification SAV become RAV when a source instance of existing facts is used to populate a table.

4 Headers

As described before, the headers of the axis are represented by the set of aspect rule axis members. As axis members are represented using XLink resources in a generic linkbase, they can be associated to generic labels or messages, and generic references. These labels, messages, and references SHOULD be used as labels and references of the headers by a rendering engine. Labels, messages, and references are used in the normal manner of such linkbases, ignoring the link role labels and references. [Herm Fischer: Note to reviewers: please indicate if there is a use case for labels to be constrained to specific link roles, such as to match the composition of a table.]

5 Syntax

An aspectRuleAxis is represented by a <xtable:aspectRuleAxis> element with one or more <xtable:aspectRuleAxisMember> elements connected by an axis-member relationship.

A <xtable:aspectRuleAxisMember> element contains one or more <formula:aspectRule> elements used to specify aspect and aspect constraints for the coordinate.

A <formula:aspectRule> element specifies an aspect and its value for an axis coordinate in a manner that is usable both to select input fact(s) that match, and to use as an entry form specifying output aspects when storing values of empty cells corresponding to the coordinate aspects.

The following <formula:aspectRule> features are not processed: @source (all rules), @augment (unit rule), and omit sub-elements (dimension rules).

The <aspectRuleAxis> and <aspectRuleAxisMember> may have @value XPath expressions, and the @formula:aspectRule may have an XPath expression (such as for QNameExpression or period). The context item for each XPath expression is the fact bound to coordinates of each axis, or the selectionAxis result when applicable (when bound to coordinates of a cell). XPath expressions may refer to parameters and selection axes by name, when in effect.

Appendix A Intellectual property status (non-normative)

This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this paragraph are included on all such copies and derivative works. However, this document itself may not be modified in any way, such as by removing the copyright notice or references to XBRL International or XBRL organizations, except as required to translate it into languages other than English. Members of XBRL International agree to grant certain licenses under the XBRL International Intellectual Property Policy (www.xbrl.org/legal).

This document and the information contained herein is provided on an "AS IS" basis and XBRL INTERNATIONAL DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

The attention of users of this document is directed to the possibility that compliance with or adoption of XBRL International specifications may require use of an invention covered by patent rights. XBRL International shall not be responsible for identifying patents for which a license may be required by any XBRL International specification, or for conducting legal inquiries into the legal validity or scope of those patents that are brought to its attention. XBRL International specifications are prospective and advisory only. Prospective users are responsible for protecting themselves against liability for infringement of patents. XBRL International takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; neither does it represent that it has made any effort to identify any such rights. Members of XBRL International agree to grant certain licenses under the XBRL International Intellectual Property Policy (www.xbrl.org/legal).

Appendix B Acknowledgements (non-normative)

This document could not have been written without the contributions of many people.

Appendix C Document history (non-normative)

Date	Author	Details
01 October 2011	Herm Fischer	Initial draft
11 October 2011	Hugh Wallis	Prepare for DPWD

Appendix D Errata corrections in this document

This appendix contains a list of the errata corrections that have been incorporated into this document. This represents all those errata corrections that have been approved by the XBRL International Rendering Working Group up to and including 19 October 2011.

No errata have been incorporated into this document.