IoT-provideracties instellen

Artikel
09/04/2024

Nadat u een IoT (Internet of Things)-provider hebt ingesteld, kunt u een reeks acties opgeven die moeten worden geactiveerd op basis van de vastgelegde gegevens van de IoT-apparaten van uw organisatie. Naast vijf vooraf gedefinieerde acties kunt u aangepaste acties maken die aan uw provider zijn gekoppeld om verschillende aspecten van uw Connected Field Service-activiteiten te automatiseren.

Connected Field Service biedt de volgende acties:

Apparaatgegevens ophalen
Apparaat registreren
Gecombineerde apparaatwaarden
Query uitvoeren op apparaatwaarden
Apparaatgebeurtenissen ophalen

Apparaatgegevens ophalen

Met de actie Apparaatgegevens ophalen haalt u de nieuwste gegevens voor één apparaat of een verzameling apparaten op bij de IoT-provider. Deze wordt weergegeven op het tabblad Geschiedenis van apparaatgegevens.

Omdat gegevens afkomstig kunnen zijn van meerdere apparaten, vereist de actie Apparaatgegevens ophalen EntityCollection als invoer. In de volgende tabel worden de parameters van EntityCollection beschreven.

Parameter	Type	DETAILS
msdyn_iotdeviceid	string	De id van het GUID-apparaat (msdyn_iotdevice) in Connected Field Service, omgezet in een tekenreeks
msdyn_name	string	De naam van het apparaat
@odata.type	string	Het OData-type van de entiteit

Voorbeeldinvoer:

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

De actie Apparaatgegevens ophalen retourneert de opgehaalde gegevens in geserialiseerde JSON-indeling. In de volgende tabel worden de parameters van de PullDeviceDataResultsJSON-uitvoer beschreven.

JSON-eigenschap	Type	DETAILS
Id	string	De id van het GUID-apparaat (msdyn_iotdevice) in Connected Field Service, omgezet in een tekenreeks
ConnectionState	boolean	Of het apparaat niet verbonden (false) of verbonden (true) is
ConnectionStateUpdatedTime	datetime	De timestamp van de laatste verbindingsstatusupdate van de IoT-provider
DeviceReportedProperties	string	De gerapporteerde eigenschappen van het apparaat, die zijn ingedeeld als een JSON-tekenreeks
LastActivityTime	datetime	De timestamp van de laatste gemelde activiteit van het apparaat

Voorbeelduitvoer:

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

Apparaat registreren

Met de actie Apparaat registreren wordt een koppeling tot stand gebracht tussen een apparaat of een verzameling apparaten en de IoT-provider. Nieuwe apparaten en apparaten of onderdelen die een technicus vervangt, kunnen worden geregistreerd. Nadat u een apparaat hebt geregistreerd, verschijnt het op het tabblad Registratiegeschiedenis van de IoT-apparaatrecord.

Omdat er meerdere apparaten tegelijk kunnen worden geregistreerd, vereist de actie Apparaat registreren een EntityCollection als invoer. In de volgende tabel worden de parameters van EntityCollection beschreven.

Parameter	Type	DETAILS
msdyn_iotdeviceid	string	De id van het GUID-apparaat (msdyn_iotdevice) in Connected Field Service, omgezet in een tekenreeks
msdyn_name	string	De naam van het apparaat
@odata.type	string	Het OData-type van de entiteit

Voorbeeldinvoer:

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

De actie Apparaat registreren retourneert de registratieresultaten in geserialiseerde JSON-indeling. In de volgende tabel worden de parameters van de RegistrationResultsJSON-uitvoer beschreven.

JSON-eigenschap	Type	DETAILS
Id	string	De id van het GUID-apparaat (msdyn_iotdevice) in Connected Field Service, omgezet in een tekenreeks
RegistrationStatus	OptionSetValue	De status van de registratie vanaf de IoT-provider terug naar Connected Field Service Waarden en labels: - 192350000: Onbekend - 192350001: Ongeregistreerd - 192350002 : Wordt uitgevoerd - 192350003: Geregistreerd - 192350004: Fout Opmerking: een OptionSet is een lijst met opties met toewijzing van labelwaarden als een vervolgkeuzelijst.
DeviceId	string	De id van het apparaat in het IoT-providersysteem
Bericht	string	Een gedetailleerd bericht met betrekking tot de registratie aan de Connected Field Service-gebruiker

Voorbeelduitvoer:

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

Gecombineerde apparaatwaarden

Met de actie Gecombineerde apparaatwaarden worden gecombineerde apparaatgegevens opgehaald van de IoT-provider. Gecombineerde gegevens bieden een snelle momentopname van de staat van het apparaat op overzichtstegels in Connected Field Service.

Schermopname van een IoT-apparaat in Field Service, met gecombineerde waarden.

In de volgende tabel worden de invoerparameters van de actie Gecombineerde apparaatwaarden beschreven.

Parameter	Type	DETAILS
deviceId	string	De id van het GUID-apparaat (msdyn_iotdevice) in Connected Field Service, omgezet in een tekenreeks
meetwaarden	string	Een lijst met metingen in JSON-indeling. Zie het volgende codefragment voor voorbeelden

Voorbeeldinvoer:

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

De actie Gecombineerd apparaatwaarden retourneert de metingen in geserialiseerde JSON-indeling. In de volgende tabel worden de uitvoerparameters weergegeven.

