Konfigurer handlinger for IoT-leverandør
Etter at du har konfigurert en IoT-leverandør (Tingenes Internett), kan du angi et sett med handlinger som skal utløses basert på registrerte data fra organisasjonens IoT-enheter. Du har fem forhåndsdefinerte handlinger og kan lage egendefinerte handlinger som er knyttet til leverandøren, for å automatisere ulike aspekter ved Connected Field Service-operasjonene.
Følgende handlinger kommer med Connected Field Service:
- Hent enhetsdata
- Registrer enhet
- Aggregerte enhetsavlesninger
- Spør etter enhetsavlesninger
- Hent enhetshendelser
Hent enhetsdata
Handlingen Hent enhetsdata henter de nyeste dataene for én enhet eller en samling enheter fra IoT-leverandøren. Den vises i fanen Historikk for enhet.
Siden data kan komme fra flere enheter, må handlingen Hent enhetsdata ha en EntityCollection som inndata. Tabellen nedenfor beskriver parameterne for EntityCollection.
| Parameter | Type | Details |
|---|---|---|
| msdyn_iotdeviceid | string | Enhets-ID-en for GUID (msdyn_iotdevice) i Connected Field Service, konvertert til en streng |
| msdyn_name | string | Navnet på enheten |
| @odata.type | string | OData-type for enheten |
Eksempelinndata:
{
"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"
}
]
}
Handlingen Hent enhetsdata returnerer de hentede dataene i serialisert JSON-format. Tabellen nedenfor beskriver parameterne for utdataene fra PullDeviceDataResultsJSON.
| JSON-egenskap | Type | Details |
|---|---|---|
| ID | string | Enhets-ID-en for GUID (msdyn_iotdevice) i Connected Field Service, konvertert til en streng |
| ConnectionState | boolean | Hvorvidt enheten er frakoblet (false) eller tilkoblet (true) |
| ConnectionStateUpdatedTime | datetime | Tidsstempelet for siste oppdatering av tilkoblingstilstand fra IoT-leverandøren |
| DeviceReportedProperties | string | Enhetens rapporterte egenskaper, formatert som en JSON-streng |
| LastActivityTime | datetime | Tidsstempelet for enhetens siste rapporterte aktivitet |
Eksempel på utdata:
{
"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"
}
]
}
Registrer enhet
Handlingen Registrer enhet oppretter en tilknytning mellom en enhet eller en samling enheter og IoT-leverandøren. Nye enheter og enheter eller komponenter som en tekniker bytter ut, kan registreres. Etter at du har registrert en enhet, vises den i fanen Registreringslogg for oppføringen for IoT-enhet.
Siden flere enheter kan registreres samtidig, må handlingen Registrer enhet ha en EntityCollection som inndata. Tabellen nedenfor beskriver parameterne for EntityCollection.
| Parameter | Type | Details |
|---|---|---|
| msdyn_iotdeviceid | string | Enhets-ID-en for GUID (msdyn_iotdevice) i Connected Field Service, konvertert til en streng |
| msdyn_name | string | Navnet på enheten |
| @odata.type | string | OData-type for enheten |
Eksempelinndata:
{
"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"
}
]
}
Handlingen Registrer enhet returnerer registreringsresultatene i serialisert JSON-format. Tabellen nedenfor beskriver parameterne for utdataene fra RegistrationResultsJSON.
| JSON-egenskap | Type | Details |
|---|---|---|
| ID | string | Enhets-ID-en for GUID (msdyn_iotdevice) i Connected Field Service, konvertert til en streng |
| RegistrationStatus | OptionSetValue | Statusen for registreringen fra IoT-leverandøren tilbake til Connected Field Service Verdier og etiketter: - 192350000: Ukjent - 192350001: Avregistrert - 192350002 : Pågår - 192350003: Registrert - 192350004: Feil Merk: Et OptionSet er en liste over alternativer med etikettverditilordning, for eksempel en rullegardinlistekontroll. |
| DeviceId | string | ID-en for enheten i systemet for IoT-leverandør |
| Melding | string | En detaljert melding til Connected Field Service-brukeren om registreringen |
Eksempel på utdata:
{
"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"
}
]
}
Aggregerte enhetsavlesninger
Handlingen Aggregerte enhetsavlesninger henter aggregerte enhetsdata fra IoT-leverandøren. Aggregerte data gir et øyeblikksbilde av tilstanden til enheten på sammendragsfliser i Connected Field Service.
Tabellen nedenfor beskriver inndataparameterne for handlingen Aggregerte enhetsavlesninger.
| Parameter | Type | Details |
|---|---|---|
| deviceId | string | Enhets-ID-en for GUID (msdyn_iotdevice) i Connected Field Service, konvertert til en streng |
| mål | string | En liste over mål i JSON-format; følgende kodesnutt viser eksempler |
Eksempelinndata:
[
{
"Measure":"Humidity",
"Aggregate":"Min",
"TimeRangeType":"Days",
"TimeRangeValue":7
},
{
"Measure":"Temperature",
"Aggregate":"Avg",
"TimeRangeType":"Days",
"TimeRangeValue":14
}
]
Handlingen Aggregerte enhetsavlesninger returnerer målene i serialisert JSON-format. Tabellen nedenfor viser utdataparameterne.
| JSON-egenskap | Type | Details |
|---|---|---|
| measuresOutput | string | Verdiene til de returnerte målene i JSON-format; følgende kodesnutt viser eksempler |
Eksempel på utdata:
[
{
"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"
}
]
Aggregerte enhetsavlesninger er basert på enheten for enhetsdatalogg hvis du ikke bruker handlingen Aggregerte enhetsavlesninger.
Spør etter enhetsavlesninger
Handlingen Spør etter enhetsavlesninger henter historiske enhetsdata, for eksempel temperatur og fuktighet, fra IoT-leverandøren og viser dem som et tidsseriediagram.
Tabellen nedenfor beskriver inndataparameterne for handlingen Spør etter enhetsavlesninger.
| Parameter | Type | Details |
|---|---|---|
| From | datetime | Starttidspunktet for avlesningen (målepunkt) i ISO-format, for eksempel «2020-04-10T13:51:55.781Z» |
| For å | datetime | Sluttidspunktet for avlesningen (målepunkt) i ISO-format |
| IoTDeviceId | string | Enhets-ID-en for GUID (msdyn_iotdevice) i Connected Field Service, konvertert til en streng |
| Intervall | string | Intervallstørrelsen for tegnepunktet angitt i varighetsformatet ISO-8601; 1 minutt er for eksempel «PT1M», 1 millisekund er «PT0.001S» Alle intervaller har samme størrelse. Én måned blir alltid konvertert til 30 dager, og ett år er alltid 365 dager. |
Eksempelinndata:
{
"From":"2023-04-01T18:05:37.661Z",
"To":"2023-05-31T18:05:37.661Z",
"IotDeviceId":"50fce36f-9e3e-ed11-bba3-000d3a8b1de9",
"Interval":"P1D"
}
Handlingen Spør etter enhetsavlesninger returnerer dataene i serialisert JSON-format. Tabellen nedenfor viser utdataparameterne.
| JSON-egenskap | Type | Details |
|---|---|---|
| AggregatedDeviceReadings | String | Verdiene til de returnerte målene i JSON-format; følgende kodesnutt viser eksempler |
Eksempel på utdata:
{
"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
}
}
}
}
Hent enhetshendelser
Handlingen Hent enhetshendelser henter hendelser fra tjenesteloggen for enheten og viser dem som stifter nederst i diagrammet som opprettes av handlingen Spør etter enhetsavlesninger. Du kan inkludere egendefinerte enheter, for eksempel siste gang du utførte en ressursoppgradering.
Merk
Du trenger ikke opprette en ny-handling. Registrer et egendefinert programtillegg for handlingen msdyn_IoTGetDeviceEvents, for eksempel programtillegg for å opprette hendelser.
Tabellen nedenfor beskriver inndataparameterne for handlingen Hent enhetsavlesninger.
| JSON-egenskap | Type | Details |
|---|---|---|
| From | datetime | Starttidspunktet for avlesningen (målepunkt) i ISO-format, for eksempel «2020-04-10T13:51:55.781Z» |
| For å | datetime | Sluttidspunktet for avlesningen (målepunkt) i ISO-format |
| IoTDeviceId | string | Enhets-ID-en for GUID (msdyn_iotdevice) i Connected Field Service, konvertert til en streng |
Eksempelinndata:
{
"IotDeviceId": "50fce36f-9e3e-ed11-bba3-000d3a8b1de9",
"From": "2023-06-12T18:57:54.864Z",
"To": "2023-06-12T19:57:54.864Z"
}
Handlingen Hent enhetshendelser returnerer dataene i serialisert JSON-format. Tabellen nedenfor viser utdataparameterne.
| JSON-egenskap | Type | Details |
|---|---|---|
| EventsName | string | Kort beskrivelse av kategorien for hendelsen; bruk den til å vise eller skjule alle hendelser i kategorien |
| Tidsstempel | string | Tidsstempelet for hendelsen formatert som en streng i ISO-format, tidsstempelet for x-aksen for hendelsesstiften |
| Color | string | Fargen på hendelsesstiften, gitt som en heksadesimal kodestreng |
| Bekrivelse | string | En kort beskrivelse av hendelsen, som vises når brukeren holder musepekeren over stiften eller velger stiften for å vise detaljer |
| ID | string | ID-en for hendelsen, som kan være et navn eller en annen brukervennlig verdi, for eksempel arbeidsordrenummeret eller bestillingsbekreftelseskoden |
| Entity | string | Navnet på Dataverse-enheten som er relatert til hendelsen, for eksempel «msdyn_workorder» |
| URL | string | Nettadressen til detaljsiden for hendelsen, for eksempel en kobling til arbeidsordreskjemaet Hvis du sender en enhet og GUID, genererer systemet automatisk en hyperkobling. |
| GUID | string | GUID-en, konvertert til en streng, for enhetsoppføringen i Dataverse |
Eksempel på utdata:
{
"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"
}
}
}