IoT провайдерінің әрекеттерін реттеңіз

IoT (заттардың интернеті) провайдерін орнатқаннан кейін ұйымыңыздың IoT құрылғыларынан түсірілген деректер негізінде іске қосылатын әрекеттер жинағын көрсетуге болады. Алдын ала анықталған бес әрекетпен бірге Connected Field Service әрекеттерінің әртүрлі аспектілерін автоматтандыру үшін провайдермен байланысты арнаулы әрекеттерді жасай аласыз.

Келесі әрекеттер Connected Field Service қызметімен бірге келеді:

• Құрылғы деректерін тартыңыз
• Құрылғыны тіркеңіз
• Құрылғының жиынтық көрсеткіштері
• Құрылғының көрсеткіштерін сұрау
• Құрылғы оқиғаларын алыңыз

Құрылғы деректерін шығарып алу

Құрылғы деректерін тарту әрекеті бір құрылғы немесе IoT провайдерінен құрылғылар жинағы үшін соңғы деректерді алады. Ол Құрылғы деректерінің журналы қойындысында пайда болады.

Деректер бірнеше құрылғылардан келуі мүмкін болғандықтан, құрылғы деректерін тарту әрекеті енгізу ретінде EntityCollection қажет етеді. Келесі кесте EntityCollection параметрлерін сипаттайды.

Параметр	Түр	Толық мәліметтер
msdyn_iotdeviceid	string	Жолға түрлендірілген Connected Field Service ішіндегі GUID құрылғы идентификаторы (msdyn_iotdevice)
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 сипаты	Түр	Толық мәліметтер
Идентификатор	string	Жолға түрлендірілген Connected Field Service ішіндегі GUID құрылғы идентификаторы (msdyn_iotdevice)
ConnectionState	boolean	Құрылғы ажыратылған (жалған) немесе қосылған (шын)
ConnectionStateUpdatedTime	datetime	IoT провайдерінен соңғы қосылым күйінің жаңартуының уақыт белгісі
DeviceReporterProperties	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	Жолға түрлендірілген Connected Field Service ішіндегі GUID құрылғы идентификаторы (msdyn_iotdevice)
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 сипаты	Түр	Толық мәліметтер
Идентификатор	string	Жолға түрлендірілген Connected Field Service ішіндегі GUID құрылғы идентификаторы (msdyn_iotdevice)
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 ішіндегі жиынтық тақталардағы құрылғы күйінің жылдам сурет береді.

Келесі кесте Біріктірілген құрылғы көрсеткіштері әрекетінің кіріс параметрлерін сипаттайды.

Параметр	Түр	Толық мәліметтер
deviceId	string	Жолға түрлендірілген Connected Field Service ішіндегі GUID құрылғы идентификаторы (msdyn_iotdevice)
өлшемдер	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 провайдерінен температура мен ылғалдылық сияқты тарихи құрылғы деректерін алады және оны уақыт қатарларының диаграммасы ретінде көрсетеді.

Келесі кесте сұрау құрылғысының оқулары әрекетінің енгізу параметрлерін сипаттайды.

Параметр	Түр	Толық мәліметтер
Басы	datetime	ISO форматындағы оқудың (өлшеудің) басталу уақыты; мысалы, "2020-04-10T13:51:55.781Z"
Келесіге	datetime	ISO форматындағы оқудың (өлшеудің) аяқталу уақыты
IoTDeviceId	string	Жолға түрлендірілген Connected Field Service ішіндегі GUID құрылғы идентификаторы (msdyn_iotdevice)
Аралық	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	String	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 сипаты	Түр	Толық мәліметтер
Басы	datetime	ISO форматындағы оқудың (өлшеудің) басталу уақыты; мысалы, "2020-04-10T13:51:55.781Z"
Келесіге	datetime	ISO форматындағы оқудың (өлшеудің) аяқталу уақыты
IoTDeviceId	string	Жолға түрлендірілген Connected Field Service ішіндегі GUID құрылғы идентификаторы (msdyn_iotdevice)

Енгізу үлгісі:

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

Құрылғы оқиғаларын алу әрекеті деректерді серияланған JSON пішімінде қайтарады. Келесі кесте шығыс параметрлерін көрсетеді.

JSON сипаты	Түр	Толық мәліметтер
EventsName	string	Оқиға категориясының қысқаша сипаттамасы; оны сол санаттағы барлық оқиғаларды көрсету немесе жасыру үшін пайдаланыңыз
Timestamp	string	ISO форматындағы жол ретінде пішімделген оқиғаның уақыт белгісі; оқиға пиніне арналған x осінің уақыт белгісі
Түсі	string	Оқиға пинінің түсі, он алтылық код жолы ретінде берілген
Сипаттама	string	Оқиғаның қысқаша сипаттамасы, пайдаланушы мәліметтерді көру үшін пиннің үстіне меңзерді апарғанда немесе түйреуішті таңдағанда көрсетіледі
Идентификатор	string	Оқиғаның идентификаторы; атау немесе жұмысқа тапсырыс нөмірі немесе тапсырысты растау коды сияқты басқа пайдаланушыға ыңғайлы мән болуы мүмкін
Entity	string	The 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"
    }
  }
}

Келесі қадамдар

• Connected Field Service ішінде пәрмендерді жіберу
• Теңшелетін IoT шешімдеріне арналған IoT провайдері
• Connected Field Service көмегімен IoT интеграциясы