JSON-eigenschap	Type	DETAILS
measuresOutput	string	De waarden van de geretourneerde metingen in JSON-indeling. Zie het volgende codefragment voor voorbeelden

Voorbeelduitvoer:

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

Gecombineerde apparaatwaarden zijn gebaseerd van de entiteit voor de geschiedenis van apparaatgegevens als u de actie Gecombineerde apparaatwaarden niet gebruikt.

Query uitvoeren op apparaatwaarden

Met de actie Query uitvoeren op apparaatwaarden worden historische apparaatgegevens, zoals de temperatuur en vochtigheid, opgehaald van de IoT-provider en weergegeven als een tijdreeksdiagram.

Schermopname van de apparaattemperatuur en -vochtigheid in de loop van de tijd.

In de volgende tabel worden de invoerparameters van de actie Query uitvoeren op apparaatwaarden beschreven.

Parameter	Type	DETAILS
From	datetime	De begintijd van de aflezing (meetpunt) in ISO-indeling, bijvoorbeeld 2020-04-10T13:51:55.781Z
To	datetime	De eindtijd van de aflezing (meetpunt) in in ISO-indeling
IoTDeviceId	string	De id van het GUID-apparaat (msdyn_iotdevice) in Connected Field Service, omgezet in een tekenreeks
Interval	string	De intervalgrootte van het plotpunt opgegeven in de ISO-8601 duurnotatie; 1 minuut is bijvoorbeeld PT1M, 1 milliseconde is PT0.001S Alle intervallen hebben dezelfde grootte. Een maand wordt altijd omgezet in 30 dagen en een jaar is altijd 365 dagen.

Voorbeeldinvoer:

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

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

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

    "Interval":"P1D"
}

De actie Query uitvoeren op apparaatwaarden retourneert de gegevens in geserialiseerde JSON-indeling. In de volgende tabel worden de uitvoerparameters weergegeven.

JSON-eigenschap	Type	DETAILS
AggregatedDeviceReadings	String	De waarden van de geretourneerde metingen in JSON-indeling. Zie het volgende codefragment voor voorbeelden

Voorbeelduitvoer:

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

Apparaatgebeurtenissen ophalen

Met de actie Apparaatgebeurtenissen ophalen worden gebeurtenissen uit de servicegeschiedenis van het apparaat opgehaald en weergegeven als spelden onder aan het diagram dat wordt gemaakt door de actie Query uitvoeren op apparaatwaarden. U kunt alle aangepaste entiteiten opnemen, zoals de laatste keer dat u een activumupgrade hebt uitgevoerd.

Schermopname van gebeurtenissen, weergegeven als spelden onder de grafiek voor temperatuur en vochtigheid van het apparaat in de loop van de tijd.

Notitie

U hoeft geen nieuwe actie te maken. Registreer een aangepaste invoegtoepassing voor de actie msdyn_IoTGetDeviceEvents, zoals invoegtoepassingen voor maakgebeurtenissen.

In de volgende tabel worden de invoerparameters van de actie Apparaatgebeurtenissen ophalen beschreven.

JSON-eigenschap	Type	DETAILS
From	datetime	De begintijd van de aflezing (meetpunt) in ISO-indeling, bijvoorbeeld 2020-04-10T13:51:55.781Z
To	datetime	De eindtijd van de aflezing (meetpunt) in in ISO-indeling
IoTDeviceId	string	De id van het GUID-apparaat (msdyn_iotdevice) in Connected Field Service, omgezet in een tekenreeks

Voorbeeldinvoer:

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

De actie Apparaatgebeurtenissen ophalen retourneert de gegevens in geserialiseerde JSON-indeling. In de volgende tabel worden de uitvoerparameters weergegeven.

JSON-eigenschap	Type	DETAILS
EventsName	string	Korte beschrijving van de categorie van de gebeurtenis; gebruik deze om alle gebeurtenissen in die categorie te tonen of te verbergen
Tijdstempel	string	De timestamp van de gebeurtenis, als een tekenreeks in ISO-indeling; de tijdstempel op de x-as voor de gebeurtenisspeld
Color	string	De kleurcode van de gebeurtenisspeld, opgegeven als een hexadecimale tekenreeks
Omschrijving	string	Een korte beschrijving van de gebeurtenis, die wordt weergegeven wanneer de gebruiker met de muisaanwijzer over de speld beweegt of als de gebruiker de speld selecteert om details te bekijken
Id	string	De id van de gebeurtenis. Dit kan een naam zijn of een andere gebruiksvriendelijke waarde, zoals het werkordernummer of de boekingsbevestigingscode
Entity	string	De Dataverse-entiteitsnaam gerelateerd aan de gebeurtenis, bijvoorbeeld msdyn_workorder
URL	string	De URL van de detailpagina van de gebeurtenis, zoals een koppeling naar het werkorderformulier Als u een entiteit en GUID doorgeeft, genereert het systeem automatisch een hyperlink.
GUID	string	De GUID, geconverteerd naar een tekenreeks, van de entiteitsrecord in Dataverse

Voorbeelduitvoer:

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

Delen via

IoT-provideracties instellen

Apparaatgegevens ophalen

Apparaat registreren

Gecombineerde apparaatwaarden

Query uitvoeren op apparaatwaarden

Apparaatgebeurtenissen ophalen

Volgende stappen

Feedback

Aanvullende resources