Show/Hide Toolbars

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

Блоки "Используется" (БИ)

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

В блоках "Используется" (сокращенно — БИ) могут отображаться задачи из других категорий, а также другие объекты (письма, звонки, файлы и пр.), имеющие отношение к данной задаче. Таким образом на карточке можно собрать все сведения, необходимые для работы с этой задачей — например, все контакты, документы и события по текущему контрагенту. Кроме того, это позволяет наглядно отобразить связи этой категории с другими категориями. Вот так это может выглядеть в карточке задачи в интерфейсе пользователя:

binded-01

Блок "Используется" в пользовательском режиме

Возможность создавать новые задачи в соответствующие категории непосредственно из блока "Используется" определяется доступностью кнопки binded-02. Это настраивается отдельно для каждой вкладки блока. Видимость кнопки может определяться не только по принципу "да/нет" ("отображается/скрыта"), но и с помощью смарт-фильтра.

Также можно настраивать доступность БИ по смарт-фильтру — в зависимости от того, кто просматривает карточку задачи (т.е. от текущего пользователя), а также от параметров самой задачи. Таким образом, вы можете скрыть лишние БИ от тех, кто ими не пользуется, чтобы не загромождать карточку задачи.

Создание БИ

Для создания нового блока нажмите кнопку Создать.

cats_properties_used-001

Список БИ в категории

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

cats_properties_used-002

Форма создания блока

Настройки блока:

Параметр

Описание

ID

ID блока. Создается автоматически после создания

Имя

Название блока

Порядок на форме

Порядок БИ в карточке задачи относительно других БИ, групп и блоков ДП

warning_icon Если у блока "Используется" порядок на форме = 1, а у блока ДП = 2, в карточке задачи БИ будет располагаться выше блока ДП и наоборот.

Может сворачиваться

Если параметр активен, в пользовательском режиме рядом с названием блока будет отображаться стрелка для раскрытия блока. В раскрытом виде отображается название и содержимое блока, в свернутом — только название.

По умолчанию свернут

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

Доступен по смарт-фильтру

Определяет доступность (т.е. видимость) блока в зависимости от условий (например, от текущего пользователя или параметров самой задачи).

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

Параметр недоступен при создании, смарт-фильтр можно задать на форме редактирования БИ.

Видимость

Определяет видимость блока в различных интерфейсах. Параметр недоступен при создании, видимость можно задать на форме редактирования БИ.

Возможные значения:

Скрыта — блок не отображается нигде

Только мобильный — блок отображается только в мобильном приложении и не виден в веб-интерфейсе

Только веб — блок отображается только в веб-интерфейсе и не виден в мобильном приложении

Отображать везде — блок отображается и в веб-интерфейсе, и в мобильном приложении

Данная настройка имеет приоритет по отношению к остальным настройкам, влияющим на видимость блока ("Доступен по смарт-фильтру").

Режим Скрыта может использоваться для того чтобы "спрятать" блок, который раньше использовался, в настоящее время не нужен, но может потребоваться в дальнейшем и поэтому не удаляется

Создание вкладки БИ

Для настройки новой вкладки блока перейдите на вкладку Добавить таблицу в блок:

cats_properties_used-0004

Добавление таблицы в блок

Колонка

Описание

Добавить таблицу из источника данных

Связанная категория

Необходимое условие для такой настройки — в связанной категории должен быть ДП Lookup, настроенный на задачи данной категории. Поэтому в выпадающем списке "Категория" будут отображаться только категории, где такой ДП есть.

При создании новой задачи из такой вкладки в БИ (кнопкой Создать) в новой задаче в ДП Lookup автоматически будет записана ссылка на исходную задачу.

Пример настройки

Процедура (SQL) для получения данных

warning_icon Для обеспечения корректной работы группировки и фильтрации задач БИ с источником данных Хранимая процедура SQL необходимо перевести на Произвольные источники данных

Требования к SQL процедурам для БИ:

Параметры: UserID, TaskID, UserNameMode, ShowAllTasks, StartIndex, EndIndex;

Возвращаемые поля: Tasks.TaskID, Tasks.IsOverdue, Tasks.StateID, Tasks.PriorityID, Tasks.IsClosed,  TaskColor.IntColor,  States.FinishWork, Tasks.ParentTaskID.

