Creatio development guide
PDF
Документация по разработке

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

Glossary Item Box

Общие сведения

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

Привязать необходимые данные к пакету, содержащему разработанную функциональность, можно на вкладке [Данные] раздела [Конфигурация]. Основные сведения об этой вкладке, а также рекомендации и типовые ошибки привязки данных приведены в статье "Раздел [Конфигурация]. Вкладка [Данные]".

Описание примера

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

ВАЖНО

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

Рис. 1. — Наборы данных, привязанные к пакету мастером разделов

Исходный код

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

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

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

ВАЖНО

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

Для создания нового раздела [Книги] воспользуйтесь мастером разделов. Свойства раздела и расположение полей на странице редактирования записей показаны на рис. 2 и рис. 3.

Рис. 2. — Свойства раздела [Книги] ([Books])

Рис. 3. — Свойства страницы редактирования записей

Основные свойства колонок страницы редактирования приведены в таблице 1.

Табл. 1. — Свойства колонок страницы редактирования записей раздела

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

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

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

Рис. 4. — Записи раздела

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

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

1. [Название] ([Name]) — "ContactsInBooks".

2. [Объект] ([Object]) — "Контакт" ("Contact").

3. [Тип установки] ([Installation type]) — "Установка" ("Installation"). Возможные типы установки описаны в статье "Раздел [Конфигурация]. Вкладка [Данные]".

4. [Колонки] ([Columns]) — выберите только заполненные колонки. Колонка [Id] должна быть выбрана обязательно.

5. Фильтр данных — отфильтруйте требуемые данные, например, по имени контакта.

Рис. 5. — Страница привязки данных контакта

К СВЕДЕНИЮ

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

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

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

1. [Название] ([Name]) — "AccountsInBooks".

2. [Объект] ([Object]) — "Контрагент" ("Account").

3. [Тип установки] ([Installation type]) — "Установка" ("Installation").

4. [Колонки] ([Columns]) — выберите только заполненные колонки. Колонка [Id] должна быть выбрана обязательно.

5. Фильтр данных — отфильтруйте требуемые данные, например, по идентификатору контрагента. Узнать идентификатор можно из адресной строки браузера, открыв страницу редактирования нужной записи (рис. 7)

Рис. 6. — Страница привязки данных контрагента

Рис. 7. — Определение идентификатора контрагента

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

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

1. [Название] ([Name]) — "Books".

2. [Объект] ([Object]) — "Книги" ("Books").

3. [Тип установки] ([Installation type]) — "Установка" ("Installation").

4. [Колонки] ([Columns]) — выберите только заполненные колонки. Колонка [Id] должна быть выбрана обязательно.

5. Фильтр данных — отфильтруйте требуемые данные. Если раздел содержит только две записи, то фильтр можно не использовать (рис. 8).

Рис. 8. — Страница привязки данных пользовательского раздела

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

Рис. 9. — Вкладка [Данные] пакета разработки

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

 

© Terrasoft 2002-2019.

Был ли данный материал полезен?

Как можно улучшить эту статью?