Alpha.Community

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

Передача данных по Alpha.Link

В Alpha.DevStudio можно настроить передачу данных сервера клиентам по внутреннему проприетарному TCP-протоколу Alpha.Link. Для этого нужно описать компоненты проекта автоматизации – источники и потребителей данных, передаваемых по Alpha.Link – и сами данные.

Настройка передачи данных в общем случае описана в разделе Настройка передачи данных.

Для настройки передачи данных по Alpha.Link следует:

  1. Описать источник данных.

    Источники данных могут быть расположены на компьютерах разного типа. В каждом отдельном случае следует описать компьютер с помощью подходящего элемента (Узел Alpha.Domain или Тип рабочего места), а затем описать в нем источник данных. Источниками данных могут быть:

    • Модуль TCP Сервер в составе Alpha.Server или Alpha.AccessPoint.
    • Сервер истории Alpha.Historian.
  2. Описать потребителей данных.

    Потребителями данных являются различные приложения. Они также могут быть установлены на компьютерах разного типа. В каждом отдельном случае следует описать компьютер с помощью подходящего элемента (Узел Alpha.Domain, Компьютер и Тип рабочего места), а затем описать в нем потребителя. Потребителями данных могут быть:

    • Модуль HUB в составе Alpha.Server или Alpha.AccessPoint.
    • Приложение, созданное в среде разработки Alpha.HMI – описывается с помощью элемента Alpha.HMI.
    • Любое другое приложение, получающее данные по Alpha.Link – описывается с помощью элемента Потребитель Link в составе исполняющего компонента.
  3. Описать необходимость передачи данных.

    Для этого следует выполнить одно из следующих действий:

    • внутри одного исполняющего компонента разместить ссылку на объекты другого исполняющего компонента. Затем выполнить статическое связывание параметров.
    • внутри одного исполняющего компонента разместить динамически раскрываемую ссылку на объекты другого исполняющего компонента.

    Пример приведен ниже, в подразделе Описание настройки мониторинга работы сервера истории.

  4. При необходимости указать параметры взаимодействия модуля TCP Server и потребителей.
  5. При необходимости настроить фильтрацию данных, передаваемых модулем TCP Server потребителям.

Все компьютеры, описанные с помощью элементов Узел Alpha.Domain, Компьютер и Тип рабочего места, должны быть включены в сеть Ethernet либо в сеть файлового обмена. Получившаяся схема может выглядеть, например, так:

Путем изменения значений свойств элементов и параметров их взаимодействия можно добиться нужной вам конфигурации Alpha.Server.

Описание настройки мониторинга работы сервера истории

С примером проекта, в котором настроено получение статистических данных о работе сервера истории по Alpha.Link, можно ознакомиться, открыв примеры решений, поставляемые в составе дистрибутива Alpha.DevStudio. Перейдите к решению из меню Пуск → Automiq → Примеры решений → History и ознакомьтесь с проектом Historian в составе этого решения.

Чтобы Alpha.Server мог предоставлять потребителям статистические данные о работе сервера истории по протоколу Alpha.Link, выполните следующие шаги:

  1. Добавьте в проект ссылку на модуль Om.History. Это необходимо для получения возможности обратиться к сервисным сигналам сервера истории.
  2. Перейдите к элементу, описывающему ваш сервер истории Alpha.Historian. Убедитесь, что элемент теперь представляет собой приложение, содержащее параметры, сгруппированные в логический объект JsonApi и сокеты: Instance, Config, Policy, Api, AsyncQuery, License.
  3. Добавьте в ваш сервер ссылку на сервер истории. Для этого:

    1. Перейдите к элементу, описывающему ваш Alpha.Server.
    2. Добавьте в приложение сервера Логический объект, а в этом логическом объекте разместите элемент Объектная ссылка. Для добавленной ссылки:

      • в качестве значения свойства Объект укажите элемент Alpha.Historian;
      • добавьте атрибут Раскрывать ссылку динамически.

    Помимо ссылки на сервер истории можно также делать ссылки на его базы данных (для мониторинга состояния баз) и на объект JsonApi.

    Объект JsonApi предназначен для передачи json-запросов на редактирование политик настроек сервера и его баз. Подробнее об этом – в документации на Alpha.Historian.

При применении такой конфигурации можно будет следить за состоянием сервера истории и/или его баз данных, подключившись к серверу с помощью любого приложения, запрашивающего данные по Alpha.Link (например, с помощью Alpha.HMI.Explorer), и просмотрев значения полученных сигналов сервера.

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

Определение параметров взаимодействия модуля TCP Server и потребителей

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

  • для модуля TCP Сервер настроить передачу данных таким образом, чтобы получать их могли только известные клиенты;
  • настроить разворот инициации соединения между модулями TCP Сервер и HUB (подробнее об этом – в документации на модуль TCP Сервер, входящей в состав документации на Alpha.Server);
  • настроить фильтрацию данных;
  • и т.п..

Чтобы получить возможность указывать параметры взаимодействия источника и потребителей, перейдите к элементу источника – TCP Сервер – и добавьте потребителей, параметры связи с которыми вам нужно настроить, нажав . После добавления потребителя появится элемент Параметры взаимодействия с потребителем. Параметры описаны в справочнике, примеры их применения приведены далее в этом разделе и в документации на модуль TCP Сервер (включенной в состав документации на Alpha.Server).

Описание Alpha.HMI в качестве известного клиента

Для описания Alpha.HMI в качестве известного клиента используйте элемент Alpha.HMI. Этот элемент нужен для того, чтобы указать, на каком компьютере будет запускаться Alpha.HMI. Элемент представляет собой исполняющий компонент, который может быть размещен на узле домена или в типе рабочей станции. Основным свойством элемента является Идентификатор клиента – по нему TCP Сервер "запоминает" клиента. Если в качестве идентификатора ничего не указано, то будет использовано имя элемента.

Внутри элемента можно разместить ссылки на объекты и/или приложения других исполняющих компонентов. Наличие такой ссылки:

  • означает, что приложение, описываемое элементом Alpha.HMI, является клиентом модуля TCP Сервер;
  • указывает на то, что данные этого объекта нужны в приложении, описываемом элементом Alpha.HMI. Получить эти данные можно по протоколу Alpha.Link, подключившись к модулю TCP Сервер сервера или точки доступа.

Чтобы указать модулю TCP Сервер, что Alpha.HMI является известным клиентом:

  1. В параметрах самого модуля укажите значения для свойств Разрешить изменения для анонимных клиентов: Нет и Метод аутентификации известных клиентов: Пароль – если необходимо запретить взаимодействие с анонимными клиентами;
  2. Определите параметры взаимодействия модуля TCP Сервер и элемента Alpha.HMI, как описано в подразделе выше. Для этого нажмите на элементе модуля. В открывшемся окне выберите элемент Alpha.HMI.

    Появится элемент Параметры взаимодействия с потребителем. Укажите для него значение свойства Пароль аутентификации известного клиента. Это же значение пароля используется для подключения к серверу модулем HUB (автоматически подставляется в конфигурацию) и должен быть указан в проекте Alpha.HMI у компонента Источник AP.

Фильтрация данных, передаваемых модулем TCP Server потребителям

Настройка фильтрации выполняется с применением механизма множеств. Рекомендуется сначала ознакомиться с разделом, описывающим Конфигурирование множеств.

Ниже описано, как использовать механизм множеств для выделения и фильтрации данных, которые источник будет передавать потребителям по Alpha.Link. Для этого необходимо:

  1. Параметры нужных сигналов включить во множество. Как это сделать – описано в разделе Конфигурирование множеств.
  2. Описать модуль TCP Сервер и потребителей данных, передаваемых модулем по Alpha.Link (как – описано в начале этого раздела), определить параметры их взаимодействия.
  3. Связать созданное множество с потребителями данных.
  4. Если необходимо, определить индивидуальные настройки передачи данных множества конкретным потребителям.

