Пример промышленных соединений
С помощью сущности "Промышленные соединения" в ThingWorx можно подключаться к серверу ThingWorx Kepware Server для моделирования, настройки и связывания тегов, которые существуют в ThingWorx Kepware Server, с вещами в модели ThingWorx.
 |
В этом примере предполагается, что установлена и запущена версия ThingWorx 8.0 или более поздняя.
|
Создание ключа приложения и вещи в ThingWorx
Для подключения к ThingWorx Kepware Server необходимо создать ключ приложения и вещь, которая использует шаблон вещи IndustrialGateway.
1. Создайте ключ приложения в ThingWorx. Скопируйте Идентификатор ключа для дальнейшего использования.
2. Создайте вещь в ThingWorx. Запишите Имя этой вещи, так как оно будет использоваться позже в ThingWorx Kepware Server.
|
|
В этом примере вещь имеет наименование ThingWorx Kepware Server.
|
3. В поле Базовый шаблон вещи выберите IndustrialGateway.
4. Щелкните Сохранить
Установка ThingWorx Kepware Server
1. Загрузите и запустите установщик ThingWorx Kepware Server.
2. На странице приветствия щелкните Далее.
3. Примите лицензионное соглашение и щелкните Далее.
4. Примите или измените расположение установки и нажмите кнопку Далее.
5. Примите или измените расположение данных и нажмите кнопку Далее.
6. Примите или отключите установку ярлыка на рабочем столе для ThingWorx Kepware Server и щелкните Далее.
7. Выберите комплект и щелкните Далее.
8. Щелкните значок слева от опции Полная установка и выберите все компоненты Вся функция будет установлена на локальный жесткий диск или включите функции, подходящие для вашей среды.
9. Проверьте сделанный выбор и щелкните Далее (или "Назад" для проверки).
10. Включите динамическую адресацию (при необходимости) и щелкните Далее.
11. Задайте надежный пароль администратора (или пропустите его в этот раз) и нажмите кнопку Далее.
12. Щелкните Install.
13. Нажмите кнопку Готово.
На рабочем столе появится значок ThingWorx Kepware Server.
Конфигурирование ThingWorx Kepware Server и подключение к ThingWorx
1. Запустите настройку ThingWorx Kepware Server со значка рабочего стола. Откроется окно Конфигурация.
2. Щелкните правой кнопкой мыши Project и выберите Properties.
3. В Редакторе свойств выберите ThingWorx.
4. Задайте следующие настройки (настройки, не перечисленные здесь, могут остаться со значениями по умолчанию):
◦ Задайте для Enable значение Yes.
◦ Хост - IP-адрес или полное доменное имя для экземпляра ThingWorx.
◦ Порт - порт, на котором отвечает ThingWorx (обычно 80 или 443).
◦ Ключ приложения - идентификатор ключа для ключа приложения, созданного ранее.
◦ Доверять самозаверяющему сертификату - если платформа имеет самозаверяющий сертификат, измените настройку на Да. Для обеспечения максимальной безопасности задавайте значение Нет.
◦ Доверять всем сертификатам - отключает или включает строгую проверку сертификатов и может потребоваться для некоторых самозаверяющих сертификатов. Для обеспечения максимальной безопасности задавайте значение Нет.
◦ Отключить шифрование - задайте Да, если вы не используете SSL-шифрование на платформе. Для обеспечения максимальной безопасности задавайте значение Нет.
| | Незашифрованная связь представляет угрозу безопасности, и следует включать ее ТОЛЬКО во время крупномасштабного тестирования или если среда хорошо защищена другими средствами по периметру. |
◦ Наименование вещи - наименование вещи IndustrialGateway, которая была создана в ThingWorx.
| | Значение Имя вещи должно точно соответствовать имени вещи IndustrialGateway (с учетом регистра). |
5. Нажмите кнопку Применить. ThingWorx Kepware Server пытается соединиться с ThingWorx.
| | Во время оценки может быть полезно использовать драйвер симулятора с ThingWorx Kepware Server с тестовыми данными и тегами. См. руководство драйвера Simulator. |
Привязка тегов в ThingWorx Kepware Server к свойствам в ThingWorx
После соединения ThingWorx Kepware Server с ThingWorx найдите вещь IndustrialGateway, связанную с ThingWorx Kepware Server, и свяжите теги в ThingWorx Kepware Server со свойствами в ThingWorx.
1. Откройте Composer.
2. Щелкните Обзор > Промышленные соединения.
| | Промышленные соединения не отображаются, если соединение не установлено. Если ThingWorx Kepware Server установлен, но не присоединен, щелкните Start Runtime Service на значке ThingWorx Kepware Server на панели инструментов рабочего стола. |
3. Если ThingWorx Kepware Server выполняется, то отображается вещь "Промышленные соединения". Если в столбце со значком базы данных отсутствует галочка, сохраните вещь так, чтобы она была сохраненной постоянно.
a. Щелкните наименование сущности.
b. Щелкните Сохранить
4. В выпадающем меню заголовка Промышленное соединение щелкните Обнаружение. Щелкните значок плюса (+), чтобы развернуть каналы и устройства, которые существуют в ThingWorx Kepware Server.
5. Если щелкнуть отдельное устройство, под ним откроется список доступных тегов. Поставьте галочки рядом со всеми тегами, которые вы хотите добавить к новому активу, и щелкните Привязать к новому объекту.
6. Выберите шаблон вещи и щелкните OK.
| | Необходимо выбрать тип удаленного шаблона. |
7. Открывается экран создания новой вещи. Информация о конфигурации и привязке настраивается на автоматическое подключение новой вещи через ThingWorx Kepware Server. Укажите Имя для вещи.
8. Щелкните Сохранить
| | При сохранении профиль IndustrialThingShape реализуется вещью и не может быть удален из нее. При сохранении любой вещи, чей базовый шаблон вещи является производным от удаленной вещи с реализованным профилем IndustrialThingShape, разрешаются только удаленные привязки на основе адреса тега. |
| | • ThingWorx не поддерживает наследование свойства в IndustrialThingShapes. • После переопределения свойства вещи все изменения, относящиеся к привязкам свойств, внесенные в профиль вещи, не будут отражены. Это ограничено аспектами привязок. Изменение, внесенное в базовый тип свойства для экземпляра, будет распространено. • Необходимо удалить переопределенное свойство вещи (фактически отменить переопределение), и все изменения, внесенные в профиль вещи, будут отражены в вещи. |
9. В выпадающем меню заголовка промышленной вещи выберите Свойства и предупреждения. Щелкните Обновить. Значения будут изменяться в соответствии с текущими данными из ThingWorx Kepware Server.
10. Щелкните любое свойство в столбце Имя, чтобы просмотреть или исправить это свойство.
| | Для свойств типа таблицы данных должен быть задан тип Всегда отправлять принудительно. |
| | Следующие свойства характерны для вещи "Промышленные соединения": • Адрес тега - адрес тега в виде, в котором он существует в ThingWorx Kepware Server. Имя свойства и адрес связанного тега не обязательно должны совпадать. • Промышленный тип данных - тип данных в виде, в котором он существует в ThingWorx Kepware Server. Это соответствует базовому типу в ThingWorx. • Тип принудительной отправки: типом принудительной отправки по умолчанию является Отправлять принудительно с учетом изменения значения. Хотя опция Отправлять принудительно с учетом зоны нечувствительности подобна опции Отправлять принудительно с учетом изменения значения, существуют тонкие различия в передаваемых значениях. Например, если значения от устройства - 1, 2, 3 и 4, а тип принудительной отправки Отправлять принудительно с учетом изменения значения с величиной Порог принудительной отправки 2, то значение, которое будет отправлено от Edge, будет равно 1. Однако это значение не передается повторно, поскольку оно было изменено только на 1. Если в этом примере будет задан тип принудительной отправки Отправлять принудительно с учетом зоны нечувствительности, это приведет к отправке значений 1 и 3, потому что изменение находится между последним значением, которое было отправлено, а не последним значением из Edge.
|
11. Чтобы привязать дополнительные теги к имеющимся сущностям, щелкните Добавить, чтобы получить доступ к атрибутам нового свойства. Назначьте имя и другие нужные свойства, не забывая выбрать Удаленно связанный в разделе Привязывание. Щелкните Добавить под опцией "Адрес тега", чтобы выбрать дополнительные теги для связывания с выбранной сущностью.
| | Можно также выбрать опцию Динамический тег, ввести адрес динамического тега и выбрать Промышленный тип данных перед нажатием кнопки Готово. |
Свойства диагностики промышленного интерфейса
Существует несколько диагностических свойств IndustrialGateway, которые можно использовать, чтобы получить информацию о статусе на ThingWorx Kepware Server.
| | Все количественные свойства регистрируются в потоке данных. |
• ActiveTagCount - число тегов, связанных со свойствами на платформе. Число тегов, активно предоставляемых сервером ThingWorx Kepware Server всем присоединенным клиентам.
• ClientCount - количество всех клиентов OPC DA, соединенных с ThingWorx Kepware Server.
• DateTime - текущие дата и время, скорректированные для часового пояса.
• DroppedUpdates - число обновлений, которые были отброшены ThingWorx Kepware Server, а не предоставлены платформе.
| | Это значение не следует использовать для проверки соединения, поскольку может быть отброшено именно это обновление. |
• ExpiredFeatures - наименования компонентов ThingWorx Kepware Server, таких как драйверы или подключаемые модули, которые больше не будут предоставлять данные до остановки и перезапуска сервера, потому что срок их действия истек или потому что компонент является лицензируемым.
• FullProjectName - полное имя и расположение текущего выполняющегося файла проекта ThingWorx Kepware Server.
• Hostname - имя хост-компьютера, на котором выполняется ThingWorx Kepware Server.
• IndustrialThingCount - число удаленных вещей, использующих интерфейс IndustrialGateway, чтобы предоставлять данные на платформу.
• isConnected - состояние соединения сервера ThingWorx Kepware Server.
• lastConnected - последнее время успешного соединения сервера ThingWorx Kepware Server.
• LicensedFeatures - имена компонентов ThingWorx Kepware Server, таких как драйверы или подключаемые модули, которые лицензированы для данного экземпляра ThingWorx Kepware Server.
• OpcClientNames - имена подключенных клиентов OPC DA, если они предоставлены.
• ProductName - наименование программного обеспечение, использующего шаблон вещи "Промышленный шлюз".
• ProductVersion - версия программного обеспечения, использующего шаблон вещи "Промышленный шлюз".
• ProjectName - имя файла проекта, используемого ThingWorx Kepware Server.
• ProjectTitle - название файла проекта, используемого ThingWorx Kepware Server.
• PropertyCount - число свойств, связанных с удаленными вещами на платформе.
• TimeLimitedFeatures - имена компонентов ThingWorx Kepware Server, таких как драйверы или подключаемые модули, которые не лицензированы для данного экземпляра ThingWorx Kepware Server, но поставляют данные.
• TotalTagCount - число тегов, назначенных всем клиентам.
• UpdatesPerSecond - среднее число обновлений, переданных в ThingWorx с ThingWorx Kepware Server.
Сервисы
Используйте один из этих сервисов для управления промышленными соединениями.
Сервис | Описание | ||
BrowseItems | Входные данные: path и filter. Фильтр является необязательным.
Возвращает: SourceType (например, Word или Word Array) тип данных, который определен в ThingWorx Kepware Server и согласуется с базовым типом ThingWorx. Этот сервис принимает фильтр в качестве аргумента, позволяя выполнять поиск определенных имен тега. Приемы фильтрации, которые могут использоваться в этом поле фильтра: * - подстановочный знак - соответствует любому набору символов. ? - подстановочный знак единственного символа - соответствует любому отдельному символу. [...] - набор включаемых символов - соответствует любому отдельному символу, включенному между квадратными скобками. Диапазоны символов могут обозначаться дефисом: "c-j". [!...] - набор исключаемых символов - соответствует любому отдельному символу, не включенному между квадратными скобками. Диапазоны символов могут обозначаться дефисом: "c-j". # - цифра - соответствует любому цифровому символу. | ||
BrowseGroups | Входные данные: path и filter. Если path не определен, возвращаются все группы. | ||
GetIndustrialThings | Возвращает все вещи, которые связаны через шаблон вещи IndustrialGateway. Просмотреть эту информацию можно также в мэшапе "Удаленные Вещи" в ThingWorx. | ||
GetPropertySubscriptions | Можно использовать этот сервис (в удаленной вещи), чтобы возвращать аспекты (свойства, определенные в ThingWorx Kepware Server).
| ||
GetBoundItems | Введите число для maxItems. Возвращает все теги, привязанные к вещи, из которой запущен сервис.
| ||
GetPropertyDiagnostics | Доступно в удаленных вещах и добавляется с помощью IndustrialThingShape. Этот сервис принимает локальное имя свойства, в данный момент привязанного к вещи, на которой выполняется сервис, и возвращает следующую информацию: • Description: поле описания на ThingWorx Kepware Server. • Valid - Boolean. Является действительным свойством на ThingWorx Kepware Server? • DriverFriendlyName: наименование, представленное пользователям для драйвера, который используется, чтобы создать тег. • Model - модель устройства под управлением драйвера, который используется для создания тега. • Error - Boolean. Ошибка устройства? • Name - имя адреса в ThingWorx Kepware Server. • DriverPersistedName - имя ThingWorx Kepware Server для драйвера, использовавшегося для создания тега. • Address - физический адрес тега в ThingWorx Kepware Server. • DataType - промышленный тип данных, каким его видит ThingWorx Kepware Server. • ReadOnly - Boolean. При значении true тег доступен только для чтения. • CurrentValue - значение тега во время выполнения сервиса. • CurrentQuality - качество тега во время выполнения сервиса. • CurrentTimestamp - время, когда тег был прочитан при выполнении сервиса. | ||
GetDiagnosticDigest | Доступно на вещи промышленного интерфейса. Этот сервис принимает любой адрес тега и возвращает диагностическую информацию этого тега из ThingWorx Kepware Server. Это единственный диагностический сервис, который может использовать статический или динамический адрес на экземпляре ThingWorx Kepware Server, чтобы предоставить информацию. Это означает, что тег не должен быть привязан к свойству на платформе, чтобы этот сервис возвращал результаты. Определение каждого из возвращенных полей совпадает с определениями для сервиса GetPropertyDiagnostics (см. выше). |
Импорт вещей через CSV-файл
Чтобы импортировать вещи в ThingWorx, можно использовать расширение импорта CSV. Это расширение включает ImportRepository, ImportHelper, ImportMashup и файл примера TestImport.csv .
| | Поддерживающие расширения PTC доступны на странице загрузки ThingWorx Foundation. |
1. Получите и импортируйте расширение в ThingWorx.
2. Откройте ImportMashup.
| | При выборе ссылки Import Format отображается формат файла. |
3. Нажмите Выберите файл и выберите CSV-файл для импорта. Файл выгружается на платформу, чтобы платформа могла прочитать файл.
4. Щелкните Выгрузить.
5. При необходимости установите флажок My CSV file has a header row.
6. Щелкните Импорт.
7. В Composer вы должны видеть все вещи, импортированные через CSV-файл.