Пример процедуры

Произвольный источник

Произвольным источником может являться хранимая процедура SQL. К таким процедурам предъявляется ряд требований. Входные параметры хранимой процедуры:

Обязательно: @UserID (int) — ID текущего пользователя.

Опционально: @TaskID (int) — ID текущей задачи

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

Хранимая процедура может возвращать произвольные данные и произвольный набор колонок. Названия колонок должны быть на латинице без пробелов.

Пример процедуры

warning_icon Обратите внимание: при изменении состава колонок в хранимой процедуре или функции требуется обновить колонки на вкладке Колонки в настройках произвольного источника данных

Smart фильтр

Для поля Smart фильтр необходимо создать смарт-фильтр, возвращающий значение true для тех задач, которые должны отображаться на вкладке блока "Используется". Смарт-фильтр будет сохранен в разделе "Общие SMART". Также вы можете выбрать смарт-фильтр из раздела "Общие SMART".

Поле Категория определяет категорию, в которой будут создаваться новые задачи из данной вкладки БИ, и не влияет на результаты отбора смарт-фильтра. Смарт-фильтр может отбирать задачи из любых категорий, в том числе из нескольких одновременно. Поэтому если вкладка БИ настраивается с помощью смарт-фильтра, она может содержать задачи сразу из нескольких категорий.

warning_icon Особенности обращения к параметрам контекста при создании смарт-фильтров для БИ описаны в настройках СМАРТ категории

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

Существующая таблица

Повторное добавление в блок уже существующей вкладки из данного или другого БИ в категории

Выбрать блок

Блок, в который будет добавлена данная вкладка

Категория

Категория, в которую будут ставиться задачи при нажатии на кнопку "Создать".
Поиск поддерживается как по названию категории, так и по ID.

Порядок

Номер вкладки в блоке (слева направо)

Имя

Если имя указано, то оно будет отображаться в качестве названия вкладки; если же имя не указано, то названием вкладки станет название источника данных (доступно только для источников SQL и Smart)

Показывать только активные

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

Smart фильтр

или

Процедура (SQL) для получения данных

Название smart-выражения или SQL процедуры, возвращающих набор данных для отображения.

Требования к SQL процедурам для БИ:

параметры: UserID, TaskID, UserNameMode, ShowAllTasks, StartIndex, EndIndex;

возвращаемые поля: Tasks.TaskID, Tasks.IsOverdue, Tasks.StateID, Tasks.PriorityID, Tasks.IsClosed,  TaskColor.IntColor,  States.FinishWork, Tasks.ParentTaskID.

Отображать кнопку "Создать"

Если флажок включен, на вкладке блока будет отображаться кнопка Создать. Пользователи смогут создавать новые задачи в соответствующей категории непосредственно из блока "Используется". Если источником для вкладки является связанная категория, то создаваемые задачи будут сразу же "привязаны" к исходной задаче через ДП Lookup.

Возможные значения:

Да (кнопка отображается)

Нет (кнопка не отображается)

Smart/TSql (кнопка отображается, если смарт-фильтр возвращает true)

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

Пакетная обработка

Если флажок включен, то на панели инструментов вкладки отображается кнопка пакетной обработки, и на данной вкладке пользователи смогут запускать пакетную обработку. Описание пакетной обработки есть в Руководстве пользователя. Если пакетная обработка задач инициирована в режиме выбора (см. ниже), то обрабатываются все выбранные задачи, иначе — обрабатываются все задачи, отображаемые на данной вкладке блока.

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

перенести срок,

изменить заказчика,

добавить/удалить исполнителей,

написать комментарий,

добавить/удалить подписчика,

перенести задачи в другую категорию,

удалить задачи (если пользователь имеет права администратора)

Режим выбора

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

Тип контента

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

Возможные значения:

Задача

Прочее (например, письмо или звонок)

Брать ссылку из

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

Название одной из колонок набора данных, которая возвращает хранимую процедуру.

Если ссылка заполнена, то по клику на строку в БИ будет открываться ссылка, хранящаяся в данном поле.

Если ссылка не заполнена, то по клику на строку в БИ будет открываться ссылка на задачу

