Настройка форматов электронной отчетности для использования параметров, указанных для юридического лица
Обзор
Во многих форматах электронной отчетности (ER), которые будут создаваться, необходимо фильтровать данные с помощью набора значений, которые относятся к каждому юридическому лицу вашего экземпляра (например, набору налоговых кодов для фильтрации проводок по налогу). В настоящее время, когда фильтрация этого типа настроена в формате ER, значения, зависящие от юридического лица (например, налоговые коды), используются в выражениях в формате ER для указания правил фильтрации данных. Таким образом, используется формат ER для компании, а для создания необходимых отчетов необходимо создать производные копии оригинального формата ER для каждого юридического лица, для которого нужен формат ER. Каждый производный формат ER должен быть изменен для того, чтобы передать в него значения, зависящие от юридического лица, изменяя основу при обновлении исходной (базовой) версии, которая экспортируется из тестовой среды и импортируется в производственную среду, когда она должна быть развернута для практического использования и т. д. Таким образом, обслуживание этого типа настроенного решения ER является сложным и требует много времени по нескольким причинам:
- Чем больше юридических лиц, тем большее количество конфигураций формата ER необходимо поддерживать.
- Для поддержки конфигураций ER требуется, чтобы у бизнес-пользователей были сведения об ER.
Параметры, зависящие от приложения ER, позволяют опытным пользователям настраивать фильтрацию данных в формате ER, чтобы они основывались на наборе абстрактных правил. Этот набор правил может быть настроен таким образом, чтобы использовать источники данных, доступные в формате ER. Бизнес-пользователи могут затем указать реальные правила за пределами среды ER, используя пользовательский интерфейс, который автоматически создается на основе настроек соответствующего формата ER и текущих данных юридического лица, к которым будут иметь доступ источники данных в формате ER. Набор правил, указанный для формата ER, может быть экспортирован из текущего юридического лица экземпляра Dynamics 365 Finance (Finance). Затем он может быть импортирован в другое юридическое лицо того же или другого экземпляра в качестве набора правил для того же формата ER.
Необходимые условия
Чтобы выполнить примеры в этой статье, необходимо иметь доступ к экземпляру служб Regulatory Configuration Services (RCS), который был подготовлен для того же клиента, что и Finance, для одной из следующих ролей:
- Разработчик электронной отчетности
- Консультант по функциональным возможностям электронной отчетности
- Системный администратор
Рекомендуется выполнить шаги, указанные в статье Поддержка параметризованных вызовов источников данных электронной отчетности для типа ВЫЧИСЛЯЕМОЕ ПОЛЕ. После выполнения этих шагов можно пропустить шаги в разделе Импорт конфигураций ER в RCS.
Импорт конфигураций ER в RCS
Загрузите и локально сохраните следующие конфигурации электронной отчетности.
| Описание содержания | Имя файла |
|---|---|
| Пример файла конфигурации Модель данных ER | Model to learn parameterized calls.version.1.xml |
| Пример файла конфигурации Метаданные ER | Metadata to learn parameterized calls.version.1.xml |
| Пример файла конфигурации Сопоставления модели ER | Mapping to learn parameterized calls.version.1.1.xml |
| Пример конфигурации Формат ER | Format to learn parameterized calls.version.1.1.xml |
Затем войдите в экземпляр RCS.
В этом примере вам предстоит создать конфигурацию для компании-образца Litware, Inc. Перед выполнением этой процедуры необходимо выполнить шаги в статье Создание поставщика конфигурации и пометка его как активного в RCS.
В панели мониторинга по умолчанию выберите Электронная отчетность.
Выберите Конфигурации отчетности.
Импортируйте конфигурации ER, загруженные ранее в RCS, в следующей последовательности: модель данных, метаданные, сопоставление модели и формат. Для каждой конфигурации ER выполните следующие действия.
- Выберите Обменять.
- Выберите Загрузить из XML-файла.
- Выберите Обзор, чтобы выбрать файл для требуемой конфигурации ER в формате XML.
- Нажмите ОК.
Предварительный просмотр предоставленного решения ER
В дереве конфигурации разверните содержимое пункта Модели для изучения параметризованных вызовов.
Выберите элемент Формат для изучения параметризованных вызовов.
Выберите Конструктор.
Выберите Развернуть/Свернуть.
Формат ER Формат для изучения параметризованных вызовов предназначен для создания налоговой выписки в формате XML, представляющей несколько уровней налогообложения (обычный, сокращенный и отсутствует). На каждом уровне разное число деталей.
На вкладке Сопоставление раскройте элементы Модель, Данные и Сводка.
В качестве источника данных Model.Data.Summary возвращается список налоговых проводок. Такие проводки упорядочиваются по налоговому коду. Для этого источника данных вычисляемое поле Model.Data.Summary.Level настроено для возврата кода уровня налогообложения для каждой записи сводки. Для любого кода налога, получаемого из источника данных Model.Data.Summary во время выполнения, вычисляемое поле возвращает код уровня налогообложения (обычный, пониженный, отсутствует или другой) в виде текстового значения. Вычисляемое поле Model.Data.Summary.Level используется для фильтрации записей источника данных Model.Data.Summary и ввода отфильтрованных данных в каждый элемент XML, представляющий уровень налогообложения, с помощью полей Model.Data2.Level1, Model.Data2.Level2 и Model.Data2.Level3.
Вычисляемое поле Model.Data.Summary.Level было настроено, чтобы оно содержало выражение ER. Налоговые коды (VAT19, InVAT19, VAT7, InVAT7, THIRD и InVAT0) жестко запрограммированы в этой конфигурации. Поэтому этот формат ER зависит от юридических лиц, в которых настроены эти налоговые коды.
Для поддержки различных наборов налоговых кодов для каждого юридического лица необходимо выполнить следующие действия:
- Создайте производную версию формата ER для каждого юридического лица.
- Обновите налоговые коды в вычисляемом поле Model.Data.Summary.Level на основе параметра юридического лица.
Закройте страницу Конструктор форматов.
Создание производного формата
Затем будут использованы параметры, зависящие от приложения ER, для поддержки различных наборов налоговых кодов для каждого юридического лица в одном формате ER.
- В дереве конфигурации разверните содержимое пункта Модели для изучения параметризованных вызовов.
- Выберите элемент Формат для изучения параметризованных вызовов.
- Выберите Создать конфигурацию.
- Выберите Производное от имени: формат для изучения параметризованных вызовов, Microsoft.
- В поле Имя введите Формат для изучения поиска данных LE.
- Выберите Создать конфигурацию.
Настройка производного формата
Добавление перечисления форматов
Далее необходимо добавить новое перечисление формата ER. Значения этого перечисления форматов будут представлены для бизнес-пользователей, которые будут определять зависимые от компании наборы налоговых кодов для различных уровней налогообложения, используемых в формате ER.
Выберите Конструктор.
Выберите Перечисление форматов.
Выберите Добавить.
В поле Имя введите Список уровней налогообложения.
Нажмите Сохранить.
На вкладке Значения перечисления форматов выберите Добавить.
В поле Имя введите Обычное налогообложение.
Снова выберите Добавить.
В поле Имя введите Сокращенное налогообложение.
Снова выберите Добавить.
В поле Имя введите Нет налогообложения.
Снова выберите Добавить.
В поле Имя введите Другое.
Так как бизнес-пользователи могут использовать другие языки для указания зависящих от компании наборов налоговых кодов, рекомендуется перевести значения этого перечисления в языки, настроенные в качестве предпочтительных языков для пользователей в Finance.
Выберите запись Нет налогообложения.
Щелкните поле Метка.
Выберите Перевести.
В области Перевод текста в поле Код метки введите LBL_LEVELENUM_NO.
В поле Текст на языке по умолчанию введите Нет налогообложения.
В поле Язык выберите DE.
В поле Переведенный текст введите keine Besteuerung.
Выберите Перевести.
Нажмите Сохранить.
Закройте страницу Перечисления форматов.
Добавление нового источника данных поиска
Далее необходимо добавить новый источник данных, чтобы указать, как бизнес-пользователи будут задавать правила, зависящие от компании, чтобы определить правильный уровень налогообложения для каждой суммарной записи проводки.
На вкладке Сопоставление выберите Добавить.
Выберите Перечисление/поиск форматов.
Только что было определено, что каждое правило, указанное бизнес-пользователями для распознавания на уровне налогообложения, возвратит значение перечисления формата ER. Обратите внимание на то, что тип источника данных Поиск может быть доступен в модели данных и блоках Dynamics 365 for Operations в дополнение к блоку Перечисление форматов. Таким образом, перечисления модели данных ER и перечисления приложений могут использоваться для указания типа значений, которые возвращаются для источников данных этого типа. Дополнительные сведения об источниках данных поиска см. в Настройка источников данных поиска для использования функции параметров для приложения электронной отчетности.
В поле Имя введите Выбор.
В поле Перечисление форматов выберите Список уровней налогообложения.
Вы указали, что для каждого правила, указанного в этом источнике данных, бизнес-пользователь должен выбрать одно из значений перечисления форматов Список уровней налогообложения в качестве возвращенного значения.
Выберите Изменить поиск.
Выберите Столбцы.
Разверните элемент Model.
Разверните элемент Данные.
Разверните элемент Налог.
Выберите элемент Model.Data.Tax.Code.
Нажмите кнопку Добавить (стрелка вправо).
Вы только что указали, что для каждого правила, указанного в этом источнике данных для распознавания уровня налогообложения, бизнес-пользователь должен выбрать один из кодов налога в качестве условия. Список налоговых кодов, которые может выбрать пользователь, будет возвращен в источнике данных Model.Data.Tax. Поскольку этот источник данных содержит поле Имя, имя налогового кода будет отображаться для каждого значения налогового кода в поиске, представляемом для бизнес-пользователя.
Нажмите ОК.
Бизнес-пользователи могут добавить несколько правил в виде записей этого источника данных. Каждая запись будет пронумерована с помощью кода строки. Правила будут оценены в порядке возрастания номера строки.
Так как в качестве условия для правил в источнике данных поиска выбрано поле Налоговый код, и поскольку Налоговый код задан как поле типа данных Строка, каждое правило будет оцениваться во время выполнения путем сравнения налогового кода, который передается в источник данных, с налоговым кодом, который указан в этой записи источника данных.
При обнаружении правила, удовлетворяющего настроенному условию, этот источник данных возвращает значение поиска для правила, которое определено в поле Результат поиска. Если правило не найдено, выдается исключение, уведомляющее пользователя о том, что текущий источник данных не может вернуть правильное значение.
Нажмите Сохранить.
Закройте страницу Конструктор поиска.
Нажмите ОК.
Обратите внимание, что был добавлен новый источник данных, который будет возвращать уровень налогообложения в виде значения перечисления форматоров Список уровней налогообложения для любого налогового кода, который передается в источник данных в качестве аргумента параметра Код с типом данных Строка.
Оценка настроенных правил зависит от типа данных полей, которые были выбраны для определения условий этих правил. При выборе поля, настроенного в качестве поля типа Числовой или Данные, критерии будут отличаться от критериев, описанных выше, для типа данных Строка. Для полей Числовой и Данные правило должно быть определено как диапазон значений. Затем условие правила будет считаться удовлетворенным, когда значение, передаваемое в источник данных, попадает в настроенный диапазон.
На следующем рисунке приведен пример этого типа настройки. В дополнение к полю Model.Data.Tax.Code типа данных Строка поле Model.Tax.Summary.Base типа данных Вещественный используется для определения условий для источника данных поиска.
Так как для этого источника данных поиска выбраны поля Model.Data.Tax.Code и Model.Tax.Summary.Base, каждое правило этого источника данных будет настроено следующим образом:
- В представленном списке значение перечисления форматов Список уровней налогообложения должно быть выбрано как возвращаемое значение.
- Налоговый код должен быть введен как условие этого правила. Применимы только налоговые коды, предоставляемые в источнике данных Model.Data.Tax.
- Минимальное и максимальное значения базовой суммы налога должны вводиться в качестве условий этого правила.
Ниже показано, как каждое правило этого источника данных будет оцениваться во время выполнения:
- Совпадает ли код типа данных Строка, переданного в этот источник данных, с кодом налога правила?
- Попадает ли значение типа данных Вещественный, переданное в этот источник данных, в интервал между указанными минимальным и максимальным значениями?
Правило будет учитываться как применимое, если удовлетворяются оба условия.
Перевод метки добавленного источника данных поиска
Так как бизнес-пользователи могут использовать другие языки для указания зависящих от компании наборов налоговых кодов, рекомендуется перевести этикетку добавляемого источника данных поиска, чтобы она отображалась на предпочитаемом языке пользователя на соответствующей странице.
Выберите источник данных Model.Data.Selector.
Выберите Правка.
Щелкните поле Метка.
Выберите Перевести.
В области Перевод текста в поле Код метки введите LBL_SELECTOR_DS.
В поле Текст на языке по умолчанию введите Выбрать уровень налогообложения по коду налога.
В поле Язык выберите DE.
В поле Переведенный текст введите Steuerebene für Steuerkennzeichen auswählen.
Выберите Перевести.
Нажмите ОК.
Добавление нового поля для использования настроенного поиска
Разверните элемент Model.Data.
Выберите элемент Model.Data.Summary.
Выберите Добавить.
Выберите Функции/Вычисляемое поле.
В поле Имя введите LevelByLookup.
Выберите Изменить формулу.
В поле Формула введите Model.Selector(Model.Data.Summary.Code).
Нажмите Сохранить.
Закройте страницу Редактор формул.
Нажмите ОК.
Обратите внимание, что добавленное вычисляемое поле LevelByLookup будет возвращать уровень налогообложения как значение перечисления форматов Список уровней налогообложения для каждой сводной записи налоговых проводок. Налоговый код записи будет передан в источник данных поиска Model.Selector, и набор правил для этого источника данных будет использоваться для выбора правильного уровня налогообложения.
Добавление нового источника данных на основе перечисления форматов
Далее будет добавлен новый источник данных, относящийся к перечислению форматов, добавленному ранее. Значения этого источника данных будут использоваться в выражении формата ER позднее.
- Выберите Добавить корень.
- Выберите Перечисление форматов/перечисление.
- В поле Имя введите TaxationLevel.
- В поле Перечисление форматов выберите Список уровней налогообложения.
- Нажмите Сохранить.
Измените существующее поле, чтобы начать использовать поиск
Далее будет изменено существующее вычисляемое поле, чтобы оно использовало настроенный источник данных поиска для возврата значения налогообложения в зависимости от налогового кода.
Выберите элемент Model.Data.Summary.Level.
Выберите Правка.
Выберите Изменить формулу.
Обратите внимание, что текущее выражение поля Model.Data.Summary.Level включает следующие жестко запрограммированные налоговые коды:
CASE (@.Code, "VAT19", "Обычный", "InVAT19", "Обычный", "VAT7", "Сокращенный", "InVAT7", "Сокращенный", "THIRD", "Нет", "InVAT0", "Нет", "Другой")
В поле Формула введите CASE(@.LevelByLookup, TaxationLevel.'Regular taxation', "Regular", TaxationLevel.'Reduced taxation', "Reduced", TaxationLevel.'No taxation', "None", "Other").
Обратите внимание, что выражение в поле Model.Data.Summary.Level теперь возвращает уровень налогообложения на основе налогового кода текущей записи и набора правил, которые бизнес-пользователь настраивает в источнике данных поиска Model.Data.Selector.
Нажмите Сохранить.
Закройте страницу Конструктор формул.
Нажмите ОК.
Нажмите Сохранить.
Закройте страницу Конструктор форматов.
Завершение черновой версии производного формата
- На экспресс-вкладке Версии выберите Изменить статус.
- Выберите Завершено.
- Нажмите ОК.
Экспорт завершенной версии измененного формата
- В дереве конфигурации выберите элемент Формат для изучения поиска данных LE.
- На экспресс-вкладке Версии выберите запись со статусом Завершено.
- Выберите Обменять.
- Выберите Экспорт в виде XML-файла.
- Нажмите ОК.
- Веб-браузер загружает файл Format to learn how to look up LE data.xml. Сохраните этот файл локально.
Повторите шаги в этом разделе для родительских элементов формата Формат для изучения поиска данных LE и сохраните следующие файлы локально:
- Формат для изучения параметризованных вызовов.xml
- Сопоставление для изучения параметризованных вызовов.xml
- Модели для изучения параметризованных вызовов.xml
Чтобы узнать, как использовать настроенный формат ER Формат для изучения поиска данных LE для настройки наборов налоговых кодов, зависящих от юридического лица, для фильтрации налоговых проводок по разным уровням налогообложения, выполните шаги в статье Настройка параметров формата электронной отчетности для юридического лица.
Дополнительные ресурсы
Конструктор формул в электронной отчетности
Настройка параметров формата электронной отчетности для юридического лица