Для доступа в cтудию необходимо:

1. Войти в систему с правами администратора
2. В меню пользователя, расположенном в правом верхнем углу, выбрать пункт «Администрирование»
3. В подразделе «Инструментарий разработчика» перейти в раздел «Студия»

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

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

В студии вы можете выполнять следующие действия:

• Добавлять новые/редактировать существующие поля модуля
• Добавлять новые/редактировать существующие связи между модулями
• Изменять субпанели модуля
• Изменять надписи полей модуля
• Изменять макеты форм
• Сбрасывать внесенные ранее настройки модуля

В процессе сброса настроек у вас будет возможность выбрать необходимые компоненты:

• Удалить пользовательские поля
• Сбросить макеты
• Сбросить надписи
• Очистить расширения

Для редактирования модуля выполните следующее:

1. В студии выберите редактируемый модуль
2. Выберите один из следующих компонентов модуля:

• Надписи
• Поля
• Связи
• Макеты

Для быстрого перехода к другому компоненту студии вы можете воспользоваться цепочкой навигации, расположенной непосредственно над кнопкой «Сохранить и установить» или также в левой стороне страницы

Надписи (Лейблы полей/субпанелей)
Выберите данный компонент для редактирования надписей. Используя редактор надписей, вы можете изменять надписи полей, кнопок, ссылок, заголовки модулей и всплывающих окон. Вы также можете менять стандартные подписи полей для всех установленных языковых пакетов. Каждый модуль отображает в редакторе список содержащихся в базе данных полей и соответствующих им надписей пользовательского интерфейса.

Использование редактора надписей вместо редактора макетов при изменении множества надписей значительно сокращает время редактирования (То есть, если изменить лейбл поля в целом, то его значение автоматически обновится во всех макетах модуля, где он используется)

Для изменения надписи выполните следующее:
1. В необходимом модуле выберите компонент «Надписи»
На странице отобразится список содержащихся в базе данных полей и соответствующих им надписей/лейблов

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

3. Перейдите к необходимой надписи и введите новое значение
4. Нажмите на кнопку «Сохранить и установить»

Изменение названия закладки модуля
Для изменения названия закладки модуля необходимо:

• Открыть компонент «Надписи» любого модуля
• Нажать на кнопку «Переименовать закладку модуля»
• Из выпадающего списка, содержащего перечень установленных в систему языковых пакетов, вы можете выбрать необходимый язык, используемый при работе с системой
• Нажмите на необходимое название модуля (Кликнув 2 раза) и укажите новые названия для обозначения единственного и множественного числа
• Нажмите на кнопку «Сохранить» для сохранения изменений
• Нажмите на кнопку «Отказаться» для отмены внесённых изменений

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

• Перейти в модуль, наименование закладки которого было изменено
• Перейти в компонент «Надписи»
• Обновить надпись соответствующих списков

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

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


Создание поля
Для добавления поля выполните следующее:
1. Выберите компонент «Поля»
В необходимом модуле выберите компонент «Поля», на странице отобразится список как стандартных, так и пользовательских полей:

• В первой колонке списка указано наименование поля, хранимое в БД
• Во второй — видимое значение, при необходимости оно может быть изменено в редакторе надписей (или здесь же)
• В третьей колонке указан тип поля, задаваемый при создании поля в соответствии с типом хранимых в нём данных

Примечание: пользовательские (кастомные) поля расположены в конце списка, оканчиваются на «_c» и помечены символом звёздочки

2. Нажмите на кнопку «Добавить поле»
После чего отобразится форма создания/редактирования поля

3. Укажите доп. информацию
В редакторе поля укажите значения параметров

3.1 Тип данных
Выберите соответствующий тип данных, основываясь на данных, которые будут вводиться в поле

Примечание: поля типа Relate никак не связаны с существующими пользовательскими связями. Изменения данных полей не влияют на существующие связи и наоборот.

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

1. Название поля
Название поля, сохраняемое в базе данных. Не должно содержать пробелов и специальных символов. Указывать название необходимо в английской раскладке.

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

3. Системная надпись
Используется для обращения к полю внутри системы, также отображается слева от поля при редактировании надписей. Система заполняет данное поле автоматически, на основе указанного названия поля, добавив к нему префикс «LBL_». При необходимости вы можете поменять это значение на этапе создания поля.

4. Справка
Введите описание поля. Этот текст отображается в виде подсказки при наведении курсора на поле в форме редактирования записи.

