Alpha.Community

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

История изменений

2.0

Новая возможность

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

Улучшение

Добавлена возможность масштабирования форм, поставляемых в составе компонентов расширения. Масштаб формы SystemLogViewer_App можно изменить в конфигурационном файле app_settings.json. Масштаб формы SystemLogViewer_Form можно изменить, применив к ней тему оформления журнала событий.

Исправление

[Alpha.HMI.WebViewer] Устранена причина, по которой источники, отмеченные в окне Фильтр, не сохранялись после закрытия этого окна.

Изменения документации

Редакция 1

В руководстве пользователя:

  • В разделе Запуск в виде самостоятельного приложения:

    • Настройки отображения окна приложения вынесены в отдельный подраздел.
    • Описано изменение масштаба окна.
    • Упомянуто о настройках типа SystemLogViewer, влияющих на настройки приложения.
  • В разделе Просмотр журналов событий:

    • Добавлена информация об ошибке при указании недопустимых значений в редакторе даты и времени.
    • Обновлено описание свойств конфигурационного файла data.json.
  • В разделе Фильтрация событий обновлено описание фильтрации по дате: описана проверка допустимости значений при их вводе в редакторе даты и времени.

В справочном руководстве:

  • В разделе, описывающем тип SystemLogViewer, добавлены:

    • Описание конфигурационных файлов, создаваемых типом SystemLogViewer в режиме рантайма.
    • Информация о том, что настройки из конфигурационных файлов типа SystemLogViewer влияют и на формы.
  • В разделе Тема оформления Журнала событий актуализированы изображения.
  • В Свойства типа Тема оформления Журнала событий добавлено описание свойства Масштаб.
  • Обновлен раздел, описывающий форму SystemLogViewer_Form:

    • Удалено упоминание конфигурационного файла, создаваемого формой SystemLogViewer_Form в режиме рантайма.
    • Добавлено примечание о возможности настройки масштаба формы SystemLogViewer_Form.

1.3

Новые возможности

  • На панель инструментов добавлены кнопки Оперативный режим и Исторический режим. В оперативном режиме отображаются события в реальном времени за период, который можно настроить по нажатию кнопки Параметры на панели инструментов или в конфигурационном файле data.json. В историческом режиме отображаются события, произошедшие за указанный вами промежуток времени.
  • На панель инструментов добавлена кнопка Параметры. По нажатию этой кнопки можно настроить:

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

    Эти настройки будут сохранены в конфигурационных файлах data.json и export.json.

  • В строке состояния теперь отображается еще одна иконка, которая становится активной, когда настроен фильтр по источникам событий по нажатию кнопки Параметры или в конфигурационном файле data.json.

Улучшения

  • Формат иконок приложения изменен на SVG. Ранее использовался формат PNG.
  • Теперь по нажатию клавиши Home на клавиатуре будет выделено событие журнала, произошедшее последним.
  • Конфигурационный файл app_session.json теперь сохраняет информацию и о настройках отображения панели инструментов, строки состояния и окна приложения, а также о режиме работы журнала событий.
  • В тип SystemLogViewer и форму SystemLogViewer_Form добавлены свойства:

    • Активный режим (оперативный/исторический) (ActiveMode), которое определяет режим работы загружаемого журнала событий.
    • Путь к файлам конфигурации (ConfigurationPath), которое хранит путь к папке, хранящей файлы конфигурации data.json и export.json.
    • Автоматически загружать конфигурацию (AutoLoadConfiguration), которое позволяет автоматически загружать конфигурацию из файлов, путь к которым указан в свойстве Путь к файлам конфигурации (ConfigurationPath).
    • Отображать панель инструментов (ShowToolbar), которое позволяет настроить отображение панели инструментов.
    • Отображать строку состояния (ShowStatusbar), которое позволяет настроить отображение строки состояния.
  • В тип SystemLogViewer добавлены функции:

    • OpenOperativeLog, которая загружает журнал событий в оперативном режиме.
    • OpenHistoricalLog, которая загружает журнал событий в историческом режиме.
  • Для типа SystemLogViewer исключены свойства Настройки отображения (init_ViewSettings) и Настройки (init_Settings).
  • Для формы SystemLogViewer_Form добавлены свойства:

    • Начальная граница событий (init_ViewLogsBegin), которое определяет метку времени, соответствующую началу интервала, за который будет загружен журнал событий в историческом режиме.
    • Конечная граница событий (init_ViewLogsEnd), которое определяет метку времени, соответствующую концу интервала, за который будет загружен журнал событий в историческом режиме.
    • Отображать поверх всех окон (init_AlwaysOnTop), которое позволяет настроить отображение формы поверх всех окон.
  • Для формы SystemLogViewer_Form исключено свойство Настройки (init_Settings).
  • В тип Разрешения добавлено свойство Редактирование настроек (EditSettings), которое позволяет настроить отображение кнопки Параметры на панели инструментов.

Исправления

  • [Alpha.HMI.WebViewer] Устранена причина, по которой можно было скрыть строку состояния по нажатию сочетания клавиш Ctrl + S.
  • [Alpha.HMI.WebViewer] Устранена причина, по которой при закрытии окна Фильтр по нажатию кнопки Закрыть элементы интерфейса отображались некорректно, после чего происходило закрытие этого окна.
  • [Linux] Устранена причина, по которой по повторному нажатию кнопки Сохранить журнал в файл... не отображался путь к файлу.
  • Устранена причина, по которой в строке состояния отображалось количество событий последнего загруженного журнала при открытии некорректного журнала.
  • Устранена причина, по которой некорректно выполнялась фильтрация по дате.
  • Устранена причина, по которой не создавалась папка LogFiles, хранящая журналы событий по умолчанию.

