Введение
Расширение «Загрузчик данных по шаблонам», редакция 1.2 разработано в среде «1С:Предприятия 8.3». Настоящее руководство предназначено для пользователей типовых прикладных решений, а именно:

• «1С:ERP Управление предприятием 2», редакция 2.5 (с 2.5.26.106),
• «1С:Комплексная автоматизация», редакция 2.5 (с 2.5.26.106),
• «1С:Управление торговлей», редакция 11.5 (с 11.5.26.106).

Расширение имеет назначение «Дополнение» и не требует внесения изменений в типовую конфигурацию. Требования к программному обеспечению и версии платформы «1С:Предприятие 8.3» определяется функционалом расширяемой конфигурации. Рекомендуемая к использованию версия платформы «1С:Предприятие 8.3», для каждого релиза конфигурации, указывается в файле readme.txt из поставки. В клиент-серверном варианте работы дополнительно создание и настройка профиля безопасности не требуется. Расширение «Загрузчик данных по шаблонам», как следует из названия, позволяет автоматизировать процесс формирования шаблонов в 1С для загрузки данных из сторонних систем и вести учет загрузок данных по указанным шаблонам. Расширение является инструментом для автоматического формирования шаблонов таблиц загрузки данных по выбранному объекту (например, справочник или документ) в формате Excel и последующей загрузки в информационную базу. Принцип работы расширения заключается в использовании отдельной специальной подсистемы «Загрузчик данных по шаблонам», которая включает в себя:

• механизм настройки шаблона загрузки реквизитов по выбранному объекту метаданных (справочник «Шаблоны загрузки»);
• механизм загрузки данных согласно выбранному шаблону (обработка «Загрузка шаблонов);
• механизм хранения результатов загрузки данных (документ «Журнал загрузки шаблонов» с возможностью распечатки списка и протокола загрузки).

1. Подключение расширения в типовую конфигурацию
Подключение расширения в типовую конфигурацию, например, в «1С:ERP Управление предприятием 2», редакция 2.5 (релиз не ниже 2.5.26.106), осуществляется в подсистеме «НСИ и администрирование», раздел «Администрирование» – «Печатные формы, отчеты и обработки».

Для добавления из файла на диске нужно указать путь к расширению «МДК_ЗагрузчикДанныхПоШаблонам.cfe».

При подключении нужно обязательно снять флаг «Безопасный режим» использования расширения.

Также, в некоторых случаях, потребуется снять флаг «Защита от опасных действий». Для этого нужно в меню главного окна (функции технического специалиста) перейти в форму управления расширениями конфигурации и сделать соответствующие настройки.

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

2. Работа с расширением
Рассмотрим принцип работы расширения на примере переноса данных справочника Номенклатура в «1С: ERP Управление предприятием 2». Функционал выведен в отдельную подсистему «Загрузчик данных по шаблонам», состоит из справочника по настройке шаблонов, обработки по загрузке данных и документов, регистрирующих загрузку.

2. Работа с расширением
При создании шаблона загрузки указываются Наименование, Идентификатор, Описание, выбирается Объект метаданных (в данном примере, справочник Номенклатура). Табличная часть заполняется реквизитами автоматически при помощи кнопки «Заполнить по объекту метаданных», есть возможность добавлять или удалять строки вручную.

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

После заполнения всей необходимой информации шаблон записывается и сохраняется в файл Excel для передачи ответственному за заполнение пользователю.

К оформлению таблицы в файле Excel предъявляются следующие требования: не менять имя файла, не менять имя листа с данными «Шаблон», формат всех ячеек шаблона должен быть текстовым, на листе с шаблоном не должно быть лишнего текста, кроме данных самой таблицы. На других листах файла находится справочная информация по заполнению для пользователя.

Следующим этапом, разрабатывается алгоритм загрузки файла шаблона, тестируется, проверятся через отладчик, исправляются ошибки (при наличии). Верный код вставляется в Алгоритм загрузки и записывается в шаблоне.

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

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

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

3. Обновление расширения
При смене релиза расширяемой конфигурации или при необходимости, работоспособность расширения «Загрузчик данных по шаблонам» обеспечивается путем предоставления пользователю новой версии, по электронной почте: info@axelsoft.ru. Для выполнения обновления расширения выполните следующие действия:

• Запустите приложение 1С в режиме «Предприятия».
• Перейдите на вкладку «НСИ и администрирование», пункт «Печатные формы, отчеты и обработки».

4. Отключение расширения
Отключение выполняется пользователем при обнаружении ошибок и невозможности дальнейшего использования расширяемой типовой конфигурации. Чтобы отключить расширение необходимо иметь права администратора или полные права. В подсистеме «НСИ и администрирование», раздел «Администрирование» – «Печатные формы, отчеты и обработки» перейти по ссылке «Расширения».

В строке с отключаемым расширением снять пометку в соответствующей колонке. В окне предупреждения необходимо нажать кнопку «Отключить».
Изменения вступят в силу после перезапуска программы.

6. Удаление расширения
Удаление расширения не влечет за собой изменение метаданных расширяемой конфигурации. Для удаления расширения из информационной базы необходимо в форме «Расширения» выбрать соответствующую строку расширения и нажать кнопку «Удалить».
В окне предупреждения необходимо подтвердить удаление.
После удаления расширения потребуется перезапуск программы.