Элемент управления "Календарь"

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

Свойства

Высота календаря

Строка, задает высоту календаря в виде строки свойства width (например, "500px" или "50%"),

Группы событий

Содержит набор групп событий. Редактирование свойства осуществляется через форму:

Рисунок 1. Группы событий

Кнопки редактирования списка групп (порядок элементов влияет на порядок элементов в выпадающем списке в форме создания/редактирования события).
Список групп.
Свойства выбранной группы.

Представления

Содержит набор представлений только для чтения, список представлений. Редактирование свойства осуществляется через форму:

Рисунок 2. Представления

Кнопки редактирования списка представлений (порядок элементов влияет на порядок кнопок переключения представлений в интерфейсе календаря).
Список представлений.
Свойства выбранного представления.

Типы дней

Содержит набор типов дней. Редактирование свойства осуществляется через форму:

Рисунок 3. Типы дней

Кнопки редактирования списка типов дней (порядок элементов влияет на порядок элементов в выпадающем списке в форме изменения типа дня).

Источник данных

Задается источник данных календаря. Редактирование свойства осуществляется через форму.

Выбор плагина в качестве источника данных

Рисунок 4. Выбор "Плагина" в качестве источника данных календаря

Выберите и настройте тип источника данных Плагин.
Укажите название плагина в поле Имя плагина.

Выбор секции и полей для событий

Рисунок 5. Выбор "Данных карточки" в качестве источника данных календаря

Выберите и настройте тип источника данных Данные карточки.
Область События предназначена для описания Событий и Участников, содержит следующие поля:
1. Поле Секция событий — табличная секция, содержит следующие подчинённые поля:
  1. Название события — поле с типом String или Unistring.
  2. Дата начала — поле с типом Date или DateTime.
  3. Дата окончания — поле с типом Date или DateTime.
  4. Весь день — поле с типом Bool.
  5. Описание события — поле с типом String, Unistring, Text или Unitext.
  6. Группа событий — поле с типом:
    
    String.
    
    Unistring.
    
    UniqueId.
    
    RefId.
    
    Int.
    
    Enum.
  7. Важное — поле с типом Bool.
  8. Создал — поле с типом RefId, ссылка на сотрудника справочника сотрудников.
  9. Дата создания — поле с типом DateTime.
  10. Изменил — поле с типом RefId, ссылка на сотрудника справочника сотрудников.
  11. Дата изменения — поле с типом DateTime.
2. Поле Секция участников — табличная секция, содержит следующие подчинённые поля:
  1. Участник — поле с типом RefId, ссылка на сотрудника справочника сотрудников.
  2. ИД события — поле с типом RefId или UniqueId.
    
    Используется для связи секции событий и секции участников, если секция участников НЕ является дочерней к секции событий.
Область Дни используется для выбора дней, содержит поля для Дней, и Годов — используется для хранения типов дней.
1. Поле Секция дней — табличная секция
  1. Дата — поле с типом Date или DateTime. Поле доступно, если указана секция дней и не указана секция годов.
  2. Номер дня — поле с типом Int (доступно если указана секция годов)
  3. Тип дня — поле с типом:
    
    String
    
    Unistring
    
    UniqueId
    
    RefId
    
    Int
    
    Enum
  4. Комментарий — поле с типом:
    
    String
    
    Unistring
    
    Text
    
    Unitext
2. Секция годов — табличная секция, содержит следующие подчинённые поля
  1. Год — поле с типом Int.

Выбор виртуальной папки

Рисунок 6. Выбор "Виртуальной папки" в качестве источника данных календаря

Выберите и настройте тип источника данных Виртуальная папка.
ИД папки — системный идентификатор папки.
Поисковый параметр начала периода — параметр должен быть опеределен в поисковом запросе папки и использовать в условии на поле с типом Date или DateTime.
Поисковый параметр окончания периода — параметр должен быть опеределен в поисковом запросе папки и использовать в условии на поле с типом Date или DateTime.
Настройки видов карточек — определяет набор видов карточек, которые будут отображаться в календаре. Настройка осуществляется через форму:

Рисунок 7. Настройки видов карточек для выбора виртаульной папки
1. В области Прочее выберите:
  1. Вид карточки — выбор вида карточек.
  2. Отображаемое название — можно задать отобржамое название, которое будет использоваться, напр., в контекстном меню создания карточки.
  3. Весь день — определяет будут ли карточки данного вида трактоваться как события с признаком "Весь день".
  4. Группа событий — задает группу событий, к которой будут отнесены карточки данного вида
    
    Осуществляется выбор из набора групп, заданного в поле Группы событий.
  5. Разрешить создание — определяет будет ли доступно создание карточки данного вида в контекстном меню календаря
  6. Разрешить удаление — определяет будет ли доступно удаление карточки данного в контекстном меню календаря
  7. Разрешить редактирование — определяет будет ли доступно редактирование карточки данного в контекстном меню календаря
2. В области Сопоставление полей определяется сопоставление полей карточки и событий календаря:
  1. Название события — поле с типом String или Unistring.
  2. Дата начала — поле с типом Date или DateTime.
  3. Дата окончания — поле с типом Date или DateTime.
  4. Весь день — поле с типом Bool.
    
    Приоритет имеет свойство Весь день вида.
  5. Описание — поле с типом String, Unistring, Text или Unitext,
  6. Группа событий
    
    Поле с типом:
    
    String
    
    Unistring
    
    UniqueId
    
    RefId
    
    Int
    
    Enum
    
    Приоритет имеет свойство Группа событий вида.
  7. Важное — поле с типом Bool.
  8. Создал — поле с типом RefId, ссылка на сотрудника справочника сотрудников.
  9. Дата создания — поле с типом DateTime.
  10. Изменил — поле с типом RefId, ссылка на сотрудника справочника сотрудников.
  11. Дата изменения — поле с типом DateTime.
Представление — задает представление, которое будет использоваться в гриде папки календаря, по умолчанию выбрано представление папки

Параметры

Задает дополнительные параметры, которые передаются в методы плагина-источника данных.

Операция редактирования типов дней

Операция редактирования для проверки доступности изменения типов дней.

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

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

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

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

Только для чтения

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

Начало периода

Только для чтения, начальная дата выбранного периода.

Конец периода

Только для чтения, конечная дата выбранного периода.

Целый день

Только для чтения, выбран ли весь день.

Текущая дата

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

Настройки календаря

Настройки компонента FullCalendar, подробнее в Документации FullCalendar.

Пункты контекстного меню

Позволяет изменить набор команд контекстного меню календаря.

События

Перед загрузкой данных

Вызывается перед отправкой запроса на получение данных.

После загрузки данных

Вызывается после отправкой запроса на получение данных.

При изменении текущей даты

Вызывается при перелистывании календаря.

При изменении текущей даты

Вызывается при перелистывании календаря.

При изменении периода

Вызывается при смене выделения в календаре.

При выборе пункта контекстного меню

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