Project

General

Profile

Настройка системы событий в приложениях Дигиспот II

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

  1. Имя хоста системы событий
  2. Точки для подключения
    1. Клиентские - для исходящих подключений к другим серверам
    2. Серверные - для возможности входящих соединений извне

Для этого необходимо формирование специального XML-файла настройки системы событий, с описанием хоста и создаваемых точек подключения.
Это можно сделать 2-мя способами:

Если приложение - DJin,

Можно указать XML-файл инициализации системы событий в виде специальной строчки в конфигурационном файле.
event_server.xml - это имя файла конфигурации, имя файла может любым, быть полным или относительным, от каталога SYSTEM.
Строка настройки обычно вносится в самый конец VID файла.

INIT_EVENT_SERVER event_srv.xml

Если приложение не DJin

Файл должен называться <имя exe>.XML и находиться в каталоге SYSTEM.

Если это не приложение, а сервис

Файлы настройки системы событий, если они нужны, следует создавать для каждого из экземпляров сервиса отдельно, и названия этих файлов должны включать в себя пользовательский идентификатор (если он есть) и находиться в каталоге SYSTEM.
Например:

RDS_SERVICE_myname.xml

Сервис в этом случае должен называться RDS_SERVICE_myname.

Пример содержимого файла

  • Пример содержимого файла, создающего хост HOST1 и 2 точки подключения:клиентскую и серверную.
<EVENT_SERVER HOST="HOST1">
  <CLIENTS>
    <TCP ADDR="SRV2" TYPE="CLIENT" IP="192.168.0.115" PORT="7601"/>
    <TCP ADDR="SRV1" TYPE="SERVER" IP="127.0.0.1" PORT="7600" />
  </CLIENTS>
</EVENT_SERVER>

Данные точки подключения будут доступны только для приложений системы Digispot II, т.к. по умолчанию используется внутренний закрытый протокол обмена.
Для создания серверной точки подключения с форматом данных XML, доступным, в частности, Инфопанели, необходимо указать это явно атрибутом PROTOCOL=XML.

<EVENT_SERVER HOST="HOST1">
  <CLIENTS>
        <TCP ADDR="SRV2" TYPE="CLIENT" IP="192.168.0.115" PORT="7601"/>
        <TCP ADDR="SRV1" TYPE="SERVER" IP="127.0.0.1" PORT="7600" PROTOCOL="XML" />
  </CLIENTS>
</EVENT_SERVER>
  • HOST - имя данного хоста, уникально среди других хостов (примерный аналог - имя компьютера в сети).
  • TYPE - тип точки подключения - серверная или клиентская
  • IP - адрес точки. Может быть:
    • Для серверной точки
      • 0.0.0.0 - принимающий запросы из любых сетей, существующих на данном компьютере
      • IP - принимающий запросы только из сети, в которой находится данный адрес
      • 127.0.0.1 - только для локальных подключений, с этого же компьютера
      • COMPUTER_NAME - имя компьютера в локальной сети. Аналогичен указанию IP. Но зависит от настроек механизма DNS - в какой IP отображается имя данного компьютера.
    • для клиентской точки
      • 127.0.0.1 - для подключения к локальному серверу
      • IP - указание IP серверной точки.
      • COMPUTER_NAME - аналогично IP с учетом DNS
  • PORT - порт, на котором открывается серверная точка, для клиентской точки должен совпадать с указанной на сервере.
  • PROTOCOL - тип протокола обмена. Если не указан - используется закрытый внутренний протокол, иначе XML.
  • ADDR - это имя самой точки подключения. Оно должно быть уникальным среди имен получателей событий на данном хосте. Явно не используется, имеет внутреннее назначение. *

Отладочный лог

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

Кроме того можно добавить запрещающий запись фильтр через xml файл. Не проверяемые фильтром поля оставляем пустыми или *

Например запрет записи в отладочный лог событий с идентификатором MTR (индикаторы уровня):

<EVENT_SERVER HOST="HOST1">
  <CLIENTS>
     <TCP ADDR="SRV2" TYPE="CLIENT" IP="192.168.0.115" PORT="7601"/>
     <CLIENT ADDR="SYS_LOG" >
        <DISABLE_EVENT_FILTER CMD="MTR" SRC="" DST=""/>
     </CLIENT>
  </CLIENTS>
</EVENT_SERVER>

Add picture from clipboard (Maximum size: 742 MB)