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.
| Parametre | Türü | Details |
|---|---|---|
| msdyn_iotdeviceid | Dize | Connected Field Service içindeki, dizeye dönüştürülen GUID cihaz kimliği (msdyn_iotdevice) |
| msdyn_name | Dize | Cihazın adı |
| @odata.type | Dize | Varlığın OData tü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.
| JSON özelliği | Türü | Details |
|---|---|---|
| Kimlik | Dize | Connected Field Service içindeki, dizeye dönüştürülen GUID cihaz kimliği (msdyn_iotdevice) |
| ConnectionState | boolean | Cihaz bağlantısının kesik (false) veya bağlı (true) olup olmadığı |
| ConnectionStateUpdatedTime | datetime | IoT sağlayıcısından son bağlantı durumu güncelleştirmesinin zaman damgası |
| DeviceReportedProperties | Dize | Cihazın JSON dizesi olarak biçimlendirilen raporlanan özellikleri |
| LastActivityTime | datetime | Cihazın son raporlanan etkinliğinin zaman damgası |
Ö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.
| Parametre | Türü | Details |
|---|---|---|
| msdyn_iotdeviceid | Dize | Connected Field Service içindeki, dizeye dönüştürülen GUID cihaz kimliği (msdyn_iotdevice) |
| msdyn_name | Dize | Cihazın adı |
| @odata.type | Dize | Varlığın OData tü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.
| JSON özelliği | Türü | Details |
|---|---|---|
| Kimlik | Dize | Connected Field Service içindeki, dizeye dönüştürülen GUID cihaz kimliği (msdyn_iotdevice) |
| RegistrationStatus | OptionSetValue | IoT sağlayıcısından Connected Field Service'e kayıt durumu Değerler ve etiketler: - 192350000: Bilinmiyor - 192350001: Kaydı Kaldırılmış - 192350002: Devam Ediyor - 192350003: Kayıtlı - 192350004: Hata Not: OptionSet, açılır denetimi gibi etiket değeri eşlemesi seçeneklerin listesidir. |
| DeviceId | Dize | IoT sağlayıcısı sistemi içindeki cihazın kimliği |
| Mesaj | Dize | Connected Field Service kullanıcısı için kayıtla ilgili ayrıntılı ileti |
Ö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.
| Parametre | Türü | Details |
|---|---|---|
| deviceId | Dize | Connected Field Service içindeki, dizeye dönüştürülen GUID cihaz kimliği (msdyn_iotdevice) |
| ölçümler | Dize | JSON biçiminde ölçülerin listesi; örnekler için aşağıdaki kod parçacığına bakın |
Ö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.
| JSON özelliği | Türü | Details |
|---|---|---|
| measuresOutput | Dize | Döndürülen ölçümlerin JSON biçiminde değerleri; örnekler için aşağıdaki kod parçacığına bakın |
Ö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.
| Parametre | Türü | Details |
|---|---|---|
| From | datetime | Okumanın (ölçüm) ISO biçiminden başlangıç zamanı; örneğin, "2020-04-10T13:51:55.781Z" |
| İşlem | datetime | Okumanın (ölçüm) ISO biçiminden bitiş zamanı |
| IoTDeviceId | Dize | Connected Field Service içindeki, dizeye dönüştürülen GUID cihaz kimliği (msdyn_iotdevice) |
| Aralık | Dize | Çizim noktasının ISO-8601 süre biçiminde belirtilen aralık boyutu; örneğin, 1 dakika "PT1M", 1 milisaniye "PT0.001S" şeklindedir Tüm aralıklar aynı boyuttadır. Bir ay her zaman 30 güne dönüştürülür ve bir yıl her zaman 365 gündü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.
| JSON özelliği | Türü | Details |
|---|---|---|
| AggregatedDeviceReadings | String | Döndürülen ölçümlerin JSON biçiminde değerleri; örnekler için aşağıdaki kod parçacığına bakın |
Ö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.
Not
Yeni eylem oluşturmanız gerekmez. msdyn_IoTGetDeviceEvents eyleminde, olay oluşturma eklentileri gibi özel bir eklenti kaydedin.
Aşağıdaki tabloda Cihaz olaylarını alma eyleminin giriş parametreleri açıklanmaktadır.
| JSON özelliği | Türü | Details |
|---|---|---|
| From | datetime | Okumanın (ölçüm) ISO biçiminden başlangıç zamanı; örneğin, "2020-04-10T13:51:55.781Z" |
| İşlem | datetime | Okumanın (ölçüm) ISO biçiminden bitiş zamanı |
| IoTDeviceId | Dize | Connected Field Service içindeki, dizeye dönüştürülen GUID cihaz kimliği (msdyn_iotdevice) |
Ö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.
| JSON özelliği | Türü | Details |
|---|---|---|
| EventsName | Dize | Olay kategorisinin kısa açıklaması; bu kategorideki tüm olayları göstermek veya gizlemek için bunu kullanın |
| Zaman damgası | Dize | Olayın ISO biçiminden dize olarak biçimlendirilmiş zaman damgası; olay sabitlemesinin x ekseni zaman damgası |
| Color | Dize | Onaltılık kod dizesi olarak sunulan olay sabitlemesinin rengi |
| Veri Akışı Açıklaması | Dize | Olayın kısa bir açıklaması, kullanıcı imleci sabitlemenin üzerine getirdiğinde veya ayrıntıları görmek için sabitlemeyi seçtiğinde görüntülenir |
| Kimlik | Dize | Olay kimliği; bir ad veya iş emri numarası ya da rezervasyon onay kodu gibi kullanıcı dostu bir değer olabilir |
| Entity | Dize | Olayla ilgili Dataverse varlık adı; örneğin, "msdyn_workorder" |
| URL | Dize | İş emri formuna bağlantı gibi, olaya ilişkin ayrıntılar sayfasının URL'si Bir varlığı ve GUID'yi geçirirseniz sistem otomatik olarak bir köprü oluşturur. |
| GUID | Dize | Dataverse içindeki varlık kaydının dizeye dönüştürülmüş GUID'i |
Ö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"
}
}
}