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

Материал из OrticonWiki
Перейти к навигации Перейти к поиску
Praktik (обсуждение | вклад)
Нет описания правки
Praktik (обсуждение | вклад)
Нет описания правки
 
Строка 1: Строка 1:
[[Описание конфигурации XBRL]]
[[Описание конфигурации XBRL]]


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


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


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


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


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


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


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


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


4. Преобразование значения пересечения в данные закрытой оси, перечисления (enumerator), разрядности (decimals) и единицы измерения (unit). Преобразование в элемент закрытой оси и перечисления может быть, как по значению лейбла (описания признака) таксономии, так и по произвольному значению. Это позволяет, например, преобразовать код операции отчета о движении денежных средств без необходимости указывать полную строку, соответствующую данным таксономии на 100%.
Выгрузка файла 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]]
|}
|}


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


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


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




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


[[File:478584.jpg|center|700px]]


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


[[File:257870.jpeg|border|center|750px]]
[[File:459749.jpg|center|700px]]




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


[[File:988673.jpg|center|700px]]


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


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


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


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


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


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


Сохраненный файл можно провалидировать встроенным механизмом для проверки бизнес-правил, который открывается по кнопке «Валидация», но лучше пользоваться визуализацией нарушений бизнес-правил в инструменте для работы с табличным слоем.
[[File:137835.jpg|center|700px]]




'''ЛОГ'''
<span style="font-size: 130%">'''ЛОГ'''</span>


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


Лог, который генерирует процессор XBRL, доступен сразу же по кнопке «Лог», которая появится после начала формирования файла XBRL. В нем отражается информация о выгружаемых отчетных ролях, времени ее выгрузки и проблемах, возникших при этом.
[[File:600743.jpg|center|700px]]




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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


'''Исключения:'''
'''Исключения:'''


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


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


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