IoT-palveluntarjoajan toimintojen määrittäminen
Kun olet määrittänyt IoT (Internet of Things) -palvelun, voit määrittää joukon käynnistettäviä toimintoja organisaatiosi IoT-laitteista kerättyjen tietojen perusteella. Viiden esimääritetyn toiminnan lisäksi voit luoda palveluun liittyviä mukautettuja toimintoja, joilla voit automatisoida Connected Field Service -toimintoja.
Connected Field Servicessä on seuraavat valmiit toiminnot:
- Nouda laitteen tiedot
- Rekisteröi laite
- Yhdistetyt laitteiden lukemat
- Laitelukemien kyseleminen
- Hae laitetapahtumat
Nouda laitteen tiedot
Vedä laitetiedot -toiminto noutaa IoT-palvelusta uusimmat tiedot yhdestä laitteesta tai laitekokoelmasta. Se näkyy Laitetietojen historia -välilehdessä.
Koska tiedot voivat olla peräisin useista laitteista, Vedä laitetiedot -toiminto edellyttää EntityCollection-toimintoa syötteenä. Seuraavassa taulukossa on kuvattu EntityCollectionin parametrit.
| Parametri | Type | Details |
|---|---|---|
| msdyn_iotdeviceid | string | Laitteen GUID-tunnus (msdyn_iotdevice) Connected Field Servicessa, muunnettu merkkijonoksi |
| msdyn_name | string | Laitteen nimi |
| @odata.type | string | Entiteetin OData-tyyppi |
Esimerkkisyöte:
{
"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"
}
]
}
Vedä laitetiedot ‑toiminto palauttaa noudetut tiedot sarjoitetussa JSON-muodossa. Seuraavassa taulukossa on kuvattu PullDeviceDataResultsJSON-tuloksen parametrit.
| JSON-ominaisuus | Type | Details |
|---|---|---|
| Tunnus | string | Laitteen GUID-tunnus (msdyn_iotdevice) Connected Field Servicessa, muunnettu merkkijonoksi |
| ConnectionState | boolean | Onko laite ilman yhteyttä (epätosi) vai yhteydessä (tosi) |
| ConnectionStateUpdatedTime | datetime | Viimeisimmän yhteystilan päivityksen aikaleima IoT-palveluntarjoajalta |
| DeviceReportedProperties | string | Laitteen raportoidut ominaisuudet JSON-merkkijonomuodossa |
| LastActivityTime | datetime | Laitteen viimeisimmän raportoidun aktiviteetin aikaleima |
Mallitulos:
{
"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"
}
]
}
Rekisteröi laite
Rekisteröi laite -toiminto luo liitoksen laitteen tai laitekokoelman ja IoT-palvelun välille. Uusia laitteita ja laitteita tai komponentteja, joita teknikko vaihtaa, voi rekisteröidä. Kun olet rekisteröinyt laitteen, se näkyy IoT-laitetietueen Rekisteröintihistoria-välilehdessä.
Koska kerralla voidaan rekisteröidä useita laitteita, Rekisteröi laite -toiminto edellyttää EntityCollectionia syötteenä. Seuraavassa taulukossa on kuvattu EntityCollectionin parametrit.
| Parametri | Type | Details |
|---|---|---|
| msdyn_iotdeviceid | string | Laitteen GUID-tunnus (msdyn_iotdevice) Connected Field Servicessa, muunnettu merkkijonoksi |
| msdyn_name | string | Laitteen nimi |
| @odata.type | string | Entiteetin OData-tyyppi |
Esimerkkisyöte:
{
"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"
}
]
}
Rekisteröi laite ‑toiminto palauttaa rekisteröintitulokset sarjoitetussa JSON-muodossa. Seuraavassa taulukossa on kuvattu RegistrationResultsJSON-tuloksen parametrit.
| JSON-ominaisuus | Type | Details |
|---|---|---|
| Tunnus | string | Laitteen GUID-tunnus (msdyn_iotdevice) Connected Field Servicessa, muunnettu merkkijonoksi |
| RegistrationStatus | OptionSetValue | Rekisteröinnin tila IoT-palveluntarjoajasta takaisin Connected Field Serviceen Arvot ja otsikot: - 192350000: tuntematon - 192350001: rekisteröimätön - 192350002: kesken - 192350003: rekisteröity - 192350004: virhe Huomautus: OptionSet on luettelo valinnoista, joilla on selitteen arvon vastaavuusmääritys, kuten avattavan luettelon ohjausobjekti. |
| DeviceId | string | Laitteen tunnus IoT-palveluntarjoajan järjestelmässä |
| Sanoma | string | Rekisteröitymistä koskevat yksityiskohtaiset sanomat Connected Field Service -käyttäjälle |
Mallitulos:
{
"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"
}
]
}
Yhdistetyt laitteiden lukemat
Yhdistetyt laitteiden lukemat -toiminto noutaa koostettuja laitetietoja IoT-palvelusta. Yhdistetyt tiedot tarjoaa Connected Field Servicen yhteenvetoruutujen kautta pikanäkymän laitteen tilasta.
Seuraavassa taulukossa on kuvattu Yhdistetyt laitteiden lukemat -toiminnon syöteparametrit.
| Parametri | Type | Details |
|---|---|---|
| deviceId | string | Laitteen GUID-tunnus (msdyn_iotdevice) Connected Field Servicessa, muunnettu merkkijonoksi |
| mittarit | string | Mittausten luettelo JSON-muodossa; esimerkkejä on seuraavassa koodikatkelmassa |
Esimerkkisyöte:
[
{
"Measure":"Humidity",
"Aggregate":"Min",
"TimeRangeType":"Days",
"TimeRangeValue":7
},
{
"Measure":"Temperature",
"Aggregate":"Avg",
"TimeRangeType":"Days",
"TimeRangeValue":14
}
]
Yhdistetyt laitteiden lukemat ‑toiminto palauttaa mittaukset sarjoitetussa JSON-muodossa. Seuraavassa taulukossa on esitetty tulosparametrit.
| JSON-ominaisuus | Type | Details |
|---|---|---|
| measuresOutput | string | Palautettujen mittausten arvot JSON-muodossa; esimerkkejä on seuraavassa koodikatkelmassa |
Mallitulos:
[
{
"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"
}
]
Yhdistetyt laitteiden lukemat perustuvat laitehistoriaentiteettiin, jos et ole ottanut käyttöön Yhdistetyt laitteiden lukemat -toimintoa.
Laitelukemien kyseleminen
Laitelukemien kyseleminen -toiminto noutaa laitteen historiatiedot, kuten lämpötila- ja kosteustiedot, IoT-palvelusta ja näyttää ne aikasarjakaaviona.
Seuraavassa taulukossa on kuvattu Laitelukemien kyseleminen -toiminnon syöteparametrit.
| Parametri | Type | Details |
|---|---|---|
| From | datetime | Lukeman (mittauksen) aloitusaika ISO-muodossa; esimerkiksi, "2020-04-10T13:51:55.781Z" |
| Kohde | datetime | Lukeman (mittauksen) lopetusaika ISO-muodossa |
| IoTDeviceId | string | Laitteen GUID-tunnus (msdyn_iotdevice) Connected Field Servicessa, muunnettu merkkijonoksi |
| Aikaväli | string | Kuvaajapisteen arvovälin koko määritettynä ISO-8601-keston muodossa; esimerkiksi 1 minuutti on "PT1M", 1 millisekunti on "PT0.001S" Kaikki arvovälit ovat samansuuruisia. Yksi kuukausi muunnetaan aina 30 päiväksi, ja yksi vuosi on aina 365 päivää. |
Esimerkkisyöte:
{
"From":"2023-04-01T18:05:37.661Z",
"To":"2023-05-31T18:05:37.661Z",
"IotDeviceId":"50fce36f-9e3e-ed11-bba3-000d3a8b1de9",
"Interval":"P1D"
}
Laitelukemien kyseleminen ‑toiminto palauttaa tiedot sarjoitetussa JSON-muodossa. Seuraavassa taulukossa on esitetty tulosparametrit.
| JSON-ominaisuus | Type | Details |
|---|---|---|
| AggregatedDeviceReadings | String | Palautettujen mittausten arvot JSON-muodossa; esimerkkejä on seuraavassa koodikatkelmassa |
Mallitulos:
{
"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
}
}
}
}
Hae laitetapahtumat
Hae laitetapahtumat -toiminto noutaa tapahtumat laitteen palveluhistoriasta ja näyttää ne nastoina Laitelukemien kyseleminen -toiminnon luoman kaavion alareunassa. Voit lisätä mitä tahansa mukautettuja entiteettejä, kuten edellisen resurssipäivityksen.
Muistiinpano
Uutta toimintoa ei tarvitse luoda. Mukautettu laajennus rekisteröidään msdyn_IoTGetDeviceEvents-toiminnossa. Kyse voi olla esimerkiksi tapahtumien luontilaajennuksesta.
Seuraavassa taulukossa on kuvattu Hae laitetapahtumat -toiminnon syöteparametrit.
| JSON-ominaisuus | Type | Details |
|---|---|---|
| From | datetime | Lukeman (mittauksen) aloitusaika ISO-muodossa; esimerkiksi, "2020-04-10T13:51:55.781Z" |
| Kohde | datetime | Lukeman (mittauksen) lopetusaika ISO-muodossa |
| IoTDeviceId | string | Laitteen GUID-tunnus (msdyn_iotdevice) Connected Field Servicessa, muunnettu merkkijonoksi |
Esimerkkisyöte:
{
"IotDeviceId": "50fce36f-9e3e-ed11-bba3-000d3a8b1de9",
"From": "2023-06-12T18:57:54.864Z",
"To": "2023-06-12T19:57:54.864Z"
}
Hae laitetapahtumat ‑toiminto palauttaa tiedot sarjoitetussa JSON-muodossa. Seuraavassa taulukossa on esitetty tulosparametrit.
| JSON-ominaisuus | Type | Details |
|---|---|---|
| EventsName | string | Tapahtuman luokan lyhyt kuvaus; sen avulla voit näyttää tai piilottaa kaikki luokan tapahtumat |
| Aikaleima | string | Tapahtuman aikaleima, joka on muotoiltu merkkijonoksi ISO-muodossa; tapahtuman nastan x-akselin aikaleima |
| Color | string | Tapahtuman nastan väri heksakoodimerkkijonona |
| Description | string | Tapahtuman lyhyt kuvaus, joka tulee näkyviin, kun käyttäjä pitää osoitinta nastan päällä tai kun käyttäjä valitsee nastan tietojen näyttämistä varten |
| Tunnus | string | Tapahtuman tunnus; voi olla nimi tai toinen helppokäyttöinen arvo, kuten työtilausnumero tai varausvahvistuksen koodi |
| Entity | string | Tapahtumaan liittyvän Dataverse-entiteetin nimi, esimerkiksi "msdyn_workorder". |
| URL | string | Tapahtuman tietosivun URL-osoite, kuten linkki työtilauslomakkeeseen Jos entiteetti ja GUID välitetään, järjestelmä luo automaattisesti hyperlinkin. |
| GUID | string | Dataverse-entiteettitietueen GUID-tunnus, muunnettu merkkijonoksi |
Mallitulos:
{
"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"
}
}
}