Alpha.Community

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

Создание шаблона отчёта

Создавать шаблон отчета необходимо только в Alpha.Reports.Designer. Создавать в сторонних, подобных приложениях и загружать в Alpha.Reports.Configurator недопустимо. В таком случае правильная работа имеющихся функций не гарантирована!

Настройка переменных

Чтобы настроить переменные в шаблоне, нажмите кнопку Настройка переменных на вкладке Отчет.

Откроется окно Настройка переменных.

Добавление переменных

Чтобы добавить переменную, в окне Настройка переменных:

  1. Нажмите кнопку Добавить.
  2. Для добавленной переменной заполните поля.

    Описания полей
    Поле Описание
    Имя переменной

    Имя переменной.

    Не должно:

    • Начинаться с цифры.
    • Содержать пробелы или другие недопустимые символы.
    • Совпадать с уже существующим именем.

      Совпадение проверяется регистронезависимо: имя my-var совпадёт с именем My-Var.

    Описание Произвольное описание.
    Тип Тип значений.
    Список Работа со списками описана ниже.
    Значение по умолчанию Значение переменной по умолчанию.
    Добавлять к имени файла

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

    Имя файла будет формироваться следующим образом:

    • Имя шаблона
    • Знак подчёркивания _
    • Переменные, отмеченные флагом Добавлять к имени файла, разделённые знаком подчёркивания _, в порядке, в котором они перечислены в таблице (с учётом сортировки).
  3. Сохраните изменения.

Добавить можно не более 25 переменных.

Удаление переменных

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

Работа со списками

Чтобы создать список переменной, нажмите кнопку Списки.

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

Добавление списка

Чтобы добавить список, нажмите кнопку +.

Добавление/удаление записи в списке

Чтобы добавить запись в список, нажмите кнопку Добавить запись.

Чтобы удалить запись из списка, выберите её и нажмите кнопку Удалить запись.

Сохранение изменений в списке

Чтобы сохранить все внесённые изменения, нажмите кнопку .

Чтобы отменить все внесённые изменения, нажмите кнопку .

Удаление списка

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

Экспорт/импорт списка в файл

Чтобы экспортировать список в файл, выберите его и нажмите кнопку . В результате список будет сохранён в файле формата *.json.

Чтобы импортировать список из файла, нажмите кнопку и выберите директорию, в которой находится файл со списком в формате *.json.

Работа в отчёте с переменными типа Список

Чтобы в ячейку отчёта вывести ключ переменной типа Список, в ячейке нужно указать формулу вида =<Имя>_key, где <Имя> – имя переменной.

Чтобы в ячейку отчёта вывести значение переменной типа Список, в ячейке нужно указать формулу вида =<Имя>_value, где <Имя> – имя переменной.

Редактирование значения по умолчанию

Чтобы изменить значение переменной по умолчанию:

  1. Выберите переменную в списке.
  2. В столбце Значение по умолчанию введите новое значение.

  3. Нажмите кнопку Сохранить изменения.

Чтобы переместить строку переменных на позицию выше/ниже, нажмите кнопку Переместить выше или Переместить ниже соответственно.

Выбор переменных

Чтобы добавить атрибут в шаблон:

  1. На вкладке Отчет нажмите кнопку Выбор переменных.

    Откроется окно Поиск атрибутов.

  2. В выпадающем списке выберите источник данных поиска.

  3. Выберите объект.
  4. Выберите атрибут объекта любым способом:

    • Дважды кликните по атрибуту.
    • Выберите атрибут и нажмите кнопку Добавить.

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

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

Список поддерживаемых формул и функций приведён в Приложение A: Поддерживаемые функции.

Текущие значения атрибутов

Функция CurrAttrValue отображает значение выбранного атрибута в текущий момент времени.

Чтобы отобразить путь текущего значения атрибута:

  1. На вкладке Отчет нажмите кнопку Текущее значение.

    Появится панель конфигурирования формулы.

  2. Кликните по полю Список атрибутов и выберите в таблице ячейку или диапазон ячеек.

  3. Кликните по полю Результирующая ячейка и выберите в таблице ячейку, в которую будет записан результат.

  4. Выберите положение переключателя вывода времени:

    • Не выводить время
    • Время слева
    • Время сверху
  5. (опционально) Чтобы выводилось качество сигнала, установите флаг Качество.
  6. Нажмите кнопку Добавить.

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

Вывод текущего значения с отображением качества сигнала без вывода времени:

Вывод текущего значения с отображением качества сигнала с выводом времени:

Значения на дату для атрибутов

Функция ValueOnDate отображает значение выбранного атрибута на запрашиваемую дату.

Чтобы сконфигурировать формулу для отображения значения атрибута на определённую дату:

  1. На вкладке Отчет нажмите кнопку Значение на дату.

    Появится панель для конфигурирования формулы.

  2. Кликните по полю Список атрибутов и в таблице выберите ячейку или диапазон ячеек.

  3. В поле Дата введите дату или выберите переменную.

  4. Кликните по полю Результирующая ячейка и выберите в таблице ячейку, в которую будет записан результат.
  5. Выберите положение переключателя вывода времени:

    • Не выводить время
    • Время слева
    • Время сверху
  6. Нажмите кнопку Добавить.

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

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

