IoT sağlayıcısı eylemlerini ayarlama

Bir IoT (Nesnelerin İnterneti) sağlayıcısı ayarladıktan sonra, kuruluşunuzun IoT cihazlarından yakalanan verilere göre tetiklenecek bir dizi eylem belirtebilirsiniz. Önceden tanımlı beş eylemle birlikte, Connected Field Service işlemlerinizin çeşitli yönlerini otomatikleştirmek için sağlayıcınızla ilişkili özel eylemler oluşturabilirsiniz.

Aşağıdaki eylemler Connected Field Service ile gelir:

• Cihaz verilerini al
• Cihazı kaydetme
• Toplanan cihaz okumaları
• Cihaz okumalarını sorgulama
• Cihaz olaylarını alma

Cihaz verilerini al

Cihaz verilerini çek eylemi bir cihaz veya cihaz koleksiyonu için IoT sağlayıcısından en son verileri alır. Bu işlem Aygıt Verileri Geçmişi sekmesinde görüntülenir.

Veriler birden çok aygıttan gelebileceğinden, Cihaz verilerini çek eylemi giriş olarak bir EntityCollection gerektirir. Aşağıdaki tabloda EntityCollection'ın parametreleri açıklanmaktadır.

Örnek giriş:

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

Cihaz verilerini çek eylemi, alınan verileri serileştirilmiş JSON biçiminde döndürür. Aşağıdaki tabloda PullDeviceDataResultsJSON çıkışının parametreleri açıklanmaktadır.

Örnek çıkış:

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

Cihazı kaydetme

Cihazı kaydet eylemi bir cihaz veya cihazlar koleksiyonu ile IoT sağlayıcısı arasında bir ilişki oluşturur. Teknisyenin değiştireceği yeni ve eski cihazlar veya bileşenler kaydedilebilir. Bir cihaz, kaydedildikten sonra IoT Cihaz kaydının Kayıt Geçmişi sekmesinde görüntülenir.

Aynı anda birden fazla cihaz kaydedilebileceğinden, Cihazı kaydet eylemi giriş olarak bir EntityCollection gerektirir. Aşağıdaki tabloda EntityCollection'ın parametreleri açıklanmaktadır.

Örnek giriş:

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

Cihazı kaydet eylemi, kayıt sonuçlarını serileştirilmiş JSON biçiminde döndürür. Aşağıdaki tabloda RegistrationResultsJSON çıkışının parametreleri açıklanmaktadır.

Örnek çıkış:

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

Toplanan cihaz okumaları

Toplanan cihaz okumaları eylemi, IoT sağlayıcısından toplanan cihaz verilerini alır. Toplanan veriler, Connected Field Service içindeki özel kutucukların durumunun hızlı bir anlık görüntüsünü sağlar.

Aşağıdaki tabloda Toplanan cihaz okumaları eyleminin giriş parametreleri açıklanmaktadır.

Örnek giriş:

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

Toplanan cihaz okumaları eylemi, ölçümleri serileştirilmiş JSON biçiminde döndürür. Aşağıdaki tabloda çıkış parametreleri görüntülenir.

Örnek çıkış:

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

Toplanan cihaz okumaları eylemini kullanmıyorsanız Toplanan cihaz okumaları, cihaz veri geçmişi varlığını temel alır.

Cihaz okumalarını sorgulama

Cihaz okumalarını sorgulama eylemi, IoT sağlayıcısından sıcaklık ve nem gibi geçmiş cihaz verilerini alır ve bunu bir zaman serisi grafiği olarak görüntüler.

Aşağıdaki tabloda Cihaz okumalarını sorgulama eyleminin giriş parametreleri açıklanmaktadır.

Örnek giriş:

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

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

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

    "Interval":"P1D"
} 

Cihaz okumalarını sorgulama eylemi, verileri serileştirilmiş JSON biçiminde döndürür. Aşağıdaki tabloda çıkış parametreleri görüntülenir.

Örnek çıkış:

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

Cihaz olaylarını alma

Cihaz olaylarını alma eylemi, cihaz servis geçmişinden olayları alır ve bunları Cihaz okumalarını sorgulama eylemi tarafından oluşturulan grafiğin altında sabitlenen öğeler olarak görüntüler. Son varlık yükseltme yaptığınız zaman gibi dilediğiniz özel varlığı dahil edebilirsiniz.

Aşağıdaki tabloda Cihaz olaylarını alma eyleminin giriş parametreleri açıklanmaktadır.

Örnek giriş:

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

Cihaz olaylarını alma eylemi, verileri serileştirilmiş JSON biçiminde döndürür. Aşağıdaki tabloda çıkış parametreleri görüntülenir.

Örnek çıkış:

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

Sonraki adımlar

• Connected Field Service'te komut gönderme
• Özel IoT çözümleri için IoT sağlayıcısı
• Connected Field Service ile IoT tümleştirmesi