แชร์ผ่าน

ตั้งค่าการดำเนินการของผู้ให้บริการ IoT

  • บทความ

หลังจากที่ คุณตั้งค่าผู้ให้บริการ IoT (อินเทอร์เน็ตในทุกสิ่ง) คุณสามารถระบุชุดของการดำเนินการที่จะทริกเกอร์ตามข้อมูลที่รวบรวมจากอุปกรณ์ IoT ขององค์กรของคุณ นอกเหนือจากการดำเนินการที่กำหนดไว้ล่วงหน้าห้ารายการแล้ว คุณสามารถสร้าง การดำเนินการแบบกำหนดเอง ที่เกี่ยวข้องกับผู้ให้บริการของคุณ เพื่อทำให้การดำเนินงานด้านต่างๆ ของ Connected Field Service ของคุณเป็นแบบอัตโนมัติ

การดำเนินการที่มาพร้อมกับ Connected Field Service มีดังต่อไปนี้:

ดึงข้อมูลอุปกรณ์

การดำเนินการดึงข้อมูลอุปกรณ์ จะดึงข้อมูลล่าสุดสำหรับอุปกรณ์หนึ่งรายการหรือชุดอุปกรณ์จากผู้ให้บริการ IoT ปรากฏในแท็บ ประวัติข้อมูลอุปกรณ์

เนื่องจากข้อมูลสามารถมาจากอุปกรณ์หลายรายการ การดำเนินการดึงข้อมูลอุปกรณ์จึงจำเป็นต้องมี EntityCollection เป็นอินพุต ตารางต่อไปนี้อธิบายถึงพารามิเตอร์ของ EntityCollection

พารามิเตอร์ ชนิด คำอธิบาย
msdyn_iotdeviceid string รหัสอุปกรณ์ GUID (msdyn_iotdevice) ใน Connected Field Service ที่แปลงเป็นสตริง
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"
      }
  ]
}

การดำเนินการดึงข้อมูลอุปกรณ์จะส่งคืนข้อมูลที่ดึงมาในรูปแบบ JSON ที่เป็นอนุกรม ตารางต่อไปนี้อธิบายถึงพารามิเตอร์ของเอาต์พุต PullDeviceDataResultsJSON

คุณสมบัติ JSON ชนิด คำอธิบาย
ID string รหัสอุปกรณ์ GUID (msdyn_iotdevice) ใน Connected Field Service ที่แปลงเป็นสตริง
ConnectionState แบบบูลีน อุปกรณ์ถูกตัดการเชื่อมต่อ (เท็จ) หรือเชื่อมต่อแล้ว (จริง)
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"
     }
  ]
}

ลงทะเบียนอุปกรณ์

การดำเนินการลงทะเบียนอุปกรณ์จะสร้างการเชื่อมโยงระหว่างอุปกรณ์หรือคอลเลกชันของอุปกรณ์กับผู้ให้บริการ IoT อุปกรณ์หรือส่วนประกอบใหม่ที่ช่างเทคนิคเปลี่ยนสามารถลงทะเบียนได้ หลังจากที่คุณลงทะเบียนอุปกรณ์ อุปกรณ์นั้นจะปรากฏในแท็บ ประวัติการลงทะเบียน ของเรกคอร์ดอุปกรณ์ IoT

เนื่องจากสามารถลงทะเบียนอุปกรณ์หลายเครื่องได้ในคราวเดียว การดำเนินการลงทะเบียนอุปกรณ์จึงจำเป็นต้องมี EntityCollection เป็นอินพุต ตารางต่อไปนี้อธิบายถึงพารามิเตอร์ของ EntityCollection

พารามิเตอร์ ชนิด คำอธิบาย
msdyn_iotdeviceid string รหัสอุปกรณ์ GUID (msdyn_iotdevice) ใน Connected Field Service ที่แปลงเป็นสตริง
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 ชนิด คำอธิบาย
ID string รหัสอุปกรณ์ GUID (msdyn_iotdevice) ใน Connected Field Service ที่แปลงเป็นสตริง
RegistrationStatus OptionSetValue สถานะของการลงทะเบียนจากผู้ให้บริการ IoT กลับไปที่ Connected Field Service
ค่าและป้ายชื่อ:
- 192350000: ไม่รู้จัก
- 192350001: ไม่ได้ลงทะเบียน
- 192350002: กำลังดำเนินการ
- 192350003: ลงทะเบียนแล้ว
- 192350004: ข้อผิดพลาด
หมายเหตุ: OptionSet เป็นรายการของตัวเลือกพร้อมการแมปค่า-ป้ายชื่อ เช่น ตัวควบคุมรายการดรอปดาวน์
DeviceId string รหัสของอุปกรณ์ในระบบผู้ให้บริการ IoT
ข้อความ string ข้อความโดยละเอียดที่เกี่ยวกับการลงทะเบียนที่ไปยังผู้ใช้ Connected Field Service

