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

Статия
10/05/2023

След като настроите доставчик на IoT (Интернет на нещата), можете да зададете набор от действия, които да се задействат въз основа на данните, събрани от IoT устройствата на вашата организация. Заедно с пет предварително дефинирани действия можете да създавате действия по избор, които са свързани с вашия доставчик, за да автоматизирате различни аспекти на операциите на услугата за свързани полета.

Следните действия се предоставят с услугата за свързани полета:

Издърпайте данните на устройството
Регистриране на устройство
Агрегирани показания на устройството
Четене на устройства за заявки
Получаване на събития за устройства

Извличане на данни на устройство

Действието Pull device data извлича най-новите данни за едно устройство или колекция от устройства от доставчика на IoT. Той се появява в раздела Хронология на данните на устройството.

Тъй като данните могат да идват от няколко устройства, действието за данни на устройството Pull изисква EntityCollection като вход. Следващата таблица описва параметрите на EntityCollection.

параметър	Тип	Подробни данни
msdyn_iotdeviceid	string	ИД на GUID устройство (msdyn_iotdevice) в услугата за свързани полета, преобразуван в низ
msdyn_name	string	Името на устройството
@odata.type	string	Типът OData на обекта

Примерен вход:

{
  "EntityCollection":[
      {
    "msdyn_iotdeviceid":"B25B5E21-326E-4C36-9296-C195286DGEC9",
    "msdyn_name":" HVAC 32443",
    "@odata.type":"Microsoft.Dynamics.CRM.msdyn_iotdevice"
      },
      {
    "msdyn_iotdeviceid":"B25B5E21-326E-4C36-9296-C195286DGEE9",
    "msdyn_name":" HVAC 92232",
    "@odata.type":"Microsoft.Dynamics.CRM.msdyn_iotdevice"
      }
  ]
}

Действието Pull device data връща извлечените данни в сериализиран JSON формат. Следващата таблица описва параметрите на изхода PullDeviceDataResultsJSON.

Собственост на JSON	Тип	Подробни данни
ИД	string	ИД на GUID устройство (msdyn_iotdevice) в услугата за свързани полета, преобразуван в низ
ConnectionState	boolean	Дали устройството е изключено (невярно) или свързано (вярно)
ConnectionStateUpdatedTime	datetime	Времевото клеймо на последната актуализация на състоянието на връзката от доставчика на IoT
DeviceReportedProperties	string	Отчетените свойства на устройството, форматирани като JSON низ
LastActivityTime	datetime	Времевото клеймо на последната отчетена активност на устройството

Примерно извеждане:

{
  "PullDeviceDataResultsJSON":[
     {
    "Id":"B25B5E21-326E-4C36-9296-C195286DGEC9",
    "ConnectionState":true,
    "ConnectionStateUpdatedTime":"2019-08-2911:00:00",
    "DeviceReportedProperties":{
      "temperature":65.6366305680316,
      "humidity":21.3333366666
      },
    "LastActivityTime": "2019-08-2011:00:00"
    },
    {
    "Id":"B25B5E21-326E-4C36-9296-C195286DGEE9",
    "ConnectionState":true,
    "ConnectionStateUpdatedTime":"2019-08-2911:00:00",
    "DeviceReportedProperties":{
      "temperature":62.8366305680316,
      "humidity":19.5333366666
    },
    "LastActivityTime": "2019-08-2011:00:00"
     }
  ]
}

Регистриране на устройство

Действието на устройството Register създава връзка между устройство или колекция от устройства и доставчика на IoT. Нови устройства и устройства или компоненти, които техник сменя, могат да бъдат регистрирани. След като регистрирате устройство, то се появява в раздела "История на регистрацията" на записа на IoT устройството.

Тъй като няколко устройства могат да бъдат регистрирани едновременно, действието Регистриране на устройство изисква EntityCollection като вход. Следващата таблица описва параметрите на EntityCollection.

параметър	Тип	Подробни данни
msdyn_iotdeviceid	string	ИД на GUID устройство (msdyn_iotdevice) в услугата за свързани полета, преобразуван в низ
msdyn_name	string	Името на устройството
@odata.type	string	Типът OData на обекта

Примерен вход:

{
  "EntityCollection": [
    {
      "msdyn_iotdeviceid": "5754578D-1F9A-4720-BC21-3C3042C05B2F",
      "msdyn_name": "Coffee maker 1",
      "@odata.type": "Microsoft.Dynamics.CRM.msdyn_iotdevice"
    },
    {
      "msdyn_iotdeviceid": "5754578D-1F9A-4720-BC21-3C3042C06C5F",
      "msdyn_name": "Coffee maker 2",
      "@odata.type": "Microsoft.Dynamics.CRM.msdyn_iotdevice"
    }
  ]
}

Действието "Регистриране на устройство" връща резултатите от регистрацията в сериализиран JSON формат. Следващата таблица описва параметрите на изхода на RegistrationResultsJSON.

