6.3. Вычисления и валидация

Теперь, когда у нас есть таксономия, позволяющая построить неплохой отчет, настало время приступить к решению ещё одного вопроса – валидация.

Как вы помните, в нашей компании работает один ‘одаренный’ математик. Несмотря на то, что отчет в целом выглядит хорошо, 27 мужчин и 15 женщин никак не могут дать общее количество сотрудников, равное 41.

К счастью, в XBRL есть решение на такой случай – базы ссылок вычислений (calculation linkbases).

6.3.1. Схема таксономии

Нам нужно внести несколько изменений в схему таксономии, чтобы начать использовать базу ссылок вычислений:

Определить связь с базой ссылок;
Разрешить использование необходимых ролей.

6.3.1.1. Связь с базой ссылок

Чтобы включить базу ссылок вычислений в DTS (связанный комплекс таксономий), необходимо определить связь с ней.

<link:linkbaseRef
  xlink:type="simple"
  xlink:href="sample-2006-01-03-calculation.xml"
  xlink:role="http://www.xbrl.org/2003/role/calculationLinkbaseRef"
  xlink:arcrole="http://www.w3.org/1999/xlink/properties/linkbase" />

Мы ссылаемся на документ, содержащий базу ссылок вычислений, с помощью атрибута href. Атрибуту role присваивается значение calcLinkbaseRef, указывающее на тип базы ссылок.

6.3.1.2. Роли вычислений

Есть два вычисления, которые мы можем сделать:

Сумма детальных значений в гендерной иерархии должна давать корректное общее количество сотрудников;
Сумма детальных значений в возрастной иерархии должна давать корректное общее количество сотрудников.

Поскольку у нас определен только один концепт для общего количества сотрудников, в каждом из вычислений должна использоваться своя роль. Забудь мы это, и получим задвоенное общее количество сотрудников – сложатся детальные значения обеих иерархий.

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

<link:roleType
  roleURI="http://www.sample.com/genderDemographics" id="genderDemographics">
  <link:definition>Gender related demographics on employees</link:definition>
  <link:usedOn>link:presentationLink</link:usedOn>
  <link:usedOn>link:calculationLink</link:usedOn>
</link:roleType>
<link:roleType
  roleURI="http://www.sample.com/ageDemographics" id="ageDemographics">
  <link:definition>Age related demographics on employees</link:definition>
  <link:usedOn>link:presentationLink</link:usedOn>
  <link:usedOn>link:calculationLink</link:usedOn>
</link:roleType>

Разрешить использование роли в базе ссылок вычислений – означает просто добавить в нее элемент usedOn со значением calculationLink.

6.3.2. База ссылок вычислений

Начало документа, содержащего базу ссылок, должно выглядеть знакомым для вас.

<?xml version="1.0" encoding="utf-8"?>
<linkbase
  xmlns="http://www.xbrl.org/2003/linkbase"
  xmlns:link="http://www.xbrl.org/2003/linkbase"
  xmlns:xbrli="http://www.xbrl.org/2003/instance"
  xsi:schemaLocation="http://www.xbrl.org/2003/instance
                      http://www.xbrl.org/2003/xbrl-instance-2003-12-31.xsd"
  xmlns:xhtml="http://www.w3.org/1999/xhtml"
  xmlns:xlink="http://www.w3.org/1999/xlink"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" >
</linkbase>

6.3.2.1. Связи с ролями

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

<roleRef
  xlink:type="simple"
  xlink:href="sample-2006-01-03.xsd#genderDemographics"
  roleURI="http://www.sample.com/genderDemographics" />
<roleRef
  xlink:type="simple"
  xlink:href="sample-2006-01-03.xsd#ageDemographics"
  roleURI="http://www.sample.com/ageDemographics" />

Опять же, никаких сюрпризов для вас тут быть не должно.

6.3.2.2. Ссылки вычислений

Мы определяем элемент calculationLink для каждого вычисления, используя роли, чтобы различать их.

<calculationLink
  xlink:type="extended"
  xlink:role="http://www.sample.com/genderDemographics" >
</calculationLink>
<calculationLink
  xlink:type="extended"
  xlink:role="http://www.sample.com/ageDemographics" >
</calculationLink>

6.3.2.3. Локаторы

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

6.3.2.4. Дуги вычислений

Теперь мы наконец можем определить дуги вычислений, объединяющие концепты каждого из разделов отчета с общим количеством сотрудников.

<calculationArc
  xlink:type="arc"
  xlink:arcrole="http://www.xbrl.org/2003/arcrole/summation-item"
  xlink:from="concept_nr_employees_total"
  xlink:to="concept_nr_employees_male"
  weight="1.0"
  order="1" />
<calculationArc
  xlink:type="arc"
  xlink:arcrole="http://www.xbrl.org/2003/arcrole/summation-item"
  xlink:from="concept_nr_employees_total"
  xlink:to="concept_nr_employees_female"
  weight="1.0"
  order="2" />

<calculationArc
  xlink:type="arc"
  xlink:arcrole="http://www.xbrl.org/2003/arcrole/summation-item"
  xlink:from="concept_nr_employees_total"
  xlink:to="concept_nr_employees_age_up_to_20"
  weight="1.0"
  order="1" />
<calculationArc
  xlink:type="arc"
  xlink:arcrole="http://www.xbrl.org/2003/arcrole/summation-item"
  xlink:from="concept_nr_employees_total"
  xlink:to="concept_nr_employees_age_21_to_40"
  weight="1.0"
  order="2" />
<calculationArc
  xlink:type="arc"
  xlink:arcrole="http://www.xbrl.org/2003/arcrole/summation-item"
  xlink:from="concept_nr_employees_total"
  xlink:to="concept_nr_employees_age_41_and_up"
  weight="1.0"
  order="3" />

Для атрибута arcrole указано значение summation-item, означающее, что from-концепт является суммой to-концептов.

Здесь вы можете также увидеть полезный атрибут weight – он определяет коэффициент, на который умножается to-концепт при расчете общей суммы. В нашем случае для простого суммирования мы везде используем коэффициенты ‘1.0’. А для вычитания to-концепта из общей суммы достаточно указать коэффициент ‘-1.0’.

6.3.3. Что в результате?

Когда мы построим отчет в нашем приложении, вот что мы увидим:

Расчет по гендерной демографии привел к ошибке валидации: указанное значение ‘41’ не соответствует рассчитанному значению ‘42’. Все как мы и ожидали.

Но здесь также видно и одно из ограничений базы вычислений: наше приложение для визуализации отчета не смогло определить, для какого факта показать ошибку. Факты по концепту 'Total number employees' (общее количество сотрудников) указаны в каждом разделе отчета, поэтому и ошибка выведена также в каждый раздел.

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

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

6.3.3.1. Корректировка

Если мы исправим данные отчета, изменив количество сотрудников-мужчин на 26, то при формировании отчета ошибки не будет.

Навигация по главам

XBRL: просто о сложном − Глава 6. Погружение в XBRL − Часть 3. Вычисления и валидация