Skip to main content

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

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

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

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

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

  • «Название» — название, под которым соединение выбирается в шаблонах отчётов и настройках других модулей. Название должно быть уникальным.
  • «Идентификатор» — уникальный идентификатор соединения. ТехноДок присваивает его при создании соединения, изменить его нельзя. По идентификатору ТехноДок сопоставляет соединения при импорте. Кнопка справа от поля копирует идентификатор в буфер обмена.
  • «Тип» — тип источника данных. От типа зависит состав полей в группах «Настройки подключения». У нового соединения выбран тип «КАСКАД 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» и тип аутентификации «Сертификат»:

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