Налаштування дій провайдера IoT

Налаштувавши постачальника IoT (Інтернету речей), ви можете вказати набір дій, які потрібно ініціювати на основі отриманих даних із пристроїв IoT вашої організації. Поряд із п’ятьма попередньо визначеними діями, ви можете створювати власні дії , пов’язані з вашим постачальником, щоб автоматизувати різні аспекти ваших операцій Connected Field Service.

Наступні дії супроводжують Connected Field Service:

• Отримання даних пристрою
• Зареєструвати пристрій
• Агреговані показання приладу
• Запит показань пристрою
• Як отримувати події на пристрої

Отримати дані пристроїв

Дія Pull device data отримує найновіші дані для одного пристрою або колекції пристроїв від постачальника IoT. Він відображається на вкладці «Історія даних пристрою».

Оскільки дані можуть надходити з кількох пристроїв, дія Pull device data вимагає EntityCollection як вхідні дані. Наступна таблиця описує параметри EntityCollection.

Приклад вхідних даних:

{
  "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.

Зразок виводу:

{
  "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"
     }
  ]
}

Зареєструвати пристрій

Дія «Реєструвати пристрій» створює зв’язок між пристроєм або колекцією пристроїв і постачальником IoT. Нові пристрої та пристрої або компоненти, які технік замінює, можуть бути зареєстровані. Після реєстрації пристрою він з’явиться на вкладці «Історія реєстрацій» запису IoT-пристрою.

Оскільки кілька пристроїв можуть бути зареєстровані одночасно, дія «Реєструвати пристрій» вимагає введення EntityCollection. Наступна таблиця описує параметри EntityCollection.

Приклад вхідних даних:

{
  "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.

Зразок виводу:

{
   "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. Агреговані дані дають швидкий знімок стану пристрою на зведених плитках в Connected Field Service.

У наступній таблиці описані вхідні параметри дії агрегованих показань приладу.

Приклад вхідних даних:

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

Дія «Агреговані показання пристрою» повертає вимірювання у серійному форматі 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"
    }
]

Зведені показання пристрою обчислюються на основі сутності історії даних пристрою, якщо ви не використовуєте дію Зведені показання пристрою.

Запит показань пристрою

Дія «Зчитування пристрою запиту» отримує історичні дані пристрою, такі як температура та вологість, від постачальника IoT і відображає їх у вигляді діаграми часових рядів.

У наведеній нижче таблиці описані вхідні параметри дії зчитування пристрою Query.

Приклад вхідних даних:

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

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

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

    "Interval":"P1D"
} 

Дія «Запит зчитування пристрою» повертає дані у серіалізованому форматі 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
      }
    }
  }
}    

Як отримувати події на пристрої

Дія "Отримати події пристрою" отримує події з журналу служб пристрою та відображає їх у вигляді позначок у нижній частині діаграми, створеної дією "Запит зчитування пристрою". Можна додавати й будь-які настроювані сутності, наприклад, час останнього оновлення активу.

У наведеній нижче таблиці описано вхідні параметри дії Отримати події пристрою.

Приклад вхідних даних:

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

Дія «Отримати події пристрою» повертає дані у серіалізованому форматі JSON. У наступній таблиці відображені параметри виводу.

Зразок виводу:

{
  "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"
    }
  }
}

Наступні кроки

• Надсилання команд у форматі Connected Field Service
• Постачальник IoT для індивідуальних рішень IoT
• Інтеграція IoT з Connected Field Service