Настройки соединения

Справочник описывает поля формы «Внешние соединения»: общие настройки соединения и настройки подключения для каждого типа источника данных. Типы перечислены в том же порядке и с той же группировкой, что и в списке «Тип».

Общие настройки

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

Настройки соединения:

• «Название» — название, под которым соединение выбирается в шаблонах отчётов и настройках других модулей. Название должно быть уникальным.
• «Идентификатор» — уникальный идентификатор соединения. ТехноДок присваивает его при создании соединения, изменить его нельзя. По идентификатору ТехноДок сопоставляет соединения при импорте. Кнопка справа от поля копирует идентификатор в буфер обмена.
• «Тип» — тип источника данных. От типа зависит состав полей в группах «Настройки подключения». У нового соединения выбран тип «КАСКАД 3». При смене типа ТехноДок заменяет все подключения одним подключением со значениями по умолчанию.
• «Допустимое количество ошибок доступа» — число неудачных попыток установить одно подключение, после которого ТехноДок перестаёт его использовать. Целое число не меньше 1. Значение по умолчанию — 3.
• «Время пребывания в недоступном состоянии в секундах» — время, в течение которого ТехноДок не использует подключение после превышения допустимого количества ошибок. Целое число не меньше 0. Значение по умолчанию — 300. По истечении времени ТехноДок снова пробует установить это подключение.

Как ТехноДок перебирает подключения, описано в разделе «Настройка резервных подключений».

SCADA-системы

КАСКАД 3

Соединение с XML-RPC-сервером проекта КАСКАД 3. Порядок настройки на стороне КАСКАД описан в статье «КАСКАД».

Настройки подключения:

• «Адрес сервера» — адрес XML-RPC-сервера КАСКАД с протоколом и портом. Значение по умолчанию — http://localhost:8242.
• «Время ожидания выполнения запроса (c)» — время ожидания ответа на запрос в секундах. Целое число не меньше 0. Значение по умолчанию — 300.
• «Время ожидания обработки ответа (с)» — время ожидания чтения ответа после выполнения запроса в секундах. Целое число не меньше 0. Значение по умолчанию — 1200.
• «Оптимизировать загрузку значений за период» — определяет способ загрузки значений тегов за период. Если переключатель включён, ТехноДок запрашивает значения за период по HTTP в формате JSON, остальные запросы выполняются по XML-RPC. Если выключен, все запросы выполняются по XML-RPC. Значение по умолчанию — включено.

Если в соединении несколько подключений, их порядок для КАСКАД 3 не важен. ТехноДок обращается к первому доступному серверу, а КАСКАД перенаправляет запрос на основной сервер проекта.

КАСКАД 4

Соединение с сервером КАСКАД 4.

Настройки подключения:

• «Адрес сервера» — IP-адрес или доменное имя сервера КАСКАД 4. Значение по умолчанию — 127.0.0.1.
• «Порт» — TCP-порт сервера. Целое число от 0 до 65535. Значение по умолчанию — 8080.
• «Имя пользователя» — учётная запись КАСКАД 4 для подключения.
• «Пароль» — пароль учётной записи.
• «Использовать защищённое соединение (WSS)» — включает шифрование соединения по протоколу WSS. Значение по умолчанию — выключено.

WinCC Classic

Соединение с базой данных WinCC Classic через провайдер OLE DB. Тип работает, только если сервер ТехноДок установлен в Windows.

Настройки подключения:

• «Название провайдера OLE DB» — название провайдера OLE DB для WinCC, например WinCCOLEDBProvider.1.
• «Адрес сервера» — IP-адрес или имя хоста сервера WinCC.

СУБД

InfluxDB

Соединение с базой данных InfluxDB. ТехноДок обращается к серверу через программный интерфейс InfluxDB 1.x и выполняет запросы на языке InfluxQL. Язык Flux не поддерживается.

Настройки подключения:

• «Протокол» — протокол подключения: «HTTP» или «HTTPS». Значение по умолчанию — «HTTP».
• «Адрес сервера» — IP-адрес или доменное имя сервера InfluxDB.
• «Порт» — TCP-порт сервера. Целое число от 0 до 65535. Значение по умолчанию — 8086.
• «Название базы данных» — название базы данных InfluxDB.
• «Имя пользователя» — учётная запись для подключения.
• «Пароль» — пароль учётной записи.

Microsoft SQL Server

Соединение с базой данных Microsoft SQL Server.

Настройки подключения:

• «Адрес сервера» — IP-адрес или имя сервера. Для именованного экземпляра имя экземпляра указывается через обратную косую черту: server\SQLEXPRESS.
• «Порт» — TCP-порт сервера. Целое число от 0 до 65535. Значение по умолчанию — 1433.
• «Название базы данных» — название базы данных.
• «Имя пользователя» — учётная запись SQL Server.
• «Пароль» — пароль учётной записи.
• «Дополнительные настройки» — параметры строки подключения в формате Ключ=Значение;, например TrustServerCertificate=True;. ТехноДок добавляет их в конец строки подключения без изменений.

MySQL

Соединение с базой данных MySQL.

Настройки подключения:

• «Адрес сервера» — IP-адрес или доменное имя сервера MySQL.
• «Порт» — TCP-порт сервера. Целое число от 0 до 65535. Значение по умолчанию — 3306.
• «Название базы данных» — название базы данных.
• «Имя пользователя» — учётная запись MySQL.
• «Пароль» — пароль учётной записи.
• «Дополнительные настройки» — параметры строки подключения в формате Ключ=Значение;. ТехноДок добавляет их в конец строки подключения без изменений.

Oracle

Соединение с базой данных Oracle. Тип есть в списке, только если в каталоге сервера ТехноДок лежит библиотека Devart.Data.Oracle.dll.

