Выгрузка XBRL: различия между версиями

Материал из OrticonWiki
Перейти к навигации Перейти к поиску
Нет описания правки
Praktik (обсуждение | вклад)
Нет описания правки
 
(не показано 6 промежуточных версий 2 участников)
Строка 1: Строка 1:
[[Описание конфигурации XBRL]]
Для выгрузки данных в XBRL в продукте реализован механизм работы со слоями таксономии: слой определений (definition), задающий гиперкубы отчетности, слой контрольных соотношений и табличный слой (модели отчетов таксономии). Выгрузка производится за счет меппинга внутренних моделей в слой определений (definition). Меппинг позволяет очень гибко настроить соответствие данных отчета и элементов гиперкуба, включая следующие возможности:
1. Преобразование пересечений строк и колонок отчета в элемент XBRL и совокупность аналитических признаков (значений осей гиперкуба).
2. Расчет периода на основании периода отчета, включая расчет рабочих дней (по регламентированному календарю).
3. Расчет значений открытых осей по произвольной формуле.
4. Преобразование значения пересечения в данные закрытой оси, перечисления (enumerator), разрядности (decimals) и единицы измерения (unit). Преобразование в элемент закрытой оси и перечисления может быть, как по значению лейбла (описания признака) таксономии, так и по произвольному значению. Это позволяет, например, преобразовать код операции отчета о движении денежных средств без необходимости указывать полную строку, соответствующую данным таксономии на 100%.
5. Для каждого элемента можно установить невыгружаемое значение (например, «#»), разрядность, единицу измерения (для монетарных типов).
6. Для элементов можно установить отбор по таблице, например, для совмещения в од-ной таблице итоговых и детальных записей, которые в таксономии разделены на не-сколько ролей. Также подобный подход позволяет выгрузить такие отчета, как ОСВ и ОФР, указывая отбор счета и символа ОФР для соответствующего выгружаемого элемента.
Вместе с гибкостью настройки меппинг предполагает и дополнительные трудозатраты, поэтому в продукте реализован механизм автоматического меппинга отчета на основа-нии табличного слоя таксономии, который сам по себе является меппингом для гипуркубов отчетности. В настоящее время данная технология находится в разработке, поэтому в продукте доступен только ограниченный функционал меппинга закрытых моделей и открытых реестровых отчетов без оси У.
Выгрузка файла XBRL может быть произведена из регламентированного отчета по соответствующей кнопке, либо из списка документов.
{| style="margin:auto; clear:both;"
|
{| class="wikitable" style="float:left; margin-right:1.4em;"
|-
| [[Файл:577158.jpg|770px]]
|}
{| class="wikitable" style="float:left; margin-right:1.4em;"
|-
| [[Файл:637503.jpg|500px]]
|}
|}
По кнопке будет доступна форма формирования файла XBRL:
[[File:333563.jpg|center|700px]]
Для начала выберем схему меппинга по ссылке:
[[File:478584.jpg|center|700px]]
[[File:459749.jpg|center|700px]]
После выбора схемы нужно указать расположение файла выгрузки и задать ему имя, если предложенное системой не устраивает.
[[File:988673.jpg|center|700px]]
Стоит иметь ввиду, что в клиент-серверном варианте использования решения есть возможность сохранить файл прямо на сервер (особенно, если файл больше 4 Гб и не может быть доставлен на клиентской компьютер) – для этого используйте галочку «Сохранять на сервере», но и путь должен быть серверный или в общую сетевую папку (желательно, чтобы она находилась на компьютере, на котором запущен процесс сервера 1С, особенно если файл большой).
После того, как имя файла выбрано, нажмите «Сохранить XBRL».
По кнопке «'''Сохранить XBRL'''» производится формирование инстанса, по кнопке «'''Создать пакет'''» производится создание Zip-архива с сервисным файлом – XBRL-пакета. При этом все прикрепленные к документу «Регламентированный отчет», для которого была нажата кнопка «XBRL», будут помещены в пакет и отражены в сервисном файле.
Также, если это необходимо, по кнопке «Пространства имен» есть возможность включить в заголовок XBRL-файла необходимые сторонним продуктам дополнительные пространства имен.
Сохраненный файл можно провалидировать встроенным механизмом для проверки бизнес-правил, который открывается по кнопке «Валидация», но лучше пользоваться визуализацией нарушений бизнес-правил в инструменте «Работа с табличным слоем XBRL».
[[File:137835.jpg|center|700px]]
<span style="font-size: 130%">'''ЛОГ'''</span>
Лог, который генерирует процессор XBRL, доступен сразу же по кнопке «Лог», которая появится после начала формирования файла XBRL. В нем отражается информация о выгружаемых отчетных ролях, времени ее выгрузки и проблемах, возникших при этом.
[[File:600743.jpg|center|700px]]
Самой распространенной, но не критической проблемой является пустое значение показателя (пустая строка, прочерк, решетка, ноль).
Следующая проблема – преобразование типов. Процессор пытается преобразовать строки в числа, удаляя лишние пробелы и меняя запятую на точку. Также система пытается преобразовать дату из строки – для этого она удаляет точку и косую черту из строки. Таким образом даты в формате «ГГГГ-ММ-ДД» не смогут быть выгружены. Дата, которая точно выгрузится из строки, должна быть в виде «ДД.ММ.ГГГГ».
Также в логе отражаются коллизии, если значения коллизий не отличаются, будет сформировано сообщение о том, что на контекст повторно попало значение. Если значения были разные, то инстанс будет выгружен только в том случае, если стоит галочка «Игнорировать ошибки». Данные критические ошибки попадают в красный лог.
Также в лог попадают сообщения о том, что в сопоставлении роли не найдена та или иная ось при обработке данных модели. Данные сообщения могут выводиться для отчетов, которые разделены на несколько ролей. Например, в отдельную роль вынесены долевые ценные бумаги, а в другую – долевые. В итоге информация о том, что при выгрузке роли с долевыми ЦБ не найдены оси для долговых, попадет в лог и, соответственно, наоборот.
Итак, в логе собирается следующая информация:
1. Имена выгружаемых ролей.
2. Время выгрузки роли в миллисекундах.
3. Факты, которые не были выгружены процессором XBRL из-за пустых значений или невозможности преобразования в исходящий тип таксономии из данных модели. Также если при поиске значения в перечислении словаря не найдено дня него сопоставимое значение.
4. Строки табличных моделей, которые при поиске осей не были определены хотя бы для одной оси. Это может быть нормальным явлением, если из одной модели данные выгружаются в несколько отчетных ролей таксономии.
5. Конфликты концептов на идентичных кубах (например, при выгрузке баланса и примечаний, в которых итоговые показатели находятся на значениях осей, определенных как значения по умолчанию, которые не выгружаются в гиперкуб). При этом если итоговые значения примечаний не будут идентичны значениям баланса, система прекратит выгрузку инстанса.
В следующих случаях выгрузка инстанса прекращается:
1. Если при возникновении коллизии выгружаемые значения не равны между собой.
2. При выгрузке пустого значения в открытую ось (пустая строка, решетка, прочерк, ноль).
3. Если после меппинга поменяли имя колонки или строки в модели отчета и процессор не может найти данные.
4. Если нет подключения к внешнему источнику.
5. При несоответствии выгружаемого строки паттерну.
'''Исключения:'''
1. Если стоит галочка «игнорировать ошибки», то процессор не останавливает выгрузку при неодинаковых коллизиях фактов на контекстах.  Данные попадают в критический лог.
2. Отключается проверка соответствия выгружаемой строки паттерну. Данные попадают в критический лог.
3. Если при меппинге у роли указан признак «быстрой выгрузки» (для реестровых отчетов более 100к строк) проверка на коллизии не производится. Этим управляет галочка справа от вида отчета в форме сопоставления определений.
[[Категория:XBRL| ]]
[[Категория:XBRL| ]]

Текущая версия от 11:51, 28 сентября 2020

Описание конфигурации XBRL

Для выгрузки данных в XBRL в продукте реализован механизм работы со слоями таксономии: слой определений (definition), задающий гиперкубы отчетности, слой контрольных соотношений и табличный слой (модели отчетов таксономии). Выгрузка производится за счет меппинга внутренних моделей в слой определений (definition). Меппинг позволяет очень гибко настроить соответствие данных отчета и элементов гиперкуба, включая следующие возможности:

1. Преобразование пересечений строк и колонок отчета в элемент XBRL и совокупность аналитических признаков (значений осей гиперкуба).

2. Расчет периода на основании периода отчета, включая расчет рабочих дней (по регламентированному календарю).

3. Расчет значений открытых осей по произвольной формуле.

4. Преобразование значения пересечения в данные закрытой оси, перечисления (enumerator), разрядности (decimals) и единицы измерения (unit). Преобразование в элемент закрытой оси и перечисления может быть, как по значению лейбла (описания признака) таксономии, так и по произвольному значению. Это позволяет, например, преобразовать код операции отчета о движении денежных средств без необходимости указывать полную строку, соответствующую данным таксономии на 100%.

5. Для каждого элемента можно установить невыгружаемое значение (например, «#»), разрядность, единицу измерения (для монетарных типов).

6. Для элементов можно установить отбор по таблице, например, для совмещения в од-ной таблице итоговых и детальных записей, которые в таксономии разделены на не-сколько ролей. Также подобный подход позволяет выгрузить такие отчета, как ОСВ и ОФР, указывая отбор счета и символа ОФР для соответствующего выгружаемого элемента.

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

Выгрузка файла XBRL может быть произведена из регламентированного отчета по соответствующей кнопке, либо из списка документов.


По кнопке будет доступна форма формирования файла XBRL:


Для начала выберем схему меппинга по ссылке:



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


Стоит иметь ввиду, что в клиент-серверном варианте использования решения есть возможность сохранить файл прямо на сервер (особенно, если файл больше 4 Гб и не может быть доставлен на клиентской компьютер) – для этого используйте галочку «Сохранять на сервере», но и путь должен быть серверный или в общую сетевую папку (желательно, чтобы она находилась на компьютере, на котором запущен процесс сервера 1С, особенно если файл большой).

После того, как имя файла выбрано, нажмите «Сохранить XBRL».

По кнопке «Сохранить XBRL» производится формирование инстанса, по кнопке «Создать пакет» производится создание Zip-архива с сервисным файлом – XBRL-пакета. При этом все прикрепленные к документу «Регламентированный отчет», для которого была нажата кнопка «XBRL», будут помещены в пакет и отражены в сервисном файле.

Также, если это необходимо, по кнопке «Пространства имен» есть возможность включить в заголовок XBRL-файла необходимые сторонним продуктам дополнительные пространства имен.

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


ЛОГ

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


Самой распространенной, но не критической проблемой является пустое значение показателя (пустая строка, прочерк, решетка, ноль).

Следующая проблема – преобразование типов. Процессор пытается преобразовать строки в числа, удаляя лишние пробелы и меняя запятую на точку. Также система пытается преобразовать дату из строки – для этого она удаляет точку и косую черту из строки. Таким образом даты в формате «ГГГГ-ММ-ДД» не смогут быть выгружены. Дата, которая точно выгрузится из строки, должна быть в виде «ДД.ММ.ГГГГ».

Также в логе отражаются коллизии, если значения коллизий не отличаются, будет сформировано сообщение о том, что на контекст повторно попало значение. Если значения были разные, то инстанс будет выгружен только в том случае, если стоит галочка «Игнорировать ошибки». Данные критические ошибки попадают в красный лог.

Также в лог попадают сообщения о том, что в сопоставлении роли не найдена та или иная ось при обработке данных модели. Данные сообщения могут выводиться для отчетов, которые разделены на несколько ролей. Например, в отдельную роль вынесены долевые ценные бумаги, а в другую – долевые. В итоге информация о том, что при выгрузке роли с долевыми ЦБ не найдены оси для долговых, попадет в лог и, соответственно, наоборот.

Итак, в логе собирается следующая информация:

1. Имена выгружаемых ролей.

2. Время выгрузки роли в миллисекундах.

3. Факты, которые не были выгружены процессором XBRL из-за пустых значений или невозможности преобразования в исходящий тип таксономии из данных модели. Также если при поиске значения в перечислении словаря не найдено дня него сопоставимое значение.

4. Строки табличных моделей, которые при поиске осей не были определены хотя бы для одной оси. Это может быть нормальным явлением, если из одной модели данные выгружаются в несколько отчетных ролей таксономии.

5. Конфликты концептов на идентичных кубах (например, при выгрузке баланса и примечаний, в которых итоговые показатели находятся на значениях осей, определенных как значения по умолчанию, которые не выгружаются в гиперкуб). При этом если итоговые значения примечаний не будут идентичны значениям баланса, система прекратит выгрузку инстанса.

В следующих случаях выгрузка инстанса прекращается:

1. Если при возникновении коллизии выгружаемые значения не равны между собой.

2. При выгрузке пустого значения в открытую ось (пустая строка, решетка, прочерк, ноль).

3. Если после меппинга поменяли имя колонки или строки в модели отчета и процессор не может найти данные.

4. Если нет подключения к внешнему источнику.

5. При несоответствии выгружаемого строки паттерну.

Исключения:

1. Если стоит галочка «игнорировать ошибки», то процессор не останавливает выгрузку при неодинаковых коллизиях фактов на контекстах. Данные попадают в критический лог.

2. Отключается проверка соответствия выгружаемой строки паттерну. Данные попадают в критический лог.

3. Если при меппинге у роли указан признак «быстрой выгрузки» (для реестровых отчетов более 100к строк) проверка на коллизии не производится. Этим управляет галочка справа от вида отчета в форме сопоставления определений.