Атрибут @bindAsSequence общих переменных имеет последствия для их оценки, в соответствии с Разделом 4.1
3.4 Переменные факта XBRL
Переменная факта объявляется элементом <variable:factVariable>.
Синтаксис для элемента <variable:factVariable> определяется нормативной схемой, предоставленной вместе с настоящей спецификацией.
Атрибут @bindAsSequence переменных факта имеет последствия для их оценки, в соответствии с Разделом 4.1
Опциональный атрибут @fallbackValue переменных факта имеет последствия для их оценки, в соответствии с Разделом 4.2.
Выражение XPath, подразумеваемое переменной факта, обусловлено его фильтрами.
Если атрибут @nils переменной факта опускается или равен false, то выражение XPath, подразумеваемое переменной факта, начинается с:
xfi:non-nil-facts-in-instance(/xbrli:xbrl)
Если атрибут @nils переменной факта равен true, то выражение XPath, подразумеваемое переменной факта, начинается с:
xfi:facts-in-instance(/xbrli:xbrl)
После этого терма следует предикат XPath, который фильтрует факты в последовательности, полученной при помощи функции xfi:facts-in-instance(/xbrli:xbrl) или функции xfi:non-nil-facts-in-instance(/xbrli:xbrl). Выражение в предикате XPath включает выражение XPath, подразумеваемое каждым из фильтров переменной факта.
Переменная факта может использовать фильтр или дополнение фильтра для определения своего подразумеваемого выражения XPath. Дополнение фильтра отбирает все факты, которые не отобраны фильтром.
Выражение XPath, подразумеваемое дополнением фильтра, является функцией fn:not(), примененной к выражению XPath, подразумеваемому фильтром.
Если переменная факта использует фильтр, а не его дополнение, тогда выражение XPath, подразумеваемое этим фильтром, окружено круглыми скобками ( и ) перед включением в выражение XPath, подразумеваемое переменной факта.
Если переменная факта использует дополнение фильтра, а не фильтр, тогда выражение XPath, подразумеваемое дополнением фильтра, не изменяется перед включением в выражение XPath, подразумеваемое переменной факта.
Для получения полного выражения XPath в предикате XPath, выражения XPath, подразумеваемые фильтрами и дополнениями фильтра, совмещаются при помощи базового элемента and для образования единичного и-выражения XPath.
3.4.1 Фильтры
Фильтр определяет критерии отбора для фактов во входном отчете XBRL.
Входной факт является фактом в фильтруемом входном отчете XBRL.
Фильтры выражают критерии, которые могут быть применены ко входным фактам. Такие критерии включаются в выражения XPath, подразумеваемые переменными факта.
Фильтры объявляются как ресурсы XLink в расширенных ссылках XLink. НЕОБХОДИМО, чтобы фильтры были в группе подстановки для абстрактного элемента <variable:filter>.
Фильтр может покрывать аспект, если он отбирает факты, используя этот аспект в качестве критерия отбора.
Непокрытый аспект переменной факта является аспектом, который не покрыт фильтрами, используемыми для построения выражения XPath, подразумеваемого переменной.
НЕОБХОДИМО, чтобы каждая спецификация фильтров указывала аспекты (при наличии таковых), которые фильтр может покрыть.
Покрывающий фильтр является фильтром, который покрывает аспект или аспекты, которые он может покрыть.
Непокрывающий фильтр является фильтром, который не покрывает аспект или аспекты, которые он может покрыть.
В связи между фильтром и переменной факта, использующей фильтр, указывается то, является ли фильтр покрывающим или непокрывающим.
НЕОБХОДИМО, чтобы все фильтры подразумевали выражение XPath, которое представляет собой суть оценки факта в качестве пункта контекста. Выражение XPath указывает на характер обработки для включения или отклонения факта-кандидата в отфильтрованный результирующий набор, однако в нем не обязательно указана вся структура интерфейса, условное исполнение и кодирование ошибок, которое может потребоваться.
НЕОБХОДИМО, чтобы каждая спецификация фильтров включала такое определение выражения XPath, которое подразумевается фильтром.
Операции по обработке выражения XPath, подразумеваемого фильтром, и вызовы функции подразумевают обработку в виде операций XPath и вызовов функции, их синтаксис аргумента и подразумеваемую проверку типа, а также операционные исключения, которые могут иметь место в том случае, если реализация включила выражение XPath. Если же реализация использует другое кодирование для эквивалентных операций, поведения функции, проверки типа и операционных исключений, она должна выявить и сообщить о тех же ошибках и условиях, которые были бы сообщены самим XPath, кроме случаев, когда спецификация фильтр предусматривает другой механизм выявления и сообщения об ошибках по сравнению с механизмом, подразумеваемым выражением XPath. В том случае, если спецификация фильтра описывает механизм выявления и сообщения об ошибках, который отличается от подразумеваемого самим XPath, спецификация фильтра имеет преимущественную силу.
Выражение XPath, подразумеваемое фильтром, МОЖЕТ включать ссылки на переменные XPath. Разрешение ссылок на переменные XPath в выражениях XPath, подразумеваемых фильтрами, выходит за рамки предмета настоящей спецификации. Разрешение таких ссылок на переменные XPath должно быть определено спецификациями, созданными на основании настоящей спецификации. В таких спецификациях должен указываться способ связи переменных с QName, использованными для ссылок на переменные XPath.
Покрывающие фильтры могут отбирать лишь те факты, которые имеют покрываемые ими аспекты. Не предполагается успешное применение подразумеваемого выражения XPath к фактам без покрытых аспектов. Ожидается, что реализация будет при необходимости предусматривать такое кодирование в своей структуре интерфейса, с тем чтобы операции и аргументы функции подразумеваемого XPath не принимали неприемлемые факты.
Не ожидается, что фильтры будут расположены в какой-либо последовательности. При этом они могут быть оптимизированы, а их результаты – кэшированы, если они не зависят от других переменных набора.
Фильтры, которые не являются покрывающими (например, общий фильтр), могут иметь явные выражения XPath, предназначенные для определенных видов данных, таких как числовые операции. Несмотря на то, что такой фильтр может быть совмещен с другими фильтрами, которые ограничивают факты определенными концептами типов данных, ввиду того, что фильтры могут применяться (и кэшироваться) в любом порядке, таким выражениям требуется защитное кодирование для предотвращения исполнения запрещенных операций при необходимости. Например, в общем фильтре числовые операции должны быть защищены путем расположения в выражении if, что препятствует исполнению в отношении нечисловых фактов, так как общий фильтр может обеспечить исполнение выражения XPath в любое время и с любым фактом в качестве своего пункта контекста.
Пример 4: Ссылки на переменные XPath в выражениях фильтра
В спецификации фильтра МОЖЕТ указываться «Использование XPath идентично тому, которое указано в Спецификации XBRL Переменные (с гиперссылкой на настоящий документ)». Если такое указано, фильтр с отношениями переменная-фильтр к переменной факта МОЖЕТ иметь выражение XPath, содержащее ссылки на переменные XPath на переменные и параметры, используя QName атрибутов @name отношений переменная-набор ресурса набора переменных.
Факт отвечает критериям, указанным фильтром, лишь в том случае, если результат оценки выражения XPath, подразумеваемого этим фильтром, используя факт в качестве пункта контекста, имеет действительное булево значение true. Если фильтр покрывает аспект, которого нет у факта, результат фильтр является действительным булевым значением false без необходимого исполнения выражения XPath (применимость аспекта реализуется при помощи связывающего при помощи интерфейса кода реализации, который не обязательно описывается в качестве части подразумеваемого выражения XPath).
Фильтры МОГУТ быть связаны с переменными факта следующими тремя способами:
- Явно, посредством отношений переменная-фильтр (См. Раздел 3.4.1.1) Явно, посредством отношений набор переменных-фильтр (См. Раздел 3.5.2) Неявно (См. Раздел 3.5.3)
Все способы связывания фильтров с переменными факта указывают на то, покрывает ли фильтр аспекты, и использует ли переменная факта фильтр или дополнение фильтра.
3.4.1.1 Отношения переменная-фильтр
Отношение переменная-фильтр является отношением между переменной факта и фильтром, выраженным дугой XLink.
Для объявления отношения переменная-фильтр НЕОБХОДИМО, чтобы дуга XLink:
- имела значение роли дуги равное http://xbrl. org/arcrole/2008/variable-filter имела переменную факта в начальном ресурсе дуги имела фильтр в конечном ресурсе дуги
Значение роли дуги, http://xbrl.org/arcrole/2008/variable-filter, объявляется в нормативной схеме, предоставляемой вместе с настоящей спецификацией.
НЕОБХОДИМО, чтобы отношения переменная-фильтр выражались дугами переменная-фильтр. Нарушение этого требования может быть выявлено посредством валидации относительно Спецификации XBRL [XBRL 2.1].
Дополненное отношение переменная-фильтр является отношением переменная-фильтр, которое выражено дугой с атрибутом @complement со значением true.
Переменная факта с дополненным отношением переменная-фильтр к фильтру использует дополнение фильтра в его подразумеваемом выражении XPath, а не в самом фильтре.
Покрывающее отношение переменная-фильтр является отношением переменная фильтр, которое выражено дугой с атрибутом @cover со значением true.
|
Из за большого объема этот материал размещен на нескольких страницах:
1 2 3 4 5 6 7 8 9 10 |
Основные порталы (построено редакторами)