Редактирование метаданных

Рисунок 1

В информационном окне отражаются сведения о загрузке и применении метаданных.

Структура данных представлена тремя модулями: База, БизнесМодель, CRM.

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

БизнесМодель – функционал предметного решения (предметные классы, диаграммы). При заведении объектных параметров и списков можно использовать классы модуля База и БизнесМодель. Дочерние классы можно создавать только модуля БизнесМодель.

CRM - модуль почтовых рассылок. При заведении объектных параметров и списков можно использовать классы модуля База и CRM. Дочерние классы можно создавать только модуля CRM.

Вверху окна расположен раскрывающийся список модулей и кнопка , вызывающая меню (Рис. 2).

Рисунок 2

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

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

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

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

Классы, принадлежащие текущему модулю (модулю, выбранному из раскрывающегося списка), отображаются в дереве стандартным черным цветом. Классы, не принадлежащие текущему модулю, отображаются серым цветом. Однако, если у класса, не принадлежащего текущему модулю, хотя бы один потомок принадлежит текущему модулю, то класс-родитель отображается в дереве классов синим цветом. Такая подсветка классов позволяет легко ориентироваться в большой и многоуровневой иерархии классов. Для удобства чтения информации о классе, у каждого класса есть пиктограммы. Их значения описаны в Таблица 1 Пиктограммы классов. Все действия с классами производятся из контекстного меню дерева классов, описание пунктов контекстного меню приведено в Таблица 2 Контекстное меню дерева классов.

Пиктограмма	Значение
	Класс - потомок класса "Классы".
	Перечисление - потомок типа "Перечисления".
	Класс - потомок класса "Элементы списков".
	Наличие этого элемента в пиктограмме означает, что класс допускает хранимые ссылки.
	Наличие этого элемента в пиктограмме означает, что класс нехранимый.
	Наличие этого элемента в пиктограмме означает, что класс системный, доступен только для просмотра.
	Наличие этого элемента в пиктограмме означает, что класс пользовательский, есть возможность редактирования.

Таблица 1. Пиктограммы классов

Форма "Свойства класса" (Рис. 3) вызывается при добавлении нового класса, редактировании или просмотре существующего. Создание и редактирование возможно только для пользовательских классов, к  их названию  добавляется префикс usr_. Вызов класса на редактирование осуществляется выбором пункта контекстного меню.

Рисунок 3

Все пользовательские справочники рекомендуется создавать в классе База.Справочники.

Имя пользовательского класса должно состоять из букв, цифр и знаков подчеркивания. Начинаться такие имена могут с буквы или со знака подчеркивания.

Вкладка "Опции" недоступна для изменений. Пользовательские классы и пользовательские элементы списков всегда хранимые.

На вкладке "Доп. опции" определяется набор дополнительных опций класса. Из контекстного меню можно вносить доп. опции по категориям. Поддерживается мультистрочный ввод значений дополнительных опций. Удаление опции производится из контекстного меню выбором пункта "Удалить строку". Описание дополнительных опций класса приведено в Таблица 3 Дополнительные опции класса.

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

Для пользовательских классов все дополнительные опции доступны для заполнения.

На вкладке "Ключи" задаются ключи для класса - как простые (уникальность проверяется по одному параметру), так и составные (уникальность проверяется по сочетанию нескольких параметров). Удаление ключа производится из контекстного меню по пункту "Удалить строку".

На вкладке "Значения" устанавливаются значения параметров по умолчанию во вновь создаваемом объекте класса. Для параметров с типом Перечисление (см. Свойства перечисления) значение по умолчанию может быть задано как перечислением наименований выбранных по умолчанию элементов перечисления через запятую, так и в бинарном виде - числом, равным сумме параметров Значение этих элементов перечисления.

Для класса обязательно задание значений по умолчанию для параметров guid и Название. Значения могут быть сгенерированы автоматически на основе текущего названия класса с помощью нажатия на кнопку "Задать умолчания" в окне добавления/редактирования класса.

На вкладке "Описание" дается многострочное описание функционального назначения класса и его места в объектной иерархии.

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

Это требование применимо, если класс создается в качестве потомка от класса, не имеющего ключей (например, от "Элементы списков"). При создании же класса от родителя, имеющего ключи (например, "Объекты системы" - ключ "guid"), отдельно создавать ключи не требуется.

Пример: создание для класса из числа потомков класса "Элементы списков" вложенного списка/структуры (получается, что во вложенном списке/структуре окажется объектный параметр «Владелец» со ссылкой на родительский класс).

В случае, если для любого класса из числа потомков класса "Элементы списков" (для определённости назовём его "Класс 1") создаётся параметр с типом "Список" или "Структура", необходимо для этого класса сделать следующее:

