Сервисы удаленных вещей
Ниже приведен список сервисов, которые могут использоваться с удаленными вещами.
Сервис
Описание
EvaluateReporting
Этот сервис оценивает статус отчетов вещи на основе стратегии.
Ниже приведены входные параметры для сервиса:
eventName - имя события.
eventTime - время инициирования события.
source - наименование вещи, которая инициирует события.
sourceProperty - свойство источника eventData.
После выполнения этого сервиса выходные данные не принимаются.
GetEventSubscriptions
Получение событий, связанных с удаленной вещью.
Для этого сервиса не требуется ввод данных.
При выполнении этого сервиса возвращаются подписанные события для удаленной вещи в форме таблицы данных.
После выполнения этого сервиса принимаются следующие параметры:
Data Shape - EdgeThingEventNotification.
Infotable Type - только таблица данных.
GetPropertySubscriptions
Получение свойств, а также типа изменения данных и порога изменения данных для вещи Edge.
Ниже приведены входные параметры для сервиса:
options - опции привязки, поддерживаемые вызывающим SDK.
При выполнении этого сервиса возвращаются подписанные свойства для удаленной вещи в форме таблицы данных.
После выполнения этого сервиса принимаются следующие параметры:
Data Shape - EdgeThingEventNotification.
Infotable Type - только таблица данных.
GetQueuedTasks
Загрузка любых заданий для этой присоединенной вещи.
Для этого сервиса не требуется ввод данных.
Выполнение этого сервиса возвращает вещи Edge в форме таблицы данных.
После выполнения этого сервиса принимаются следующие параметры:
Data Shape - MessageStoreList.
Infotable Type - только таблица данных.
GetRemoteMetadata
Возвращает метаданные для подключенной вещи.
Для этого сервиса не требуется ввод данных.
При выполнении этого сервиса возвращаются метаданные подключенной вещи в формате JSON.
GetReportingStrategy
Загружает стратегию отчетности для этой вещи.
Для этого сервиса не требуется ввод данных.
При выполнении этого сервиса возвращаются метаданные подключенной вещи в формате STRING.
Invoke
Ниже приведены входные параметры для сервиса:
endpointUri
paramsTable
headerParams
resultType
Выполнение этого сервиса возвращает выходные данные в виде таблицы данных.
ProcessRemoteEvents
Обработка удаленных событий.
Ниже приведены входные параметры для сервиса:
values
После выполнения этого сервиса выходные данные не принимаются.
ReceiveRouteLifecycleEvent
Ниже приведены входные параметры для сервиса:
eventPayload
После выполнения этого сервиса выходные данные не принимаются.
RegisterRoute
Ниже приведены входные параметры для сервиса:
routeXml
После выполнения этого сервиса выходные данные не принимаются.
SendMaxQueuedTasks
Отправляет до определенного максимального числа заданий, помещенных в очередь, в подключенную вещь.
Ниже приведены входные параметры для сервиса:
maxCount - максимальное число сообщений, требуемое устройством Edge.
Выполнение этого сервиса возвращает число отправленных заданий, помещенных в очередь, вплоть до maxCount, в формате INTEGER.
SendQueuedTasks
Отправляет все задания в очереди в подключенную вещь.
Для этого сервиса не требуется ввод данных.
После выполнения этого сервиса выходные данные не принимаются.
SetReportingStrategy
Задание стратегии передачи сообщений для этой вещи.
Ниже приведены входные параметры для сервиса:
strategyThing - наименование вещи стратегии.
После выполнения этого сервиса выходные данные не принимаются.
UpdateSubscribedPropertyValues
Запись значения свойств подписки для присоединенной вещи.
Ниже приведены входные параметры для сервиса:
values
После выполнения этого сервиса выходные данные не принимаются.
Параметр values представляет таблицу данных, состоящую из нескольких строк, где каждая строка содержит имя, значение и качество свойства, сопровождаемые меткой времени обновления. Значения свойств не могут быть заданы как null.
По умолчанию обновление значения выполняется для каждого свойства по отдельности. Чтобы значения сортировались и группировались по метке времени, а не по свойству, для настройки GroupPropertyValuesByTime необходимо задать значение true в разделе BasicSettings файла platform-settings.json.
Когда для этой настройки задано значение true, совместно инициируются события и предупреждения, инициируемые данными, для всех свойств, обновляемых с той же меткой времени. В результате подписки на несколько событий, зарегистрированные для некоторых или всех этих событий, будут выполняться только один раз для метки времени с передачей соответствующих событий в параметре events.
UpdateSubscribedPropertyValuesBatched
Значения свойств подписки записываются в пакетах для присоединенной вещи.
Ниже приведены входные параметры для сервиса:
batches
После выполнения этого сервиса выходные данные не принимаются.
Параметр batches представляет таблицу данных, состоящую из нескольких строк. Каждая строка содержит пакет значений свойств и метку времени обновления.
Значение поля batch представляет таблицу данных, состоящую из нескольких строк. Каждая строка содержит имя, значение и качество свойства. Значения свойств не могут быть заданы как null.
Значения свойств сортируются и группируются по меткам времени пакетов. Это означает, что инициируемые данными события и предупреждения для всех свойств, обновленных с одной меткой времени, инициируются совместно. В результате подписки на несколько событий, зарегистрированные для некоторых или всех этих событий, будут выполняться только один раз для метки времени с передачей соответствующих событий в параметре events.
Было ли это полезно?