Работа с ЭУ "Календарь"

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

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

Источником данных календаря может выступать:

  • Плагин — кодовое расширение.

  • Данные карточки — данные извлекаются из секций карточки, в разметке которой расположен ЭУ.

  • Виртуальная папка — данные извлекаются из набора карточек, который формирует виртуальная папка Docsvision.

    Виртуальная папка может выступать только источником событий, но не типов дней
ЭУ "Календарь"
Рисунок 1. ЭУ "Календарь"

Основные элементы ЭУ

  1. Кнопки навигации

  2. Влево — переход к предыдущему отрезку времени;

  3. Вправо — переход к следующему отрезку времени;

  4. Календарь — переход к конкретной дате, при нажатии на кнопку отображаются дополнительные элементы:

    • Календарь с галочкой — кнопка перехода к текущей дате (сегодня)

    • Дата — поле для ввода даты, к которой нужно перейти. Переход происходит сразу после ввода корректной даты.

  5. Дата начала и окончания текущего отображаемого отрезка времени.

  6. Кнопки выбора представления.

  7. Кнопка для отображения диалога с информацией об ЭУ.

  8. Событие с длительностью в несколько дней.

  9. Событие в рамках одного дня.

  10. Боковая панель — кнопка открытия боковой панели.

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

  12. Элемент группы события — цвет фона и текста элемента соответствует настройкам группы событий. Содержит чекбокс для переключения видимости группы.

  13. Элемент типа дня — цвет фона и текста элемента соответствует настройкам типа дня. Содержит чекбокс для переключения видимости типа дня.

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

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

Типы представлений:

  1. Грид по дням

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

  2. Грид по времени

    Представление календаря "Грид по времени"
    Рисунок 3. Представление календаря "Грид по времени"

  3. Список событий

    Представление календаря "Список событий"
    Рисунок 4. Представление календаря "Список событий"

  4. Несколько месяцев

    Представление календаря "Несколько месяцев"
    Рисунок 5. Представление календаря "Несколько месяцев"

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

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

Группы позволяют визуально выделить события по смыслу (например, совещания, дни рождения и т.д.). Набор групп событий задается в параметрах ЭУ.

Для каждой группы событий определяется:

  1. Идентификатор группы — используется для связи с группой событий в источнике данных

  2. Название — отображается во всплывающей подсказке к событию

  3. Цвет текста

  4. Цвет фона

  5. CSS классы

Типы дней

Типы дней позволяют визуально выделить дни по типам (например, отпуск, больничный и т.д.). Набор типов дней задается в параметрах ЭУ.

Для каждого типа дня определяется:

  1. Название — отображается во всплывающей подсказке к дню

  2. Идентификатор типа дня — используется для связи с типом дня в источнике данных

  3. Цвет фона

  4. CSS классы

Редактирование и просмотр

Если выбран источник данных Данные карточки, создание, редактирование и удаление событий календаря доступно при соблюдении следующих условий:

  • Свойство Только для чтения не включено.

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

  • Если задано сопоставление поля для автора события, то "ИЛИ".

    • Текущий пользователь = автор события.

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

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

  1. Выбран период времени (например, день или несколько дней):

    1. Изменить тип дня — доступно если в свойствах ЭУ задан набор типов дней.

    2. Добавить событие

  2. Выбрано событие

    1. Редактировать событие

    2. Копировать событие

    3. Пометить важным

    4. Удалить событие

Форма создания и редактирования события
Рисунок 6. Форма создания и редактирования события

  1. Название события — обязательное поле, отображается в блоке события в календаре

  2. Группа события — обязательное поле, отображается, если в свойствах ЭУ задан набор групп событий

  3. Дата начала — обязательное поле, дата начала события

  4. Дата окончания — не может быть ранее даты начала, дата окончания события

  5. Флаг "Весь день" — указывает, что событие длится весь день, т.е. время не учитывается

  6. Флаг "Важное" — помечает событие как важное

  7. Поле "Участники" — список участников события из справочника сотрудников. Отображается во всплывающей подсказке к событию и в форме просмотра события.

  8. Описание события — отображается во всплывающей подсказке к событию и в форме просмотра события

  9. Сведения об авторе события, дате создания, авторе последнего изменения и дате последнего изменения — отображаются в при редактировании ранее созданного события

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

Просмотр всех данных события происходит по двойному клику по событию:

Форма просмотра события
Рисунок 7. Форма просмотра события

Изменение типа дня происходит через следующую форму:

day type edit
Рисунок 8. Форма изменения типа дня

  1. Тип дня

  2. Комментарий — отображается во всплывающей подсказке к дню