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

Режим Excel

Ключевой столбец

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

•Текст,

•Деньги,

•Выпадающий список,

•Телефон,

•Lookup,

•Число,

•Дата,

•Дата и время,

•RowID (в этом случае при импорте строки будут сопоставляться по порядковому номеру).

Отображать как

Вид отображения таблицы:

•Таблица — Таблица будет располагаться в карточке задачи

•Ссылка — В карточке задачи будет располагаться ссылка, по клику на которую таблица будет открываться в отдельной вкладке браузера

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

Таблица в виде полей

Максимальная высота таблицы в PX

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

Разрешить экспорт

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

В экспорте участвуют только столбцы, у которых включен параметр Разрешить экспорт (см. ниже настройку столбцов таблицы).

Особенности экспорта описаны в Руководстве пользователя

Разрешить импорт

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

В импорте участвуют только столбцы, у которых включен параметр Разрешить импорт (см. ниже настройку столбцов таблицы).

Особенности импорта описаны в Руководстве пользователя

Загружать файлы в момент вкладывания

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

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

Файловый провайдер

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

Сохранять строку после редактирования

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

Выбор ячейки при использовании клавиш Tab и Enter для перемещения по таблице не сбрасывается при активной опции, что позволяет продолжить работу в таблице без прерывания, используя клавиатуру

Создавать строки в модальном окне

Если настройка активна, то при добавлении строки в таблицу по кнопке "+" откроется модальное окно для ввода значений столбцов. Строка появится в таблице после нажатия кнопки "Ок" в модальном окне.

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

Включить секции столбцов в настройках таблицы

Включение настройки секций столбцов. Пример таблицы с настроенными секциями:

Пример таблицы с настроенными секциями

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

Режим ширины по умолчанию

Выбор режима ширины столбцов таблицы:

•По умолчанию

•По размеру экрана

•По содержимому столбцов

•По содержимому и заголовкам

Скрыть кнопку добавления строк

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

ID

Идентификатор столбца

Имя

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

Порядок

Порядок расположения столбцов в пользовательском режиме. По умолчанию для всех столбцов установлено значение 0.

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

Участвует в группировке, порядок

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

Тип

Тип данных в столбце. Доступные типы данных:

•Текст

•Большой текст без форматирования

•Выпадающий список

•Текст с маской

•Деньги

•Дата и время

•Дата

•Телефон

•LookUp

•Чекбокс (флажок)

•Число

•Файл

•Виртуальная

•Шаблонная

•Блок кнопок

•Выбор пользователей

Название секции

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

Сортировка по умолчанию

Столбец для сортировки строк таблицы. Возможные значения:

•Нет

•По возрастанию

•По убыванию

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

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

Смарт-выражение для вычисления значения в столбце.

Доступно для столбцов: Текст, Число, Дата, Дата и время, Деньги, Lookup, Большой текст без форматирования, Выбор пользователей

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

При использовании смарт-выражения для столбца становится недоступным режим "Обязателен для заполнения".

Смарт-столбцы вычисляются в момент, когда пользователь завершил редактирование строки в ДП "Таблица" и сохранил изменения, но после вычисления и сохранения в БД всех "не смарт" столбцов в данной строке таблицы

Маска

Маска для данных типа "текст".

Для прежней версии ДП "Таблица":

При описании маски используются следующие спецсимволы:

•# — цифра или пробел,

•L — обязательно большая буква,

•l — обязательно маленькая буква,

•a — любой символ,

•<n..m> — обязательно числовое значение от n до m,

•<Символ1|Символ2|Символ3> — один из указанных символов,

•\x — вставить в маску любой символ (например, "\а" вставит в маску символ "а").

Для новой версии ДП "Таблица"(Как включить новую таблицу):

Для добавления маски в поле необходимо ввести нужное значение:

•Email — добавляет маску почтового адреса в формате ___@___.__

•Phone — добавляет маску номера телефона в формате +_ (___) ___-__-__

Для создания кастомных масок используются следующие спецсимволы

•0 — любое число,

•a — любая буква,

•* — любой символ,

•[] — необязательные значения (указываются внутри скобок),

•{} — фиксированная часть (указывается внутри скобок),

•` — предотвращает смещение символов.

Пример: {#}000[aaa]/NIC-`*[**]'

Для нового ДП "Таблица" также возможно задать маску с помощью регулярных выражений.

Столбец шаблона значения

Настройка заполнения значения по шаблону в текстовом столбце. Опция доступна только для типа "Текст".

В опции выбирается другой столбец этой же таблицы с типом “Lookup поле" или “Текст”, который содержит шаблон в нотации RegEx. Шаблон может включать символы \w для прописных букв и \d для цифр, а пробелы вокруг них обязательны или могут быть началом/концом строки.

Если указан столбец "Lookup поле", то шаблон должен быть написан в тексте выбранной задачи.

Пример шаблона в карточке задачи для значения в столбце с типом "Lookup поле"

Примеры шаблонов:

•Утвердить сотруднику \w выполнение ЦП за \w на \d %

•Проект \w-\d

•Заявка №\d

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

Выбран шаблон в столбце "Lookup поле"

При редактировании ячейки текстового столбца будет отображаться подсказка с серым фоном и фиксированным текстом “Текст” или “Число” в зависимости от типа шаблона.

Редактирование текстового столбца с шаблоном

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

Ввод значений в шаблон

При просмотре таблицы введенный текст также отображается с фоновым выделением.

Отображение параметра после сохранения

Итого

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

Опция доступна для типов "Число" или "Деньги". Столбец активен, только если в таблице есть хоть одно поле одного из указанных типов.

Режим столюца

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

•Необязательно — столбец доступен, но не обязателен для заполнения.

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

•Только для чтения — столбец доступен только для чтения.

•Скрытая — столбец не отображается в пользовательском режиме и не доступен для вычислений. Обратите внимание: инструменты автоматизации не могут обращаться к столбцам данного типа.

•Невидимая — столбец не отображается в пользовательском режиме. В отличие от типа Скрытая, сохраняет доступ к данным для автоматизации.

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

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

Значение по умолчанию

Значение, подставляемое по умолчанию. Возможные значения:

•Оставить пустым

•Фиксированное значение

•Smart выражение

Шаблоны для фиксированных значений:

•Дата: DD-MM-YYYY, например 10-22-2018

•Дата и время: DD-MM-YYYY hh:mm, например 10-22-2018 10:30

•Лукап: {"Номер задачи":"Текст задачи"}, например {"123":"Продажа"}

•Выпадающий список: {"Значение":"Текст"}, например {"2":"Встреча"}

Пример SQL запроса на формирование даты

Недоступно для столбцов следующих типов: Файл, Телефон, Текст с маской, Виртуальная, Шаблонная, Блок кнопок

Локализованное значение

Локализованное значение названия столбца в таблице

Ширина столбца

Ширина столбца.

Если значение не задано (равно 0), то ширина рассчитывается автоматически в соответствии с типом данных столбца.

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

•1 —  Узкий диапазон

Столбец "Количество" с шириной 1

•2 — Малый диапазон

Столбец "Количество" с шириной 2

•4 — Средний диапазон

Столбец "Количество" с шириной 4

•6 — Широкий диапазон

Столбец "Количество" с шириной 6

Другие значения интерпретируются как ширина в пикселях (px). В отличие от значений 1, 2, 4, 6 столбцы будут растягиваться по ширине только до своего предела в зависимости от типа

Макс высота

(Устаревшее, не используется)

Максимальная высота столбца.

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

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

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

Определяет способ выравнивания заголовка столбца и его содержимого. Возможные значения:

•по левому краю

•по центру

•по правому краю

•по ширине

Прикрепить

Может принимать два значения: пустое и "Слева". Прикрепленные слева столбцы таблицы не двигаются при прокрутке таблицы в пользовательском режиме

Разрешить экспорт

Если опция активна, то столбец участвует в экспорте.

Разрешить импорт

Если опция активна, то столбец участвует в импорте.

Перенос строк

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

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

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

Видимость в закрытых секция

Столбец отображается в закрытой секции

Видимость в открытых секциях

Столбец отображается в открытой секции

Участвует в поиске

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

Логировать действия с файлами

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

Доступно только для столбца с типом Файл

Итого

Вывод итогов по столбцу.

Доступно только для столбца с типом Число, Деньги

Столбец шаблона значения

Выбор столбца этой же таблицы с типом Текст или Lookup.

Шаблон задается в виде регулярного выражения, которое указывается в столбце-источнике. Регулярное выражение работает в режиме редактирования и является регистрозависимым, где символ \w соответствует только прописным латинским буквам, а символ \d — любым цифрам. Пробелы вокруг этих символов обязательны, вместо пробела может быть начало или конец строки.

