Show/Hide Toolbars

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

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

Ссылки Назад Вверх Вперед

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

Источники данных задач (TaskSources) используются для настройки контейнеров-синдикатов. Источник данных может объединять данные из нескольких категорий или использовать сложные условия отбора данных.

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

data_sources_2_new

Форма настройки источника данных задач.

Источник данных задач может задаваться как фильтр поиска, смарт-фильтр или LUA скрипт.  Чтобы выбрать нужный режим, кликните мышью на левую или правую часть блоке "Фильтр задач".

Название

Описание

Фильтр задач

Фильтр поиском

Настройка параметров отбора задач. По ссылке "Открыть настройки поиска" открывается окно расширенного поиска:

кликните мышью для просмотра изображения в полном размере

Параметры не сохраняются и при повторном открытии окна редактирования сбрасываются (становятся пустыми)!

Смарт-фильтр

Выбор готового смарт-фильтра из выпадающего меню (чтобы отредактировать выбранный фильтр, нажмите !edit) или создание нового (нажмите !GreenCross). Открывается обычное окно редактирования смартов.

warning_icon   Смарт-фильтр не должен содержать сортировки (если это запрос на TSQL, он не должен содержать ORDER BY).

В смарт-фильтре можно использовать параметр @ContextId, содержащий ID задачи, и @CurrentSessionUserId, содержащий Id текущего пользователя

warning_icon   Контроль прав запроса возлагается на системного администратора! Для контроля прав используйте процедуру fn_UserTskPermissions()

Пример смарт-фильтра:

example_smart-filter
В данном случае происходит проверка на выполнение двух условий: задача должна принадлежать к 9361 категории и быть в статусе "Выполняется" (ID статуса = "2")

Сортировка

Поле

Название поля, по которому осуществляется сортировка задач

Смарт-выражение

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

warning_icon   Смарт-выражение не должно содержать сортировки (если это запрос на TSQL, он не должен содержать ORDER BY)

Сортировать

Порядок сортировки (по возрастанию\по убыванию)

Выводить

Пустые записи (не содержащие значений) можно выводить в начале или в конце отсортированного списка

LUA скрипты

LUA скрипты

Выбор готового смарт-скрипта из выпадающего меню (чтобы отредактировать выбранный скрипт, нажмите !edit) или создание нового (нажмите !GreenCross). Открывается обычное окно редактирования смарт-скрипта.

warning_icon   При указании LUA скрипта остальные настройки будут скрыты

Создание источника данных

Чтобы создать новый источник данных, нажмите кнопку Создать источник данных задач (1), введите название источника (2) и нажмите кнопку Добавить (3).

data_sources_6

Создание нового источника данных задач.

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

Удаление источника данных

Чтобы удалить источник данных, выберите его в выпадающем списке (1) и нажмите кнопку Удалить (2).

data_sources_3

Удаление источника данных задач.

Особенности использования

Структура отдачи tasksource

{tasks, categories, templates}

в task МП находит нужную категорию и далее находит нужный шаблон для отображения.

Кастомная ячейка рендирится в МП вертикально, где по вертикали имеем заданный в шаблоне порядок элементов (основных и доп параметров). Это следует иметь в виду при настройке дин. шаблонов.

В Template структура имеет вид: {settings, sections > blocks > elements}. Подробнее в разделе Настройка динамического шаблона.

Типовой и нетиповой дизайн

В источнике данных могут присутствовать задачи из разных категорий. Для каких-то категорий могут быть настроены свои шаблоны для вывода задачи в списке (cell), и эти шаблоны могут внешне отличаться друг от друга. В этом случае список задач в источнике данных может получиться внешне разнородным и плохо читаемым. Чтобы управлять этим, в шаблоне taskSourceDashboardItem есть параметр cellStyle, который может принимать значения default и custom.

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

Если выбрано значение custom, то для отображения каждой задачи будет использоваться шаблон Cell, указанный в ее категории, а если шаблон в категории не указан, то будет использоваться шаблон по умолчанию. Это сделает список разнородным, но позволит учесть особенности отображения разных задач.

CustomTaskSource

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

В этом случае используется контейнер с Id равным CustomTaskSource. Для контейнера настраивается шаблон taskSourceDashboardItem. В параметре cellStyle шаблона указывается значение custom. В параметр dataSourceUrl записывается адрес вызова публикации (при необходимости задаются значения параметров). Публикация должна возвращать данные в формате JSON, соответствующие по структуре и наполнению динамическому шаблону. В этой публикации можно настроить и детализацию данных (drill-down) по нажатию на какое-то поле.

Полезные ссылки