Настройки подключения:

• «Адрес сервера» — IP-адрес или доменное имя сервера Oracle.
• «Порт» — TCP-порт сервера. Целое число от 0 до 65535. Значение по умолчанию — 1521.
• «Название службы» — название службы базы данных, например orcl.
• «Имя пользователя» — учётная запись Oracle.
• «Пароль» — пароль учётной записи.
• «Дополнительные настройки» — параметры строки подключения в формате Ключ=Значение;. ТехноДок добавляет их в конец строки подключения без изменений.

PostgreSQL

Соединение с базой данных PostgreSQL.

Настройки подключения:

• «Адрес сервера» — IP-адрес или доменное имя сервера PostgreSQL.
• «Порт» — TCP-порт сервера. Целое число от 0 до 65535. Значение по умолчанию — 5432.
• «Название базы данных» — название базы данных.
• «Имя пользователя» — учётная запись PostgreSQL.
• «Пароль» — пароль учётной записи.
• «Дополнительные настройки» — параметры строки подключения в формате Ключ=Значение;. ТехноДок добавляет их в конец строки подключения без изменений.

Файлы

Текстовый

Соединение с текстовым файлом.

Настройки подключения:

• «Путь до файла» — абсолютный путь к файлу на сервере ТехноДок.

Excel

Соединение с файлом Excel.

Настройки подключения:

• «Путь до файла» — абсолютный путь к файлу на сервере ТехноДок.

Прочее

HTTP

Соединение с HTTP-сервером.

Настройки подключения:

• «Адрес ресурса» — базовый адрес HTTP-сервера с протоколом, например http://example.com.
• «Время ожидания ответа (c.)» — время ожидания ответа сервера в секундах. Целое число не меньше 0. Значение по умолчанию — 15.
• «Заголовки» — HTTP-заголовки, которые ТехноДок добавляет к каждому запросу через соединение. Для каждого заголовка задаётся ключ и значение, строка добавляется кнопкой «Добавить» и удаляется кнопкой удаления. По умолчанию список пуст.

ODBC

Соединение через драйвер ODBC.

Настройки подключения:

• «Строка соединения» — строка подключения в формате Driver={Название драйвера ODBC};Ключ1=Значение1;Ключ2=Значение2;, например Driver={ODBC Driver 17 for SQL Server};Server=localhost;Database=master;UID=sa;PWD=password. Допустимые ключи описаны в документации драйвера ODBC.

OLE DB

Соединение через провайдер OLE DB. Тип работает, только если сервер ТехноДок установлен в Windows.

Настройки подключения:

• «Строка соединения» — строка подключения в формате Provider=Название провайдера OLE DB;Ключ1=Значение1;Ключ2=Значение2;, например Provider=MSOLEDBSQL;Server=localhost;Database=master;UID=sa;PWD=password. Допустимые ключи описаны в документации провайдера OLE DB.

OPC

Соединение с OPC-сервером по стандарту OPC DA, OPC HDA или OPC UA.

Настройки подключения:

• «Стандарт OPC» — стандарт подключения: «DA», «HDA» или «UA». Значение по умолчанию — «DA». Кнопка с лупой справа от поля открывает окно «Обозреватель OPC серверов». В окне задаётся адрес сервера, а для стандарта «UA» — адрес конечной точки сервера обнаружения. После нажатия кнопки «Поиск» и выбора сервера из найденных ТехноДок заполняет поля подключения.
• «Тип аутентификации» — способ входа на OPC-сервер: «Анонимная», «Имя пользователя и пароль» или «Сертификат». Значение «Сертификат» доступно только для стандарта «UA». Значение по умолчанию — «Анонимная».

Если выбран стандарт «DA» или «HDA»:

• «Адрес сервера» — IP-адрес или имя хоста OPC-сервера.
• «Название OPC-сервера» — программный идентификатор OPC-сервера, например Matrikon.OPC.Simulation.1.

Если выбран стандарт «UA»:

• «Адрес конечной точки» — адрес конечной точки OPC UA сервера, например opc.tcp://127.0.0.1:62640/.
• «Режим безопасности» — защита сообщений: «Без режима безопасности», «Подписать» или «Подписать и зашифровать». Значение по умолчанию — «Без режима безопасности».
• «Политика безопасности» — набор алгоритмов подписи и шифрования. Значение по умолчанию — «Без политики безопасности». Политика должна совпадать с политикой конечной точки сервера.

  Значение	Описание
  «Без политики безопасности»	Сообщения не подписываются и не шифруются
  «Basic128Rsa15»	Шифрование AES-128, подпись SHA-1, обмен ключами RSA PKCS#1 v1.5. Спецификация OPC UA признала политику устаревшей
  «Basic256»	Шифрование AES-256, подпись SHA-1, обмен ключами RSA-OAEP. Спецификация OPC UA признала политику устаревшей
  «Basic256Sha256»	Шифрование AES-256, подпись SHA-256, обмен ключами RSA-OAEP
  «Aes128_Sha256_RsaOaep»	Шифрование AES-128, подпись SHA-256, обмен ключами RSA-OAEP
  «Aes256_Sha256_RsaPss»	Шифрование AES-256, подпись SHA-256 по схеме RSA-PSS

Если выбран тип аутентификации «Имя пользователя и пароль»:

• «Имя пользователя» — учётная запись на OPC-сервере.
• «Пароль» — пароль учётной записи.

Если выбран стандарт «UA» и тип аутентификации «Сертификат»:

• «Путь до сертификата клиента» — путь к файлу сертификата клиента на сервере ТехноДок.
• «Путь до приватного ключа» — путь к файлу приватного ключа сертификата на сервере ТехноДок.