ตัวอย่างเอาต์พุต:

{
   "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 อย่างรวดเร็ว

ภาพหน้าจอของอุปกรณ์ IoT ใน Field Service ซึ่งแสดงการอ่านแบบรวม

ตารางต่อไปนี้อธิบายพารามิเตอร์อินพุตของการดำเนินการอ่านข้อมูลอุปกรณ์แบบรวม

พารามิเตอร์ ชนิด คำอธิบาย
deviceId string รหัสอุปกรณ์ GUID (msdyn_iotdevice) ใน Connected Field Service ที่แปลงเป็นสตริง
การวัด 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"
    }
]

การอ่านข้อมูลอุปกรณ์แบบรวมอิงตามเอนทิตีประวัติข้อมูลอุปกรณ์ หากคุณไม่ได้ใช้การดำเนินการอ่านข้อมูลอุปกรณ์แบบรวม

สอบถามการอ่านข้อมูลอุปกรณ์

การดำเนินการสอบถามการอ่านข้อมูลอุปกรณ์จะดึงข้อมูลอุปกรณ์ในอดีต เช่น อุณหภูมิและความชื้น จากผู้ให้บริการ IoT และแสดงเป็นแผนภูมิอนุกรมเวลา

ภาพหน้าจอของอุณหภูมิและความชื้นของอุปกรณ์ในช่วงเวลาหนึ่ง

ตารางต่อไปนี้อธิบายพารามิเตอร์อินพุตของการดำเนินการสอบถามการอ่านข้อมูลอุปกรณ์

พารามิเตอร์ ชนิด คำอธิบาย
From datetime เวลาเริ่มต้นของการอ่านข้อมูล (การวัด) ในรูปแบบ ISO ตัวอย่างเช่น "2020-04-10T13:51:55.781Z"
To datetime เวลาสิ้นสุดของการอ่านข้อมูล (การวัด) ในรูปแบบ ISO
IoTDeviceId string รหัสอุปกรณ์ GUID (msdyn_iotdevice) ใน Connected Field Service ที่แปลงเป็นสตริง
ช่วง 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 สตริง ค่าของการวัดที่ส่งคืนในรูปแบบ 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 เช่น ปลั๊กอินสำหรับสร้างกิจกรรม

ตารางต่อไปนี้อธิบายพารามิเตอร์อินพุตของการดำเนินการรับเหตุการณ์ของอุปกรณ์

คุณสมบัติ JSON ชนิด คำอธิบาย
From datetime เวลาเริ่มต้นของการอ่านข้อมูล (การวัด) ในรูปแบบ ISO ตัวอย่างเช่น "2020-04-10T13:51:55.781Z"
To datetime เวลาสิ้นสุดของการอ่านข้อมูล (การวัด) ในรูปแบบ ISO
IoTDeviceId string รหัสอุปกรณ์ GUID (msdyn_iotdevice) ใน Connected Field Service ที่แปลงเป็นสตริง

ตัวอย่างอินพุต:

{ 
    "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 สำหรับหมุดเหตุการณ์
Color string สีของหมุดเหตุการณ์ที่ระบุเป็นสตริงรหัสฐานสิบหก
Description string คำอธิบายสั้นๆ เกี่ยวกับเหตุการณ์ที่แสดงเมื่อผู้ใช้วางเมาส์เหนือหมุดหรือเลือกหมุดเพื่อดูรายละเอียด
ID string รหัสของเหตุการณ์ อาจเป็นชื่อหรือค่าอื่นที่จำได้ง่าย เช่น หมายเลขใบสั่งงานหรือรหัสยืนยันการจอง
เเอนทิตี 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"
    }
  }
}

ขั้นตอนถัดไป