Открывать ссылку в

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

Определяет, как будет открываться ссылка, указанная в настройке Брать ссылку из. Возможные значения:

По умолчанию — в соответствии с настройкой Область просмотра задач в профиле пользователя.

В новом окне

В модальном окне

Видимость

Определяет видимость блока в различных интерфейсах.

Возможные значения:

Скрыта — блок не отображается нигде

Только мобильный — блок отображается только в мобильном приложении и не виден в веб-интерфейсе

Только веб — блок отображается только в веб-интерфейсе и не виден в мобильном приложении

Отображать везде — блок отображается и в веб-интерфейсе, и в мобильном приложении

Данная настройка имеет приоритет по отношению к остальным настройкам, влияющим на видимость блока ("Доступен по смарт-фильтру").

Режим Скрыта может использоваться для того чтобы "спрятать" блок, который раньше использовался, в настоящее время не нужен, но может потребоваться в дальнейшем и поэтому не удаляется

Редактирование БИ

Для перехода к редактированию БИ нажмите на нужную строку в таблице.

cats_properties_used-0003

Редактирование настроек блока

В категории могут быть настроены несколько БИ, а в каждом блоке может быть несколько вкладок, каждая из которых имеет свой источник данных.

В качестве источников данных для вкладок блока могут выступать:

Связанные категории (имеющие ДП типа Lookup, настроенные на выбор из данной категории);

Хранимые процедуры SQL (требования к таким процедурам описаны ниже);

Произвольные источники данных;

Любые категории (отбор задач ограничивается смарт-фильтром, а связи между задачами по ДП типа Lookup не учитываются).

Настройки для различных типов источников данных имеют свои особенности, они описаны ниже.

warning_icon Настройки вкладок с различными типами источников данных имеют свои особенности, см. ниже

Одна таблица может быть одновременно добавлена в несколько блоков. При этом одна и та же таблица в одном блоке может встречаться только один раз.

Для перехода к редактированию таблицы (вкладки БИ) нажмите на нужную строку в таблице.

cats_properties_used-004

Редактирование таблицы

Настройки таблицы (вкладки блока):

Параметр

Описание

Категория

Категория, в которую будут ставиться задачи при нажатии на кнопку "Создать".
Доступен поиск по названию или id категории.

Порядок

Номер вкладки в блоке (слева направо)

Показывать только активные

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

Имя

Если имя указано, то оно будет отображаться в качестве названия вкладки; если же имя не указано, то названием вкладки станет название источника данных (доступно только для источников SQL и Smart)

Источник

Название smart-выражения или SQL процедуры

Табличный вид

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

cats_properties_used-5

Табличный вид

warning_icon Не забывайте настраивать табличный вид для каждой вкладки БИ

Порядок выбора табличного вида:

Если для вкладки настроен свой табличный вид, то задачи во вкладке отображаются в соответствии с этим видом.

Если табличный вид для вкладки не настроен, проверяется табличный вид категории (если во вкладке отображаются задачи из категории, а не SQL-view или смарт-фильтра).

Если табличный вид категории также не настроен или во вкладке отображаются задачи из SQL-view или смарт-фильтра, то используется табличный вид по умолчанию

Нажатие на кнопку Сброс табличного вида БИ пользователя удаляет настройки табличного вида у текущего пользователя

Нажатие на кнопку Сброс табличного вида БИ всех пользователей удаляет настройки табличного вида у всех пользователей

Отображать кнопку "Cоздать"

Если параметр включен, на вкладке блока будет отображаться кнопка Создать. Пользователи смогут создавать новые задачи в соответствующей категории непосредственно из блока "Используется". Если источником для вкладки является связанная категория, то создаваемые задачи будут сразу же "привязаны" к исходной задаче через ДП Lookup.

Возможные значения:

Да (кнопка отображается)

Нет (кнопка не отображается)

Smart/TSql (кнопка отображается, если смарт-фильтр возвращает true)

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

Пакетная обработка

Если параметр включен, то на панели инструментов вкладки отображается кнопка пакетной обработки, и на данной вкладке пользователи смогут запускать пакетную обработку. Описание пакетной обработки есть в Руководстве пользователя. Если пакетная обработка задач инициирована в режиме выбора (см. ниже), то обрабатываются все выбранные задачи, иначе — обрабатываются все задачи, отображаемые на данной вкладке блока.

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

