Привязать данные к пакету

Сложный

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

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

Пример. Для пользовательского раздела Книги (Books) необходимо привязать две демонстрационные записи и связанные с ними записи других разделов.

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

scr_bound_master.png

Исходный код 

Пакет с реализацией примера можно скачать по ссылке.

Алгоритм реализации примера 

1. Создать новый раздел Книги 

Важно. Функциональность нового раздела следует создавать в отдельном пакете разработки. Чтобы мастер раздела создавал схемы в пакете разработки, необходимо выбрать этот пакет в колонке Значение по умолчанию (Default value) системной настройки Текущий пакет (Current package). После завершения работы мастера в качестве текущего можно установить пакет Custom.

Для создания нового раздела Книги воспользуйтесь мастером разделов.

Свойства раздела Книги (Books)
scr_wiz_section.png
 Свойства страницы редактирования записей
scr_wiz_page.png
Свойства колонок страницы редактирования записей раздела
Заголовок Название (Код в БД) Тип данных
Название (Name) UsrName Строка (String).
Описание (Description) UsrDescription Строка (String). Многострочный текст (Multiline text).
ISBN UsrISBN Строка (String).
Автор (Author) UsrAuthor Справочник Контакт (Contact). Значение колонки будет привязано к одной из записей раздела Контакты.
Издатель (Publisher) UsrPublisher Справочник Контрагент (Account). Значение колонки будет привязано к одной из записей раздела Контрагенты.
Стоимость (Price) UsrPrice Дробное число (Decimal).

2. Добавить в раздел необходимые записи 

Добавьте в раздел две демонстрационные записи. При необходимости также создайте записи в связанных разделах Контакты и Контрагенты.

scr_records.png

3. Привязать к пакету данные о контактах 

Поскольку записи раздела Книги связаны с записями раздела Контакты по колонке UsrAuthor, то сначала необходимо привязать к пакету сведения об авторах. Для этого выполните действие Добавить (Add) на вкладке Данные (Data) раздела Конфигурация и установите следующие свойства страницы привязки данных:

  1. Название (Name) — "ContactsInBooks".
  2. Объект (Object) — "Контакт" ("Contact").
  3. Тип установки (Installation type) — "Установка" ("Installation").
  4. Колонки (Columns) — выберите только заполненные колонки. Колонка Id должна быть выбрана обязательно.
  5. Фильтр данных — отфильтруйте требуемые данные, например, по имени контакта.
scr_contact_in_books.png

На заметку. Рекомендуется использовать фильтрацию по колонке Id (см. следующий шаг), т. к. полное имя контакта может быть изменено.

4. Привязать к пакету данные о контрагентах 

Выполните действие Добавить (Add) на вкладке Данные (Data) раздела Конфигурация и установите следующие свойства страницы привязки данных:

  1. Название (Name) — "AccountsInBooks".
  2. Объект (Object) — "Контрагент" ("Account").
  3. Тип установки (Installation type) — "Установка" ("Installation").
  4. Колонки (Columns) — выберите только заполненные колонки. Колонка Id должна быть выбрана обязательно.
  5. Фильтр данных — отфильтруйте требуемые данные, например, по идентификатору контрагента. Узнать идентификатор можно из адресной строки браузера, открыв страницу редактирования нужной записи.
 Страница привязки данных контрагента
scr_account_in_books.png
Определение идентификатора контрагента
scr_account_id.png

5. Привязать к пакету данные пользовательского раздела 

Выполните действие Добавить (Add) на вкладке Данные (Data) раздела Конфигурация и установите следующие свойства страницы привязки данных:

  1. Название (Name) — "Books".
  2. Объект (Object) — "Книги" ("Books").
  3. Тип установки (Installation type) — "Установка" ("Installation").
  4. Колонки (Columns) — выберите только заполненные колонки. Колонка Id должна быть выбрана обязательно.
  5. Фильтр данных — отфильтруйте требуемые данные. Если раздел содержит только две записи, то фильтр можно не использовать.
scr_books_data.png

В результате выполнения примера к пакету будут привязаны три дополнительных набора данных для трех разделов.

scr_ready.png

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