5. Комментарий
При необходимости введите комментарий к полю, он остается только в модуле студии.

6. Значение по умолчанию
При необходимости укажите стандартное значение поля.

7. Максимальный размер
Параметр отображается при создании текстовых типов полей. Задаёт максимальное количество символов, вводимых в поле.

8. Массовое обновление — чек-бокс
Параметр отображается при выборе типов «Выпадающй список» или «Дата». Добавляет создаваемое поле в раздел массового обновления формы списка.

9. Комбобокс
Параметр отображается при выборе типов «Выпадающий список», «Множественное выделение», «Радио».

10. Минимальное значение
Параметр отображается при выборе типа «Целое значение». Задаёт минимально допустимое значение числа.

11. Максимальное значение
Параметр отображается при выборе типа «Целое значение». Задаёт максимально допустимое значение числа.

14. Открыть ссылку на
Параметр отображается при выборе типа URL и позволяет открывать ссылку на текущей или на новой странице или закладке браузера

15. Точность
Параметр отображается при выборе типа «Десятичное значение», «Значение с плавающей точкой». В поле необходимо ввести количество символов в дробной части числа (Справа после запятой).

16. Обязательное поле — чек-бокс
Отметьте данный параметр, если поле является обязательным для заполнения

17. Аудит — чек-бокс
Отметьте данный параметр, если хотите отслеживать изменения значений данного поля и видеть перечень внесённых изменений при просмотре журнала изменений записи

18. Быстрая правка — чек-бокс
Отметьте данный параметр, если хотите изменять значение данного поля непосредственно в форме списка или в форме просмотра записи

19. Импортирование. Из выпадающего списка выберите одно из следующих значений:

• Да. Разрешить пользователям импортировать значения в данное поле (При сопоставлении полей системы с полями импортируемого файла данное поле отобразится)
• Нет. Запретить пользователям импортировать значения в данное поле (При сопоставлении полей системы с полями импортируемого файла — данное поле не отобразится)
• Обязательное. При импортировании значение не может быть пустым (При сопоставлении полей системы с полями импортируемого файла — данное поле обязательно должно быть сопоставлено с полем из файла)

Для создания стандартного комбобокса необходимо:
1. В компоненте «Поля» нажать на «Добавить поле»
2. В поле «Тип поля» выбрать тип «Выпадающий список», «Множественное выделение» или «Радио»
3. В редакторе поля нажмите на кнопку «Добавить

4. Из выпадающего списка выберите необходимый языковой пакет
5. Укажите название создаваемого комбобокса. Система автоматически предлагает использовать суффикс «_list» для идентификации комбобокса в базе данных, однако, вы можете изменить предлагаемое значение по вашему желанию
6. Введите ключ добавляемого в комбобокс элемента. Данный ключ будет использоваться в базе данных системы
7. Введите видимое значение добавляемого в комбобокс элемента. Данное значение будет отображаться в интерфейсе системы
8. Нажмите на кнопку «Добавить». В элементах списка появится новая позиция
9. Для добавления нового элемента списка повторите шаги 6−8
10. Для добавления в комбобокс пустого значения нажмите на кнопку «Добавить», не вводя значений ни в ключ, ни в видимое значение комбобокса

11. Для сортировки элементов списка воспользуйтесь кнопками восходящей и нисходящей сортировки
12. Для сохранения внесенных изменений нажмите на кнопку «Сохранить»

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

Для редактирования комбобокса выполните следующее:
1. Нажмите на кнопку «Изменить» для перехода в редактор комбобокса
2. Для редактирования элемента комбобокса нажмите на второй значок справа и отредактируйте надпись

3. Для удаления элемента нажмите на крайний правый значок

4. Для добавления нового элемента введите ключ, видимое значение и нажмите на кнопку «Добавить»
5. Нажмите на кнопку «Сохранить» для сохранения изменений
6. Нажмите на кнопку «Отменить» для отмены внесённых изменений
7. Нажмите на кнопку «Вернуть» для возврата внесённых изменений

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

Для этого необходимо:
1. Создать поле «Регион» с типом «Выпадающий список» и создать для него комбобокс с выбором значений региона

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

В качестве родительского комбобокса необходимо указать имя первого поля с окончанием «_c» на конце

3. В компоненте «Макеты» добавить только что созданные поля в форму редактирования и форму просмотра
4. Нажать кнопку «Сохранить и установить»