перенести срок,

изменить заказчика,

добавить/удалить исполнителей,

написать комментарий,

добавить/удалить подписчика,

перенести задачи в другую категорию,

удалить задачи (если пользователь имеет права администратора)

Режим выбора

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

Тип контента

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

Возможные значения:

Задача

Прочее (например, письмо или звонок)

Брать ссылку из

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

Название одной из колонок набора данных, которая возвращает хранимую процедуру.

Если ссылка заполнена, то по клику на строку в БИ будет открываться ссылка, хранящаяся в данном поле.

Если ссылка не заполнена, то по клику на строку в БИ будет открываться ссылка на задачу

Открывать ссылку в

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

Определяет, как будет открываться ссылка, указанная в настройке Брать ссылку из. Возможные значения:

По умолчанию — в соответствии с настройкой Область просмотра задач в профиле пользователя.

В новом окне

В модальном окне

Видимость

Определяет видимость блока в различных интерфейсах.

Возможные значения:

Скрыта — блок не отображается нигде

Только мобильный — блок отображается только в мобильном приложении и не виден в веб-интерфейсе

Только веб — блок отображается только в веб-интерфейсе и не виден в мобильном приложении

Отображать везде — блок отображается и в веб-интерфейсе, и в мобильном приложении

Данная настройка имеет приоритет по отношению к остальным настройкам, влияющим на видимость блока ("Доступен по смарт-фильтру").

Режим Скрыта может использоваться для того чтобы "спрятать" блок, который раньше использовался, в настоящее время не нужен, но может потребоваться в дальнейшем и поэтому не удаляется

warning_icon  Информация о привязке таблиц к БИ хранится в новой таблице базы данных EpBlockSettingsToBlocks

Форма быстрой постановки задач

В блоке "Используется" возможно включить краткую постановку задач. Если она активирована, то нажатие на кнопку Создать открывает краткую форму — на ней отображаются системные поля в зависимости от настроек категории (текст задачи, исполнитель, срок и т.д.) и обязательные при создании ДП.

binded-10

Краткая форма постановки задачи

При этом в выпадающем меню доступен пункт "Полная форма".

binded-09

Пункт "Полная форма" в выпадающем меню

В базе данных настройки блока "Используется" находятся в таблице CustomTaskUsedAsEpBlockSettings, для включения быстрой формы постановки в поле IsQuickCreateForm необходимо указать значение "1" (по умолчанию "0").

warning_icon Возможно только для БИ, смотрящего на категорию

warning_icon Форма быстрой постановки не будет использована, если в категории при постановке есть обязательные ДП с типом "Таблица" и "Выбор нескольких задач из категории (Multilookup)" — в таком случае будет открыта полная форма.

Итоги

В системе есть возможность вывода и автоматический подсчет итогов в числовых и денежных полях отдельной строкой: сумма, среднее, минимальное и максимальное значение.

Для настройки итогов необходимо в добавить Кастомную настройку приложения DataSourceAggregates в формате: 

{ "type": "{type}", "id": {id}, "gridTotalColumns": { "{column}": ["sum","avg", "min", "max"] } }

где:

type — taskUsed.

id — ID БИ (атрибут "ID") из таблицы БД "CustomTaskUsedAsEpBlockSettings".

column — для ДП указывается ExtParam{ExtParamId}, где ExtParamId = ID ДП (Пример: если ID ДП=123, то ExtParam123); для основных параметров указывается имя параметра (Пример: "Общие плановые трудозатраты" = "overallPlan", "Общие фактические трудозатраты" = "overallFact").

Пример значения:

[{"type": "taskUsed", "id": 39, "gridTotalColumns": { "ExtParam1709": ["sum", "avg"]}}]

Переход к настройкам из пользовательского интерфейса

Перейти в настройки БИ можно из пользовательского интерфейса. Администраторам доступен пункт Настройки в контекстном меню при клике правой кнопкой мыши на блок в карточке задачи. Выбор пункта откроет соответствующий раздел режима администрирования.

admin-settings-mtf-07

Переход к настройкам из пользовательского режима

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