Menyiapkan tindakan penyedia IoT

Artikel
10/05/2023

Setelah menyiapkan penyedia IoT (Internet of Things), Anda dapat menentukan serangkaian tindakan yang akan dipicu berdasarkan data yang diambil dari perangkat IoT organisasi Anda. Bersama dengan lima tindakan standar, Anda dapat membuat tindakan kustom yang terkait dengan penyedia Anda untuk mengotomatisasi berbagai aspek operasi Connected Field Service Anda.

Tindakan berikut datang dengan Connected Field Service:

Menarik data perangkat
Daftarkan perangkat
Pembacaan perangkat gabungan
Pembacaan perangkat kueri
Mendapatkan aktivitas perangkat

Tarik data perangkat

Tindakan Pull device data mengambil data terbaru untuk satu perangkat atau kumpulan perangkat dari penyedia IoT. Ini muncul di tab Riwayat Data Perangkat.

Karena data dapat berasal dari beberapa perangkat, tindakan Pull device data memerlukan EntityCollection sebagai input. Tabel berikut menjelaskan parameter EntityCollection.

Parameter	Tipe	Detail
msdyn_iotdeviceid	string	ID perangkat GUID (msdyn_iotdevice) di Connected Field Service, dikonversi ke string
msdyn_name	string	Nama perangkat
@odata.type	string	Jenis OData entitas

Masukan sampel:

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

Tindakan Pull device data mengembalikan data yang diambil dalam format JSON serial. Tabel berikut menjelaskan parameter output PullDeviceDataResultsJSON.

Properti JSON	Tipe	Detail
ID	string	ID perangkat GUID (msdyn_iotdevice) di Connected Field Service, dikonversi ke string
ConnectionState	boolean	Apakah perangkat terputus (false) atau tersambung (true)
ConnectionStateUpdatedTime	datetime	Stempel waktu pembaruan status koneksi terakhir dari penyedia IoT
DeviceReportedProperties	string	Properti perangkat yang dilaporkan, diformat sebagai string JSON
LastActivityTime	datetime	Stempel waktu aktivitas terakhir yang dilaporkan perangkat

Output sampel:

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

Daftarkan perangkat

Tindakan Daftarkan perangkat membuat hubungan antara perangkat atau kumpulan perangkat dan penyedia IoT. Perangkat dan perangkat atau komponen baru yang ditukar teknisi dapat didaftarkan. Setelah Anda mendaftarkan perangkat, perangkat akan muncul di tab Riwayat Pendaftaran pada rekaman Perangkat IoT.

Karena beberapa perangkat dapat didaftarkan sekaligus, tindakan Daftarkan perangkat memerlukan EntityCollection sebagai input. Tabel berikut menjelaskan parameter EntityCollection.

Parameter	Tipe	Detail
msdyn_iotdeviceid	string	ID perangkat GUID (msdyn_iotdevice) di Connected Field Service, dikonversi ke string
msdyn_name	string	Nama perangkat
@odata.type	string	Jenis OData entitas

Masukan sampel:

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

Tindakan Daftarkan perangkat menampilkan hasil pendaftaran dalam format JSON berseri. Tabel berikut menjelaskan parameter output RegistrationResultsJSON.

Properti JSON	Tipe	Detail
ID	string	ID perangkat GUID (msdyn_iotdevice) di Connected Field Service, dikonversi ke string
RegistrationStatus	OptionSetValue	Status pendaftaran dari penyedia IoT kembali ke Connected Field Service Nilai dan label: - 192350000: Tidak dikenal - 192350001: Tidak Terdaftar - 192350002 : Sedang Berlangsung - 192350003: Terdaftar - 192350004: Kesalahan Catatan: OptionSet adalah daftar opsi dengan pemetaan nilai label, seperti kontrol daftar drop-down.
DeviceId	string	ID perangkat dalam sistem penyedia IoT
Pesan	string	Pesan terperinci kepada pengguna Connected Field Service mengenai pendaftaran

Output sampel:

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

Pembacaan perangkat gabungan

Tindakan pembacaan perangkat gabungan mengambil data perangkat agregat dari penyedia IoT. Data agregat memberikan snapshot cepat kondisi perangkat pada ubin ringkasan di Connected Field Service.

Cuplikan layar perangkat IoT di Field Service, menunjukkan pembacaan agregat.

Tabel berikut menjelaskan parameter input tindakan pembacaan perangkat Gabungan.

Parameter	Tipe	Detail
deviceId	string	ID perangkat GUID (msdyn_iotdevice) di Connected Field Service, dikonversi ke string
tindakan	string	Daftar pengukuran dalam format JSON; Lihat cuplikan kode berikut untuk contoh

Masukan sampel:

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

Tindakan pembacaan perangkat gabungan mengembalikan pengukuran dalam format JSON serial. Tabel berikut menampilkan parameter output.

