Электронная отчетность — Создание требуемой конфигурации для импорта данных из внешнего файла
В следующих шагах поясняется, как пользователь с ролью "Системный администратор" или "Разработчик электронной отчетности" может создать конфигурации электронной отчетности для импорта данных в приложение из внешнего файла. В этом примере вам предстоит создать необходимые конфигурации ER для взятой в качестве примера компании Litware, Inc. Чтобы выполнить следующие шаги, вам необходимо сначала выполнить шаги в проводнике по задаче "Электронная отчетность — Создание поставщика конфигурации и пометка его как активного". Эти шаги можно выполнить с использованием набора данных USMF. Кроме того, необходимо загрузить и сохранить следующие файлы локально:
| Описание содержания | Имя файла |
|---|---|
| Конфигурации модели данных электронной отчетности - 1099 | 1099model.xml |
| Конфигурация формата электронной отчетности - 1099 | 1099format.xml |
| Пример входящего документа в формате XML | 1099entries.xml |
| Пример книги для управления данными входящего документа | 1099entries.xlsx |
ER предоставляет бизнес-пользователям возможность настраивать процесс импорта внешних файлов данных в таблицы в формате XML или TXT. Во-первых, абстрактная модель данных и конфигурация модели данных ER должны быть созданы таким образом, чтобы представлять импортируемые данные. Затем необходимо определить структуру импортируемого файла и метод, который будет использоваться для переноса данных из файла в абстрактную модель данных. Необходимо создать конфигурацию формата ER, которая будет соответствовать созданной модели данных для этой абстрактной модели данных. После этого необходимо расширить конфигурацию модели данных, добавив сопоставление, которое описывает, как импортируемые данные сохраняются как данные абстрактной модели данных и как они используются для обновления таблиц. В конфигурацию модели данных ER должно быть добавлено новое сопоставление модели, описывающее привязку модели данных к местам назначения приложения.
Следующий сценарий показывает возможности импорта данных ER. Сюда входят проводки по поставщику, которые отслеживаются извне, а затем импортируются, чтобы позже включаться в отчеты в сопоставлении поставщика для формы 1099.
Добавление новой конфигурации модели ER
Перейдите в раздел "Управление организацией" > "Рабочие области" > "Электронная отчетность".
Проверьте, что поставщик конфигурации для демонстрационной компании Litware, Inc. доступен и помечен как активные. Если вы не видите этого поставщика конфигурации, необходимо сначала выполнить шаги в процедуре "Электронная отчетность — создание поставщика конфигурации и пометка его как активного".
Щелкните "Конфигурации отчетности".
Вместо того чтобы создавать новую модель для поддержки импорта данных, загрузите файл 1099model.xml, загруженный ранее. Этот файл содержит модель пользовательских данных проводок по поставщику. Эта модель данных сопоставляется с компонентами данных, которые находятся в объекте данных AOT.
Щелкните "Обменять".
Щелкните "Загрузить из XML-файла".
Нажмите кнопку "Обзор" и перейдите к ранее загруженному файлу 1099model.xml.
Нажмите кнопку "OК".
В дереве выберите "Модель платежей по форме 1099".
Проверка параметров модели данных
Выберите Конструктор.
Эта модель предназначена для представления проводок по поставщикам с точки зрения бизнеса и не связана с реализацией.
В дереве разверните узел ''1099-MISC".
В дереве выберите "1099-MISC\Проводки".
В дереве разверните узел "1099-MISC\Проводки".
Элемент "Проводки" этой модели представляет отдельные проводки. Дочерние элементы используются для указания требуемых сведений, таких как счет поставщика и дата проводки для каждой проводки.
Закройте страницу.
Добавление новой конфигурации формата ER, поддерживающей импорт данных
Шаги в этой подзадаче показывают, как можно создать новую конфигурацию формата для управления импортом данных из внешних файлов.
Щелкните "Создать конфигурацию", чтобы открыть ниспадающее диалоговое окно.
В поле "Создать" введите «Формат, основанный на модели данных "Модель платежей по форме 1099"».
Выберите "Да" в поле "Поддерживает импорт данных".
Нажмите клавишу ESC, чтобы закрыть эту страницу.
Вместо того чтобы создавать новый формат для поддержки импорта данных, загрузите файл 1099format.xml, загруженный ранее. Этот файл содержит определенную структуру импортируемого файла и сопоставление структуры с моделью пользовательских данных проводок по поставщикам.
Щелкните "Обменять".
Щелкните "Загрузить из XML-файла". Нажмите кнопку "Обзор" и перейдите к ранее загруженному файлу 1099format.xml.
Нажмите кнопку "OК".
В дереве разверните узел "Модель платежей по форме 1099".
В дереве выберите "Модель платежей по форме 1099\Формат для импорта проводок поставщиков".
Проверка параметров формата
Выберите Конструктор.
Установите переключатель "Показать сведения" в положение "Вкл.".
Щелкните "Развернуть/свернуть".
Щелкните "Развернуть/свернуть".
Созданный формат представляет ожидаемую структуру внешнего файла. Этот файл должен быть в формате XML и иметь корневой элемент сопоставления. Проводка по каждому поставщику представлена элементом проводки, который определяется как имеющий кратность ноль ко многим. Это означает, что входящий файл может содержать от нуля до нескольких проводок. Вложенные элементы элемента "проводка" представляют атрибуты одной проводки. Обратите внимание, что все атрибуты, кроме страны, помечены как обязательные, что означает, что они должны присутствовать в импортируемом файле.
Проверка параметров сопоставления формата с моделью данных
Щелкните "Сопоставить формат модели".
Сопоставление "Для импорта проводок поставщиков" содержит правила переноса данных из входящего XML-файла в выбранную часть модели настраиваемых данных, которая определяется выбором определения 1099-MISC.
Выберите Конструктор.
Установите переключатель "Показать сведения" в положение "Вкл.".
В дереве разверните "формат: Запись".
В дереве выберите "формат: Запись".
Обратите внимание, что созданный формат представляется как компонент источника данных.
В дереве разверните узел
format: Record\*settlement: XML Element 1..1 (settlement): Record.В дереве разверните узел
format: Record\*settlement: XML Element 1..1 (settlement): Record\transaction: XML Element 0..* (transaction): Record list.В дереве разверните узел
format: Record\*settlement: XML Element 1..1 (settlement): Record\transaction: XML Element 0..* (transaction): Record list\*vendor: XML Element 1..1 (vendor): Record.В дереве разверните узел
format: Record\*settlement: XML Element 1..1 (settlement): Record\transaction: XML Element 0..* (transaction): Record list\country: XML Element 0..1 (country): Record.В дереве выберите узел
format: Record\*settlement: XML Element 1..1 (settlement): Record\transaction: XML Element 0..* (transaction): Record list\*vendor: XML Element 1..1 (vendor): Record.Обратите внимание, что презентация обязательных и необязательных элементов формата отличается в предопределенном компоненте источника данных "формат".
В дереве разверните "Проводки: Список записей= формат.сопоставление.'$enumerated'".
Обратите внимание, что элементы формата, который определяет структуру импортированного файла, привязаны к элементам модели пользовательских данных. На основании этих привязок содержимое импортированного XML-файла будет храниться во время выполнения в существующей модели данных. Обратите внимание на привязку элемента страны. Для любого элемента проводки во входящем файле, не имеющего такой элемент, в модели данных будет заполнен код страны по умолчанию "США".
Перейдите на вкладку "Проверки".
Это сопоставление формата может содержать пользовательскую логику для проверки точности импортируемых данных с точки зрения бизнеса. Например, на основе параметра для любой проводки в импортируемом файле без определенного кода страны будет создаваться предупреждающее сообщение в Infolog, информирующее пользователя об этом и указывающее порядковый номер проводки.
Закройте страницу.
Выполнение сопоставления формата с моделью данных
Выполните это сопоставление формата в целях тестирования. Используйте файл 1099entries.xml, загруженный ранее. Этот файл можно экспортировать из книги 1099entries.xlsx, используемой для управления проводками по поставщику. Созданные выходные данные будут импортированы из выбранного XML-файла и заполнят модель пользовательских данных в реальном импорте.
Щелкните "Выполнить".
Нажмите кнопку "Обзор" и перейдите к ранее загруженному файлу 1099entries.xml.
Нажмите кнопку "OК".
Обратите внимание на предупреждающее сообщение об отсутствующем коде страны для проводки в импортированном файле.
Просмотрите выходные данные в формате XML, представляющем данные, которые были импортированы из выбранного файла, а затем перенесены в модель данных.
Закройте страницу.
Закройте страницу.
Проверка параметров сопоставления модели с местами назначения
В дереве выберите "Модель платежей по форме 1099".
Выберите Конструктор.
Щелкните "Сопоставить модель с источником данных".
Сопоставление для импорта проводок вручную по форме 1099 было определено с типом направления "В место назначения". Это означает, что оно было введено для поддержки импорта данных и содержит настройку правил, определяющих, как импортированный внешний файл и сохраненные как данные абстрактной модели данные будут использоваться для обновления таблиц в приложении.
Выберите Конструктор.
В дереве разверните "модель: Модель данных Модель платежей по форме 1099".
В дереве разверните "модель: Модель данных Модель платежей по форме 1099\Проводки: Список записей".
Обратите внимание, что созданная модель представляется как элемент источника данных. Во время выполнения она будет содержать данные, импортируемые из внешнего файла. Несколько таблиц были добавлены в качестве элементов источника данных для обеспечения того, что импортируемые данные соответствуют данным текущего приложения, включая доступность импортируемого счета поставщика для проводки в системе, существование комбинации кодов страны и государства импорта и т. д.
В дереве выберите "модель: Модель данных Модель платежей по форме 1099\Проводки: Список записей$сбой: Вычисляемое поле = IF(OR(ISEMPTY(model.Transactions.'$refs'.vendor), ISEMPTY(model.Transactions.'$refs'.vendor1099), ISEMPTY(model.Transactions.'$refs'.box1099), ISEMPTY(model.Transactions.'$refs'.country), ISEMPTY(model.Transactions.'$refs'.state), ISEMPTY(model.Transactions.'$refs'.location)), true, false): Boolean'.
Щелкните "Изменить".
Щелкните "Изменить формулу".
Если хотя бы одна проверка завершится с ошибкой для отдельной импортированной проводки, эта проводка будет помечена как не прошедшая проверку с помощью атрибута источника данных "$failed".
Закройте страницу.
Щелкните "Отмена".
В дереве выберите "tax1099trans: Таблица 'VendSettlementTax1099' записи= модель.Проверено".
Щелкните "Изменить назначение".
Место назначения ER было добавлено для указания того, как импортированные данные будут обновлять таблицы приложения. В этом случае выбрана таблица данных VendSettlementTax1099. Поскольку было выбрано действие "Вставить" действия записи, импортированные проводки будут вставлены в таблицу VendSettlementTax1099. Обратите внимание, что одно сопоставление модели может содержать несколько мест назначения. Это означает, что импортируемые данные можно использовать для одновременного обновления нескольких таблиц приложения. Таблицы, представления и объекты данных можно использовать как места назначения ER.
Если сопоставление будет вызываться с точки в приложении (например, кнопка или пункт меню), которая была специально предназначена для этого действия, место назначения ER должно быть помечено как точка интеграции. В данном примере это точка ERTableDestination#VendSettlementTax1099.
Щелкните "Отмена".
Щелкните "Показать все".
Щелкните "Показать только сопоставленные".
В дереве разверните "tax1099trans: Таблица 'VendSettlementTax1099' записи= модель.Проверено".
Обратите внимание, что элемента источника данных, который содержит только проверенные проводки, привязан к созданному месту назначения. Можно выполнить фильтрацию импортированных проводок, чтобы пропустить те, которые несовместимы с данными приложений.
В дереве выберите "сбой: Таблица 'VendSettlementTax1099Entity' записи= модель.Сбой".
Перейдите на вкладку "Проверки".
Это сопоставление модели может содержать пользовательскую логику для проверки правильности импортируемых данных из существующих данных приложения. Например, на основе текущего параметра для любой проводки в импортированном файле со счетом поставщика, отсутствующим в системе, будет создаваться предупреждающее сообщение, информирующее пользователя об этом и указывающее неверный код счета поставщика.
Обратите внимание, что параметр "Действие после проверки" может использоваться для каждой проверки для указания того, следует ли продолжать процесс импорта, а также следует ли сохранить или отменить уже выполненные операции вставки и обновления.
Щелкните "Показать только сопоставленные".
Щелкните "Показать все".
Закройте страницу.
Выполните это сопоставление модели для тестирования сопоставлений созданного формата и модели. Используйте файл 1099entries.xml. Данные из выбранного файла будут импортированы в систему.
Щелкните "Выполнить".
Обратите внимание, что диалоговое окно не содержит дополнительные вопросы о сопоставлении формата, который необходимо использовать для анализа импортируемого файла и последующего переноса данных в модель данных. Это происходит потому, что в данный момент существует только один формат, который использует эту модель и который будет помечен как формат, созданный для поддержки импорта данных.
Определите код ваучера для отличия импортированных проводок от других проводок, которые могли быть уже введены вручную или импортированы.
В поле "Введите код ваучера" введите "IMPORT-001".
Найдите файл "1099entries.xml".
Нажмите кнопку "OК".
Список созданных предупреждений предоставляет сведения о неверных счетах поставщиков, неверном коде налога по форме 1099, отсутствующих кодах стран и т. д. Сравните этот список предупреждений с содержимым, включенным в исполняемый XML-файл.
Закройте страницу.
Закройте страницу.
Закройте страницу.
Закройте страницу.
Перейдите в раздел "Расчеты с поставщиками" > "Периодические задачи" > "Налог по форме 1099" > "Сопоставление поставщика для формы 1099".
Эта форма показывает кумулятивные проводки в таблице Tax1099Summary, которые были созданы на основе импортированных проводок.
В поле "Начальная дата" установите для даты значение "01.01.2000".
Щелкните "Проводки по форме 1099 вручную".
Эта форма содержит список проводок, которые были добавлены вручную и которые были только что импортированы.
Откройте фильтр столбца "Ваучер".
Введите значение фильтра "IMPORT-001" в поле "Ваучер" с помощью оператора фильтра "начинается с".
Проверка связи между моделью и сопоставлениями формата
Закройте страницу.
Закройте страницу.
Перейдите в раздел "Управление организацией" > "Рабочие области" > "Электронная отчетность".
Щелкните "Конфигурации отчетности".
В дереве выберите "Модель платежей по форме 1099".
Предположим, что вам требуется поддерживать импорт тех же данных, но из формата файла TXT.
Щелкните "Создать конфигурацию", чтобы открыть диалоговое окно.
В поле "Создать" введите «Формат, основанный на модели данных "Модель платежей по форме 1099"».
В поле "Имя" введите "Импорт данных из TXT-файла".
Выберите "Да" в поле "Поддерживает импорт данных".
Нажмите Создать конфигурацию.
Выберите Конструктор.
Щелкните "Сопоставить формат модели".
Щелкните "Создать".
В поле "Определение" введите или выберите значение.
Выберите параметр "1099-MISC".
В поле "Имя" введите "Импорт данных из TXT-файла".
В поле "Описание" введите "Импорт данных из TXT-файла".
Нажмите кнопку "Сохранить".
Закройте страницу.
Закройте страницу.
Выберите Изменить.
Если вы установили исправление "KB 4012871 Поддержка сопоставлений модели GER в отдельных конфигурациях с возможностью указать различные виды предварительных условий для их развертывания в различных версиях Dynamics 365 Finance" (KB 4012871), выполните следующий шаг «Включить флаг "По умолчанию для сопоставления модели"» для введенной конфигурации формата. В противном случае пропустите следующий шаг.
Выберите "Да" в поле "По умолчанию для сопоставления модели".
В дереве выберите "Модель платежей по форме 1099".
Выберите Конструктор.
Щелкните "Сопоставить модель с источником данных".
Щелкните "Выполнить".
Если на компьютере установлено исправление "KB 4012871 Поддержка немецкой модели сопоставления в отдельных конфигурациях с возможностью указать различные виды предварительных условий для развертывания их в различных версиях (KB 4012871), выберите предпочтительное сопоставление модели в поле поиска. Если вы еще не установили исправление, перейдите к следующему шагу, поскольку сопоставление уже выбрано определением конфигурации формата по умолчанию.
Если вы еще не установите исправление КБ 4012871, обратите внимание, что диалоговое окно содержит дополнительный вопрос сопоставления модели, который используется для анализа импортируемого файла. Данные затем переносятся из диалогового окна в модель данных. В настоящее время можно выбрать, какое сопоставление формата необходимо использовать в зависимости от типа файла, который планируется импортировать.
Если планируется вызывать это сопоставление модели с точки в приложении, специально предназначенной для этого действия, место назначения ER и сопоставление формата должны быть помечены как часть интеграции.
Щелкните "Отмена".
Закройте страницу.
Закройте страницу.