Как выгрузить описание структуры конфигурации 1с
Всем привет) С вами образовательный канал по изучению платформы 1С:Предприятие 8.3.
Прежде чем приступить к изучению нового объекта - справочники, необходимо обезопасить себя и знать то, как можно выгрузить вашу программу - для работы с ней на другом компьютере, как загрузить её на другой компьютер и как сделать восстановление информационной базы, если вы вдруг потеряли исходник вашей программы или случайно удалили её из списка баз.
Перед тем как приступить, хочу напомнить, что мы поставили перед самой цель разработки, научились устанавливать платформу и поработали с константой. Все это вы можете найти на моем канале - уроки идут последовательно и имеют нумерацию.
Часть 1. Выгрузка ИБ(далее ИБ - это информационная база)
Выгрузка ИБ - это резервное копирование базы 1С и может осуществляться несколькими способами, самый универсальный — через утилиту выгрузки информационной базы в конфигураторе 1с.
Выгрузка ИБ (будем называть ее программой) происходит в формат ".dt".
Давайте приступим к практике. Открываем нашу ИБ в режиме разработчика (Рисунок 1)
И выполняем команду "Администрирование - Выгрузить информационную базу" (Рисунок 2).
В следующем окне выбираем папку, в которую мы хотим сохранить нашу программу и обзываем файл "Магазин Счастье" (Рисунок 3).
После этого свернем режим разработчика, найдем папку, в которую только что сохранили нашу программу и посмотрим. В этой папке должен быть файл с именем "Магазин Счастье" и имеет расширение ".dt" (Рисунок 4).
Это и есть резервное копирование ИБ (программы).
Теперь, находясь в папке, вы можете его просто скопировать и делать сколько угодно копий и распространять их другим пользователям для изучения.
Если вы работаете с платформой версии 8.3.18 и делаете выгрузку, то потом нельзя будет загрузить выгруженный файл в более раннюю версию, например, в версию 8.3.17. А если выгрузить из версии 8.3.17 и загрузить в версию 8.3.18, то все будет хорошо - в этом направлении все работает.
Часть 2. Загрузка ИБ
Загрузка ИБ - это один из способов, при котором можно работать с ИБ на разных компьютерах. Загрузка информационной базы позволяет загрузить любую информационную базу в новую информационную базу и сразу же приступить к работе. Но, важно помнить следующее.
Примечание. Если вы работаете в информационной базе и захотите загрузить в нее другую ИБ, то после применения всех уведомлений, ваша информационная база перестанет существовать и вся ваша работа пропадет! Поэтому, если вы хотите продолжить свою работу и видеть, что есть в другой программе, то необходимо запустить ярлык 1С, добавить в список новую ИБ и потом в нее в режиме разработчика добавить в нее вторую программу.
Приступим к практике.
Откройте окно запуска платформы, добавьте новую информационную базу (Рисунок 5) и назовем ее "Копия"
Итак, для создания правил обмена данными нам нужна информация о структуре информационных баз участвующих в обмене. Если мы будем знать структуру информационных баз, то сможем задать какие объекты информационной базы источника должны преобразовываться в объекты информационной базы приемника. То есть по сути, сможем настроить правила обмена данными между двумя информационными базами.
У нас имеется информационная база по которой нам нужно получить информацию о ее структуре. Выгрузим информацию о структуре информационной базы в файл. Для этого используется внешняя обработка MD81Exp.epf и MD80Exp.epf для конфигураций на платформе "1С:Предприятии 8.1" и "1С:Предприятии 8.0" а так же MD77Exp.ert для конфигураций на платформе "1С:Предприятии 7.7". Эти обработки входят в комплект дистрибутива конфигурации "Конвертация данных 2.0".
Для подготовки XML-файла содержащего описание структуры метаданных конфигурации нужно запустить внешнюю обработку соответствующую версии платформы , указать путь для файла, в который необходимо выгрузить информацию о структуре информационной базы и нажать кнопку "Выгрузить".
Если наша информационная база работает на базе платформы 1С:Предприятие 8.1, то процесс выгрузки информации о структуре информационной базы будет выглядеть следующим образом:
- Открытие информационной базы, информацию о структуре метаданных которой необходимо получить (одинаков для всех платформ)
- Открытие внешней обработки MD81Exp.epf. Для этого достаточно в главном меню открыть пункт "Файл\Открыть" и указать путь по которому располагается обработка MD81Exp.epf (для платформы 7.7 и 8.0 нужно открывать обработки MD77Exp.ert соответственно MD80Exp.epf).
- Указание имени файла, в который необходимо сохранить информацию о структуре информационной базы
- Нажатие на кнопку Выполнить
Эти действия позволили нам выгрузить информацию структуре информационной базы.
Осталось только загрузить данную информацию в программу и можно будет приступить к настройке правил обмена данными.
Загрузка информации о структуре информационной базы
Когда файл с информацией о структуре метаданных готов, его можно загрузить в конфигурацию "Конвертация данных".
Для этого достаточно открыть "Панель функций" и выбрать пункт "Загрузить структуру метаданных конфигурации".
После чего откроется форма в которой необходимо указать путь к файлу, в котором хранится информация о структуре информационной базы.
Имеется возможность загрузить данные о структуре конфигурации в новый элемент, либо модифицировать уже загруженную структуру метаданных информационной базы.
После нажатия на кнопку "Выполнить загрузку" программа загрузит информацию о структуре информационной базы (Процесс загрузки информации о структуре метаданных информационной базы может потребовать некоторого времени. О ходе загрузки данных программа будет Вас информировать сообщая количество загруженных объектов, их свойств и предопределенных значений).
После окончания загрузки программа откроет информацию о загруженных данных. При этом будет создан новый элемент справочника "Конфигурации". Этот элемент справочника в дальнейшем будет соответствовать информации о выгруженной конфигурации.
В справочнике "Конфигурации" хранится информация о информационной базе из которой были выгружены данные. Имеется возможность посмотреть информацию о структуре информационной базы.
В верхней части формы в виде дерева представлена структура метаданных. В табличной части на закладке "Свойства" показаны реквизиты, табличные части объектов метаданных. Для документов дополнительно показана структура записей регистров, движения по которым делает соответствующий документ.
Если информация о структуре метаданных информационной базы источника и приемника загружена полностью, то все готово для создания правил обмена данными.
С уважением, Владимир Милькин (преподаватель школы 1С программистов и разработчик обновлятора).
Как помочь сайту: расскажите (кнопки поделиться ниже) о нём своим друзьям и коллегам. Сделайте это один раз и вы внесете существенный вклад в развитие сайта. На сайте нет рекламы, но чем больше людей им пользуются, тем больше сил у меня для его поддержки.
Конвертация данных - это какая-то вспомогательная конфигурация или обработка ?
кажися, такой обработки нет. Да ?
что такое "укажите имя файла, в котором находится описание структуры конфигурации" .
непонятно какого типа этот файл должен быть? и где это взять?
новый может создать ?
В папке с шаблоном Конвертации должны быть файлы внешних обработок. С помощью этой обработки создаешь файл образа структуры интересующей тебя конфигурации с которой будешь делать обмен. Обычно таким образом ты получаешь два файла конфигурации. Вообще в самой конфигурации довольно хорошая справочная служба, рекомендую с ней ознакомиться. Ибо сейчас ты на самую заметную кочку наступила и уже шатаешься.
Выгрузка информации о структуре информационной базы
Итак, для создания правил обмена данными нам нужна информация о структуре информационных баз участвующих в обмене. Если мы будем знать структуру информационных баз, то сможем задать какие объекты информационной базы источника должны преобразовываться в объекты информационной базы приемника. То есть по сути, сможем настроить правила обмена данными между двумя информационными базами.
У нас имеется информационная база по которой нам нужно получить информацию о ее структуре. Выгрузим информацию о структуре информационной базы в файл. Для этого используется внешняя обработка MD81Exp.epf и MD80Exp.epf для конфигураций на платформе "1С:Предприятии 8.1" и "1С:Предприятии 8.0" а так же MD77Exp.ert для конфигураций на платформе "1С:Предприятии 7.7". Эти обработки входят в комплект дистрибутива конфигурации "Конвертация данных 2.0".
Для подготовки XML-файла содержащего описание структуры метаданных конфигурации нужно запустить внешнюю обработку соответствующую версии платформы , указать путь для файла, в который необходимо выгрузить информацию о структуре информационной базы и нажать кнопку "Выгрузить".
Если наша информационная база работает на базе платформы 1С:Предприятие 8.1, то процесс выгрузки информации о структуре информационной базы будет выглядеть следующим образом:
1. Открытие информационной базы, информацию о структуре метаданных которой необходимо получить (одинаков для всех платформ)
2. Открытие внешней обработки MD81Exp.epf. Для этого достаточно в главном меню открыть пункт "Файл\Открыть" и указать путь по которому располагается обработка MD81Exp.epf (для платформы 7.7 и 8.0 нужно открывать обработки MD77Exp.ert соответственно MD80Exp.epf).
3. Указание имени файла, в который необходимо сохранить информацию о структуре информационной базы
Эти действия позволили нам выгрузить информацию структуре информационной базы.
Осталось только загрузить данную информацию в программу и можно будет приступить к настройке правил обмена данными.
Простая обработка позволяет выгрузить структуру хранения данных из метаданных конфигурации в табличный документ и сохранить его в файл Excel (в обычном и управляемом режимах). Выгрузка включает справочники, документы, перечисления, регистры, константы, планы, бизнес-процессы; включая табличные части и общие реквизиты; включая описания типов, в т.ч. составных, в частности, СправочникСсылка, ЛюбаяСсылка и т.п.
В ходе работы над проектом, связанным с интеграцией (да и не только), часто возникает потребность получить описание структуры хранения данных определенной базы, либо для дальнейшего анализа, либо для вставки в техническое задание или другую проектную документацию. Для решения этой задачи существует множество обработок и публикаций с разными способами получения подобного описания. Данная обработка имеет простой интерфейс (одна кнопка «сделать всё»), но выводит максимальное количество полезной для анализа информации и поддерживает сохранение табличного документа во внешний файл Excel.
На текущий момент в табличный документ выводятся следующие классы метаданных (колонка Тип таблицы) и группы полей (колонка Тип группы):
- Справочники, Документы, БизнесПроцессы, Задачи, ПланыВидовХарактеристик, ПланыОбмена:
СтандартныеРеквизиты + Реквизиты + ОбщиеРеквизиты + ТабличныеЧасти
- РегистрыСведений, РегистрыНакопления, РегистрыБухгалтерии, РегистрыРасчета:
СтандартныеРеквизиты + Измерения + Ресурсы + Реквизиты + ОбщиеРеквизиты
СтандартныеРеквизиты + Реквизиты + ОбщиеРеквизиты + ТабличныеЧасти + СтандартныеТабличныеЧасти
СтандартныеРеквизиты + Реквизиты + ОбщиеРеквизиты + ТабличныеЧасти + СтандартныеТабличныеЧасти + ПризнакиУчета + ПризнакиУчетаСубконто
- ОбщиеРеквизиты (выводятся в составе других таблиц):
Справочники, Документы, БизнесПроцессы, Задачи, ПланыВидовХарактеристик, ПланыОбмена,
РегистрыСведений, РегистрыНакопления, РегистрыБухгалтерии, РегистрыРасчета,
Для всех таблиц и полей выводится внутреннее имя (как в конфигураторе) и синоним (как на форме).
Для всех полей выводится комментарий из конфигуратора.
Для всех полей, кроме Значений перечисления, выводится Тип и Уточнение типа, а также Обязательность заполнения (свойство Проверка заполнения = Выдавать ошибку). В качестве уточнения типа для ссылочных типов выводится тип ссылки (имя ссылочного объекта), а для примитивных типов квалификаторы. Примеры:
- Строка: П256 – переменная длина 256 символов; Ф10 – фиксированная строка 10 символов (будет дополняться пробелами справа до указанной длины).
- Число: (10, 3) неотр. – разрядность 10, разрядность дробной части 3, допустимый знак – неотрицательный.
- Дата: Дата, Время, Дата и время
- Справочник: Номенклатура
Для полей составного типа в колонку Тип выводится признак «Составной» и в уточнение типа указывается количество входящих в него типов. Отдельно выполняется проверка на вхождение таких группировочных типов, как ЛюбаяСсылка, СправочникСсылка, ДокументСсылка и т.д., они выводятся одной строкой. Затем перечисляются все прочие типы. Типы отсортированы по алфавиту в возрастающем порядке.
Для реквизитов иерархических справочников в колонке «Тип группы» также указывается использование:
- Рекв (Гр/Эл) – реквизит есть у групп и элементов
- Рекв (Эл) – реквизит есть только у элементов
- Рекв (Гр) – реквизит есть только у групп
Обработка тестировалась на платформе 8.3.17 в обычном и управляемом режиме, в файловой и клиент-серверной базе. Также проверялись режимы совместимости от 8.1 до 8.3.17.
В качестве основной идеи брал бесплатную обработку MetadataToXML, которая выгружает структуру данных в XML. Укажу автора, если смогу вспомнить, т.к. скачивал обработку давно, а тот сайт теперь не работает.
В тонком клиенте при включении флажка сохранения файла на сервере необходимо проверить наличие у службы сервера доступа к выбранной папке для сохранения внешнего файла Excel. А лучше сохранять отображенный табличный документ с клиента через Ctrl+S с выбором формата xlsx.
Во вложении архив с обработкой и результатом выгрузки метаданных, и тестовая конфигурация для проверки
Сегодня мы с вами изучим еще один способ архивирования ИБ и дальнейшей работе с ней. Этот способ является очень привлекательным, если вы хотите сделать ручное изменение файлов или посмотреть их структуру.
Как делается эта выгрузка?
Для выгрузки конфигурации в файлы необходимо выполнить команду: "Конфигурация-Выгрузить конфигурацию в файлы" (Рисунок 1).
После этого у вас сразу же откроется новое окно, которое предлагает выбрать путь сохранения (Рисунок 2).
После этого зайдите в папку, в которую только что сохраняли и вы увидите следующие файлы и папки (Рисунок 3)
В данном случае при выгрузке у нас появились именно такие файлы, потому что мы создали такую конфигурацию. Посмотрите на рисунок 4 и вы увидите там 4 константы, которые мы создавали на прошлом уроке. Если бы мы их создали больше, то и соответственно их в папке было бы больше. То есть это вся наша конфигурация в виде файлов.
На рисунке 5 представлен файл, который отвечает за язык, с которым работает платформа. Так как, при установке у нас был один язык, то и тут он всего один.
Возникает вопрос? А какие же тут форматы и что это за форматы?
Конфигурация выгружается в набор файлов разного типа: xml, html, bin, bsl и так другие. Модули и текстовые макеты сохраняются в виде файлов TXT. Картинки из конфигурации сохраняются в виде файлов изображений (BMP, PNG и т.д.). Справочная информация выгружается в файлы HTML.
Ранее, у платформы был похожий механизм, который позволял ей выгружать какие-то определенные файлы, а не всю конфигурацию целиком, но по какой-то причине разработчики решили отказаться от этой функциональности.
Данный механизм позволяет выгружать в файлы с расширением xml.
XML - это стандартизированный, но расширяемый язык текстовой разметки, основанный на удобном и легко читаемом, как пользователями, так и компьютером, синтаксисе, состоящем из тегов, атрибутов и препроцессоров.
Что это все значит? А это значит, что вы можете взять файл с этим расширением, открыть его с помощью блокнота, внести в него свои изменения и потом заново все загрузить в платформу и платформа воспримет все изменения и отобразит их в платформе (если все конечно правильно сделали и согласно требованиям).
Как сделать загрузку?
Нужно воспользоваться обратно командой "Конфигурация-Загрузить конфигурацию из файлов". В новом окне выбрать папку, в которой находятся файлы конфигурации. Потом запускаете режим пользователя и проверяете все изменения.
Этот и другие механизмы помогают разработчикам разрабатывать свои программные продукты достаточно быстро и с удобством.
На этом статья урока подходит к концу. Попробуйте выполнить все действия, которые описаны в этом уроке.
Всем спасибо. Задать вопросы, которые у вас возникли вы можете, написав комментарий или вступить в группу и задать там свой вопрос. Ссылка для вступления в группу - t.me.Apiscourses
Читайте также: