Перейти к основному содержимому

Параметры

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

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

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

КАСКАД 3, WinCC OA, АСОКУ​

Параметр для получения данных из системы КАСКАД версии 3. Использует протокол XMLRPC для доступа к точкам данных и архивам. Источник данных также совместим со SCADA-системами WinCC OA и АСОКУ.

Настройки параметра:

  • «Внешнее соединение» — соединение с системой КАСКАД 3, настроенное на форме «Внешние соединения».
  • «Тип параметра» — вид запроса:
    • «Текущее значение точки данных» — текущее (онлайн) значение точки данных.
    • «Значение параметра за метку времени» — последнее значение точки данных, записанное в архив не позже выбранной метки времени.
    • «Среднее за период для дискретного параметра» — среднее арифметическое значений, записанных в архив за период.
    • «Средневзвешенное за период» — среднее, в котором каждое значение учитывается пропорционально времени, в течение которого оно действовало. Значение, действовавшее на начало периода, входит в расчёт.
    • «Последнее за период» — последнее значение, записанное в архив за период. Если записей за период нет, значение пустое.
    • «Минимальное за период для дискретного параметра» — наименьшее из значений, записанных в архив за период.
    • «Максимальное за период для дискретного параметра» — наибольшее из значений, записанных в архив за период.
    • «Среднее за период для непрерывного параметра» — среднее арифметическое значений за период с учётом значения, действовавшего на начало периода.
    • «Минимальное за период для непрерывного параметра» — наименьшее значение за период с учётом значения, действовавшего на начало периода.
    • «Максимальное за период для непрерывного параметра» — наибольшее значение за период с учётом значения, действовавшего на начало периода.
    • «Сумма за период» — сумма значений, записанных в архив за период.
    • «Количество изменений параметра за период» — число значений, записанных в архив за период.
    • «Запрос» — произвольный запрос dpQuery() к архиву, результат в виде HTML-таблицы.
    • «Запрос алармов» — запрос событий из архива алармов, результат в виде таблицы.
    • «Значение параметра на начало отчётного дня» — значение точки данных на начало отчётного дня. Метка времени не выбирается.
    • «Значение параметра на первое число отчётного месяца» — значение точки данных на первое число отчётного месяца. Метка времени не выбирается.
    • «Значение параметра на первое число отчётного года» — значение точки данных на первое число отчётного года. Метка времени не выбирается.
    • «Изменение значения параметра за период» — разница значений в начале и конце периода.
    • «Алармы за период» — список алармов в виде массива.
    • «Значения параметра за период времени» — массив значений точки данных.
    • «Значение пользовательского бита» — значение пользовательского бита точки данных с заданным номером на выбранную метку времени.
    • «Описание точки данных» — описание, заданное точке данных в проекте КАСКАД. Возвращается строкой.
    • «Единица измерения точки данных» — единица измерения, заданная точке данных в проекте КАСКАД.
    • «Формат точки данных» — формат вывода значения, заданный точке данных в проекте КАСКАД.
    • «Запись из каталога сообщений» — текст из каталога сообщений проекта КАСКАД по имени каталога, ключу сообщения и индексу языка.
  • «Адрес тега» — адрес точки данных. Можно ввести вручную или выбрать через дерево тегов.
  • «Архивная группа» — номер архивной группы.
    • Настройка актуальна для проектов с NGA бекендом InfluxDB. Настройка опциональна.
    • Эта опция предназначена для оптимизации количества запросов к БД InfluxDB, так как по умолчанию запросы рассылаются во все архивные группы, что повышает нагрузку на SCADA-систему и БД InfluxDB.
    • При указании номера архивной группы в CONTROL-запрос добавляется выражение с ключевым словом ARCHIVENUM, которое указывает проекту, из какой группы читать данные.

КАСКАД 4​

Параметр для получения данных из системы КАСКАД версии 4.

Настройки параметра:

  • «Внешнее соединение» — соединение с системой КАСКАД 4, настроенное на форме «Внешние соединения».
  • «Тип параметра» — вид запроса:
    • «Значение параметра на текущее время» — текущее значение точки данных.
    • «Значение параметра за метку времени» — значение на указанный момент времени.
    • «Значения параметра за период времени» — массив значений за интервал.
  • «Имя системы» — имя подсистемы КАСКАД (например, System1).
  • «Адрес тега» — адрес точки данных. Можно ввести вручную или выбрать через дерево тегов.

OPC UA, DA, HDA​

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

Настройки параметра:

  • «Внешнее соединение» — соединение с OPC-сервером, настроенное на форме «Внешние соединения». Стандарт соединения (UA, DA, HDA) определяет доступные типы параметра.
  • «Тип параметра» — вид запроса:
    • «Значение параметра на текущее время» — текущее значение тега.
    • «Значение параметра за метку времени» — значение тега на указанный момент времени.
    • «Значения параметра за период времени» — массив значений тега за заданный интервал.
  • «Адрес тега» — адрес тега на OPC-сервере. Можно ввести вручную или выбрать через дерево тегов.
  • «Включать границы» — включать ли в выборку значения на граничных временных метках.
  • «Максимальное количество возвращаемых записей» — ограничение числа строк в результате.

СУБД Microsoft SQL Server, MySQL, PostgreSQL, InfluxDB​

Параметр для выполнения запросов к базам данных и использования результатов в отчёте. Поддерживаются Microsoft SQL Server, MySQL, PostgreSQL и InfluxDB. С помощью встроенного редактора запросов можно просматривать структуру БД и формировать запросы как вручную, так и с помощью графического конструктора.

Порядок настройки параметра:

  1. Настройте внешнее соединение с базой данных на форме «Внешние соединения».
  2. Создайте новый параметр в шаблоне отчёта и выберите тип «СУБД».
  3. Укажите свойства параметра:
    • «Внешнее соединение» — соединение, созданное на первом шаге.
    • «Тип параметра» — определяет формат вывода данных. Выберите подходящий вариант в зависимости от задачи.

Тип параметра СУБД

Тип параметра СУБД

«Тип параметра» позволяет отображать данные запроса в виде различных структур:

  • «Таблица (html)» — легковесная HTML-таблица без возможности редактирования. Для вывода больших объёмов данных в читаемом виде.
  • «Таблица (числа)» — таблица с исключительно числовыми данными. К элементам можно обращаться по индексам строк и столбцов (например, %Параметр%[1][0]). Оптимально, когда один запрос нужно многократно использовать в расчётах.
  • «Матрица объектов» — таблица для данных любого типа (строки, числа, даты). К элементам можно обращаться по индексам матрицы.
  • «Ячейка (строка)» — одно значение в виде строки. Можно размещать в табличных ячейках с шагом. Поддерживает редактирование в отчёте и подсветку.
  • «Ячейка (число)» — одно значение в виде числа. Можно размещать в табличных ячейках с шагом. Поддерживает редактирование в отчёте и подсветку.
  1. Настройте редактор запросов. Доступны два режима:
    • «Расширенный» — ручной ввод запроса. Включает «Обозреватель базы данных» для просмотра структуры БД (таблицы, столбцы, типы данных).
    • «Простой» — Low-code конструктор для построения запросов к одной таблице.

Тип параметра СУБД (Простой режим)

Тип параметра СУБД (Простой режим)

В простом режиме доступны следующие блоки:

  1. «Схема и таблица» — выберите целевую таблицу из выпадающего списка.
  2. «Столбцы» — выберите нужные столбцы, при необходимости укажите агрегатную функцию и псевдоним.
  3. «Отфильтровать (WHERE)» — задайте условия выборки. В поле «Значение» можно ввести константу или выбрать другой параметр шаблона.
  4. Дополнительно (опционально): «GROUP BY», «ORDER BY», «LIMIT».

Пример отображения данных в отчёте

Пример отображения данных в отчёте

ODBC​

Параметр для выполнения SQL-запросов через драйвер ODBC.

Настройки параметра:

  • «Внешнее соединение» — соединение через ODBC, настроенное на форме «Внешние соединения».
  • «Тип параметра» — формат возвращаемых данных:
    • «Таблица (html)» — результат запроса в виде HTML-таблицы.
    • «Массив дробных чисел» — двумерный массив числовых значений.
    • «Матрица объектов» — двумерный массив значений любого типа.
    • «Ячейка (строка)» — одно значение в виде строки.
    • «Ячейка (число)» — одно значение в виде числа.
    • «Множество строк» — одномерный массив строк.
  • «SQL-запрос» — текст запроса к базе данных.
  • «Включать заголовок» — добавлять ли строку с именами столбцов в результат (для типа «Таблица (html)»).

OLE DB​

Параметр для выполнения SQL-запросов через провайдер OLE DB.

Настройки параметра:

  • «Внешнее соединение» — соединение через OLE DB, настроенное на форме «Внешние соединения».
  • «Тип параметра» — формат возвращаемых данных:
    • «Таблица (html)» — результат запроса в виде HTML-таблицы.
    • «Ячейка (строка)» — одно значение в виде строки.
    • «Ячейка (число)» — одно значение в виде числа.
  • «SQL-запрос» — текст запроса к базе данных.
  • «Включать заголовок» — добавлять ли строку с именами столбцов в результат (для типа «Таблица (html)»).

WinCC​

Параметр для получения данных из SCADA-системы WinCC через её базу данных.

Настройки параметра:

  • «Внешнее соединение» — соединение с БД WinCC, настроенное на форме «Внешние соединения».
  • «Адрес тега» — имя тега в WinCC.
  • «Тип агрегации» — способ обработки данных за период:
    • «Значения параметра за период времени» — массив всех значений за интервал.
    • «Первое за период» — первое зафиксированное значение.
    • «Последнее за период» — последнее зафиксированное значение.
    • «Минимальное за период» — минимальное значение.
    • «Максимальное за период» — максимальное значение.
    • «Среднее за период» — среднее значение.
    • «Сумма за период» — сумма значений.
  • «Параметр с именем БД» — параметр шаблона типа string, содержащий имя базы данных WinCC.

HTTP​

Параметр для получения данных через HTTP-запрос. Результат возвращается в виде строки.

Настройки параметра:

  • «Внешнее соединение» — соединение с HTTP-сервером, настроенное на форме «Внешние соединения».
  • «Метод» — HTTP-метод запроса: «GET», «HEAD», «POST», «PUT», «DELETE», «OPTIONS».
  • «Путь» — путь к ресурсу, добавляемый к базовому URL соединения.
  • «Тело запроса» — тело запроса (для методов «POST», «PUT»).
  • «Заголовки» — список HTTP-заголовков в виде пар ключ — значение.

Наработка​

Параметр для получения расчётных показателей из модуля «Наработка».

Настройки параметра:

  • «Тип параметра» — функция расчёта:
    • «Продолжительность пребывания оборудования в определённом состоянии за период» — суммарная длительность нахождения в состоянии за интервал.
    • «Количество вхождений оборудования в определённое состояние за период» — число переходов в состояние за интервал.
    • «Информация по последнему пребыванию оборудования в определённом состоянии с начала года» — длительность последнего периода нахождения в состоянии с начала года.
    • «Журнал изменения состояний оборудования за период» — полный журнал переходов за интервал.
  • «Параметр» — параметр учёта времени работы, настроенный в модуле «Наработка».
  • «Устройство» — устройство из параметра учёта.
  • «Состояние» — состояние, по которому ведётся расчёт.

Отчёт​

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

Настройки параметра:

  • «Тип параметра» — способ получения данных: одно значение параметра, список значений и т. д.
  • «Отчёт» — отчёт ТехноДок, из которого берутся данные.
  • «Параметр» — конкретный параметр выбранного отчёта (для получения единственного значения).
  • «Список параметров» — набор параметров выбранного отчёта (для получения нескольких значений).
  • «Временная метка» — момент времени для отчётов на срез времени.

ПК Пирамида​

Параметр для получения данных из программного комплекса Пирамида.

Настройки параметра:

  • «Внешнее соединение» — соединение с ПК Пирамида, настроенное на форме «Внешние соединения».
  • «Тип параметра» — вид запроса (значение параметра, дискретное состояние и т. д.).
  • «Параметр» — имя параметра в ПК Пирамида.
  • «Имя объекта» — имя объекта, к которому относится параметр.
  • «Код объекта (ObjCode)» — числовой код объекта.
  • «Элемент объекта (ObjItem)» — числовой код элемента объекта.
  • «Имя группы дискрет» — название группы дискретных состояний (для дискретных запросов).
  • «Имя дискреты» — название конкретного дискретного состояния.
  • «Значение по умолчанию» — состояние по умолчанию для дискретных значений.

Информационная модель​

Параметр для получения данных из информационных моделей ТехноДок — см. «Информационные модели».

Настройки параметра:

  • «Информационная модель» — модель, из которой параметр получает данные.
  • «Тип параметра» — режим получения данных: «Список узлов», «Значение атрибута» или «Ссылка на информационную модель».
  • «Узлы» (при типе «Список узлов») — один или несколько узлов, выбранных из дерева модели; в отчёт выводится список их имён.
  • «Узел» и «Атрибут» (при типе «Значение атрибута») — узел модели и один из его пользовательских атрибутов; в отчёт выводится текущее значение этого атрибута.

При типе «Ссылка на информационную модель» дополнительные настройки не нужны — параметр возвращает саму модель: её идентификатор и имя.

Файл (Текст)​

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

Настройки параметра:

  • «Источник» — откуда берётся файл:
    • «Сервер» — файл читается с сервера через внешнее соединение.
    • «Клиент» — файл загружается пользователем в браузере при открытии отчёта.

Для источника «Клиент»:

  • «Расширение файла» — фильтр допустимых расширений (например, xlsx, csv).

Для источника «Сервер»:

  • «Формат файла» — формат читаемого файла: «TXT», «CSV» или «Excel».
  • «Внешнее соединение» — соединение с файловым хранилищем, настроенное на форме «Внешние соединения». Для формата «Excel» используется отдельный тип соединения.

Дополнительные настройки для формата «Excel»:

  • «Тип параметра» — формат возвращаемых данных:
    • «Таблица» — диапазон ячеек в виде таблицы.
    • «Ячейка (строка)» — одна ячейка в виде строки.
    • «Ячейка (число)» — одна ячейка в виде числа.
  • «Название или номер страницы» — имя или порядковый номер листа книги (нумерация с 1).
  • «Адрес первой ячейки» — адрес ячейки или начала диапазона в формате A1.
  • «Адрес последней ячейки» — адрес конца диапазона в формате A1 (только для типа «Таблица»).

Расчётные параметры​

Агрегация​

Параметр, вычисляющий агрегированное значение по данным другого параметра за заданный период. Совместим с параметрами типов: КАСКАД 3, КАСКАД 4, ПК Пирамида, OPC UA, СУБД (числа), а также другими параметрами агрегации.

Настройки параметра:

  • «Тип агрегации» — функция агрегирования:
    • «Среднее» — среднее арифметическое значений параметра за период.
    • «Суммарное» — сумма значений параметра за период.
    • «Максимальное» — максимальное значение параметра за период.
    • «Минимальное» — минимальное значение параметра за период.
  • «Параметр» — параметр шаблона, данные которого агрегируются.
  • «Заменять ошибку значением, если нет данных» — если настройка включена, то при отсутствии данных за период агрегации вместо ошибки расчёта в отчёте отображается заданное значение. Если выключена, то при отсутствии данных параметр рассчитывается с ошибкой.

Для включённой настройки «Заменять ошибку значением, если нет данных»:

  • «Значение, если нет данных» — текст, отображаемый в ячейке вместо ошибки расчёта, например нет данных.

Расчётный параметр​

Расчётные параметры предназначены для вычисления значения параметра при помощи скриптов на языке C#. Расчётные параметры могут ссылаться на другие параметры шаблона и использовать как встроенные функции ТехноДок, так и стандартные функции доступные в SDK .NET, например, математические функции. Полный справочник встроенных переменных, функций и структур данных приведён на странице Расчётные параметры.

Настройки и действия с расчётными параметрами:

  • «Тип возвращаемого значения» — «Дробное», «Целое», «Дата» и т. д. Определяет тип значения, которое возвращает расчётный параметр. Значение можно выбрать из выпадающего списка или ввести вручную, если формула возвращает сложные типы данных, например IDictionary<string, string>. Поддерживаются все базовые типы данных и структуры .NET SDK.
  • Кнопка «Проверить» — выполняет проверку введённой формулы, при обнаружении ошибок подсвечивает строки с ошибками и указывает подробный комментарий к ошибке.
  • Кнопка «Вставить параметр» — показывает список параметров отчёта который может быть использован в формуле, позволяет выбрать параметр и вставить в формулу как ссылку, например, %Параметр из отчёта%.
  • Кнопка «Вставить метку времени» — показывает список меток времени которые могут быть использованы в формуле: «Дата начала отчёта», «Дата окончания отчёта», «Метка времени начала шага», «Метка времени окончания шага» (для отчётов с шагом) и т. д.
  • Кнопка «Вставить формулу» — показывает список формул которые определены в справочнике формул.
  • Кнопка «Открыть справку» — показывает встроенную справку с описанием системных функций ТехноДок (см. Расчётные параметры).
  • Кнопка «Развернуть» — переводит редактор формул в полноэкранный режим.

Расчётный параметр

Настройки параметра:

  • «Формула» — выражение в редакторе формул. В формуле можно использовать идентификаторы других параметров шаблона, математические операции и встроенные функции.

Случайное значение​

Параметр, генерирующий случайное число в заданном диапазоне. Используется для тестирования шаблонов отчётов.

Настройки параметра:

  • «Минимальное значение» — нижняя граница диапазона.
  • «Максимальное значение» — верхняя граница диапазона.

Компоненты​

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

Компонент, предоставляющий пользователю список значений для выбора. Используется как параметр ввода: выбранное значение передаётся в другие параметры шаблона.

Настройки параметра:

  • «Тип» — источник вариантов выбора: вручную, из словаря, из другого параметра шаблона.
  • «Множественный выбор» — разрешить выбор нескольких значений одновременно.

Для ручного заполнения:

  • «Варианты» — список значений для выбора.
  • «Значение по умолчанию» — вариант, выбранный при открытии отчёта (может быть задан как значение другого параметра).

Для заполнения из словаря:

  • «Словарь» — справочник ТехноДок.
  • «Класс» — класс объектов из выбранного словаря.
  • «Родительский экземпляр» — параметр шаблона, ограничивающий список значений по родительскому объекту (для иерархических словарей).
  • «Дополнительные варианты» — строки, добавляемые в список помимо значений из словаря.

Для заполнения из другого параметра:

  • «Параметр» — параметр шаблона, значения которого образуют список.

График​

Компонент для отображения числовых данных в виде графика. Поддерживает линейные, столбчатые и круговые типы графиков.

Настройки параметра:

  • «Тип графика» — вид визуализации: линейный, столбчатый, круговой.
  • «Серии» — набор параметров шаблона, отображаемых на графике. Для каждой серии задаётся параметр-источник данных, цвет и дополнительные настройки (тип линии, маркеры и т. д.).
  • «Настройки оси Y»:
    • Минимум и максимум — границы оси (если не задано — подбираются автоматически).
    • Интервал — шаг делений оси.
    • Дополнительные линии — горизонтальные линии на графике, привязанные к значениям параметров.
  • «Настройки оси X»:
    • Формат — автоматическая временная ось или массив меток из параметра.
    • Формат даты — строка форматирования временных меток (для автоматического режима).
    • Интервал — шаг временных меток.
    • Минимум и максимум — параметры, определяющие границы оси.
  • «Дополнительные настройки»:
    • Заголовок — текст над графиком.
    • Ширина и высота — размеры графика в пикселях.
    • Позиция легенды — расположение подписей серий (вверху, внизу, слева, справа, скрыта).

Дата​

Компонент, отображающий дату и время. Источником может служить системная дата отчёта или дата, введённая вручную, с возможностью задать смещение.

Настройки параметра:

  • «Значение» — источник даты: начало/конец периода отчёта, текущее время, дата, введённая вручную и т. д.
  • «Формат» — строка форматирования даты (например, dd.MM.yyyy HH:mm).
  • «Смещение» — поправка к дате: месяцы, дни, часы, минуты, секунды (положительные и отрицательные значения).

Диаграмма наработки​

Компонент для визуализации состояний оборудования на временной оси (диаграмма Ганта). Отображает периоды нахождения оборудования в различных состояниях.

Настройки параметра:

  • «Параметр» — параметр учёта времени работы, данные которого отображаются на диаграмме.
  • «Заголовок» — текст над диаграммой.
  • «Ширина» — ширина диаграммы в пикселях.
  • «Высота» — высота диаграммы в пикселях (если не задано — подбирается автоматически).
  • «Позиция легенды» — расположение подписей состояний.

Журнал​

Компонент для ведения журнала в отчёте: оператор вводит записи прямо в таблице журнала, а автор шаблона задаёт столбцы таблицы, порядок записей и доступные оператору действия.

Настройки параметра на вкладке «Основные»:

  • «Столбцы» — список столбцов журнала. Строка списка описывает один столбец: в ней задаются заголовок, тип и ширина. Остальные настройки столбца открываются кнопкой с шестерёнкой в строке, в окне «Настройки столбца». Поля строки и окна перечислены ниже.
  • «Размер» — ширина и высота журнала в пикселях. Если ширина не задана и ширина хотя бы одного столбца задана в процентах, журнал растягивается на всю ширину родителя. Если ширина не задана и столбцов в процентах нет, ширина журнала складывается из ширины столбцов: столбцы в пикселях получают заданную ширину, столбцы без ширины — по содержимому. Если высота не задана, она не ограничена. При заданной высоте записи, которые не поместились, прокручиваются, а строка заголовков остаётся на месте. На печати и в выгрузках журнал выводится целиком.
  • «Источник данных» — параметр шаблона, значение которого заполняет журнал при создании отчёта.

Поля строки в списке «Столбцы»:

  • «Заголовок» — название столбца. Заголовки столбцов одного журнала не повторяются: по заголовку на столбец ссылаются настройки «По умолчанию» в разделах «Сортировка» и «Группировка».
  • «Тип» — тип значения и поле, которым оператор заполняет ячейку. Типы перечислены в таблице ниже.
  • «Ширина» — ширина столбца в пикселях или в процентах от ширины журнала. Единица выбирается рядом с полем ширины. Ширина необязательна, у нового столбца она не задана.

Настройки в окне «Настройки столбца»:

  • «Требуемое» — запрещает добавлять запись с пустой ячейкой этого столбца. Незаполненная ячейка выделяется, а запись остаётся в строке ввода.
  • «Уникальное» — делает столбец частью ключа записи. Журнал не принимает две записи с одинаковыми значениями во всех уникальных столбцах и сообщает, в каких столбцах совпадение. Уникальный столбец всегда обязателен. Все столбцы журнала уникальными быть не могут. Если уникальных столбцов нет, журнал не принимает две полностью одинаковые записи.
  • Настройки типа столбца — описаны в таблице ниже.
  • «Значение по умолчанию» — значение, которым заполняется ячейка новой записи. Вид поля зависит от типа столбца.
ТипОписание
«Текст»Текст без оформления. Ячейка правится многострочным полем: Enter переносит строку, Ctrl+Enter или переход к другой ячейке завершает правку. Значение по умолчанию тоже может состоять из нескольких строк.
«Форматированный текст»Текст с оформлением: шрифтом и его размером, начертанием, цветом текста и фона, списками и выравниванием. Ячейка правится редактором с панелью форматирования, который появляется по щелчку на ячейке. Набор кнопок тот же, что у атрибута типа «Форматированный текст» информационной модели. Сортировка, фильтрация и группировка журнала учитывают только текст записи. Формулы отчёта получают значение как строку с HTML-разметкой. Значение по умолчанию задаётся в том же редакторе в окне «Настройки столбца». Там же выбирается справочник шаблонов записей.
«Число»Число. Поле ввода не принимает букв.
«Продолжительность времени»Интервал в формате чч:мм:сс.
«Дата»Дата и время, выбираются в календаре или набираются в поле. Маска и значение по умолчанию задаются в окне «Настройки столбца».
«Список»Значение из списка вариантов. Варианты задаются в поле «Варианты» окна «Настройки столбца». В том же окне включаются «Разрешить ручной ввод» — ввод значения, которого нет среди вариантов, — и «Множественный выбор» — выбор нескольких вариантов в одной ячейке. Значение по умолчанию выбирается из вариантов.
«Информационная модель»Узлы информационной модели. Модель задаётся в окне «Настройки столбца». Тип доступен при лицензии на модуль «Информационные модели».

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

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

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

Настройки параметра на вкладке «Дополнительные» в разделе «Журнал»:

  • «Сортировка» — раздел, который сворачивается и разворачивается щелчком по заголовку. При открытии окна раздел свёрнут. Настройки раздела:
    • «Включена» — разрешает в отчёте сортировать журнал по любому столбцу щелчком по его заголовку. Порядок записей в сохранённых данных при этом не меняется: после перезагрузки отчёта записи снова идут в порядке из настройки «По умолчанию». По умолчанию выключено.
    • «По умолчанию» — столбцы, по которым упорядочены записи в отчёте и в выгрузке, с направлением «По возрастанию» или «По убыванию». Записи упорядочиваются по первому столбцу списка, при равных значениях — по следующему. Приоритет столбца меняется стрелками в его строке. Значения сравниваются по типу столбца: числа как числа, дата и время как момент времени, значения списка — в порядке вариантов. Пустые значения идут первыми при сортировке по возрастанию и последними при сортировке по убыванию. Если список пуст, записи идут в порядке добавления. Настройка действует и при выключенной настройке «Включена».
  • «Группировка» — раздел, который сворачивается и разворачивается щелчком по заголовку. При открытии окна раздел свёрнут. Настройки раздела:
    • «Включена» — добавляет в заголовок служебного столбца кнопку «Группировать по», которая собирает записи в группы по значению выбранного столбца. При группировке записи упорядочиваются по этому столбцу, чтобы записи одной группы шли подряд, даже если сортировка выключена. По умолчанию выключено.
    • «По умолчанию» — столбец, по которому журнал сгруппирован при открытии отчёта и в выгрузке. Поле показывается при включённой группировке. Группы идут в направлении, заданном для этого столбца в настройке «По умолчанию» раздела «Сортировка», а если столбца там нет — по возрастанию. Внутри группы записи идут в порядке записей. Значение по умолчанию — «Без группировки». Другой столбец, выбранный в отчёте, действует до перезагрузки отчёта.
  • «Фильтрация» — добавляет в заголовок служебного столбца кнопку «Отфильтровать», которая показывает строку отбора записей по каждому столбцу. Повторное нажатие скрывает строку и сбрасывает условия отбора. Пока строка отбора показана, журнал с узкими столбцами становится шире заданной ширины. По умолчанию выключено.
  • «Скрыть границы таблицы» — выводит журнал без границ таблицы и ячеек в отчёте, на печати и в выгрузках. По умолчанию выключено.
  • «Скрыть заголовки» — выводит журнал без строки с названиями столбцов в отчёте, на печати и в выгрузках. Сортировка щелчком по заголовку и кнопка «Отфильтровать» находятся в этой строке, поэтому при скрытой строке они недоступны. Кнопка «Группировать по» переносится на панель над таблицей. По умолчанию выключено.

Столбец «Дата»​

В ячейке столбца «Дата» всегда хранятся дата и время с секундами. Маска задаёт только вид значения в отчёте и в выгрузке, например HH:mm показывает одно время. Маска записывается так же, как формат параметра «Дата». Без маски значение выводится в виде dd.MM.yyyy HH:mm:ss.

Маска не ограничивает ввод. В календаре ячейки всегда выбираются дата, время и секунды. В поле можно набрать значение по маске или полностью, в виде dd.MM.yyyy HH:mm:ss. Части, которых нет в маске, остаются от прежнего значения ячейки.

Значение по умолчанию получает новая запись журнала. Оно задаётся как у параметра «Дата»: источник даты и смещение от неё в месяцах, днях, часах, минутах и секундах. Источники:

  • «Дата начала отчета» и «Дата окончания отчета», у отчёта на момент времени — «Дата отчета»;
  • «Дата создания отчета» и «Дата обновления отчета». У нового, ещё не сохранённого отчёта вместо них берётся текущее время;
  • «Дата шага» — метка времени журнала. Пункт есть только у шаблона с шагом;
  • «День отчета», «Месяц отчета», «Год отчета» — начало суток, месяца или года, в которые начинается отчёт;
  • «Текущее время» — время добавления записи;
  • «Дата» — дата и время, выбранные в окне «Настройки столбца»;
  • «Отсутствует» — значения по умолчанию нет. Обязательный столбец без значения по умолчанию получает текущее время.

Столбцы типа «Время» из прежних версий при обновлении становятся столбцами «Дата» с маской HH:mm. Время по умолчанию, указанное в таком столбце, переносится в источник «День отчета» со смещением на это время. Записи, сделанные раньше, получают тот же день начала отчёта. Поэтому записи такого столбца по-прежнему упорядочиваются по времени.

Справочник шаблонов записей​

Справочник шаблонов записей даёт оператору типовые тексты для столбца с типом «Форматированный текст». Справочник заводится в информационной модели: её узлы служат категориями, а атрибуты типов «Текст» и «Форматированный текст» листовых узлов — шаблонами записей. Атрибуты узлов, у которых есть дочерние узлы, шаблонами не считаются.

Модель справочника выбирается в поле «Справочник шаблонов записей» в окне «Настройки столбца». Поля нет, если нет лицензии на модуль «Информационные модели» или права на просмотр модели. Модель применяется к столбцу вместе со значением по умолчанию кнопкой «ОК».

Если модель выбрана, на панели редактора ячейки появляется кнопка «Шаблон записи». Она открывает окно выбора с полем поиска по тексту шаблонов всех категорий. Слева в окне дерево категорий, первой в нём идёт группа «Последние» с недавно вставленными шаблонами. Справа списком показываются шаблоны выбранной категории целиком, с оформлением и выделенными местами подстановки.

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

Выбор подтверждается кнопкой «ОК», двойным щелчком по шаблону или клавишей Enter. Выбранный шаблон заменяет текст ячейки целиком вместе с оформлением и местами подстановки, после чего текст правится как обычно. Запись не связана с атрибутом: правка шаблона в информационной модели уже сделанные записи не меняет.

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

Переключатель «Запретить редактирование выбранных шаблонов» под полем справочника запрещает править вставленный шаблон. В шаблоне нельзя набирать текст, вставлять его из буфера обмена и удалять фрагменты. Места подстановки в шаблоне заполняются щелчком, как обычно. Текст, набранный вручную, правится без ограничений.

В ячейке журнала с шаблоном под запретом панель редактора не показывается, а у правого края столбца стоит кнопка «Очистить». Так же ведёт себя ячейка строки новой записи. Кнопка удаляет шаблон, после чего ячейка правится как обычно и панель редактора появляется снова.

Запрет относится только к шаблонам, вставленным после включения переключателя. Формулы и импорт записывают значение столбца без него.

Места подстановки​

Место подстановки — часть шаблона записи или значения по умолчанию, которую оператор заполняет при вводе записи: номер оборудования, фамилию, время. В тексте место подстановки записывается как подпись в двойных квадратных скобках: [[Оборудование]].

Место подстановки создаётся в редакторе форматированного текста атрибута информационной модели и в редакторе значения по умолчанию в окне «Настройки столбца»:

  • кнопкой «Вставить подстановку» на панели редактора — кнопка открывает окно «Подстановка» с полем «Подпись»;
  • вводом подписи в двойных квадратных скобках — место подстановки появляется, когда курсор уходит из скобок.

Подпись не может содержать символы [, ], < и >. Щелчок по месту подстановки в этих редакторах открывает окно, в котором подпись меняется. В отчёте щелчок по месту подстановки в редакторе ячейки открывает окно «Подстановка», в котором вводится значение. Незаполненное место подстановки выделено рамкой и после завершения правки, поэтому запись с пропуском видна в журнале.

Навигация​

Компонент для создания гиперссылки или кнопки перехода: на другой отчёт ТехноДок или на произвольный URL.

Настройки параметра:

  • «Текст» — подпись ссылки или кнопки.
  • «Отображение» — вид элемента: кнопка или гиперссылка.
  • «Открывать в новом окне» — открывать ли цель перехода в новой вкладке браузера.
  • «Тип ссылки» — цель перехода: отчёт ТехноДок или внешний URL.

Для перехода на отчёт:

  • «Отчёт» — выбор шаблона отчёта из списка.
  • «Открывать сохранённый отчёт» — открывать последний сохранённый экземпляр вместо создания нового.
  • «Предопределённые параметры» — значения параметров ввода открываемого отчёта, передаваемые при переходе.

Для перехода на URL:

  • «Адрес» — полный URL-адрес для перехода.

Подпись​

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

Настройки параметра:

  • «Подписанты» — список пользователей ТехноДок, чьи подписи предусмотрены в этой позиции отчёта.

Строка​

Компонент для отображения и ввода текстового значения. Значение задаётся как константа или берётся из другого параметра шаблона.

Настройки параметра:

  • «Значение» — константа или ссылка на другой параметр шаблона.
  • «Регистр» — преобразование регистра текста: без изменений, верхний, нижний.
  • «Ограничить максимальную длину» — включить ограничение длины строки.
  • «Максимальная длина» — максимально допустимое число символов (отображается при включённом ограничении).

Число​

Компонент для отображения и ввода числового значения. Значение задаётся как константа или берётся из другого параметра шаблона.

Настройки параметра:

  • «Значение» — константа или ссылка на другой параметр шаблона.