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

Хранимая процедура

Название хранимой процедуры (указывается только название процедуры, без схемы и квадратных скобок)

Автовысота строк

При включенной настройке автоматически будет установлена высота строк таблицы в соответствии с ее содержимым.

Количество строк итогов

Количество последних строк, которые будут идентифицироваться как итоговые

Брать стиль строки из

Название колонки, в которой хранится описание стиля (атрибуты форматирования) отображения для строк таблицы

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

Название колонки, в которой хранится ссылка отображения данных для строк таблицы

Счетчик значений

Отображение счетчика задач.

Доступны для выбора следующие варианты:

•Выключено — Счетчик не отображается. Значение по умолчанию.

•Количество строк — Отображается счетчик по общему количеству возвращаемых источником строк в таблицу.

•Smart — Отображается счетчик по результату, вычисленному в смарт-выражении. В результате выполнения должно возвращаться скалярное числовое значение (int). В смарт-выражении вы можете обращаться к значениям фильтра и к ID виджета — они находятся в папке Параметры события "Показ формы". Значения параметров поля "Фильтр" передаются в параметре @eventParam1 в формате JSON, а идентификатор виджета — в параметре @eventParam2. В параметре @eventParam1 дата передается как строка в формате '30.11.2019', а период — как JSON вида {"from":"01.11.2019","to":"30.11.2019 23:59"}.

При выборе значения Smart становится доступна опция Цвет счетчика.

Цвет счетчика

Цвет счетчика с количеством задач. Поле доступно, в опции Счетчик значений выбран вариант Smart.

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

•info — синий

•warning — оранжевый

•default — серый

•error — красный

Настройки вывода колонок

Блок кнопок

В первой строке настроек таблицы настраивается вывод кнопок. Если для таблицы настроены кнопки, все они выводятся в одной, самой первой (левой) колонке. Для этой колонки можно только включить признак Отображать, указать имя и ширину. Сами кнопки настраиваются в блоке Кнопки управления

Отображать

Если флажок отключен, то колонка не будет отображаться (по умолчанию отображаются все колонки)

Столбец sql

Название колонки в SQL-процедуре

Имя

Название колонки, как оно должно отображаться в таблице

Ширина колонки

Ширина колонки в % от общей ширины таблицы

Колонка для функции DrillDown

Название колонки, по которой будет строиться детализация (DrillDown).

Пример настройки детализации см. ниже

В SPA порталах данные в хранимую процедуру передаются со строчной первой буквы. К примеру: в aspx в хранимую процедуру придёт значение "TaskId", а в SPA — "taskId"

Хранимая процедура

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

Параметры хранимой процедуры:

•@XmlParam xml (readonly) — параметр, в который передаются значения фильтра, привязанного к виджету,

•@DrillDownField varchar(max) = null — название столбца SQL, для которого настраивается детализация (т.е. параметр определяет колонку, по которой кликнул пользователь).
Используется, если одна и та же хранимая процедура получает детальные данные по разным столбцам,

•@DrillDownParams varchar(max) = null — значение параметра для детализации (т.е. параметр определяет строку, по которой кликнул пользователь).
Поскольку поддерживается вложенная детализация с неограниченным количеством уровней вложенности, то в параметре передается полная история значений, по которым последовательно кликал пользователь. Это дает возможность вернуться в детализацию предыдущего уровня кнопкой "Назад",

•@UserID int = null — пользователь, для которого формируются данные.

Пример настройки детализации см. ниже

Детализация

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

Пример настройки детализации см. ниже

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

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

Если карточка задачи должна отображаться без рамки используйте формат ссылки: ~/spa/noframe/tasks/{TaskID}

Формат ссылок можно посмотреть здесь

Открывать в модальном окне

Если флажок включен, то ссылка, указанная в колонке "Брать ссылку из", будет открываться в модальном окне, а если не включен — в текущей вкладке

Другие настройки

По нажатию на значок открывается окно визуальных настроек и индикаторов

Другие настройки

Общие настройки

Выравнивание текста

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

Название группы колонок

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

Брать стилизацию из колонки

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

Брать класс из колонки

Поле, содержащее набор css-классов для форматирования значений в данной колонке

