Alpha.Community

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

Свойства

Отображаемое имя

Описание объекта (поля объекта). Позволяет указать произвольное (например, русскоязычное) имя для узнаваемости объекта (поля объекта) в проекте. Не мешает использованию базового англоязычного имени объекта (поля объекта) для обращения в коде.

Кардинальное число

Преобразует объект в массив и задает размер массива (количество элементов в массиве).

Значение

1 Одиночный объект.
>1 Массив соответствующей размерности.

Длина

int8 Length

Размер массива (количество элементов в массиве).

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

Примеры

Записать в текстовое поле длину массива.

TextEdit_1.Text = Str.ToString (SW_1.Length);

Индекс

int8 Index

Индекс элемента в массиве. Позволяет отследить у какого элемента сработало то или иное событие.

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

Примеры

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

TextEdit_2.Text = Str.ToString(Index);

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

TextEdit_3.Text = Str.ToString(penwidth[Index]);

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

if (SW_1.Mode.Index == 0)
{
TextEdit_1.Text = "Включен режим 1";
}
else
{
TextEdit_1.Text = "Включен режим 2";
}

Хост

string Location

Сетевой адрес источника данных по протоколу TCP. Для локального компьютера используется IP-адрес: 127.0.0.1.

Примеры

Вывести сетевой адрес источника данных в поле ввода.

TextEdit.Text = ApSource.Location;

Текущий хост

string CurrentLocation

Текущий сетевой адрес источника данных по протоколу TCP.

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

Примеры

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

TextEdit.Text = ApSource.CurrentLocation;

Порт

uint2 Port

Номер порта для подключения к источнику данных. По умолчанию номер 4388.

Вывести порт источника данных в поле ввода.

TextEdit_1.Text = String.ToString(ApSource_1.Port);

Текущий порт

uint2 CurrentPort

Текущий порт для подключения к источнику данных.

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

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

TextEdit_1.Text = String.ToString(ApSource_1.CurrentPort);

Порт истории

uint2 HistoryPort

Порт для доступа к историческим данным. По умолчанию номер 4950.

Текущий порт истории

uint2 CurrentHistoryPort

Текущий порт для доступа к историческим данных.

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

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

TextEdit_1.Text = String.ToString(ApSource_1.CurrentHistoryPort);

Путь

string Path

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

Доступна возможность переопределения пути во время рантайма.

Примеры

Вывести путь до целевой ветки дерева сигналов источника в поле ввода.

TextEdit.Text = ApSource.Path;

Источник учетных данных

Credentials

Источник учетных данных, используемый для подключения к защищенному источнику. Указывается в виде ссылки на объект типа Учетные данные AP, существующий в проекте.

Родительский источник

Свойство для создания иерархии источников данных. Например, на экранной форме можно разместить три компонента Источник AP, первый из которых будет содержать параметры подключения (свойства Хост и Порт). Второй и третий источники лишь будут определять конкретные ветки дерева сигналов (свойство Путь), но ссылаться при этом на первый источник как на Родительский источник.

Примеры

Записать в поле ввода сетевой адрес родительского источника.

TextEdit.Text = ApSource.ParentSource.Location;

Записать в поле ввода код состояния подключения родительского источника.

TextEdit_1.Text = String.ToString(ApSource_1.ParentSource.ConnectionState);

Таймаут операций с БД

uint4 Timeout

Максимальное время в миллисекундах для выполнения операций с базой данных. При превышении этого времени операция прерывается.

Примеры

Установить таймаут операций в 5 секунд

ApSource_1.Timeout = 5000;

Таймаут установления соединения с БД

uint4 ConnectionEstablishTimeout

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

Примеры

Установить таймаут соединения с БД в 10 секунд

ApSource_1.ConnectionEstablishTimeout = 10000;

Максимальный размера пула буферов

uint4 MaxBufferPoolSize

Максимальный размер пула буферов в байтах, используемого для временного хранения данных перед их записью в Alpha.Historian.

Общее соединение

bool ShareConnection

Использовать ли общее соединение для всех источников данных, имеющих одинаковый адрес подключения (Хост, Порт). Если этот параметр не установлен (false), то для каждого источника данных будет устанавливаться отдельное соединение. По умолчанию используется общее соединение. Это свойство актуально только в случаях, когда не указан родительский источник данных.

Активность

bool Active

Активность источника AP. С неактивными источниками не происходит обмен данными.

Примеры

Записать текущее состояние источника AP в поле ввода.

TextEdit_1.Text = String.ToString(ApSource_1.Active);

Период переподписки

uint8 ReAdvise

Интервал времени в миллисекундах, после которого будут предприниматься попытки переподписки на сигналы , отсутствующие в сервере. Значение 0 - переподписка не выполняется.

Имя клиента

string ClientDisplayName 

Имя клиента, используемое для удобного отображения подключенного клиента к источнику АР.

Примеры

Установить имя клиента Оператор;

ApSource.ClientDisplayName = "Оператор";

Идентификатор клиента

string ClientId

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

Примеры

Установить уникальный идентификатор клиента

ApSource_1.ClientId = "client12345";

Полный тег

string Tag

Полный путь Источника АР, формируемый путём конкатенации путей родительских источников.

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

Состояние соединения

uint1 ConnectionState

Код состояния подключения к источнику данных.

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

Значение

0 Отключен.
1 В процессе подключения.
2 Подключен.
3 В процессе отключения.

Примеры

Записать код состояния подключения к источнику AP в текстовое поле.

TextEdit_1.Text = String.ToString(ApSource_1.ConnectionState);

Тип ошибки

Код ошибки подключения к источнику данных.

uint1 ErrorState

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

Значение

0 Ошибок нет.
1 Ошибка инициализации.

Примеры

Записать код ошибки подключения к источнику AP в поле редактирования.

TextEdit_1.Text = String.ToString(ApSource_1.ErrorState);

Строковое описание ошибки

string ErrorString

Описание ошибки подключения к источнику данных в текстовом виде.

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

Примеры

Записать описание ошибки подключения к источнику AP в поле редактирования.

TextEdit.Text = ApSource.ErrorString;