Таким образом, при выборе в поле «Регион» значения «21» в поле «Столица региона» отобразятся значения, ключ которых начинается с «21»

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


1. Связь «Один к одному»
Каждая запись основного модуля связана только с одной записью подчинённого модуля. Для создания связи данного типа необходимо:
1. В выбранном модуле (Который будет основным) перейти в компонент «Связи». На странице будут отображены все существующие в модуле связи.
2. Нажать на кнопку «Добавить связь»
3. В справочнике «Тип связи» выбрать значение «Один к одному»
4. В блоке «Подчиненный модуль» в справочнике «Модуль» выбрать подчиненный модуль. Записи основного и подчинённого модулей будут представлены в виде отдельных полей.
5. Нажать на кнопку «Сохранить и установить» для сохранения и опубликования связи. Созданная связь появится в нижней части списка связей и будет помечена звёздочкой, указывающей на то, что данная связь создана пользователем системы.
6. Нажать на кнопку «Отказаться» для отмены внесенных изменений при создании связи

Важно: после создания связи необходимо отобразить данное поле в форме редактирования и в форме просмотра обоих модулей.


2. Связь «Один ко многим»
Каждая запись основного модуля связана с несколькими записями подчинённого модуля. Соответственно, в форме просмотра подчинённого модуля появляется поле, содержащее данные о связанном модуле, а в форме просмотра основного модуля появляется субпанель, содержащая данные о связанных записях подчиненного модуля.

Для создания связи данного типа необходимо:
1. В выбранном модуле (Который будет основным) перейти в компонент «Связи». На странице будут отображены все существующие в модуле связи.
2. Нажать на кнопку «Добавить связь»
3. В справочнике «Тип связи» выбрать значение «Один ко многим»
4. При необходимости для локализации названия связи из выпадающего списка «Язык» выберите соответствующее значение
5. В блоке «Подчиненный модуль» в справочнике «Модуль» выбрать подчиненный модуль
6. В поле «Надпись» дублируется наименование выбранного подчиненного модуля. При необходимости его можно изменить
7. В зависимости от выбранного подчинённого модуля выберите необходимую субпанель или оставьте стандартную (default). В форме просмотра основного модуля запись подчинённого модуля будет представлена в виде соответствующей субпанели
8. Нажмите на кнопку «Сохранить и установить» для сохранения и опубликования связи. Созданная связь появится в нижней части списка связей и будет помечена звёздочкой, указывающей на то, что данная связь создана пользователем системы.
9. Нажмите на кнопку «Отказаться» для отмены внесенных изменений при создании связи

Новая связь создается в виде панели в основном модуле, соответственно к изменению лейбла субпанели, порядка отображаемых полей, их наименования можно перейти через компонент «Субпанели».

Далее необходимо отобразить данное поле в форме редактирования и в форме просмотра подчиненного модуля, для этого:
1. Перейдите в подчиненный модуль в студии
2. Откройте макет формы редактирования или макет формы просмотра (Или оба при необходимости)
3. Отобразите поле основного модуля из инструментария в текущий макет
4. Сохраните внесенные изменения

Таким образом в подчиненном модуле будет отображена связь с основным модулем.


3. Связь «Многие ко многим»
Каждая запись основного модуля связана с несколькими записями подчинённого модуля, и каждая запись подчинённого модуля связана с несколькими записями основного модуля. Соответственно, в форме просмотра основного модуля появляется субпанель, содержащая данные об подчиненном модуле, а в форме просмотра подчинённого модуля появляется субпанель, содержащая данные о связанных записях основного модуля.

При выборе связи типа «Многие ко многим» укажите подчинённый модуль и выберите необходимые субпанели как в основном, так и в подчинённом модуле.

Для создания связи данного типа необходимо:

1) В выбранном модуле (Который будет основным) перейти в компонент «Связи». На странице будут отображены все существующие в модуле связи
2) Нажать на кнопку «Добавить связь»
3) В справочнике «Тип связи» выбрать значение «Многие ко многим»
4) При необходимости для локализации названия связи из выпадающего списка «Язык» выберите соответствующее значение
5) В блоке «Подчиненный модуль» в справочнике «Модуль» выбрать подчиненный модуль
6) В поле «Надпись» дублируется наименование выбранного подчиненного модуля. При необходимости его можно изменить
7) В зависимости от выбранного основного и подчинённого модулей выберите необходимую субпанель или оставьте стандартные (default)
8) Нажмите на кнопку «Сохранить и установить» для сохранения и опубликования связи. Созданная связь появится в нижней части списка связей и будет помечена звёздочкой, указывающей на то, что данная связь создана пользователем системы
9) Нажмите на кнопку «Отказаться» для отмены внесенных изменений при создании связи