1. Создать параметр, значения которого будут уникальными в рамках класса, являющегося владельцем класса "Класс 1". Это может быть, например, "Номер документа", если список представляет собой список документов. В дальнейшем потребуется заполнять значение этого параметра для каждой строки списка с соблюдением этого условия по уникальности.
2. В окне редактирования класса, на вкладке "Ключ" создать для класса "Класс 1" новый ключ, в который включить 2 параметра: параметр, созданный в предыдущем пункте, и параметр "Владелец".
3. Применить изменения к базе данных.

Это справедливо и для случаев, когда уровней вложенности несколько: например, если у класса "Класс 1" из числа потомков класса "Элементы списков" есть список, ссылающийся на класс "Класс 2", а у того - список, ссылающийся на класс "Класс 3", то описанное выше следует сделать для классов "Класс 1" и "Класс 2".

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

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

Пиктограмма	Значение
	Параметр класса.
	Наличие этого элемента в пиктограмме означает, что этот параметр не хранимый, то есть рассчитываемый, пользователь не сможет изменять его в программе.
	Наличие этого элемента в пиктограмме означает, что параметр системный, доступен только для просмотра.
	Наличие этого элемента в пиктограмме означает, что параметр пользовательский, есть возможность редактирования.

Таблица 4. Пиктограммы параметров класса

Все действия с параметрами классов производятся из контекстного меню списка параметров.

Форма "Настройки параметров класса" (Рис. 4) вызывается при добавлении нового параметра или редактировании существующего. Создание и редактирование возможно только для пользовательских параметров, к  их названию  добавляется префикс usr_.

Имя пользовательского параметра должно состоять из букв, цифр и знаков подчеркивания. Начинаться такие имена могут с буквы или со знака подчеркивания.

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

Рисунок 4

На вкладке "Опции" необходимо выбрать тип параметра: простой, объектный, список, структура, перечисление.

Если тип параметра Простой, то необходимо уточнить его тип: логический, целый, строка, вещественный, датавремя, изображение, бинарный или текст. Для параметра типа Строка необходимо указать длину, максимум 4000 символов. Для параметра типа Вещественный необходимо указать общую длину и длину дробной части (количество знаков после запятой), максимум 28 символов. Если тип параметра Объектный, то необходимо указать класс, который будет являться типом объектов, на которые будет ссылаться этот параметр.

Если тип параметра Список или Структура, то необходимо указать элементы списка, которые будут являться типом объектов, на которые будет ссылаться этот параметр. Указанные таким образом классы должны быть конечными (не иметь потомков) и не должны быть созданы под классами, уже указанными в каких-либо параметрах с типом Список или Структура.

Если тип параметра Перечисление, то в качестве типа объектов указывается перечисление. Тип параметра выбирается по кнопке .

Общая длина (сумма длин всех параметров) класса, заданных на одном уровне в иерархии классов, не должна превышать 8000 Байт. Длина параметров различных типов в байтах приведена ниже в Таблица 6 Длина в байтах для различных типов параметров.

Опции параметра Только для чтения, История и Наследуемый недоступны для изменений, т.к. пользовательские параметры всегда редактируемые, без истории, не наследуемые.

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

На вкладке "Доп. опции" определяется набор дополнительных опций параметра класса. Они позволяют указывать заголовки, управлять порядком и видимостью по умолчанию, настраивать действия. Из контекстного меню можно вносить доп. опции по категориям. Удаление опции производится из контекстного меню выбором пункта "Удалить выделенные строки". Описание дополнительных опций параметра приведено в Таблица 7 Дополнительные опции параметров классов.

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

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

На вкладке "Описание" можно дать многострочное описание функционального назначения параметра класса и его места в объектной иерархии.

После создания в метаданных параметра с типом "Структура" и применения этих метаданных к базе необходимо для этой базы запустить команду пересохранения структур класса, в котором такой параметр был добавлен.

Вид командной строки: /runcmd="База.КлиентскиеУтилиты.ПересохранитьСтруктурыКласса СИСТЕМНОЕ_ИМЯ_КЛАССА"

Аргументы:

СИСТЕМНОЕ_ИМЯ_КЛАССА - полное системное имя класса Business Studio (например, БизнесМодель.Процессы), в котором был добавлен параметр с типом "Структура". Системное имя класса отображается в Объектной модели.

Подробнее о работе с командной строкой см. Командная строка.

Форма "Свойства перечисления" (Рис. 5) вызывается при добавлении нового перечисления или редактировании существующего. Создание и редактирование возможно только для пользовательских перечислений, к их названию добавляется префикс usr_. Вызов перечисления на редактирование осуществляется выбором соответствующей опции контекстного меню.

Рисунок 5

На вкладке "Элементы" задается список элементов перечисления. Параметры перечисления: значение, наименование, описание. Значение -  подставляемое значение, название - системное название элемента, описание - подставляемое название элемента. Удаление элемента перечисления осуществляется из контекстного меню.

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

Для независимых элементов перечисления-множества, необходимо значениям элементов присваивать степени двойки: 1,2,4,8,…

На вкладке "Описание" дается многострочное описание перечисления.