Связывание множества с потребителями

Чтобы связать множество с потребителями данных, перейдите к элементу TCP Сервер. Для каждого потребителя, который должен получать значения множества, в Параметры взаимодействия с потребителем добавьте атрибут, который определяет нужное множество. Каждому потребителю можно добавить только один атрибут, так как каждый потребитель (HUB, Alpha.HMI или Потребитель Link) может потреблять данные только одного множества.

Если необходимо передавать разные наборы данных разным потребителям, рекомендуется создать одно множество, а каждому параметру множества указать индивидуальные настройки передачи данных конкретному потребителю (далее – "индивидуальные настройки потребителя").

Возможен вариант, при котором можно создать несколько множеств, разделить параметры между множествами, а затем для каждого потребителя указать нужное множество. Однако делать это не рекомендуется, так как создание разных множеств может усложнить разработку проекта и повысить нагрузку на сервер.

Определение индивидуальных настроек передачи данных потребителю

Под индивидуальными настройками потребителя пока подразумевается только одна настройка – индивидуальное условие передачи данных. Возможные значения:

  • передавать данные этого сигнала выбранному потребителю, 
  • не передавать данные этого сигнала выбранному потребителю,
  • передавать данные этого сигнала выбранному потребителю по условию.

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

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

Чтобы определить индивидуальные настройки потребителей с помощью системного атрибута:

  1. Перейдите к элементу TCP Сервер. Для каждого потребителя в Параметры взаимодействия с потребителем добавьте системный атрибут Параметры передачи потребителю Link.
  2. Добавьте этот же атрибут каждому параметру множества, значения которого должны быть переданы потребителю с индивидуальными настройками. После этого на вкладке Настройка множеств появится возможность указать отдельное условие передачи данных этого параметра потребителям:
    • Установленный флаг в поле Разрешить соответствует настройке, при которой любые значения сигнала передаются потребителю.
    • Установите флаг в поле Разрешить повторно, галочка должна смениться черным квадратом. Ниже появится поле, в котором можно будет указать условие передачи значений сигнала потребителю. В качестве условия должно быть указано логическое выражение. Условие может зависеть от значения какого-либо атрибута. Инструкция по формированию ссылки на атрибут расположена в разделе Вычисление значений атрибутов.
    • Снятый флаг в поле Разрешить соответствует настройке, при которой значения сигнала не передаются потребителю вообще.

Чтобы определить разные индивидуальные настройки для разных потребителей с помощью собственных атрибутов:

  1. Создайте пользовательский тип атрибута, который будет определять индивидуальные настройки передачи данных потребителю. Пометьте этот атрибут системным атрибутом Настройка потребителя множеств (потребитель Link).

  2. Перейдите к элементу TCP Сервер, выберите нужного потребителя и добавьте созданный атрибут в Параметры взаимодействия с потребителем.

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

  3. Добавьте созданный атрибут каждому параметру множества, значения которого должны быть переданы с индивидуальными настройками. После этого на вкладке Настройка множеств появится возможность указать отдельное условие передачи данных этого параметра потребителю:
    • Установленный флаг в поле Разрешить соответствует настройке, при которой любые значения сигнала передаются потребителю.
    • Установите флаг в поле Разрешить повторно, галочка должна смениться черным квадратом. Ниже появится поле, в котором можно будет указать условие передачи значений сигнала потребителю. В качестве условия должно быть указано логическое выражение. Условие может зависеть от значения какого-либо атрибута. Инструкция по формированию ссылки на атрибут расположена в разделе Вычисление значений атрибутов.
    • Снятый флаг в поле Разрешить соответствует настройке, при которой значения сигнала не передаются потребителю вообще.

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