Например, если значение столбца-шаблона — “Утвердить сотруднику \w выполнение ЦП за \w на \d %”, то ввод в целевом столбце будет проверяться по этому шаблону. Для столбца типа “Lookup” в качестве шаблона используется текстовое значение связанной задачи. Проверка выполняется отдельно для каждой строки таблицы.

Доступно только для столбца с типом Текст

Настройки

Переход к дополнительным настройкам столбца (см. ниже)

Разрешить сканирование

Если настройка активна, в окне добавления строки в таблицу рядом с полем "Файл" отображается значок сканирования

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

При акцепте подписи будет создана системная копия файла

Отображать превью для картинок

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

Не работает для ДП с признаком "Мультифайл".

Имя

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

Кнопка без иконки и кнопка с иконкой

Описание

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

Иконка

Название иконки из набора, которая будет отображаться на кнопке (если не указан, на кнопке будет только текст). Набор доступен по адресу: /spa/content-icons.

Пример кнопки с иконкой

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 страницы, которая должна быть открыта в модальном окне после выполнения смарт-пакета.

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

/spa/tasks/12345  — относительный адрес,

https://Адрес_Приложения/spa/tasks/12345 — абсолютный адрес.

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

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

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

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

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

Сообщение при успехе

Текст, который отображается после успешного выполнения операции, подтверждая, что действие завершено

Сообщение при ошибке

Текст, который появляется в случае неуспешного выполнения операции, информируя пользователя о причине неудачи

Информационное сообщение при нажатии

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

Режим видимости

Смарт-фильтр видимости

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

Доступные значения:

•Блокировать по смарту — если кнопка заблокирована по смарту (смарт-фильтр возвращает true), она отображается, но недоступна для нажатия.

•Скрыть по смарту — если кнопка скрыта по смарту  (смарт-фильтр возвращает true), она не отображается в интерфейсе.

Имя

Название секции

Порядок

Порядок расположения секции в таблице

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

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

Имя

Название столбца

Использовать в множественном выборе

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

Ширина

Ширина столбца в пикселях. Если не задано (значение равно 0), то рассчитывается автоматически

Порядок

Порядок расположения столбцов в пользовательском режиме. По умолчанию для всех столбцов имеет значение 0.

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

Прикрепить

Может принимать два значения: пустое и "Слева". Прикрепленные слева столбцы таблицы не двигаются при прокрутке таблицы в пользовательском режиме

Отображать количество строк

Признак, будет ли в шаблоне отображаться общее число строк в таблице

Количество отображаемых строк

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

Использовать шаблон

Активирует шаблон и делает доступными соответствующие настройки

Синхронизировать существующие задачи

Позволяет обновить соответствующие значения в БД при изменении шаблона

Хранить html представление

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

В базе данных HTML-представление ДП Таблицы хранится в атрибуте ExtParamValueGZip таблицы ExtParamValues. При денормализации значение из поля ExtParamValueGZip сопоставляется с колонкой ExtParamNativeValue. Новое значение HTML-представления записывается в истории изменений ДП (ExtParamHistory) в атрибуте ExtParamValueGZip, а старое — в ExtParamOldValueGZip.

Раз в 3 минуты запускается задание по таймеру TableExtParamValuesGZipCompressJob, которое перегоняет значения в таблицах базы данных ExtParamHistory и ExtParamValues в Gzip. Запускается раз в 3 минуты, и обрабатывает по 10,000 строк за раз. Сначала ExtParamValues, потом ExtParamHistory.

Изменение в механизме хранения данных, вступающем в силу с версии 2.265:

Начиная с версии 2.265 Цефей, значение ДП "Таблица" не хранится в атрибуте ExtParamValue таблицы БД ExtParamValues, а также в атрибуте ExtParamXXXValue в денормализованной таблице TasksInSubcatXXXDenormalized.

При этом наличие значения в атрибуте ExtParamXXXNativeValue денормализованной таблицы, начиная с указанной версии, напрямую зависит от настройки параметра Хранить html представление. Если данная опция активна, значение будет записываться в базу данных, если опция отключена, запись производиться не будет

Шаблон переменной количества строк

Служебное поле, доступно только для чтения

Заголовок

Текст, который повторяется один раз в начале представления

Шаблон строки таблицы

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

Разделитель

Символ, которым строки отделяются друг от друга

Футер

Текст, который повторяется один раз в конце представления