• Table of contents
• Настройка системы событий в приложениях Дигиспот II
  • Если приложение - DJin,
  • Если приложение не DJin
  • Если это не приложение, а сервис
  • Пример содержимого файла
  • Отладочный лог

Настройка системы событий в приложениях Дигиспот 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>