Режим фильтрации

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

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

•Отсутствует (по умолчанию)

•Обычный

•Excel

Вывод информации

Можно отметить один или несколько из флажков:

•Текст

•Изображение

•Индикатор

•График

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

Текст

Выделять красным отрицательные числа

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

Отображать 0

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

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

Вырезать теги

Если флажок включен, то текст в колонке будет выводиться без учета html-тегов

Переносить текст на другую строку

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

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

Изображение

Колонка значения

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

Высота %, px

Высота изображения в пискелях или процентах

Ширина %, px

Ширина изображения в пискелях или процентах

Стиль

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

Выравнивание

Определяет, будет ли индикатор отображаться слева или справа от значения в колонке

Индикатор

Тип индикатора

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

•Текст (используется по умолчанию)

•Иконка

Если выбрано значение Иконка, то ниже отображается поле для выбора набора иконок. Пока доступен только набор Material. Название иконки из набора должно возвращаться в колонке SQL-процедуры, указанной в настройке Колонка значения

Колонка цвета

Колонка из источника данных, которая определяет цвет фона индикатора. Значение должно быть в формате hex: #XXXXXX

Колонка значения

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

Стиль

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

Выравнивание

Определяет, будет ли индикатор отображаться слева или справа от значения в колонке

График

Колонка значения

Колонка из источника данных, которая содержит конфигурацию графика в формате JSON:

•Тип графика (линейный, столбчатый или круговая диаграмма)

•Параметры стилизации графика

•Данные

Примеры JSON, описывающих графики

Кнопки управления

Имя

Текст, который будет отображаться на кнопке

Описание

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

Иконка

Путь к иконке, которая будет отображаться на кнопке (если не указан, на кнопке будет только текст). Например:

../img/available_white1.gif

JavaScript выражение

Текст скрипта JS, который должен выполняться по нажатию кнопки. Событие нажатия на кнопку возвращает три параметра: object Row — строка, в которой была нажата кнопка, UserID — пользователь, нажавший кнопку, ID кнопки.

В JS-вставке доступна переменная event:

{
  originalEvent: MouseEvent;       // стандартный объект
  data: any;                       // строка с данными, к которой относится кнопка
  block: {
      reload: () => void;          // перезагрузить портальный блок
      freeze: () => void;          // сделать все кнопки в портальном блоке недоступными для нажатия
      unfreeze: () => void;        // сделать все кнопки в портальном блоке доступными для нажатия
  }
}

Описание стандартного объекта можно посмотреть здесь.

С помощью объекта event.data можно обратиться к полям возвращаемого списка задач или других объектов.

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

Например, event.data.isActive

Описание вызова методов веб-сервисов из JS-вставок

Колонка идентификатора (int)

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

Это поле должно быть названо так, как это оно названо в возвращаемом наборе данных (например, TaskID)

Пакеты действий

Смарт-пакет, который должен выполняться по нажатию кнопки.

В смарт-выражениях, используемых в данном пакете, доступны параметры события "Нажатие на кнопку":

•идентификатор объекта (значение из колонки идентификатора или ID строки),

•строка с json-объектом,

•ID кнопки,

а также параметры текущего пользователя.

URL

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

Адрес страницы может быть относительным или абсолютным, например:

/maintaskform.aspx?taskid=123 — относительный адрес,

https://ru.1forma.ru/maintaskform.aspx?taskid=123 — абсолютный адрес.

Колонка видимости (bool)

Название колонки, возвращающей признак видимости кнопки для текущего пользователя.

Если значение не заполнено, то считается, что видимость включена всегда.

Колонка активности (bool)

Название колонки, возвращающей признак активности кнопки. Если значение не заполнено, то считается, что активность включена всегда.

Default

Нет стиля

Success

background-color:#dff0d8 (зеленый)

Info

background-color:#d9edf7 (голубой)

Warning

background-color:#fcf8e3 (желтый)

Danger

background-color:#f2dede (розовый)

TotalsRow

font-weight: bold

BackRed

background-color: pink

BackGreen

background-color: lightgreen

BackBlue

background-color: lightblue

BackYellow

background-color: gold

TextRed

color: red

TextGreen

color: green