Создание соединителей интеграции
Чтобы создать соединители интеграции, выполните следующие действия.
1. В Composer выберите > , а затем нажмите кнопку Создать.
2. Выберите один из следующих шаблонов вещи и затем нажмите кнопку OK:
◦ GenericConnector
◦ HTTPConnector
◦ ODataConnector
◦ SAPODataConnector
◦ SwaggerConnector
◦ WindchillSwaggerConnector
Дополнительные сведения о приведенных выше шаблонах вещи см. в разделе Обзор соединителей интеграции.
3. Введите наименование и описание.
4. В соответствии с выбранным шаблоном вещи в области Конфигурация установите соединение с серверной системой.
|
Шаблоны вещей
|
Описание
|
||||
|---|---|---|---|---|---|
|
Настройки соединения общего соединителя
|
• Интервал обновления (минуты) - задайте интервал для обновления кэша конечной точки. Значение по умолчанию - 60 минут.
• Тип аутентификации - введите одно из следующих значений:
◦ Нет
◦ Фиксированный
Для этого типа аутентификации требуется учетная запись сервиса в серверном приложении. Эта учетная запись не представляет фактического пользователя; она предназначена для включения доступа к другому приложению. При любом доступе из приложений ThingWorx будет использоваться эта учетная запись сервиса в серверном приложении.
◦ SSO
Дополнительные сведения см. в разделе Аутентификация с использованием единого входа.
• ИД сервера авторизации - только для типа аутентификации SSO.
Введите идентификатор сервера авторизации, к которому следует подключиться.
Этот идентификатор назначается администратором сервера при конфигурировании ThingWorx для использования SSO. Чтобы загрузить это значение, необходимо знать о переменной <authServerId>, используемой в настройке authServerId.clientID, находящейся в файле sso-settings.json в месте установки ThingWorx. Можно связаться с администратором сервера Tomcat Apache, чтобы запросить идентификатор сервера авторизации.
Дополнительные сведения см. в разделе Конфигурирование файла sso-settings.json.
|
||||
|
Настройки CSRF
|
Введите значения в следующие поля:
• Относительный URL-адрес для запроса получения CSRF
Задайте значение, которое относится к базовому URL-адресу, и лексема CSRF будет возвращена в качестве заголовка отклика. Проверьте URL-адрес, выполнив запрос GET в инструменте, например в подключаемом модуле Postman Google. Убедитесь, что указан заголовок, в котором серверная система будет возвращать лексему CSRF при выполнении запроса. Задайте для заголовка запроса значение Fetch. Ответ должен содержать заголовок с допустимым значением лексемы.
Например, для экземпляра Windchill с примененным к нему исправлением Windchill REST Services (WRS) значение этой конфигурации может быть таким простым, как servlet/odata.
• Наименование лексемы CSRF
Наименование заголовка, в котором серверная система возвращает лексему CSRF. Для системы Windchill с WRS имя заголовка CSRF_NONCE.
|
||||
|
Настройки соединения HTTP-соединителя - только для типа аутентификации "Фиксированный".
|
• Введите значения в следующие поля:
◦ Имя пользователя
◦ Пароль
◦ Подтвердите пароль
URL-адреса пути сервиса для серверной системы OData. Введите несколько строк, если имеются различные домены. Если ввести относительный URL-адрес (как показано ниже), этот URL-адрес будет использоваться как часть пути.
Например, если относительный URL-адрес имеет вид /servlet/odata, а URL-адресами сервиса являются /ProdMgmt и /DataAdmin, то фактическими URL-адресами сервиса относительно базового URL будут /servlet/odata/ProdMgmt и /servlet/odata/DataAdmin. Эти URL-адреса пути сервиса указывают одну или несколько спецификаций OData. Для каждого URL пути сервиса добавляется путь /$metadata и запрашивается ресурс для загрузки спецификации OData.
• Для всех типов аутентификации введите информацию в следующие поля URL. Если значение по умолчанию было предоставлено в шаблоне вещи, не изменяйте значение. Например, относительный URL-адрес и URL-адрес соединения указаны для SAPODataConnector. Они указывают сервис каталога, который находит соответствующие спецификации.
◦ Базовый URL-адрес: основной URL-адрес требуется для обращений к серверной системе. Он включает в себя хост-компьютер, порт и приложение серверной системы.
Для SSO введите URL-адрес, поддерживающий OAuth. Дополнительные сведения см. в разделе Работа с контекстными областями.
◦ Относительный URL-адрес - URL-адрес, на котором обслуживается интерфейс API. Задается относительно базового URL-адреса.
◦ URL-адрес соединения - URL-адрес, используемый для проверки соединения. Задается относительно базового URL-адреса.
Получить унаследованные данные - если флажок не установлен, вновь представленные параметры будут видимыми. Новые параметры вводятся в определение конечных точек в соответствии с последним сопоставлением. Дополнительные сведения см. в разделе Базовые типы свойств. По умолчанию флажок установлен.
|
||||
|
Настройки соединения соединителя OData: только для ODataConnector
|
|||||
|
SAPODataConnector
|
|||||
|
Настройки соединения соединителя Swagger
|
• Относительный URL-адрес спецификации Swagger - URL-адрес, используемый для получения спецификации Swagger из серверной системы. Задается относительно базового URL-адреса.
|
Раздел Настройки контекстных областей сервера авторизации: только для типа аутентификации SSO.
Введите наименования контекстных областей в точности так, как они отображаются на сервере авторизации. Эти контекстные области определяются в поставщике ресурсов и регистрируются на сервере авторизации. Дополнительные сведения см. в разделе Работа с контекстными областями.
5. Перейдите к представлению сервисов в соединителе интеграции.
6. Щелкните Сохранить.
 |
Информация статуса соединения доступна в меню > > . Дополнительные сведения см. в разделе Мониторинг статуса соединителей интеграции.
|