Удаление связей
Для удаления связи необходимо:
1. Открыть компонент «Связи» необходимого модуля
2. Выбрать необходимую связь в списке связей для удаления
3. Кликнуть 2 раза, чтобы перейти в редактор связей
4. Нажать на кнопку «Удалить»
5. При необходимости проставить чек-бокс «Не удалять таблицы»

Примечание: удалению подлежат только пользовательские (Помеченные звёздочкой) связи.

Макеты
Выберите данный компонент для редактирования макетов форм списка, форм просмотра, форм редактирования, форм быстрого ввода, форм поиска, а также всплывающих форм.

У пользователя с административными правами есть возможность изменять внешний вид модулей системы: удалять поля, добавлять новые (Предварительно созданные) поля, менять расположение полей, редактировать надписи, менять порядок перехода по полям при использовании клавиши «TAB».

Для редактирования в студии доступны макеты следующих форм:
1. Форма редактирования — позволяет редактировать информацию по открытой записи
2. Форма просмотра — отображает всю информацию по открытой записи
3. Форма списка — используется при открытии модуля и отображает список записей модуля
4. Форма быстрого ввода — появляется в субпанели модуля в тот момент, когда пользователь нажимает кнопку «Создать» и служит для быстрого создания записи, связанной с текущим модулем
5. Формы дашлета — используются при отображении параметров дашлета
6. Всплывающие формы — используются для всплывающих (Pop-up) окон при поиске и отображении списка записей
7. Фильтры — используются для фильтрации информации в текущем модуле
8. Субпанели — используются для работы со связанными записями в форме просмотра записи


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

Слева от макета расположен раздел «Инструментарий», содержащий:
1. Поля: в списке содержатся все доступные в модуле, но не содержащиеся на данный момент в макете поля
2. Новая панель: при необходимости вы можете добавить в макет новую панель; при размещении полей на отдельной панели они будут визуально отделены от остальных полей макета
3. Новая строка: добавляются на панели и фактически резервируют места в макете, на которые в дальнейшем могут быть перемещены необходимые поля
4. Удалить: поместите в данную область поля, которые необходимо удалить из макета

Доступные опции в макетах формы редактирования, формы просмотра и формы быстрого ввода:

1. Для добавления полей в макет переместите их из инструментария в текущий макет (Заранее необходимо добавить строку через кнопку «Новая строка», чтобы создать место для расположения поля)
2. Для группировки полей в панель используйте кнопку «Новая панель». В системе имеется возможность отображать панель в виде панели либо в виде отдельной закладки (Данный параметр необходимо выбрать из списка справочника «Отображать как»)

Если выбрано значение «Панель», то появляется возможность отображения панели в свернутом или в развернутом виде по умолчанию (Для этого проставьте чек-бокс «Свернуть?»)

3. Для изменения порядка расположения полей нажмите на заголовок поля и переместите его в желаемую позицию (Для изменения порядка расположения панелей аналогично)
4. Для скрытия полей из макета переместите необходимые поля из текущего макета в инструментарий на кнопку «Удалить». При этом удалённое из макета поле будет доступно в списке полей инструментария
5. Для изменения лейбла поля кликните на значок редактирования данного поля (Находится в правом углу), далее в поле «Надпись» введите необходимое значение и сохраните изменения
6. Для установки порядка перехода по полям при использовании клавиши «TAB» кликните на значок редактирования данного поля (Находится в правом углу), далее в поле «Порядок перехода» укажите целое число 1, 2, 3 и т. д.
7. Для сохранения внесённых изменений в макете нажмите на кнопку «Сохранить»
8. Для того, чтобы внесенные изменения стали доступны всем пользователям системы, нажмите на кнопку «Сохранить и установить»
9. Для просмотра внесённых изменений воспользуйтесь кнопкой «Просмотр истории». Для просмотра изменений, выполненных в определённое время, нажмите на кнопку «Предпросмотр» или на ссылку с указанием даты/времени. При необходимости нажмите на кнопку «Восстановить» для восстановления измененной версии макета.
10. Для восстановления стандартного вида макета нажмите на кнопку «Восстановить», расположенную справа от «Просмотр истории»

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

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

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