Справочники
Секция Справочники определяет структуры данных, которые используются в приложении.
В секции Справочники содержится список из элементов, заголовок которых определяет название справочника и задаётся во множественном числе, например Заказы, Заявки и т.д.
Справочник
| Название | Тип | Описание |
|---|---|---|
| Наименование единицы справочника | Строка | Название единицы справочника в единственном числе. Например Заказ, Заявка и т.д. |
| Описание | Строка | Будет отображено на странице справочника по центру если список пуст и в правом верхнем углу если список не пуст. В случае отображение справочника календарём будет отображаться под элементом навигации по датам. |
| Иконка | Иконка | Используется для отображения в пункте меню. |
| Ширина окна создания-редактирования | Мелкое/Обычное/Очень мелкое/Широкое/Во всю ширину экрана | Модальное окно создания-редактирования элемента справочника будет заданного размера. |
| Позиция окна создания-редактирования | По центру экрана/Наверху экрана | Определяет вертикальное расположение модального окна создания-редактирования элемента справочника. |
| Изображение в описании | Путь до файла c картинкой | Будет отображено на странице справочника по центру если список пуст(левее текстового описания) и в правом верхнем углу если список не пуст(левее текстового описания). В случае отображение справочника календарём будет отображаться под элементом навигации по датам(выше текстового описания). |
| Поле для отображения всей сущности | Название поля этого справоника | Это поле будет использовано, если элемент этого справочника будет выбран по ссылке в другом поле другого справочника. |
| Поле для отображения как аватара | Название поля этого справоника | Это поле будет использовано как отображение аватара всей сущности, если элемент этого справочника будет выбран по ссылке в другом поле другого справочника. |
| Поле для отображения описания сущности | Название поля этого справоника | Это поле будет использовано как дополнительное описание всей сущности, если элемент этого справочника будет выбран по ссылке в другом поле другого справочника. |
| Доступно комментирование | Да/Нет | Связана с возможностью комментирования элементов этого справочника. |
| Условие показа пользователю комментариев | Условие | При выполнении условия пользователь может видеть комментарии. |
| Условие редактирование пользователем комментариев | Условие | При выполнении условия пользователь может создавать комментарии. |
| Тип сортировки | По возрастанию/По убыванию | Определяет направление сортировки. |
| Стратегия сортировки | По дате создания/Выбрать поле | Определяет какие поля будут использоваться для сортировки. |
| Поле для сортировки | Название поля этого справоника | Если Стратегия сортировки указана как Выбрать поле, то это поле будет использоваться для сортировки. |
| Поля | Массив объектов Поле справочника | Какие поля будут у этого справочника. Они могут быть отображены в колонках списков и как элементы редактирования в модальном окне создания-редактирования. |
| События | Массив объектов Событие | Логика событий при создании, редактировании и удалении элемента этого справочника. |
| Действия | Массив объектов Действие | Какие кнопки будут доступны для элемента этого справочника. |
| Инфоблоки | Массив объектов Инфоблок | Показ информационных блоков с текстом для пользователей, а так же подсвечивать строки в таблице по условию. |
| Вкладки | Массив объектов Вкладка | Какие вкладки будут отображаться в модальном окне создания-редактирования эемента этого справочника. |
| Представления | Массив объектов Представление | Определяет каким ролям и в каком виде будет отображаться справочник. |
Элементы
Поле справочника
| Название | Тип | Описание |
|---|---|---|
| Описание | Любой/Картинка/Аватар | Будет показана в всплывающем окне рядом с полем. |
| Тип поля | Булево значение/Время/Выбор роли/Вычислимое поле/Дата/Дата и время/Значение перечисления/Массив/Прогресс/Продолжительность/Сохранённый пароль/Строка/Таблица/Текст/Файл/Число/Элемент справочника | Определяет внешний вид и логику работы поля. |
| Тип файла | Любой/Картинка/Аватар | Eсли Тип поля указан как Файл или если Содержание массива указан как Файлы. |
| Тип числа | С точкой/Целое | Eсли Тип поля указан как Число или если Содержание массива указан как Числа. |
| Содержание массива | Строки/Файлы/Числа/Элементы перечисления/Элементы справочника | Eсли Тип поля указан как Массив. |
| Заполнитель при пустом значении | Строка | Отображается при отсутствии значения в элементе ввода значения. |
| Размер | 1-16 | Размер поля по 16 колоночной сетке. |
| Обязательно при создании | Да/Нет | Если поле достпупно при создании, то оно будет обязательно к заполнению. |
| Обязательно при обновлении | Да/Нет | Если поле достпупно при редактировании, то оно будет обязательно к заполнению. |
| Условие редактирования | Условие | При выполнении условия пользователь может редактировать поле. По-умолчанию все пользователи могут редактировать все поля доступных справочников. |
| Условие скрытия | Условие | При выполнении условия пользователь не видит поле. По-умолчанию все пользователи видят все поля доступных справочников. |
| Условие добавления | Условие | Eсли Тип поля указан как Таблица. При выполнении условия пользователь может добавлять строки в таблицу. По-умолчанию все пользователи могут добавлять строки в таблицу, при доступности поля. |
| Скрыто в списке | Да/Нет | Не показывать колонку этого поля в списке. |
| Скрыто на форме | Да/Нет | Не показывать это поле в модальном окне создания редактирования. |
| Предвыбрано | Да/Нет | Если Тип поля выбран как Булево значение то галочка будет установлена при создании ноговое элемента справочника. Если Тип поля выбран как Элемент справочника или Значение перечисления то это будет выбрано первое значение из списка. |
| Справочник | Название справочника | Eсли Тип поля указан как Элемент справочника. |
| Перечисление | Название Перечисления | Eсли Тип поля указан как Значение перечисления. |
| Ограничение выборки | Условие | Eсли Тип поля указан как Элемент справочника. Позволяет ограничить выборку элементов справочника. |
| Короткое имя в списке | Строка | Если задано, то в списке будет показано это название для этого поля. |
| Вкладка | Название вкладки | В какой вкладке отображается поле. |
| Префикс | Строка | Отображается перед значением у элемента редактиррования и в списке у значения. |
| Постфикс | Строка | Отображается после значением у элемента редактиррования и в списке у значения. |
| Иконка у строкового поля | Иконка | Отображается у элемента редактирования в модальном окне создания-редактирования. |
| Скрыто для ролей | Массив названий ролей | Не показывать это поле для определённых ролей. |
| Поле для обратной ссылки | Навзание поля в справочнике указанном в поле Справочник | Eсли Тип поля указан как Таблица. По этому полю определяется какие элементы попадают в таблицу. |
Событие
Название события может быть одним из значений:
- Создание
- Обновление
- Удаление
| Название | Тип | Описание |
|---|---|---|
| Описание | Строка | Описывает что происходит в событии. Будет показано пользователю, если в коде события произойдёт ошибка. |
| Python код | Путь до python файла | При генерации события соответствующего типа будет вызван этот код. |
Действие
Название действия будет использована как название кнопки в интерфейсе.
| Название | Тип | Описание |
|---|---|---|
| Описание | Строка | Будет показана при наведении пользователем курсора на кнопку как всплывающее описание. |
| Python код | Путь до python файла | При генерации события соответствующего типа будет вызван этот код. |
| Иконка действия | Иконка | При генерации события соответствующего типа будет вызван этот код. |
| Условие доступности | Условие | При выполнении условия пользователю будет досутпно это действие. |
| Описание параметров | Строка | Если у действия есть параметры, то описание будет показано при открытии модального окна ввода параметров. |
| Иконка у описания параметров | Иконка | Если у действия есть параметры, то иконка будет показана при открытии модального окна ввода параметров рядом с Описанием параметров. |
| После выполнения | Закрывать окно/Оставлять открытым | Определяет будет ли модальное окно редактирования закрыто после выполнения действия. |
| Параметры | Массив объектов Параметр действия | Какие параметры будут запрошены у пользователя перед запуском действия. |
Параметры действия
Параметры будут запрошены у пользователя при запуске действия.
| Название | Тип | Описание |
|---|---|---|
| Тип поля | Булево значение/Время/Выбор роли/Вычислимое поле/Дата/Дата и время/Значение перечисления/Массив/Прогресс/Продолжительность/Сохранённый пароль/Строка/Текст/Файл/Число/Элемент справочника | Определяет внешний вид и логику работы поля. |
| Содержание массива | Строки/Файлы/Числа/Элементы перечисления/Элементы справочника | Eсли Тип поля указан как Массив. |
| Тип файла | Любой/Аватар/Картинка | Eсли Тип поля указан как Файл. |
| Справочник | Название справочника | Eсли Тип поля указан как Элемент справочника. |
| Перечисление | Название перечисления | Eсли Тип поля указан как Значение перечисления. |
| Обязательно при создании | Да/Нет | Поле будет обязательно для заполнения. |
| Размер | 1-16 | Размер поля по 16 колоночной сетке. |
| Описание | Строка | Будет показана в всплывающем окне рядом с полем. |
Инфоблок
| Название | Тип | Описание |
|---|---|---|
| Инфоблок | Да/Нет | Является ли текущий элемент инфоблоком(Прямоугольной областью заданного цвета расположенного выше всех полей на форме создания редактирования). |
| Индикатор | Да/Нет | Числовой индикатор в пункте меню связанном с справочником. |
| Подсветка | Да/Нет | Является подсветкой строки в таблице. |
| Описание | Строка | Отображается в инфоблоке или в описании индикатора. |
| Условие показа | Условие | При выполнении условия пользователь может видеть инфоблок. Если условие не задано, то инфоблок будет показан всем пользователям. |
| Иконка в инфоблоке | Иконка | Для инфоблока иконка будет показана левее описания. |
| Цвет | Белый/Бюрюзовый/Жёлтый/Зелёный/Коричневый/Красный/Оливковый/Оранжевый/Пурпурный/Розовый/Серый/Синий | Определяет цвет фона инфоблока, цвет подсветки и/или индикатора. |
| Показывать для ролей | Массив названий ролей | Для этих ролей будет показан инфоблок. Если эта настройка не задана, то инфоблок будет показан всем пользователям. |
Вкладка
Название вкладки можно использовать у поля в настройке Вкладка. Если на вкладке есть только одно поле с типом Таблица и таблица не пуста, то к имени вкладки будет добавлено количество элементов в таблице, например "Заказы (2)".
| Название | Тип | Описание |
|---|---|---|
| Описание | Строка | Отображается выше полей на вкладке. |
Представление
| Название | Тип | Описание |
|---|---|---|
| Тип представления | Список/Форма создания/Карточки/Календарь/На внутреннем календаре | . |
| Описание | Строка | . |
| Поле для старта | Название поля этого справоника | . |
| Поле для окончания | Название поля этого справоника | . |
| Может создавать | Да/Нет | . |
| Может открывать окно редактирования | Да/Нет | . |
| Может сортировать по колонкам | Да/Нет | . |
| Может фильтровать по колонкам | Да/Нет | . |
| Показывать дату и время создания | Да/Нет | . |
| Действия в строках | Да/Нет | . |
| Доступен полнотекстовый поиск | Да/Нет | . |
| Дополнительные фильтры | Массив названий полей этого справочника | . |
| Иконка | Иконка | . |
| Имя кнопки Создать | Строка | . |
| Может выгружать в эксель | Да/Нет | . |
| Может загружать из эксель | Да/Нет | . |
| Может выделять галочками | Да/Нет | . |
| Новое имя единицы справочника | Строка | . |
| Новое имя справочника | Строка | . |
| Показывать идентификатор | Да/Нет | . |
| Поле для отображения горизонтальных колонок | Массива названий полей этого справочника | . |
| Поля для отображения | Массив названий полей этого справочника | . |
| Поля для суммы | Массив названий полей этого справочника | . |
| После редактирования | Закрывать окно/Оставлять открытым | . |
| После создания | Закрывать окно/Оставлять открытым | . |
| Правило выборки | Условие | . |
| Разделять вертикальными линиями | Да/Нет | . |
| Разряженные строки | Да/Нет | . |
| Текст после создания | Строка | . |
| Ширина списка | Узкий/На всю ширину экрана | . |
| Тип сортировки | По возрастанию/По убыванию | Определяет направление сортировки. |
| Стратегия сортировки | По дате создания/Выбрать поле | Определяет какие поля будут использоваться для сортировки. |
| Поле для сортировки | Название поля этого справоника | Если Стратегия сортировки указана как Выбрать поле, то это поле будет использоваться для сортировки. |
Примеры app.rms
Минимальный
app.rms (Фрагмент)
Перечисления:
- Статус напоминания:
Значения:
- Ожидает выполнения:
- Выполнено:
- Просрочено:
- Статус визита:
Значения:
- Запланирован:
- Завершён:
Максимальный
app.rms (Фрагмент)
Перечисления:
- Статус визита:
Значения:
- Запланирован:
Цвет: Синий
- Завершён:
Цвет: Зелёный
- Отменён:
Цвет: Красный