Архивные значения для атрибутов

Функция ArchiveAttributeValue отображает значение выбранного атрибута за определенный интервал времени.

Чтобы вывести значения за определённый период:

  1. На вкладке Отчет нажмите кнопку Архивные значения.

    Появится панель для конфигурирования формулы.

  2. Кликните по полю Список атрибутов и в таблице выберите ячейку или диапазон ячеек, содержащих пути атрибутов.

  3. В полях Начало интервала и Конец интервала введите даты или выберите переменные.
  4. Укажите количество возвращаемых элементов или установите флаг ВЕРНУТЬ ВСЕ ЗНАЧЕНИЯ или установите флаг ВЕРНУТЬ ПУСТЫЕ ЗНАЧЕНИЯ:

    • Если установлен флаг ВЕРНУТЬ ВСЕ ЗНАЧЕНИЯ, в формуле будут рассчитываться все значения за установленный интервал времени.
    • Если установлен флаг ВЕРНУТЬ ПУСТЫЕ ЗНАЧЕНИЯ и установлен будущий период времени, данные выводиться не будут.

      Флаг предназначен только для случаев, когда установлен будущий период времени, данных за который ещё не поступало, чтобы не выводилось никаких данных.

    • Если флаг ВЕРНУТЬ ВСЕ ЗНАЧЕНИЯ снят, в формуле будет рассчитываться то количество значений, которое задано в поле Количество возвращаемых элементов.
  5. (опционально) Укажите шаг в секундах, с которым нужно вернуть значения.

    Пусть начало интервала "06.10.2025 12:00:00", конец интервала "06.10.2025 12:01:00", и в выбранный интервал было два изменения значения:

    • 06.10.2025 12:00:19 – значение 12
    • 06.10.2025 12:00:47 – значение 15

    Тогда при указанном шаге 10, вернутся значения:

    • 06.10.2025 12:00:00 – 9 (предыдущее значение)
    • 06.10.2025 12:00:10 – 9
    • 06.10.2025 12:00:20 – 12
    • 06.10.2025 12:00:30 – 12
    • 06.10.2025 12:00:40 – 12
    • 06.10.2025 12:00:50 – 15
    • 06.10.2025 12:01:00 – 15

    Если задано количество возвращаемых элементов – 4, то вернутся первые четыре значения:

    • 06.10.2025 12:00:00 – 9 (предыдущее значение)
    • 06.10.2025 12:00:10 – 9
    • 06.10.2025 12:00:20 – 12
    • 06.10.2025 12:00:30 – 12

    Если шаг не указан, вернутся значения:

    • 06.10.2025 12:00:19 – 12
    • 06.10.2025 12:00:47 – 15
  6. Кликните по полю Результирующая ячейка и выберите в таблице ячейку, в которую будет записан результат.
  7. Выберите положение переключателя вывода времени:

    • Не выводить время
    • Время слева
    • Время сверху

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

  8. (опционально) Установите флаг Качество для вывода качества сигнала (только при выборе обычного архивного значения).
  9. Выберите положение переключателя вывода:

    • Все значения – будут выведены все значения атрибута за указанный интервал времени.
    • Максимум – будет выведено максимальное значение атрибута за указанный интервал времени.
    • Минимум – будет выведено минимальное значение атрибута за указанный интервал времени.
    • Среднее – будет выведено среднее арифметическое значение атрибута за указанный интервал времени.
    • Сумма – будет выведена сумма всех значений атрибута за указанный интервал времени.
    • Количество элементов – будет выведено количество значений атрибута за указанный интервал времени.
  10. Нажмите кнопку Добавить.

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

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

Макросы

Чтобы создать макрос:

  1. На вкладке Отчет нажмите кнопку Макросы.

    Откроется окно Макросы.

  2. Нажмите кнопку Создать.

    Откроется окно Новый макрос.

  3. В окне Новый макрос:

    1. Введите название.
    2. Введите текст макроса.
    3. Установите/снимите флаг Запускать перед расчётом формул.
    4. Нажмите кнопку Сохранить.

Создать можно не более 25 макросов.

Чтобы редактировать макрос, выберите его в списке и нажмите кнопку Редактировать.

Чтобы удалить макрос, выберите его в списке и нажмите кнопку Удалить.

Чтобы выполнить макрос(ы):

  • Выберите макрос в списке и нажмите кнопку Выполнить.
  • Нажмите кнопку Выполнить все: будут выполнены все макросы в списке.

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

Пересчёт формул

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

Приостановка расчётов

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

Сохранение шаблона на сервер отчётов

Чтобы сохранить сконфигурированный шаблон:

  1. На вкладке Отчет нажмите кнопку Сохранить на сервер или Сохранить как.

    Откроется диалоговое окно сохранения шаблона.

  2. В диалоговом окне введите название и описание шаблона и нажмите кнопку Сохранить.