Konfigurowanie działań dostawcy IoT
Po skonfigurowaniu dostawcy IoT (Internet rzeczy) można określić zestaw akcji, które mają być wyzwalane na podstawie przechwyconych danych z urządzeń IoT organizacji. Wraz z pięcioma predefiniowanymi akcjami można utworzyć akcje niestandardowe, które są powiązane z dostawcą w celu zautomatyzowania różnych aspektów operacji Connected Field Service.
Następujące działania są dostarczane z Connected Field Service:
- Ściągnij dane urządzenia
- Zarejestruj urządzenie
- Zagregowane odczyty urządzeń
- Sprawdzanie odczytów urządzenia
- Pobieranie zdarzeń urządzenia
Ściągnij dane urządzenia
The Akcja Pobieranie danych urządzenia pobiera najnowsze dane dla jednego urządzenia lub zbioru urządzeń od dostawcy IoT. Pojawia się ona w zakładce Historia danych urządzenia.
Ponieważ dane mogą pochodzić z wielu urządzeń, akcja Pobieranie danych urządzenia wymaga EntityCollection jako danych wejściowych. Poniższa tabela opisuje parametry EntityCollection.
| Parametr | Type | Details |
|---|---|---|
| msdyn_iotdeviceid | string | Identyfikator GUID urządzenia (msdyn_iotdevice) w Connected Field Service, przekonwertowany na ciąg znaków |
| msdyn_name | string | Nazwa urządzenia |
| @odata.type | string | Typ OData encji |
Przykładowe dane wejściowe:
{
"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"
}
]
}
Akcja Pobieranie danych urządzenia zwraca pobrane dane w serializowanym formacie JSON. Poniższa tabela opisuje parametry danych wyjściowych PullDeviceDataResultsJSON.
| Właściwość JSON | Type | Details |
|---|---|---|
| ID | string | Identyfikator GUID urządzenia (msdyn_iotdevice) w Connected Field Service, przekonwertowany na ciąg znaków |
| ConnectionState | boolean | Czy urządzenie jest odłączone (fałsz) czy podłączone (prawda) |
| ConnectionStateUpdatedTime | datetime | Znacznik czasu ostatniej aktualizacji stanu połączenia od dostawcy IoT |
| DeviceReportedProperties | string | Zgłoszone właściwości urządzenia, sformatowane jako ciąg JSON |
| LastActivityTime | datetime | Znacznik czasu ostatniej zgłoszonej aktywności urządzenia |
Przykładowe dane wyjściowe:
{
"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"
}
]
}
Zarejestruj urządzenie
Akcja Zarejestruj urządzenie tworzy powiązanie między urządzeniem lub zbiorem urządzeń a dostawcą IoT. Rejestrować można nowe urządzenia oraz urządzenia lub składniki wymieniane przez technika. Po zarejestrowaniu urządzenia pojawia się ono na karcie Historia rejestracji w rekordzie urządzenia IoT.
Ponieważ jednocześnie można zarejestrować wiele urządzeń, akcja Register device wymaga EntityCollection jako danych wejściowych. Poniższa tabela opisuje parametry EntityCollection.
| Parametr | Type | Details |
|---|---|---|
| msdyn_iotdeviceid | string | Identyfikator GUID urządzenia (msdyn_iotdevice) w Connected Field Service, przekonwertowany na ciąg znaków |
| msdyn_name | string | Nazwa urządzenia |
| @odata.type | string | Typ OData encji |
Przykładowe dane wejściowe:
{
"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"
}
]
}
Akcja Register device zwraca wyniki rejestracji w serializowanym formacie JSON. Poniższa tabela opisuje parametry danych wyjściowych RegistrationResultsJSON.
| Właściwość JSON | Type | Details |
|---|---|---|
| ID | string | Identyfikator GUID urządzenia (msdyn_iotdevice) w Connected Field Service, przekonwertowany na ciąg znaków |
| RegistrationStatus | OptionSetValue | Stan rejestracji ze strony dostawcy IoT z powrotem do usługi Connected Field Service Wartości i etykiety: - 192350000: Nieznane - 192350001: Niezarejestrowany - 192350002: W toku - 192350003: Zarejestrowany - 192350004: Błąd Uwaga: OptionSet to lista opcji z mapowaniem etykieta-wartość, podobnie jak kontrolka listy rozwijanej. |
| DeviceId | string | Identyfikator urządzenia w systemie dostawcy IoT |
| Wiadomość | string | Szczegółowy komunikat dla użytkownika Connected Field Service dotyczący rejestracji |
Przykładowe dane wyjściowe:
{
"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"
}
]
}
Zagregowane odczyty urządzeń
Akcja Zagregowane odczyty urządzeń pobiera zagregowane dane urządzenia od dostawcy IoT. Te zbiorcze zapewniają szybki podgląd stanu urządzenia na kafelkach podsumowujących w Connected Field Service.
W poniższej tabeli opisano parametry wejściowe akcji Zagregowane odczyty urządzeń.
| Parametr | Type | Details |
|---|---|---|
| deviceId | string | Identyfikator GUID urządzenia (msdyn_iotdevice) w Connected Field Service, przekonwertowany na ciąg znaków |
| miary | string | Lista pomiarów w formacie JSON; zobacz poniższy fragment kodu dla przykładów |
Przykładowe dane wejściowe:
[
{
"Measure":"Humidity",
"Aggregate":"Min",
"TimeRangeType":"Days",
"TimeRangeValue":7
},
{
"Measure":"Temperature",
"Aggregate":"Avg",
"TimeRangeType":"Days",
"TimeRangeValue":14
}
]
Akcja Zagregowane odczyty urządzeń zwraca pomiary w serializowanym formacie JSON. Poniższa tabela przedstawia parametry wyjściowe.
| Właściwość JSON | Type | Details |
|---|---|---|
| measuresOutput | string | Wartości zwróconych pomiarów w formacie JSON; przykłady można znaleźć w poniższym fragmencie kodu |
Przykładowe dane wyjściowe:
[
{
"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"
}
]
Zagregowane odczyty urządzeń są oparte na encji historii danych urządzenia, jeśli nie jest używana akcja Zagregowane odczyty urządzeń.
Sprawdzanie odczytów urządzenia
Akcja Sprawdzanie odczytów urządzenia pobiera historyczne dane urządzenia, takie jak temperatura i wilgotność, od dostawcy IoT i wyświetla je jako wykres szeregu czasowego.
W poniższej tabeli opisano parametry wejściowe akcji Sprawdzanie odczytów urządzenia.
| Parametr | Type | Details |
|---|---|---|
| From | datetime | Czas rozpoczęcia odczytu (pomiaru) w formacie ISO; na przykład "2020-04-10T13:51:55.781Z" |
| To | datetime | Końcowa godzina odczytu (miara) w formacie ISO |
| IoTDeviceId | string | Identyfikator GUID urządzenia (msdyn_iotdevice) w Connected Field Service, przekonwertowany na ciąg znaków |
| Interwał | string | Rozmiar interwału punktu kreślenia określony w formacie czasu trwania ISO-8601; na przykład 1 minuta to "PT1M", 1 milisekunda to "PT0.001S" Wszystkie interwały mają ten sam rozmiar. Jeden miesiąc jest zawsze konwertowany na 30 dni, rok ma zawsze 365 dni. |
Przykładowe dane wejściowe:
{
"From":"2023-04-01T18:05:37.661Z",
"To":"2023-05-31T18:05:37.661Z",
"IotDeviceId":"50fce36f-9e3e-ed11-bba3-000d3a8b1de9",
"Interval":"P1D"
}
Akcja Sprawdzanie odczytów urządzenia zwraca dane w serializowanym formacie JSON. Poniższa tabela przedstawia parametry wyjściowe.
| Właściwość JSON | Type | Details |
|---|---|---|
| AggregatedDeviceReadings | String | Wartości zwróconych pomiarów w formacie JSON; przykłady można znaleźć w poniższym fragmencie kodu |
Przykładowe dane wyjściowe:
{
"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
}
}
}
}
Pobieranie zdarzeń urządzenia
Akcja Pobieranie zdarzeń urządzenia pobiera zdarzenia z urządzenia historię usług i wyświetla je w postaci pinezek na dole wykresu utworzonego przez akcję Sprawdzanie odczytów urządzenia. Można uwzględnić dowolne encje niestandardowe, takie jak czas ostatniego uaktualnienia zasobu.
Uwaga
Nie musisz tworzyć nowej akcji. Zarejestruj niestandardową wtyczkę w akcji msdyn_IoTGetDeviceEvents, podobnie jak wtyczki do tworzenia zdarzeń.
W poniższej tabeli opisano parametry wejściowe akcji Pobieranie zdarzeń urządzenia.
| Właściwość JSON | Type | Details |
|---|---|---|
| From | datetime | Czas rozpoczęcia odczytu (pomiaru) w formacie ISO; na przykład "2020-04-10T13:51:55.781Z" |
| To | datetime | Końcowa godzina odczytu (miara) w formacie ISO |
| IoTDeviceId | string | Identyfikator GUID urządzenia (msdyn_iotdevice) w Connected Field Service, przekonwertowany na ciąg znaków |
Przykładowe dane wejściowe:
{
"IotDeviceId": "50fce36f-9e3e-ed11-bba3-000d3a8b1de9",
"From": "2023-06-12T18:57:54.864Z",
"To": "2023-06-12T19:57:54.864Z"
}
Akcja Pobieranie zdarzeń urządzenia zwraca dane w serializowanym formacie JSON. Poniższa tabela przedstawia parametry wyjściowe.
| Właściwość JSON | Type | Details |
|---|---|---|
| EventsName | string | Krótki opis kategorii wydarzenia; użyj go, aby wyświetlić lub ukryć wszystkie wydarzenia w tej kategorii |
| Sygnatura czasowa | string | Znacznik czasu zdarzenia sformatowany jako ciąg znaków w formacie ISO; znacznik czasu na osi x dla sworznia zdarzenia |
| Color | string | Kolor pinezki zdarzenia, dostarczany jako ciąg znaków w kodzie szesnastkowym |
| Description | string | Krótki opis wydarzenia, wyświetlany po najechaniu kursorem na pinezkę lub wybraniu pinezki w celu wyświetlenia szczegółów |
| ID | string | Identyfikator zdarzenia; może to być nazwa lub inna przyjazna dla użytkownika wartość, taka jak numer zlecenia lub kod potwierdzenia rezerwacji |
| Jednostka | string | Nazwa encji Dataverse związanej ze zdarzeniem; na przykład "msdyn_workorder" |
| URL | string | Adres URL strony ze szczegółami wydarzenia, np. link do formularza zlecenia pracy Po przekazaniu obiektu i identyfikatora GUID system automatycznie generuje hiperlink. |
| Identyfikator GUID | string | Identyfikator GUID, przekonwertowany na ciąg znaków, rekordu encji w Dataverse |
Przykładowe dane wyjściowe:
{
"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"
}
}
}