Изменения документации

Редакция 1

В руководстве пользователя:

В Справочном руководстве:

  • В разделе, описывающем тип SystemLogViewer, актуализировано описание примера создания собственного приложения.
  • В разделы Свойства типа SystemLogViewer и Свойства формы SystemLogViewer_Form добавлено описание свойств:

    • Активный режим (оперативный/исторический) (ActiveMode), которое определяет режим работы загружаемого журнала событий.
    • Путь к файлам конфигурации (ConfigurationPath), которое хранит путь к папке, хранящей файлы конфигурации data.json и export.json.
    • Автоматически загружать конфигурацию (AutoLoadConfiguration), которое позволяет автоматически загружать конфигурацию из файлов, путь к которым указан в свойстве Путь к файлам конфигурации (ConfigurationPath).
    • Отображать панель инструментов (ShowToolbar), которое позволяет настроить отображение панели инструментов.
    • Отображать строку состояния (ShowStatusbar), которое позволяет настроить отображение строки состояния.
  • В раздел Функции типа SystemLogViewer добавлено описание функций:

    • OpenOperativeLog, которая загружает журнал событий в оперативном режиме.
    • OpenHistoricalLog, которая загружает журнал событий в историческом режиме.
  • Из раздела Свойства типа SystemLogViewer исключено описание свойств Настройки отображения (init_ViewSettings) и Настройки (init_Settings).
  • В раздел Свойства формы SystemLogViewer_Form добавлено описание свойств:

    • Начальная граница событий (init_ViewLogsBegin), которое определяет метку времени, соответствующую началу интервала, за который будет загружен журнал событий в историческом режиме.
    • Конечная граница событий (init_ViewLogsEnd), которое определяет метку времени, соответствующую концу интервала, за который будет загружен журнал событий в историческом режиме.
    • Отображать поверх всех окон (init_AlwaysOnTop), которое позволяет настроить отображение формы поверх всех окон.
  • Из раздела Свойства формы SystemLogViewer_Form исключено описание свойства Настройки (init_Settings).
  • В разделе, описывающем тип Разрешения, актуализировано описание типа.
  • В раздел Свойства типа Разрешения добавлено описание свойства Редактирование настроек (EditSettings), которое позволяет настроить отображение кнопки Параметры на панели инструментов.
  • В раздел, описывающий форму SystemLogViewer_Form, добавлено описание файла, который создает форма SystemLogViewer_Form в режиме рантайма.

Редакция 2

В справочное руководство добавлено описание функции HandleKeyPress типа SystemLogViewer.

1.2

Новые возможности

  • В окне Фильтр теперь можно выбрать относительный временной диапазон. Доступные временные диапазоны располагаются в выпадающем списке, который можно открыть справа от редактора времени.
  • В окне Фильтр добавлена возможность отключать все выбранные фильтры по нажатию кнопки Отключить. Вернуть эти фильтры можно, нажав кнопку Включить.

Исправления

  • Устранена причина, по которой в окне Фильтр в редакторе даты полностью не помещалась дата.
  • Устранена причина, по которой в окне Перейти ко времени невозможно было в редакторах даты и времени указать значения повторно.
  • Устранена причина, по которой в разрабатываемом проекте не применялись Разрешения, определенные в свойствах формы SystemLogViewer_Form.

Изменения документации

Редакция 1

В руководстве пользователя:

Актуализировано справочное руководство.

1.1

Новая возможность

  • Журнал событий теперь можно экспортировать в файл формата *.csv и *.xlsx по нажатию кнопки Экспорт журнала событий на панели инструментов.
  • Добавлена возможность сохранения и загрузки журналов событий формата *.slz. Это универсальный формат журнала событий, который можно просматривать как на ОС Windows, так и на ОС Linux.

Улучшения

  • При запуске окно приложения теперь всегда располагается поверх всех окон. Для изменения этой настройки в контекстное меню журнала событий добавлен новый пункт Вид → Поверх всех окон.
  • Выделенные сообщения теперь можно скопировать в буфер обмена. Для этого можно использовать контекстное меню журнала событий или сочетание клавиш Ctrl + C. В результате в буфере обмена будут содержаться заголовки столбцов и значения ячеек таблицы, разделенные символами табуляции.

Исправления

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

Изменения документации

Редакция 1

В руководстве пользователя:

В справочном руководстве в разделе SystemLogViewer:

  • Обновлен пример создания собственного приложения.
  • Актуализированы свойства и функции.
  • Исключены команды.

1.0

1.0.1

Улучшения

  • Окно приложения десктопной версии можно свернуть в Панель задач по нажатию клавиши Esc.
  • На ОС Windows названия журналов, доступных по умолчанию, теперь указаны на русском языке.
  • Добавлена всплывающая подсказка для кнопки выбора журнала на панели инструментов.
  • Если не удается открыть журнал, то появляется предупреждение с описанием ошибки.

Изменения документации

Редакция 2

Внутренние изменения. Содержимое документа не изменилось.

Редакция 3

Улучшения

  • В разделе Запуск в виде самостоятельного приложения:

    • добавлено примечание о возможности свернуть окно приложения десктопной версии в Панель задач по нажатию клавиши Esc;
    • устранена ошибочная информация о том, что тип Тема оформления Журнала событий предоставляется расширением Alpha.HMI.CommonLib.
  • В разделе Просмотр журналов событий:

    • обновлены названия журналов на ОС Windows;
    • расширено описание переключения между журналами событий на ОС Windows;
    • добавлено примечание о возможности появления сообщения об ошибке.