Перейти к основному содержимому
Версия: 1.20.1

Choice Timeline

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

Внешний вид виджета​

Виджет состоит из следующих элементов:

  1. Заголовок.

  2. Условные обозначения – сопоставление определенного цвет и значения статуса. Отображает только те статусы, в которых была запись.

  3. Дата и время начала – отображает время начала работы над задачей.

  4. Общее время, проведенное в статусах – отображает общее время, проведенное во всех неисключенных статусах.

  5. Дата и время окончания – отображает время, когда работа над задачей была завершена. Задача должна быть в неактивном режиме (Активно = false)

Порядок сегментов соответствует порядку изменения значений статуса. Также ширина сегмента соответствует времени нахождения в определенном статусе относительно общего времени.

При наведении курсора на определенный сегмент отображается окно с названием статуса и временем нахождения в этом статусе. Если время меньше 1 минуты, отображается <1м.

Ниже показано время начала и окончания этого статуса. Если текущий статус является последним сегментом, вместо времени окончания отображается значение Сейчас.

Настройка виджета​

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

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

Добавление виджета на форму​

Чтобы добавить виджет на форму, выполните следующие шаги:

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

  2. В бургер-меню выберите Настроить → Форма → Макет.

  3. Из окна Доступно для выбора перенесите виджет Timeline в окно Выбрано.

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

  4. Нажмите Сохранить, чтобы применить изменения.

примечание

Если вы не настроите опции схемы, виджет будет иметь настройки по умолчанию:

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

Настройка опций схемы виджета​

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

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

  1. Измените заголовок виджета по умолчанию, определив новый:

    {
         "title": "Название"
    }
    подсказка

    Лучше использовать заголовок, созданный в таблице Исходные сообщения (source_message), чтобы у него были переводы.

  2. Задайте колонку типа Choice:

    {
         "column": "column_name"
    }

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

    {
         "colorMap": [
                    {"color": "#123456", "value": "choice_option.value"
    }

  4. Исключите некоторые статусы, чтобы они не отображались в виджете. Исключенные статусы отображаются серым цветом. Они занимают минимальную ширину и не учитываются в общем времени:

    {
         "excludedStates": "choice_option.value"
    }

Пример виджета​

Следующие опции:

{
    "title": "Task",
    "column": "state",
    "colorMap": [
        { "color": "#000000", "value": "1" },
        { "color": "red", "value": "-1" }
    ],
    "excludedStates": ["-2", "7"]
}

настраивают следующий виджет:

Дополнительная информация​

Виджет отображается только на созданных записях. Данные об изменении статуса берутся из таблицы Истории (sys_history), данные о статусах и их переводы берутся из таблицы Опции выбора (sys_choice).

примечание
  • Если в Истории (sys_history) есть значения опций, которых нет в наборе опций для текущего дочернего элемента таблицы Задачи, виджет ищет подходящее в наборах ближайшего родителя этой таблицы (если таковой имеется).
  • Если в Опциях выбора (sys_choice) для текущей таблицы нет статусов, виджет получает доступ к статусам родительской таблицы.
  • Если нет переводов или самого статуса, выводится значение статуса из Истории (sys_history).