База ссылок таблицы 1.0 (стр. 9 )

Узел отношения определяет обход дерева всех или части одного или нескольких сетей концептов.

Обход дерева, определенный узлом отношения, однозначно идентифицирует часть сети.

Узел отношения разрешается в упорядоченное дерево структурных узлов, представляющих его обход дерева. Каждый структурный узел имен единичный нетэгированный набор ограничений, который ограничивает соответствующий аспект (аспект концепта в случае узла отношения концепта или аспект измерения с явно заданными элементами в случае узла отношения измерения) единственным значением. Порядок узлов одного уровня задается порядком отношений, посредством которого были обнаружены концепты или элементы измерения, связанные с узлами. Упорядоченное расположение узла-родителя и его дочерних элементов определяется самим узлом отношения, а также действительным значением атрибута @parentChildOrder, как описано в Разделе 6.5.3.1.

6.7.1 Синтаксис узла отношения

Каждый конкретный тип узла отношения определяет свой собственный синтаксис и свои собственные правила для поперечного перемещения дерева отношений. В настоящей спецификации определяются два типа узла отношения: узел отношения концепта (Раздел 6.7.4) и узел отношения измерения (Раздел 6.7.5).

Источник отношения указывает на начальный концепт для обхода дерева.

НЕОБХОДИМО, чтобы все узлы отношения указывали, как минимум, на один источник отношения путем указания синтаксиса для источника, прямо указываемого автором базы ссылок таблицы, или путем определения источника отношения по умолчанию в том случае, если он не указан. В случаях, когда указано несколько источников отношения, порядок их указания является существенным и отображается в полученном дереве структурных узлов. В случае дублирования источника отношения тот же обход дерева выполняется по одному разу для каждого дублированного источника.

НЕОБХОДИМО, чтобы каждый узел отношения указывал базовые параметры своего обхода дерева, состоящего из значений свойств formulaAxis и generations.

Свойство formulaAxis является перечислением, разрешенные значения которого ДОЛЖНЫ быть подмножеством следующего набора: descendant, descendant-or-self, child, child-or-self, sibling, sibling-or-self, sibling-or-descendant, sibling-or-descendant-or-self. Эти значения соответствуют значениям свойства ось фильтров отношения концепта [CONCEPT RELATION FILTERS] (с добавлением значения sibling-or-descendant-or-self value, поведение которого аналогично поведению sibling-or-descendant, но включает источник отношения и его потомков). Суффикс - or-self указывает на то, что источники отношения должны быть включены. Если суффикс - or-self отсутствует, представленными концептами верхнего уровня являются дочерние элементы, родители или элементы одного уровня источников отношения.

Обратите внимание, что значение свойства formulaAxis воздействует лишь на те концепты, которые включены в обход дерева. Оно не оказывает воздействие на форму полученного дерева структурных узлов. Например, элементы одного уровня источника отношения всегда рассматриваются как элементы одного уровня, даже в том случае, если они обнаруживаются посредством обхода сети из источника отношения.

Свойство generations является неотрицательным целым числом (xs:nonNegativeInteger), которое ограничивает обход дерева определенным количеством поколению, таким же образом, что и в случае фильтров отношения концепта [CONCEPT RELATION FILTERS]. Значение generations = 0 приводит к неограниченному обходу дерева. Источники отношения не учитываются при расчете глубины обхода дерева, например, значение generations = 1 с formulaAxis = descendant эквивалентно указанию formulaAxis = child.

Если значение formulaAxis равно child, child-or-self, sibling или sibling-or-self, то НЕОБХОДИМО, чтобы значение generations было 0 или 1.

НЕОБХОДИМО, чтобы код ошибки xbrlte:relationshipNodeTooManyGenerations был сообщен в том случае, если программное обеспечение для обработки сталкивается со значением formulaAxis, которое предполагает обход дерева с одним поколением в сочетании со значением поколений больше 1.

6.7.2 Выражения узла отношения

Узлы отношения предлагают альтернативный способ выражения некоторых свойств; при помощи выражений XPath. НЕОБХОДИМО, чтобы результат оценки такого выражения XPath мог быть приведен к типу данных эквивалентного элемента, не являющегося выражением.

НЕОБХОДИМО, чтобы код ошибки xbrlte:expressionNotCastableToRequiredType был выдан в том случае, если встречается выражение XPath, которое не может быть приведено к необходимому типу.

Выражения XPath, используемые для указания свойств узла отношения, не имеют пункта контекста. Однако они могут ссылаться на параметры таблицы и на глобальные параметры, определенные в DTS.

6.7.3 Ярлыки узла отношения

НЕДОПУСТИМО, чтобы узлы отношения имели ярлыки, указанные в Разделе 6.5.2. РЕКОМЕНДУЕТСЯ, чтобы в ходе разрешения процессор добавлял ярлыки, в соответствии с Разделом 7.4.

6.7.4 Узел отношения концепта

Узел отношения концепта является узлом отношения, который описывает дерево значений для аспекта концепта в терминах обхода дерева сети отношений концепт-концепт.

Узлы отношения концепта обнаруживают концепты путем выполнения обхода дерева сети XBRL 2.1. Обход дерева уникально идентифицируется сетью и одним или несколькими источниками отношения. НЕОБХОДИМО, чтобы узел отношения концепта идентифицировал одну сеть. В большинстве случаев сочетания роли ссылки и роли дуги достаточно для однозначной идентификации сети, но это может потребоваться для указания дополнительной информации, такой как имя дуги или имя расширенной ссылки.

НЕОБХОДИМО, чтобы код ошибки xbrlte:ambiguousConceptNetwork был сообщен в том случае, если программное обеспечение для обработки сталкивается с узлом отношения концепта, который предоставляет недостаточно информации для однозначной идентификации единичной сети.

Указание свойств, для которых в DTS отсутствуют совпадающие отношения, не является ошибкой для узла отношения концепта. В этом случае отношения не обнаруживаются, но сами источники отношения все равно обрабатываются.

Участвующим аспектом узла отношения концепта является аспект концепта.

Как описано в Разделе 6.5.6, узлы отношения концепта не могут иметь поддеревья.

6.7.4.1 Синтаксис узла отношения концепта

Синтаксис узлов отношения концепта определяется нормативной схемой, предоставленной вместе с настоящей спецификацией.

Узел отношения концепта МОЖЕТ включать любое количество элементов <table:relationshipSource> или <table:relationshipSourceExpression>, каждый из которых содержит, соответственно, QName (xs:QName) или выражение XPath, которое определяется как QName, указывающее на единичный источник отношения для обхода дерева. В том случае, если указывается источник отношения, НЕОБХОДИМО, чтобы он был:

QName концепта, который существует в DTS, или особым значением xfi:root.

НЕОБХОДИМО, чтобы код ошибки xbrlte:invalidConceptRelationshipSource был сообщен в том случае, если программное обеспечение для обработки сталкивается с источником отношения, который не является ни QName концепта, существующего в DTS, ни особым значением xfi:root.

Особое значение xfi:root представляет собой виртуальный концепт, который имеет в качестве своих дочерних элементов корневые концепты указанной сети. При разрешении узла отношения концепта при помощи источника отношения <xfi:root> НЕОБХОДИМО, чтобы процессор базы ссылок таблицы упорядочивал корневые концепты сети, в соответствии с их QName, как указано в Разделе 6.7.4.3

Если источник отношения не указан, допускается особое значение xfi:root.

Элемент <table:arcrole> или <table:arcroleExpression>, соответственно, является непустым URI (xl:nonEmptyURI) или выражением, которое определяется как непустой URI. В любом случае этот URI идентифицирует роль дуги сети (сетей).

Элемент <table:linkrole> или <table:linkroleExpression>, соответственно, является непустым URI (xl:nonEmptyURI) или выражением, которое определяется как непустой URI. В любом случае этот URI идентифицирует роль ссылки сети (сетей). Если роль ссылки не указана, используется стандартная роль ссылки.

Элемент <table:linkname> или <table:linknameExpression>, соответственно, является QName (xs:QName) или выражением XPath, которое определяется как QName. Оно указывает на имя элемента расширенной ссылки, определяющего сеть (сети).

Элемент <table:arcname> или <table:arcnameExpression>, соответственно, является непустым QName (xl:QName) или выражением XPath, которое определяется как QName. Оно указывает на имя дуг, составляющих сеть (сети).

Элементы <table:linkname> и <table:arcname> (и соответствующие эквиваленты, основанные на выражении) являются опциональными и подлежат включению лишь в том случае, если они требуются для уникальной идентификации сети.

Если в указанной сети не обнаруживаются отношения, лишь источники отношения включаются в полученное дерево.

Если полученное дерево является пустым (например, ввиду того, что сами источники отношения исключаются посредством выбора formulaAxis), тогда это представляет собой ошибку, как описано в Разделе 6.5.3.

Элемент <table:formulaAxis> или <table:formulaAxisExpression> (при наличии) указывает на значение свойства formulaAxis, как указано в Разделе 6.7.1. В случае отсутствия элементов принимается значение descendant-or-self.

Поведение узлов отношения концепта с каждым сочетанием источника отношения и элемента <table:formulaAxis> описывается в Таблице 2 ниже.