Комплект соответствия базы ссылок таблицы 1.0
Публичная рабочая версия от 19 октября 2011 г.
Авторское право © 2011 XBRL International Inc., все права защищены
Данное издание:
<http://www. xbrl. org/WGN/table-linkbase-conformance/PWD-2011-10-19/table-linkbase-conformance-WGN-PWD-2011-10-19.html>
Редакторы:
Хью Уоллис (Hugh Wallis), Standard Dimensions <*****@***com>
Герм Фишер (Herm Fischer), Mark V Systems <*****@***com>
Автор:
Ролан Ом (Roland Hommes), RHOCON <*****@***nl>
Статус
Оборот настоящей публичной рабочей версии неограничен. Прочие документы могут замещать настоящий документ. Получатели могут предоставлять комментарии через *****@***org, а также отправлять уведомления о патентных правах, о которых им известно, и предоставлять подтверждающую документацию.
Краткое содержание
Настоящий документ является Примечанием Рабочей группы, в котором описывается Комплект соответствия базы ссылок таблицы. В нем указана важная информация для понимания пользователями структуры и содержания файлов Комплекта соответствия, а также их использования. Настоящий документ является проектом на ранней стадии, так как комплект соответствия лишь начал разрабатываться.
Содержание
1 Введение
2 Структура
3 Обработка
4 Нормативные схемы
4.1 Файл индекса тестовых сценариев
4.2 Файл вариаций тестовых сценариев
5 Статус интеллектуальной собственности (ненормативный раздел)
6 Список благодарностей от коллектива авторов (ненормативный раздел)
Приложения
A История создания документа (ненормативный раздел)
B Корректировочный лист, включенный в настоящий документ
1 Введение
Настоящий документ является Примечанием Рабочей группы, в котором описывается Комплект соответствия базы ссылок таблицы. В нем указана важная информация для понимания пользователями структуры и содержания файлов Комплекта соответствия, а также их использования. Настоящий документ является проектом на ранней стадии, так как комплект соответствия лишь начал разрабатываться.
2 Структура
Структура комплекта соответствия аналогична структуре других комплектов соответствия: каждый набор тестов находится в папке под папкой tests-report. Каждая такая вложенная папка имеет имя в форме NNNN-module, где NNNN является четырехзначным числом, указывающим на набор тестов, а module указывает на модуль спецификации базы ссылок таблицы, к которому относятся тесты.
Во вложенной папке table для каждого из этих наборов содержатся тесты, которые являются файлами, содержащими ожидаемый результат каждого из тестов. Ожидаемый результат является минимальным файлом html со структурой и содержанием таблицы (таблиц) html, которые отражают вид, созданный при помощи базы ссылок таблицы. Если база ссылок таблицы имеет множественные варианты z-оси, тогда множественные таблицы расположены последовательно в файле таблицы в порядке документа вариантов z-оси. Каждая таблица ожидаемых результатов содержит достаточную информацию о стиле html для того, чтобы быть минимально воспроизведенной браузером для демонстрации ожидаемых заголовков (строка/столбец заголовка, слияние/заполнение) и содержания ячеек.
- Использование html во вложенной папке ожидаемых результатов не предполагает, что тестируемый инструмент должен создавать html, или что инструмент, создающий html в дополнение к другому просмотру и воспроизведению, тестируется исключительно в выходном элементе html. Html в качестве формы ожидаемого результата был выбран исключительно вследствие его повсеместности; инструмент теста сравнивает его полученный вид, форму или семантику для воспроизведения (или даже внутренние структуры данных) со структурой и семантикой, собранной из ожидаемого результата.
В папке conf существует файл индекса верхнего уровня testcases-index. xml. Этот файл указывает на файлы тестовых сценариев, которые содержат варианты теста.
Сами тесты и их описания (вместе с необходимыми файлами: схемами и т. д.) перечислены в каждом файле тестового сценария. Каждый тест называется вариацией и указывает на входные данные <data> и на ожидаемый результат <result>. Результат может включать ошибки и созданные таблицы. Для каждой ошибки указана <error> (по ее указанному QName), и единый файл результатов <table> указывается с прототипом всех получаемых таблиц. Спецификация таблицы со множественными z-осями может создавать множественные результаты таблицы, но их прототипы содержатся в выходном файле единой таблицы.
На данный момент все доступные тесты содержатся в папке 1000-aspect-rules-axis. По мере развития настоящей спецификации будут добавлены дополнительные тесты, а настоящий документ будет обновлен.
3 Обработка
Файл индекса используется для запуска загрузки инструментом тестирования каждого доступного файла вариации тестового сценария.
Каждый файл вариации тестового сценария содержит отдельные вариации теста, которые указывают на входные данные для теста в разделе <data>. Дочерний элемент <data> с @readMeFirst = true является точкой входа для отчета или загрузки DTS. Тест может загружать точку входа DTS (схему или базу ссылок), если он должен создать структуру таблицы без образцов содержания данных в ячейках, и если ему не нужна контекстуальная информация, предоставляемая внутри текста, или может загружать отчет XBRL в качестве входа, если ему необходима контекстуальная информация и/или пункты факта.
Ошибки в ходе обработки, которые будут выявляться при помощи входных элементов вариации, согласовываются с элементами <error> в <result> для вариации.
Если <result> вариации создает <table>, тогда комплект тестов анализирует вид, созданный при помощи инструмента в рамках теста, и сравнивает его со структурой и содержанием ожидаемого результата. Инструмент, сравнивающий созданный вид с ожидаемым результатом, способен сравнивать информацию о структуре (заголовки столбца и строки, заголовки столбца и строки, которые сливаются/заполняются, и содержание ячеек сетки) с точки зрения структурной семантики, и не должен анализировать эти характеристики таблицы html как представляющие стиль и воспроизведение. Стиль и воспроизведение минимально указаны в комплекте тестов для того, чтобы полученная таблица могла быть просмотрена в обычном браузере.
4 Нормативные схемы
4.1 Файл индекса тестовых сценариев
<xs:schema
xmlns:xs=" h t t p : / / w w w . w 3 . o r g / 2 0 0 1 / X M L S c h e m a " elementFormDefault="qualified">
<xs:elementname="testcase">
<xs:complexType>
<xs:attributename="uri" use="required" type="xs:anyURI"/>
</xs:complexType>
</xs:element>
<xs:elementname="testcases">
<xs:complexType>
<xs:sequence>
<xs:elementref="testcase" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attributename="name" use="required" type="xs:string"/>
<xs:attributename="date" use="required" type="xs:date"/>
</xs:complexType>
</xs:element>
</xs:schema>
4.2 Файл вариаций тестовых сценариев
<xs:schema
xmlns:xs=" h t t p : / / w w w . w 3 . o r g / 2 0 0 1 / X M L S c h e m a "
xmlns:conf=" h t t p : / / x b r l . o r g / 2 0 0 8 / c o n f o r m a n c e " targetNamespace=" h t t p : / / x b r l . o r g / 2 0 0 8 / c o n f o r m a n c e " elementFormDefault="qualified" attributeFormDefault="unqualified">
<xs:elementname="testcase">
<xs:complexType>
<xs:sequence>
<xs:elementref="conf:creator"/>
<xs:elementname="number" type="xs:string"/>
<xs:elementname="name" type="xs:string"/>
<xs:elementref="conf:description"/>
<xs:elementref="conf:reference" minOccurs="0" maxOccurs="unbounded"/>
<xs:elementref="conf:variation" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:elementname="creator">
<xs:complexType>
<xs:sequence>
<xs:elementname="name" type="xs:string"/>
<xs:elementname="email" type="xs:string"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:elementname="description" type="xs:string"/>
<xs:elementname="reference">
<xs:complexType>
<xs:attributename="specification" type="xs:string"/>
<xs:attributename="id" type="xs:string"/>
</xs:complexType>
</xs:element>
<xs:elementname="variation">
<xs:complexType>
<xs:sequence>
<xs:elementref="conf:creator" minOccurs="0"/>
<xs:elementname="number" type="xs:string" minOccurs="0"/>
<xs:elementname="name" type="xs:string" minOccurs="0"/>
<xs:elementref="conf:description"/>
<xs:elementref="conf:reference" minOccurs="0" maxOccurs="unbounded"/>
<xs:elementref="conf:data"/>
<xs:elementref="conf:result"/>
</xs:sequence>
<xs:attributename="id" type="xs:ID" use="optional"/>
</xs:complexType>
</xs:element>
<xs:elementname="data">
<xs:complexType>
<xs:choicemaxOccurs="unbounded">
<xs:elementref="conf:schema"/>
<xs:elementref="conf:linkbase"/>
<xs:elementref="conf:instance"/>
<xs:elementref="conf:parameter"/>
<xs:elementref="conf:filter"/>
</xs:choice>
</xs:complexType>
</xs:element>
<xs:elementname="schema" type="conf:inputFileType"/>
<xs:elementname="linkbase" type="conf:inputFileType"/>
<xs:elementname="instance" type="conf:inputFileType"/>
<xs:complexTypename="inputFileType">
<xs:simpleContent>
<xs:extensionbase="xs:string">
<xs:attributename="id" type="xs:ID" use="optional"/>
<xs:attributename="readMeFirst" type="xs:boolean" use="optional" default="false"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:elementname="parameter">
<xs:complexType>
<xs:attributename="name" type="xs:QName"/>
<xs:attributename="datatype" type="xs:QName"/>
<xs:attributename="value" type="xs:string"/>
</xs:complexType>
</xs:element>
<xs:elementname="filter">
<xs:complexType>
<xs:attributename="file" type="xs:IDREF"/>
<xs:attributename="id" type="xs:IDREF"/>
</xs:complexType>
</xs:element>
<xs:elementname="result">
<xs:complexType>
<xs:choicemaxOccurs="unbounded">
<xs:elementname="assertionTests">
<xs:complexType>
<xs:attributename="assertionID" type="xs:string"/>
<xs:attributename="countSatisfied" type="xs:integer"/>
<xs:attributename="countNotSatisfied" type="xs:integer"/>
</xs:complexType>
</xs:element>
<xs:elementname="filterTest" type="xs:string"/>
<xs:elementname="instance" type="xs:anyURI"/>
<xs:elementname="table" type="xs:anyURI"/>
<xs:elementname="error" type="xs:QName"/>
</xs:choice>
<xs:attributename="expected" use="optional">
<xs:simpleType>
<xs:restrictionbase="xs:token">
<xs:enumerationvalue="valid"/>
<xs:enumerationvalue="invalid"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
</xs:element>
</xs:schema>
5 Статус интеллектуальной собственности (ненормативный раздел)
Настоящий документ и его переводы могут копироваться и предоставляться другим лицам, а производные работы, которые комментируют или объясняют его, а также помогают в его интерпретации, могут предоставляться, копироваться, публиковаться и распространяться (в полном или частичном объеме) без ограничений любого характера, при условии, что вышеуказанное уведомление об авторском праве и настоящий абзац излагаются во всех таких копиях и производных работах. Однако, в настоящий документ нельзя вносить изменения (такие как, например, удаление уведомления об авторском праве или ссылок на XBRL International или организации XBRL), за исключением тех изменений, которые требуются для перевода с английского языка на другие языки. Члены XBRL International соглашаются предоставить определенные лицензии в рамках Политики интеллектуальной собственности XBRL International ( w w w . x b r l . o r g / l e g a l ).
Настоящий документ и содержащаяся в нем информация предоставляются на условиях «как есть» и XBRL INTERNATIONAL ОТКАЗЫВАЕТСЯ ОТ ВСЕХ ГАРАНТИЙ (ПРЯМЫХ ИЛИ ПОДРАЗУМЕВАЕМЫХ), ВКЛЮЧАЯ, БЕЗ ОГРАНИЧЕНИЯ, ГАРАНТИИ ТОГО, ЧТО ИСПОЛЬЗОВАНИЕ ИЗЛАГАЕМОЙ В НАСТОЯЩЕМ ДОКУМЕНТЕ ИНФОРМАЦИИ НЕ НАРУШАЕТ ПРАВА ИЛИ ПОДРАЗУМЕВАЕМЫЕ ГАРАНТИИ КОММЕРЧЕСКОЙ ВЫГОДЫ ИЛИ ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
Обращается внимание пользователей настоящего документа на возможность того, что соблюдение или принятие спецификаций XBRL International может потребовать использования изобретения, на которое распространяются патентные права. XBRL International не несет ответственность за указание патентов, в отношении которых для спецификации XBRL International может потребоваться лицензия, или за наведение справок о правовой силе или предмете этих патентов, которые доводятся до его сведения. Спецификации XBRL International носят исключительно потенциальный и консультативный характер. Потенциальные пользователи несут ответственность за свою защиту в отношении ответственности за нарушение патентов. XBRL International не высказывает мнение по поводу правовой силы или предмета прав интеллектуальной собственности или других прав, которые могут быть предъявлены для того, чтобы иметь отношение к реализации или использованию технологии, описанной в настоящем документе, или по поводу того, насколько доступной может быть такая лицензия в рамках таких прав; а также XBRL International не заверяет, что она приложила усилия для установления таких прав. Члены XBRL International соглашаются предоставить определенные лицензии в рамках Политики интеллектуальной собственности XBRL International ( w w w . x b r l . o r g / l e g a l ).
6 Список благодарностей от коллектива авторов (ненормативный раздел)
Этот документ не был бы написан без вклада многих людей.
Приложение A История создания документа (ненормативный раздел)
Дата | Автор | Подробности |
14 октября 2014 г. | Хью Уоллис | Первоначальная редакция. |
14 октября 2011 г. | Герм Фишер | Уточнил применение ожидаемых результатов в таблицах html. Добавил раздел об обработке. |
Приложение B Корректировочный лист, включенный в настоящий документ
Это приложение содержит список замеченных опечаток, которые были включены в этот документ. Он представляет все те исправления опечаток, которые были одобрены Международной рабочей группой по подготовке рендеринга XBRL, вплоть до 19 октября 2011 года. Гиперссылками на соответствующие обсуждения по электронной почте могут пользоваться только те лица, которые имеют доступ к соответствующим спискам рассылки. Доступ ко внутренним спискам рассылки XBRL ограничивается членами XBRL International Inc.
В настоящем документе отсутствуют опечатки.