Properti JSON	Tipe	Detail
measuresOutput	string	Nilai pengukuran yang dikembalikan dalam format JSON; Lihat cuplikan kode berikut untuk contoh

Output sampel:

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

Pembacaan perangkat gabungan didasarkan pada entitas riwayat data perangkat jika Anda tidak menggunakan tindakan pembacaan perangkat gabungan.

Pembacaan perangkat kueri

Tindakan pembacaan perangkat Kueri mengambil data perangkat historis, seperti suhu dan kelembaban, dari penyedia IoT dan menampilkannya sebagai bagan deret waktu.

Cuplikan layar suhu dan kelembapan perangkat dari waktu ke waktu.

Tabel berikut menjelaskan parameter input tindakan pembacaan perangkat Kueri.

Parameter	Tipe	Detail
Mulai	datetime	Waktu mulai pembacaan (pengukuran) dalam format ISO; Misalnya, "2020-04-10T13:51:55.781Z"
Sampai	datetime	Waktu berakhirnya pembacaan (pengukuran) dalam format ISO
IoTDeviceId	string	ID perangkat GUID (msdyn_iotdevice) di Connected Field Service, dikonversi ke string
Interval	string	Ukuran interval titik plot yang ditentukan dalam format durasi ISO-8601; misalnya, 1 menit adalah "PT1M," 1 milisekon adalah "PT0.001S" Semua interval memiliki ukuran yang sama. Satu bulan selalu dikonversi menjadi 30 hari dan satu tahun selalu 365 hari.

Masukan sampel:

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

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

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

    "Interval":"P1D"
}

Tindakan pembacaan perangkat Kueri mengembalikan data dalam format JSON serial. Tabel berikut menampilkan parameter output.

Properti JSON	Tipe	Detail
AggregatedDeviceReadings	String	Nilai pengukuran yang dikembalikan dalam format JSON; Lihat cuplikan kode berikut untuk contoh

Output sampel:

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

Mendapatkan aktivitas perangkat

Tindakan Dapatkan peristiwa perangkat mengambil peristiwa dari riwayat layanan perangkat dan menampilkannya sebagai pin di bagian bawah diagram yang dibuat oleh tindakan Kueri pembacaan perangkat. Anda dapat menyertakan entitas kustom apa pun seperti waktu terakhir Anda melakukan peningkatan aset.

Cuplikan layar peristiwa ditampilkan sebagai pin di bawah bagan suhu dan kelembapan perangkat dari waktu ke waktu.

Catatan

Anda tidak perlu membuat tindakan baru. Daftarkan plug-in kustom pada msdyn_IoTGetDeviceEvents tindakan, seperti plug-in untuk membuat acara.

Tabel berikut menjelaskan parameter input tindakan Dapatkan peristiwa perangkat.

Properti JSON	Tipe	Detail
Mulai	datetime	Waktu mulai pembacaan (pengukuran) dalam format ISO; Misalnya, "2020-04-10T13:51:55.781Z"
Sampai	datetime	Waktu berakhirnya pembacaan (pengukuran) dalam format ISO
IoTDeviceId	string	ID perangkat GUID (msdyn_iotdevice) di Connected Field Service, dikonversi ke string

Masukan sampel:

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

Tindakan Dapatkan peristiwa perangkat menampilkan data dalam format JSON serial. Tabel berikut menampilkan parameter output.

Properti JSON	Tipe	Detail
EventsName	string	Deskripsi singkat tentang kategori acara; Gunakan untuk menampilkan atau menyembunyikan semua acara dalam kategori tersebut
Tanda Waktu	string	Stempel waktu acara diformat sebagai string dalam format ISO; stempel waktu sumbu x untuk pin peristiwa
Warna	string	Warna pin peristiwa, disediakan sebagai string kode heksadesimal
Description	string	Deskripsi singkat peristiwa, ditampilkan saat pengguna mengarahkan kursor ke pin atau memilih pin untuk melihat detail
ID	string	ID acara; dapat berupa nama atau nilai lain yang mudah digunakan, seperti nomor perintah kerja atau kode konfirmasi pemesanan
Entitas	string	Nama Dataverse entitas yang terkait dengan peristiwa; misalnya, "msdyn_workorder"
URL	string	URL halaman detail acara, seperti link ke formulir perintah kerja Jika Anda melewati entitas dan GUID, sistem secara otomatis menghasilkan hyperlink.
GUID	string	GUID, dikonversi menjadi string, dari rekaman entitas di Dataverse

Output sampel:

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

Bagikan melalui

Menyiapkan tindakan penyedia IoT

Tarik data perangkat

Daftarkan perangkat

Pembacaan perangkat gabungan

Pembacaan perangkat kueri

Mendapatkan aktivitas perangkat

Langkah berikutnya

Saran dan Komentar

Saran dan Komentar

Sumber Daya Tambahan: