Konfigurere IoT-providerhandlinger

Artikel
10/02/2024

Når du har konfigureret en IoT-udbyder (Internet of Things), kan du angive et sæt handlinger, der skal udløses, baseret på de hentede data fra organisationens IoT-enheder. Du kan oprette brugerdefinerede handlinger, der er knyttet til din udbyder, sammen med fem foruddefinerede handlinger, for at automatisere forskellige aspekter af handlingerne i Connected Field Service.

Connected Field Service indeholder følgende handlinger:

Hent enhedsdata
Registrer enhed
Aggregerede enhedslæsninger
Forespørgsel på enhedsaflæsninger
Hent enhedshændelser

Hent enhedsdata

Handlingen Hent enhedsdata henter de nyeste data til én enhed eller en samling enheder fra IoT-provideren. Den vises under fanen Oversigt over enhedsdata.

Da data kan komme fra flere enheder, kræver handlingen Hent enhedsdata en EntityCollection som input. I tabellen nedenfor finder du en beskrivelse af parametrene til EntityCollection.

Parameter	Type	Oplysninger
msdyn_iotdeviceid	string	GUID-enhedens id (msdyn_iotdevice) i Connected Field Service, konverteret til en streng
msdyn_name	string	Navn på enhed
@odata.type	string	Objektets OData-type

Prøveinput:

{
  "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 enhedsdata returnerer de hentede data i serialiseret JSON-format. I tabellen nedenfor finder du en beskrivelse af parametrene for PullDeviceDataResultsJSON-outputtet.

JSON-egenskab	Type	Oplysninger
Id	string	GUID-enhedens id (msdyn_iotdevice) i Connected Field Service, konverteret til en streng
ConnectionState	boolean	Om enheden er afbrudt (falsk) eller forbundet (sand)
ConnectionStateUpdatedTime	datetime	Tidsstempel for IoT-providerens seneste opdatering af forbindelsestilstanden
DeviceReportedProperties	string	Enhedens rapporterede egenskaber, formateret som en JSON-streng
LastActivityTime	datetime	Tidsstempel for sidste rapporterede aktivitet på enheden

Eksempelresultat:

{
  "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 enhed

Handlingen Registrer enhed opretter en tilknytning mellem en enhed eller en samling enheder og IoT-provideren. Der kan registreres nye enheder og enheder eller komponenter, som en tekniker udskifter. Når du har registreret en enhed, vises den under fanen Registreringshistorik i IoT-enhedsposten.

Da der kan registreres flere enheder på én gang, kræver handlingen Registrer enhed en EntityCollection som input. I tabellen nedenfor finder du en beskrivelse af parametrene til EntityCollection.

Parameter	Type	Oplysninger
msdyn_iotdeviceid	string	GUID-enhedens id (msdyn_iotdevice) i Connected Field Service, konverteret til en streng
msdyn_name	string	Navn på enhed
@odata.type	string	Objektets OData-type

Prøveinput:

{
  "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 enhed returnerer registreringsresultaterne i serialiseret JSON-format. I tabellen nedenfor finder du en beskrivelse af parametrene for RegistrationResultsJSON-outputtet.

JSON-egenskab	Type	Oplysninger
Id	string	GUID-enhedens id (msdyn_iotdevice) i Connected Field Service, konverteret til en streng
RegistrationStatus	OptionSetValue	Status for registreringen fra IoT-provideren tilbage til Connected Field Service Værdier og etiketter: - 192350000: Ukendt - 192350001: Ikke-registreret - 192350002 : Igangværende - 192350003: Registreret - 192350004: Fejl Bemærk: OptionSet er en liste over indstillinger med tilknytning af etiketværdier som f.eks. et kontrolelement for en rulleliste.
DeviceId	string	Id for enheden i IoT-providersystemet
Meddelelse	string	En detaljerede meddelelse om registreringen til Connected Field Service-brugeren

Eksempelresultat:

{
   "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"   
      }   
  ]
}

Aggregerede enhedslæsninger

Handlingen Aggregerede enhedsaflæsninger henter aggregerede enhedsdata fra IoT-provideren. Aggregerede data giver et hurtigt øjebliksbillede af enhedens tilstand i på oversigtsfelter i Connected Field Service.

Skærmbillede af en IoT-enhed i Field Service, som viser akkumulerede aflæsninger.

I tabellen nedenfor beskrives inputparametrene for handlingen Aggregerede enhedsaflæsninger.

Parameter	Type	Oplysninger
deviceId	string	GUID-enhedens id (msdyn_iotdevice) i Connected Field Service, konverteret til en streng
measures	string	En liste over målinger i JSON-format. Se følgende eksempel på kodestykke

Prøveinput:

[
    {
        "Measure":"Humidity",
        "Aggregate":"Min",
        "TimeRangeType":"Days",
        "TimeRangeValue":7
    },
    {
        "Measure":"Temperature",
        "Aggregate":"Avg",
        "TimeRangeType":"Days",
        "TimeRangeValue":14
    }
]

Handlingen Aggregerede enhedslæsninger returnerer målingerne i serialiseret JSON-format. I tabellen nedenfor vises outputparametrene.

JSON-egenskab	Type	Oplysninger
measuresOutput	string	Værdierne af de returnerede målinger i JSON-format. Se følgende eksempel på kodestykke

Eksempelresultat:

[
    {
        "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"
    }
]

Aggregerede enhedslæsninger er baseret på enhedsdataoversigtens objekt, hvis du ikke bruger handlingen Aggregerede enhedslæsninger.

Forespørgsel på enhedsaflæsninger

Handlingen Forespørgsel på enhedslæsninger henter historiske enhedsdata, f.eks. temperatur og fugtighed, fra udbyderen af IoT og viser dem som et tidsseriediagram.

Skærmbillede af enhedens temperatur og fugtighed over tid.

I tabellen nedenfor beskrives inputparametrene for handlingen Forespørgsel på enhedslæsninger.

Parameter	Type	Oplysninger
From	datetime	Starttidspunkt for aflæsningen (målingen) i ISO-format, f.eks. "2020-04-10T13:51:55.781Z"
To	datetime	Sluttidspunkt for aflæsningen (målingen) i ISO-format
IoTDeviceId	string	GUID-enhedens id (msdyn_iotdevice) i Connected Field Service, konverteret til en streng
Interval	string	Intervalstørrelsen på det afbildningspunkt, der er angivet i ISO-8601 varighedsformat, 1 minut er f.eks. "PT1M", 1 millisekund er "PT0.001S" Alle intervaller har samme størrelse. En måned konverteres altid til 30 dage, og et år er altid 365 dage.

Prøveinput:

{
    "From":"2023-04-01T18:05:37.661Z", 

    "To":"2023-05-31T18:05:37.661Z", 

    "IotDeviceId":"50fce36f-9e3e-ed11-bba3-000d3a8b1de9", 

    "Interval":"P1D"
}

Handlingen Forespørgsel på enhedslæsninger returnerer dataene i serialiseret JSON-format. I tabellen nedenfor vises outputparametrene.

JSON-egenskab	Type	Oplysninger
AggregatedDeviceReadings	String	Værdierne af de returnerede målinger i JSON-format. Se følgende eksempel på kodestykke

Eksempelresultat:

{
  "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 enhedshændelser

Handlingen Hent enhedshændelser henter hændelser fra enhedens servicehistorik og viser dem som knappenåle nederst i det diagram, der er oprettet af handlingen Forespørgsel på enhedslæsninger. Du kan inkludere brugerdefinerede objekter, f.eks. sidste gang du udførte en aktivopgradering.

Skærmbillede af hændelser, der vises som knappenåle under enhedens temperatur og fugtighed i tidsdiagrammet.

Bemærk

Du behøver ikke oprette en ny handling. Registrer en brugerdefineret plug-in på handlingen msdyn_IoTGetDeviceEvents, f.eks. plug-ins for oprettelse af hændelser.

I tabellen nedenfor beskrives inputparametrene for handlingen Hent enhedshændelser.

JSON-egenskab	Type	Oplysninger
From	datetime	Starttidspunkt for aflæsningen (målingen) i ISO-format, f.eks. "2020-04-10T13:51:55.781Z"
To	datetime	Sluttidspunkt for aflæsningen (målingen) i ISO-format
IoTDeviceId	string	GUID-enhedens id (msdyn_iotdevice) i Connected Field Service, konverteret til en streng

Prøveinput:

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

Handlingen Hent enhedshændelser returnerer dataene i serialiseret JSON-format. I tabellen nedenfor vises outputparametrene.

JSON-egenskab	Type	Oplysninger
EventsName	string	Kort beskrivelse af hændelsens kategori, som du kan bruge til at vise eller skjule alle hændelser i den pågældende kategori
Timestamp	string	Tidsstempel for hændelsen formateret som en streng i ISO-format. tidsstempel på x-aksen for hændelsesnålen
Color	string	Farven på hændelsesnålen, angivet som en hexadecimal kodestreng
Description	string	En kort beskrivelse af hændelsen, der vises, når brugeren holder markøren over nålen eller vælger den for at se detaljer
Id	string	Id'et for hændelsen, som kan være et navn eller en anden brugervenlig værdi, f.eks. arbejdsordrenummer eller reservationsbekræftelseskode
Entity	string	Det Dataverse objektnavn, der er relateret til hændelsen, f.eks. "msdyn_workorder"
URL	string	URL-adressen til siden med detaljer om hændelsen, f.eks. et link til formularen Arbejdsordre Hvis du sender et objekt og et GUID, oprettes der automatisk et link i systemet.
GUID	string	GUID'et, konverteret til en streng, for objektposten i Dataverse

Eksempelresultat:

{
  "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"
    }
  }
}

Del via

Konfigurere IoT-providerhandlinger

Hent enhedsdata

Registrer enhed

Aggregerede enhedslæsninger

Forespørgsel på enhedsaflæsninger

Hent enhedshændelser

Næste trin

Feedback

Yderligere ressourcer