Konfigurera IoT-leverantörens åtgärder
När du har konfigurerat en IoT-leverantör (Sakernas Internet) kan du ange en uppsättning åtgärder som ska utlösas baserat på insamlade data från organisationens IoT-enheter. Tillsammans med fem fördefinierade åtgärder kan du skapa anpassade åtgärder som är associerade med leverantören för att automatisera olika aspekter av verksamheten i Connected Field Service.
Connected Field Service kommer med följande åtgärder:
- Hämta enhetsdata
- Registrera enhet
- Aggregerade enhetsavläsningar
- Åtgärd för frågeenhetsavläsning
- Hämta enhetshändelser
Hämta enhetsdata
Med åtgärden Hämta enhetsdata hämtas de senaste data för en enhet eller en samling enheter från IoT-providern. Den visas på fliken Enhetsdatahistorik.
Eftersom data kan komma från flera enheter kräver åtgärden Hämta enhetsdata en EntityCollection som indata. Följande tabell beskriver parametrarna för EntityCollection.
| Parameter | Type | Details |
|---|---|---|
| msdyn_iotdeviceid | string | GUID-enhets-ID (msdyn_iotdevice) i Connected Field Service, konverterat till en sträng |
| msdyn_name | string | Namnet på enheten |
| @odata.type | string | Entitetens OData-typ |
Exempelinmatning:
{
"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"
}
]
}
Åtgärden Hämta enhetsdata returnerar hämtade data i serialiserat JSON-format. Följande tabell beskriver parametrarna för PullDeviceDataResultsJSON-utdata.
| JSON-egenskap | Type | Details |
|---|---|---|
| ID | string | GUID-enhets-ID (msdyn_iotdevice) i Connected Field Service, konverterat till en sträng |
| ConnectionState | boolean | Anger om enheten är frånkopplad (false) eller ansluten (true) |
| ConnectionStateUpdatedTime | datetime | Tidsstämpeln för den senaste uppdateringen av anslutningstillståndet från IoT-leverantören |
| DeviceReportedProperties | string | Enhetens rapporterade egenskaper, formaterade som en JSON-sträng |
| LastActivityTime | datetime | Tidsstämpeln för enhetens senast rapporterade aktivitet |
Exempel 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"
}
]
}
Registrera enhet
Med åtgärden Registrera enhet skapas en association mellan en enhet eller en samling enheter och IoT-providern. Nya enheter och enheter eller komponenter som en tekniker byter ut kan registreras. När du har registrerat en enhet visas den på fliken Registreringshistorik i posten IoT-enhet.
Eftersom flera enheter kan registreras samtidigt kräver åtgärden Registrera enhet en EntityCollection som indata. Följande tabell beskriver parametrarna för EntityCollection.
| Parameter | Type | Details |
|---|---|---|
| msdyn_iotdeviceid | string | GUID-enhets-ID (msdyn_iotdevice) i Connected Field Service, konverterat till en sträng |
| msdyn_name | string | Namnet på enheten |
| @odata.type | string | Entitetens OData-typ |
Exempelinmatning:
{
"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"
}
]
}
Åtgärden Registrera enhet returnerar registreringsresultaten i serialiserat JSON-format. Följande tabell beskriver parametrarna för RegistrationResultsJSON-utdata.
| JSON-egenskap | Type | Details |
|---|---|---|
| ID | string | GUID-enhets-ID (msdyn_iotdevice) i Connected Field Service, konverterat till en sträng |
| Registreringsstatus | OptionSetValue | Status för registreringen från IoT-leverantören tillbaka till Connected Field Service Värden och etiketter: - 192350000: Okänd - 192350001: Oregistrerad - 192350002: Pågår - 192350003: Registrerad - 192350004: Fel Obs! Ett OptionSet är en lista med alternativ med etikettvärdesmappning som en listrutekontroll. |
| DeviceId | string | ID för enheten i IoT-leverantörens system |
| Meddelande | string | Ett detaljerat meddelanden om Connected Field Service-användaren angående registrering |
Exempel 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"
}
]
}
Aggregerade enhetsavläsningar
Enhetens aggregerade avläsningsåtgärd hämtar aggregerade enhetsdata från IoT-leverantören. Aggregerade data ger en snabb ögonblicksbild av enhetens villkor på sammanfattningspaneler i Connected Field Service.
I följande tabell beskrivs indataparametrarna för åtgärden Aggregerade enhetsavläsningar.
| Parameter | Type | Details |
|---|---|---|
| deviceId | string | GUID-enhets-ID (msdyn_iotdevice) i Connected Field Service, konverterat till en sträng |
| mått | string | En lista med mått i JSON-format se följande kodavsnitt för exempel |
Exempelinmatning:
[
{
"Measure":"Humidity",
"Aggregate":"Min",
"TimeRangeType":"Days",
"TimeRangeValue":7
},
{
"Measure":"Temperature",
"Aggregate":"Avg",
"TimeRangeType":"Days",
"TimeRangeValue":14
}
]
Åtgärden Aggregerade enhetsavläsningar returnerar mått i serialiserat JSON-format. I följande tabell visas utdataparametrarna.
| JSON-egenskap | Type | Details |
|---|---|---|
| measuresOutput | string | Värden med returnerade mått i JSON-format se följande kodavsnitt för exempel |
Exempel 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"
}
]
Aggregerade enhetsavläsningar baseras på enhetens datahistorik om du inte använder åtgärden Aggregerade enhetsavläsningar.
Åtgärd för frågeenhetsavläsning
Frågeenhetens avläsningsåtgärd hämtar tidigare enhetsdata, t.ex. förklädning och förtjänst, från IoT-leverantören och visar dem som ett diagram över tidsserier.
I följande tabell beskrivs indataparametrarna för åtgärden för frågeenhetsavläsning.
| Parameter | Type | Details |
|---|---|---|
| From | datetime | Starttiden för avsläsningspunkten (mått) i diagrammet i ISO-format, t.ex. "2020-04-10T13:51:55.781Z" |
| To | datetime | Sluttiden för avläsningen (mätning) i ISO-format |
| IoTDeviceId | string | GUID-enhets-ID (msdyn_iotdevice) i Connected Field Service, konverterat till en sträng |
| Intervall | string | Intervallstorleken för diagrampunkten som anges i formatet ISO-8601 varaktighet; till exempel är 1 minut "PT1M", 1 millisekund är "PT0.001S" Alla intervall har samma storlek. En månad omvandlas alltid till 30 dagar och ett år är alltid 365 dagar. |
Exempelinmatning:
{
"From":"2023-04-01T18:05:37.661Z",
"To":"2023-05-31T18:05:37.661Z",
"IotDeviceId":"50fce36f-9e3e-ed11-bba3-000d3a8b1de9",
"Interval":"P1D"
}
Åtgärd för frågeenhetsavläsning returnerar data i serialiserat JSON-format. I följande tabell visas utdataparametrarna.
| JSON-egenskap | Type | Details |
|---|---|---|
| AggregatedDeviceReadings | String | Värden med returnerade mått i JSON-format se följande kodavsnitt för exempel |
Exempel 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
}
}
}
}
Hämta enhetshändelser
Åtgärden Hämta enhetshändelser hämtar händelser från enheten tjänstehistorik och visar dem som kartnålar längst ned i diagrammet som skapas av åtgärden Fråga enhetsavläsningar. Du kan lägga till egna entiteter, t.ex. förra gången du utförde en uppgradering av tillgångar.
Kommentar
Du behöver inte skapa en ny åtgärd. Registrera ett anpassat plugin-program på åtgärden msdyn_IoTGetDeviceEvents-åtgärden för att skapa händelser.
I följande tabell beskrivs indataparametrarna för åtgärden Hämta enhetshändelser.
| JSON-egenskap | Type | Details |
|---|---|---|
| From | datetime | Starttiden för avsläsningspunkten (mått) i diagrammet i ISO-format, t.ex. "2020-04-10T13:51:55.781Z" |
| To | datetime | Sluttiden för avläsningen (mätning) i ISO-format |
| IoTDeviceId | string | GUID-enhets-ID (msdyn_iotdevice) i Connected Field Service, konverterat till en sträng |
Exempelinmatning:
{
"IotDeviceId": "50fce36f-9e3e-ed11-bba3-000d3a8b1de9",
"From": "2023-06-12T18:57:54.864Z",
"To": "2023-06-12T19:57:54.864Z"
}
Åtgärd för hämta enhetshändelser returnerar data i serialiserat JSON-format. I följande tabell visas utdataparametrarna.
| JSON-egenskap | Type | Details |
|---|---|---|
| EventsName | string | Kort beskrivning av händelsekategorin med hjälp av den kan du visa eller dölja alla händelser i den kategorin |
| Tidsstämpel | string | Tidsstämpeln för händelsen som är formaterad som en sträng i ISO-format. x-axelns tidsstämpel för händelsens kartnål |
| Color | string | Färgen på händelsens kartnål, tillhandahålls som en hex-kodsträng |
| Description | string | En kort beskrivning av händelsen, som visas när användaren håller muspekaren över kartnålen eller väljer kartnålen för att se detaljer |
| ID | string | ID för händelsen kan vara ett namn eller ett annat användarvänligt värde, som arbetsordernumret eller bokningsbekräftelsekoden |
| Enhet | string | Entitetsnamnet Dataverse som är relaterat till händelsen, till exempel "msdyn_workorder" |
| webbadress | string | URL-adressen till informationssidan för händelsen, t.ex. en länk till arbetsorderformuläret Om du skickar en entitet och ett GUID skapas en hyperlänk automatiskt i systemet. |
| GUID | string | GUID, konverterat till en sträng, för entitetsposten i Dataverse |
Exempel 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"
}
}
}