Собственост на JSON	Тип	Подробни данни
ИД	string	ИД на GUID устройство (msdyn_iotdevice) в услугата за свързани полета, преобразуван в низ
RegistrationStatus	OptionSetValue	Статусът на регистрацията от доставчика на IoT обратно към Connected Field Service Стойности и етикети: - 192350000: Неизвестно - 192350001: Нерегистрирано - 192350002: В ход - 192350003: Регистрирано - 192350004: Грешка Забележка: Набор от опции е списък с опции със съпоставяне на стойност на етикет, като контрола на падащ списък.
DeviceId	string	Идентификационният номер на устройството в системата на доставчика на IoT
Съобщение	string	Подробно съобщение до потребителя на услугата за свързани полета относно регистрацията

Примерно извеждане:

{
   "RegistrationResultsJSON":[
      {
         "Id":"5754578D-1F9A-4720-BC21-3C3042C05B2F",
         "RegistrationStatus":{"Value":192350003},
         "DeviceId":"DeviceIdFromThirdPartyOrUserDefined",
         "Message":"Registration info/warning/error message"   
      },
      {
         "Id":"5754578D-1F9A-4720-BC21-3C3042C06C5F",
         "RegistrationStatus":{"Value":192350003},
         "DeviceId":"DeviceIdFromThirdPartyOrUserDefined",
         "Message":"Registration info/warning/error message"   
      }   
  ]
}

Агрегирани показания на устройството

Действието "Обобщени показания на устройства" извлича обобщени данни за устройството от доставчика на IoT. Агрегираните данни предоставят бърза снимка на състоянието на устройството на обобщени плочки в услугата за свързани полета.

Екранна снимка на IoT устройство в Field Service, показваща обобщени показания.

Следващата таблица описва входните параметри на действието Агрегирани показания на устройството.

параметър	Тип	Подробни данни
deviceId	string	ИД на GUID устройство (msdyn_iotdevice) в услугата за свързани полета, преобразуван в низ
мерки	string	Списък на измерванията във формат JSON; Вижте следното фрагмент от код за примери

Примерен вход:

[
    {
        "Measure":"Humidity",
        "Aggregate":"Min",
        "TimeRangeType":"Days",
        "TimeRangeValue":7
    },
    {
        "Measure":"Temperature",
        "Aggregate":"Avg",
        "TimeRangeType":"Days",
        "TimeRangeValue":14
    }
]

Действието Агрегирани показания на устройството връща измерванията в сериализиран JSON формат. Следващата таблица показва изходните параметри.

Собственост на JSON	Тип	Подробни данни
measuresOutput	string	Стойностите на върнатите измервания във формат JSON; Вижте следното фрагмент от код за примери

Примерно извеждане:

[
    {
        "Name":"Humidity",
        "Aggregate":"Min",
        "Unit":"F",
        "TimeRangeValue":7,
        "TimeRangeType":"Days",
        "Position":1,
        "Value":"39.13334"
    },
    {
        "Name":"Temperature",
        "Aggregate":"Avg",
        "Unit":"F",
        "TimeRangeValue":14,
        "TimeRangeType":"Days",
        "Position":2,
        "Value":"65.13334"
    }
]

Обобщените показания на устройството се основават на обекта за история на данните на устройството, ако не използвате действието Обобщени показания на устройството.

Четене на устройства за заявки

Действието за четене на устройството Query извлича исторически данни за устройството, като температура и влажност, от доставчика на IoT и ги показва като диаграма на времеви серии.

Екранна снимка на температурата и влажността на устройството с течение на времето.

Следващата таблица описва входните параметри на действието за четене на устройството за заявки.

параметър	Тип	Подробни данни
От	datetime	Началният час на отчитането (измерването) във формат ISO; например "2020-04-10T13:51:55.781Z"
За	datetime	Крайното време на отчитането (измерването) във формат ISO
IoTDeviceId	string	ИД на GUID устройство (msdyn_iotdevice) в услугата за свързани полета, преобразуван в низ
Интервал	string	Размерът на интервала на точката на изчертаване, зададен във формат ISO-8601 продължителност; например, 1 минута е "PT1M", 1 милисекунда е "PT0.001S" Всички интервали са с еднакъв размер. Един месец винаги се превръща в 30 дни, а една година винаги е 365 дни.

Примерен вход:

{
    "From":"2023-04-01T18:05:37.661Z", 

    "To":"2023-05-31T18:05:37.661Z", 

    "IotDeviceId":"50fce36f-9e3e-ed11-bba3-000d3a8b1de9", 

    "Interval":"P1D"
}

Действието за четене на устройството за заявки връща данните в сериализиран JSON формат. Следващата таблица показва изходните параметри.

Собственост на JSON	Тип	Подробни данни
AggregatedDeviceReadings	String	Стойностите на върнатите измервания във формат JSON; Вижте следното фрагмент от код за примери

Примерно извеждане:

{
  "HVAC Unit 123": {
    "Temperature": {
      "2017-04-01T06:00:00Z": {
        "min": -29,
        "max": 62.59,
        "avg": 16.89,
        "sum": 4054.14,
        "count": 240
      },
      "2017-04-01T08:00:00Z": {
        "min": -29,
        "max": 62.59,
        "avg": 16.89,
        "sum": 4054.14,
        "count": 480
      }
    },
    "Humidity": {
      "2017-04-01T06:00:00Z": {
        "min": 10,
        "max": 48.3,
        "avg": 29.25,
        "sum": 7020.62,
        "count": 240
      },
      "2017-04-01T08:00:00Z": {
        "min": 10,
        "max": 48.3,
        "avg": 29.25,
        "sum": 7020.62,
        "count": 480
      }
    }
  }
}

Получаване на събития за устройства

Действието "Получаване на събития на устройство" извлича събития от сервизната хронология на устройствата и ги показва като щифтове в долната част на диаграмата, създадена от действието "Четене на устройства за заявки". Можете да включите всякакви потребителски обекти, като например последния път, когато сте извършили надстройка на актив.

Екранна снимка на събитията, показани като щифтове под диаграмата на температурата и влажността на устройството във времето.

Бележка

Не е нужно да създавате ново действие. Регистрирайте персонализирана добавка за действието, като например добавки за създаване на msdyn_IoTGetDeviceEvents събития.

Следващата таблица описва входните параметри на действието Get device events.

Собственост на JSON	Тип	Подробни данни
От	datetime	Началният час на отчитането (измерването) във формат ISO; например "2020-04-10T13:51:55.781Z"
За	datetime	Крайното време на отчитането (измерването) във формат ISO
IoTDeviceId	string	ИД на GUID устройство (msdyn_iotdevice) в услугата за свързани полета, преобразуван в низ

Примерен вход:

{ 
    "IotDeviceId": "50fce36f-9e3e-ed11-bba3-000d3a8b1de9", 
    "From": "2023-06-12T18:57:54.864Z", 
    "To": "2023-06-12T19:57:54.864Z" 
}

Действието "Получаване на събития за устройства" връща данните в сериализиран JSON формат. Следващата таблица показва изходните параметри.

Собственост на JSON	Тип	Подробни данни
EventsName	string	Кратко описание на категорията на събитието; Използвайте го, за да покажете или скриете всички събития в тази категория
Времево клеймо	string	Времевото клеймо на събитието, форматирано като низ в ISO формат; времевото клеймо по оста x за щифта на събитието
Цвят	string	Цветът на щифта на събитието, предоставен като низ с шестнадесетичен код
Описание	string	Кратко описание на събитието, което се показва, когато потребителят застане над щифта или избере щифта, за да види подробности
ИД	string	Идентификационният номер на събитието; може да бъде име или друга удобна за потребителя стойност, като например номера на поръчката за работа или кода за потвърждение на резервацията
Entity	string	Името на обекта Dataverse , свързано със събитието; например "msdyn_workorder"
URL адрес	string	URL адресът на страницата с подробни данни за събитието, като например връзка към формуляра за поръчка на работа Ако подадете обект и GUID, системата автоматично генерира хипервръзка.
GUID	string	GUID, преобразуван в низ, на записа на обекта в Dataverse

Примерно извеждане:

{
  "Service History": {
    "2019-08-07T19:14:53Z": {
      "color": "#FF6300",
      "description": "Work Order Created",
      "id": "00001",
      "entity": "msdyn_workorder",
      "url": "",
      "guid": "952a7592-8818-ea11-a811-000d3a5466d7"
    },
    "2019-08-08T19:14:53Z": {
      "color": "#ECC5AC",
      "description": "Work Order Created",
      "id": "00002",
      "entity": "msdyn_workorder",
      "url": "",
      "guid": "952a7592-8818-ea11-a811-000d3a5466d9"
    },
    "2019-09-21T09:34:53Z": {
      "color": "#ECC5AC",
      "description": "Case Created",
      "id": "000121",
      "entity": "msdyn_incident",
      "url": "",
      "guid": "952a7592-8818-ea11-a811-000d3a5466d0"
    }
  },
  "Asset History": {
    "2019-08-07T19:14:53Z": {
      "color": "#FF6400",
      "description": "Asset Model Upgraded",
      "id": "001223",
      "entity": "new_assetupgraded",
      "url": "",
      "guid": "952a7592-8818-ea11-a811-000d3a5466d7"
    }
  }
}

Споделяне чрез

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

Извличане на данни на устройство

Регистриране на устройство

Агрегирани показания на устройството

Четене на устройства за заявки

Получаване на събития за устройства

Следващи стъпки

Допълнителни ресурси