1 Введение
Настоящая спецификация является дополнением к Спецификации XBRL [XBRL 2.1]. В ней определяется синтаксис для объявления двух видов переменных: переменных факта, которые выражаются в последовательности фактов в отчете XBRL, и общих переменных, которые могут выражаться в более широкий диапазон значений. В настоящей спецификации также определяется синтаксис для параметров, которым могут задаваться значения по умолчанию или значения, задаваемые программным обеспечением для обработки.
Переменные XBRL играют важную роль в извлечении информации из отчета XBRL или связанного комплекса таксономий. Переменные XBRL также могут использоваться для определения констант и для определения преобразований информации, доступной в других переменных.
Каждая переменная XBRL подразумевает выражение XPath. Переменная оценивается посредством оценки подразумеваемого XPath в контексте отчета XBRL.
Входной отчет XBRL является единичным действительным отчетом XBRL, в отношении которого переменные оцениваются в рамках модели обработки переменных.
Обратите внимание, что входные отчеты XBRL должны быть действительными в отношении набора переменных, который рассматривает их в качестве входных данных. Они должны быть действительными в том смысле, что они должны соответствовать спецификации XBRL 2.1 и любым спецификациям, связанным с определением модели аспекта набора переменных.
Выражения XPath, подразумеваемые переменными, оцениваются при помощи элемента <xbrli:xbrl> входного отчета XBRL в качестве пункта контекста.
Наряду с определением синтаксиса для переменных, в настоящей спецификации определяется синтаксис для сигнатур пользовательских функций, которые могут использоваться в выражениях XPath и параметрах, на которые могут ссылаться выражения XPath. Эти свойства должны увеличить сферу применения переменных XBRL. Также они предназначены для создания инфраструктуры для дополнительных спецификаций, применяющих переменные XBRL.
Синтаксис для переменных и параметров не поддерживает спецификацию имен, которые могут использоваться в качестве ссылок на переменные XPath. Вместо этого, имена связаны с переменными и параметрами посредством отношений к ресурсам (формулы, утверждения и т. д.), которые обусловлены ими. Это позволяет ссылаться на переменные и параметры при помощи различных имен при использовании в различных контекстах.
Такая гибкость является важной ввиду того, что QName в ссылках на переменные XPath жестко закодированы в выражения XPath. Следовательно, имена переменных и параметров должны быть способны к адаптации, в зависимости от имен, используемых в ссылках на переменные XPath, через которых к ним предоставляется доступ.
1.1 Общая информация
Во многих приложениях XML [XML] вложенная структура ресурсов XML означает, что XPath [XPATH 2.0] или XQuery [XQUERY 1.0] являются естественными и мощными инструментами отбора необходимой информации из ресурсов XML.
По различным причинам Спецификация XBRL [XBRL 2.1] минимально использует обычную иерархическую структуру XML, предусматривая вместо этого относительно неструктурированный синтаксис для отчетов XBRL и для их сопровождающих схем и баз ссылок XML.
Такая структура делает применение XPath или XQuery слишком громоздким для отбора данных из отчетов XBRL на основании их контента и их сопровождающих связанных комплексов таксономий (как минимум, в том случае, когда не используется библиотека пользовательских функций).
Настоящая спецификация предоставляет структуру альтернативного синтаксиса для указания фильтров, которые должны применяться в отношении отчета XBRL для отбора из них необходимых данных (при наличии таковых). Альтернативный синтаксис является открытым в том смысле, что могут быть определены дополнительные фильтры, если их сочтут полезными.
Альтернативный синтаксис является улучшением в сравнении с непосредственным использованием XPath или XQuery, позволяя пользователям работать с различными видами отношений, которые существуют в XBRL, не подвергая их искажениям, связанным с XPath или XQuery.
1.2 Связь с другими работами
Настоящая спецификация обусловлена Спецификацией XBRL [XBRL 2.1].
Настоящая спецификация должна дополняться различными спецификациями отдельных фильтров, в которых указывается точный синтаксис для отбора данных из отчетов XBRL.
1.3 Независимость языка
Официальным языком собственных рабочих продуктов XBRL International является английский язык, а предпочтительным правописанием – британский вариант английского языка.
1.4 Терминология
Термины, используемые в настоящей спецификации, соответствуют определениям терминов, указанных в спецификациях, которыми она обусловлена.
Ключевые слова НЕОБХОДИМО, НЕДОПУСТИМО, ТРЕБУЕТСЯ, ДОЛЖНЫ, ЗАПРЕЩАЕТСЯ, РЕКОМЕНДУЕТСЯ, НЕ РЕКОМЕНДУЕТСЯ, ВОЗМОЖНО, МОЖЕТ и ОПЦИОНАЛЬНО в настоящей спецификации интерпретируются в соответствии с [IETF RFC 2119].
В тех случаях, когда настоящий документ ссылается на схему XML, он ссылается на документ XML [XML], который содержит декларацию схемы, соответствующей Схеме XML [XML SCHEMA STRUCTURES].
1.5 Специальные символы, используемые в документации (ненормативный раздел)
1.5.1 Типографические специальные символы
1.5.1.1 Обозначение определения
Определения выделены текстом зеленого цвета.
1.5.1.2 Обозначение сноски
Комментарии, которые являются информативными, но не ключевыми для понимания соответствующего вопроса, указаны в сносках. Все сноски являются ненормативными.
1.5.1.3 Обозначение элемента и атрибута
Отдельный элемент идентифицируется при помощи префикса пространства имен и локального имени. Например, корневой элемент для элемента контейнера спецификации указывается как <variable:generalVariable>.
Атрибуты также идентифицируются при помощи своего локального имени и префикса пространства имен (при наличии такового). Атрибуты отличаются от элементом посредством указания в префиксе символа @. Таким образом, @id относится к атрибуту с названием id.
При ссылке на атрибут (если у него есть отдельное пространство имен) локальное имя заменяется символом звездочка (*). Таким образом, обозначение @xml:* указывает на атрибут в пространстве имен http://www. w3.org/XML/1998/namespace.
1.5.2 Специальные символы форматирования
Следующее выделение цветом используется для нормативного технического материала в настоящем документе:
Пример 1: Нормативный пример
Текст нормативного примера.
Следующее выделение цветом используется для ненормативных примеров в настоящем документе:
Пример 2: Ненормативный пример
Текст полезного примера.
Следующий абзац полезного примера.
Пример 3 указывает на форматирование ненормативных примеров неправильного, не рекомендованного и неразрешенного использования.
Пример 3: Пример неправильного использования
Сам пример.
1.6 Пространства имен и префиксы пространства имен
Префиксы пространства имен [XML NAMES] используются для элементов и атрибутов в форме ns:name, где ns является префиксом пространства имен, а name является локальным именем. В рамках настоящей спецификации присвоение префиксов пространства имен фактическим пространствам имен соответствует Таблице 1.
Столбец префиксов в Таблице 1 является ненормативным. Столбец URI пространства имен является нормативным.
Таблица 1: Пространства имен и префиксы пространства имен
Префикс | URI пространства имен |
variable | http://xbrl. org/2008/variable |
xbrlve | http://xbrl. org/2008/variable/error |
aspectTest | http://xbrl. org/2008/variable/aspectTest |
eg | http:/// |
fn | http://www. w3.org/2005/xpath-functions |
link | http://www. xbrl. org/2003/linkbase |
xbrli | http://www. xbrl. org/2003/instance |
xfi | http://www. xbrl. org/2008/function/instance |
xbrldi | http://xbrl. org/2006/xbrldi |
xbrldt | http://xbrl. org/2005/xbrldt |
xl | http://www. xbrl. org/2003/XLink |
xlink | http://www. w3.org/1999/xlink |
xs | http://www. w3.org/2001/XMLSchema |
xsi | http://www. w3.org/2001/XMLSchema-instance |
gen | http://xbrl. org/2008/generic |
iso4217 | http://www. xbrl. org/2003/iso4217 |
1.7 Использование XPath
Некоторые атрибуты и элементы, определяемые в настоящей спецификации, содержат значения, которые оцениваются в качестве выражений XPath 2.0 [XPATH 2.0]. В тех случаях, когда в настоящей спецификации упоминается выражение XPath, оно относится к выражению XPath 2.0.
Исключение оценки определяется как статическая ошибка, динамическая ошибка или ошибка типа для выражения XPath.
НЕОБХОДИМО, чтобы все модели данных XQuery/XPath, использованные для обработки XPath, были созданы при помощи соответствующего Информационного набора последующей валидации схемы.
1.7.1 Контекст оценки XPath
Спецификация XPath [XPATH 2.0] требует, чтобы выражения XPath оценивались совместно с контекстом выражения. В настоящем разделе указан способ инициализации компонентов контекста выражения.
|
Из за большого объема этот материал размещен на нескольких страницах:
1 2 3 4 5 6 7 8 9 10 |
Основные порталы (построено редакторами)