Включение и выключение актива
Выключение актива представляет собой процесс блокировки всех взаимодействий между вещью и платформой. Если вещь выключена, сообщения от платформы к вещи не отправляются и не сохраняются. Аналогично любые сообщения от вещи к платформе также блокируются и не сохраняются.
Возможность выключения вещей важна для различных бизнес-сценариев. Платформа может развертывать вещи, которые редко обмениваются данными и могут отправлять неточные или ненужные сообщения. Например, выключение вещи может немедленно оказаться полезным, если беспокоит объем данных, отправляемый агентом, или частота его взаимодействий с платформой. Выключение вещи останавливает поступающие и исходящие сообщения, предоставляя администраторам платформы время для внесения исправлений в шаблоны взаимодействия, объемы данных и скорости передачи.
Функциональность выключения или включения вещи применима только для удаленных вещей на базе Axeda, созданных с помощью шаблонов вещей AxedaBaseModel или их производных шаблонов вещей. Дополнительные сведения о шаблонах вещей Axeda см. в разделе Шаблоны вещей ACE.
• Пользователи могут включать и выключать вещи, созданные с помощью модели AxedaStandaloneModel для шаблонов вещей AxedaEMessageGatewayModel. Если вещь шлюза выключена или включена, будут автоматически включены или выключены управляемые ею устройства.
• Включение и выключение не поддерживается для устройств, управляемых с помощью шаблона вещи AxedaManagedModel. Включение и выключение управляемого устройства должно выполняться через вещь его шлюза.
• Профиль выключаемой вещи будет автоматически применен для удаленных вещей на основе Axeda, созданных с помощью шаблонов вещи AxedaBaseModel. Для всех других вещей реализация профиля выключаемой вещи приведет к появлению исключения.
Чтобы использовать функцию отключения и включения, используйте ThingWorx 9.7.0 и Axeda Compatibility Package 2.6.0 (включая сервер eMessage, расширение совместимости Axeda и расширение удаленного доступа). Дополнительные сведения о совместимых версиях см. в разделе Release Advisor.
 |
Чтобы создавать вещи вручную или программно на основе шаблона вещи AxedaBaseModel или производных от него шаблонов, необходимо иметь разрешения видимости для профилей вещей Mutable, MutableGateway и MutableManagedDevice.
|
Выключение и включение удаленной вещи на основе Axeda
Чтобы выключить или включить вещь, используйте следующие методы.
• Сервисы:
Через профиль Mutable ThingShape доступны два сервиса для удаленных вещей на основе Axeda.
◦ Mute - этот сервис выключает вещь и блокирует все ее взаимодействия с платформой. Если эта вещь - шлюз, он также выключает все управляемые вещи.
◦ Unmute - этот сервис включает вещь и разрешает все ее взаимодействия с платформой. Если эта вещь - шлюз, он также включает все управляемые вещи.
• Интерфейс пользователя Composer
Пользователь может включить или выключить вещи с помощью флажка на странице Общая информация (только для устройств Axeda).
|
|
• При первом создании вещи с помощью шаблонов активов Axeda поле Выключено может не сразу появиться на странице Общая информация вещи. Чтобы увидеть это поле, подождите несколько секунд, а затем обновите Composer или закройте и снова откройте вещь (сущность).
Если вещь не является устройством Axeda, добавление профиля выключаемой вещи установкой флажка Выключено и попытка сохранить вещь приведет к ошибке.
• Функции выключения и включения поддерживаются только сервисами выключения и включения или пользовательским интерфейсом Composer. Не рекомендуется изменять конфигурацию выключения путем импорта XML.
• При использовании функций выключения и включения доступны следующие сообщения об ошибках:
◦ При попытке выключить удаленную вещь, отличную от Axeda: Muting/Unmuting is not supported for this Thing.
◦ При попытке выключить управляемую вещь: Muting/Unmuting of managed Things is not supported.
◦ При выполнении шлюза, если не удается выключить управляемую вещь: An error occurred while Muting/Unmuting managed devices. Retry Mute/Unmute on the Gateway.
|
Проверка выключенного или включенного состояния актива
Чтобы проверить, выключена или включена вещь, используйте следующие методы.
• Сервисы
С последними расширениями ThingWorx и ThingWorx сервис IsMuted доступен для удаленных вещей на основе Axeda через профиль выключаемой вещи.
IsMuted - этот сервис показывает, выключена ли вещь.
• Composer
◦ В разделе Мониторинг на странице Удаленные вещи можно увидеть новый столбец Выключено. Если вещь выключена, в ответе будет показано Да, для включенной вещи будет показано Нет, а для вещей, не относящихся к Axeda, в ответе будет показано Н/Д.
◦ В разделе Мониторинг на странице Удаленные вещи используйте фильтр Выключено, чтобы увидеть, какие вещи выключены и включены.
◦ На странице Общая информация вещи будет виден флажок Выключено.
Поведение выключения и включения актива
Интерфейс
◦ Если выключен шлюз, автоматически будут выключены управляемые вещи, связанные со шлюзом.
◦ Если шлюз выключен, невозможно включить управляемую вещь.
◦ При включении шлюза автоматически включаются управляемые вещи, связанные со шлюзом.
◦ Если шлюз выключен, невозможно выключить управляемую вещь.
Свойства удаленной вещи на основе Axeda
Если вещь выключена, любое обновление свойства с помощью удаленного сервиса приведет к сбою с исключением AssetMutedException.
Например, появится следующее сообщение об ошибке: Thing is Muted, Unable to update <имя свойства> on <имя вещи>.
Сервис удаленной вещи на основе Axeda
Если вещь выключена, попытка выполнить любой удаленный сервис приведет к сбою с исключением AssetMutedException.
Например, появится следующее сообщение об ошибке: Thing is Muted, Unable to invoke <имя сервиса> on <имя вещи>.
Операции переноса файлов
Если вещь выключена, операция переноса новых файлов приведет к сбою с исключением AssetMutedException.
Активные операции передачи файлов продолжат выполняться даже для выключенных вещей.
Удаленные сессии
◦ Если вещь выключена, попытка выполнения новых удаленных сессий приведет к сбою с исключением.
Например: You are not allowed to start a remote session on a muted asset <name>.
◦ Активные удаленные сессии будут продолжать работать, даже если вещь отключена.
Разрешения пользователя для выключения и включения
Добавлена стандартная группа пользователей с именем MuteUnmuteUsers, позволяющая выбранной группе пользователей включать и выключать активы. Она будет работать в парадигме разрешений ThingWorx, если это касается разрешений для сервисов. Дополнительные сведения см. в разделе Группы пользователей.
Журналы аудита
Если журналы аудита включены, в них вносятся следующие записи.
• Тип действия - выключение или включение.
• Наименование изменяемой вещи.
• Метка времени, содержащая дату и время действия.
• Тип пользователя, выполнившего действие.
