IoT-Anbieteraktionen einrichten

Artikel
09/04/2024

Nachdem Sie einen IoT-Anbieter (Internet of Things) eingerichtet haben, können Sie eine Reihe von Aktionen angeben, die basierend auf den erfassten Daten von den IoT-Geräten Ihrer Organisation ausgelöst werden sollen. Neben fünf vordefinierten Aktionen können Sie benutzerdefinierte Aktionen erstellen, die Ihrem Anbieter zugeordnet sind, um verschiedene Aspekte Ihrer Connected Field Service-Vorgänge zu automatisieren.

Die folgenden Aktionen sind mit Connected Field Service verfügbar:

Gerätedaten abrufen
Gerät registrieren
Aggregierte Ablesungen für Gerät
Abfrage-Geräteauslesung
Geräte-Ereignisse abrufen

Gerätedaten abrufen

Die Aktion Gerätedaten abrufen ruft die neuesten Daten für ein Gerät oder eine Sammlung von Geräten vom IoT-Anbieter ab. Sie erscheint auf der Registerkarte Gerätedatenverlauf.

Da Daten von mehreren Geräten stammen können, erfordert die Aktion „Gerätedaten abrufen“ eine EntityCollection als Eingabe. Die folgende Tabelle beschreibt die Parameter von EntityCollection.

Parameter	Type	Informationen
msdyn_iotdeviceid	string	Die GUID-Geräte-ID (msdyn_iotdevice) in Connected Field Service, in eine Zeichenfolge konvertiert
msdyn_name	string	Der Name des Geräts
@odata.type	string	OData-Typ der Entität

Beispieleingabe:

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

Die Aktion „Gerätedaten abrufen“ gibt die abgerufenen Daten im serialisierten JSON-Format zurück. Die folgende Tabelle beschreibt die Parameter der PullDeviceDataResultsJSON-Ausgabe.

JSON-Eigenschaft	Type	Informationen
Kennung	string	Die GUID-Geräte-ID (msdyn_iotdevice) in Connected Field Service, in eine Zeichenfolge konvertiert
ConnectionState	boolesch	Gibt an, ob das Gerät nicht verbunden (false) oder verbunden (true) ist
ConnectionStateUpdatedTime	DateTime	Der Zeitstempel des letzten Updates des Verbindungsstatus vom IoT-Anbieter
DeviceReportedProperties	string	Die gemeldeten Eigenschaften des Geräts, formatiert als JSON-Zeichenfolge
LastActivityTime	DateTime	Der Zeitstempel der letzten gemeldeten Aktivität des Geräts

Beispielausgabe:

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

Gerät registrieren

Die Aktion „Gerät registrieren“ erstellt eine Zuordnung zwischen einem Gerät oder einer Gerätesammlung und dem IoT-Anbieter. Neue Geräte und Geräte oder Komponenten, die ein Techniker austauscht, können registriert werden. Nachdem Sie ein Gerät registriert haben, wird es auf der Registerkarte Registrierungsverlauf des IoT-Gerätedatensatzes angezeigt.

Da mehrere Geräte gleichzeitig registriert werden können, erfordert die Aktion „Gerät registrieren“ eine EntityCollection als Eingabe. Die folgende Tabelle beschreibt die Parameter von EntityCollection.

Parameter	Type	Informationen
msdyn_iotdeviceid	string	Die GUID-Geräte-ID (msdyn_iotdevice) in Connected Field Service, in eine Zeichenfolge konvertiert
msdyn_name	string	Der Name des Geräts
@odata.type	string	OData-Typ der Entität

Beispieleingabe:

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

Die Aktion „Gerätedaten registrieren“ gibt die Registrierungsergebnisse im serialisierten JSON-Format zurück. Die folgende Tabelle beschreibt die Parameter der RegistrationResultsJSON-Ausgabe.

JSON-Eigenschaft	Type	Informationen
Kennung	string	Die GUID-Geräte-ID (msdyn_iotdevice) in Connected Field Service, in eine Zeichenfolge konvertiert
RegistrationStatus	OptionSetValue	Der Status der Registrierung vom IoT-Anbieter zurück zu Connected Field Service Werte und Beschriftungen: - 192350000: Unbekannt - 192350001: Nicht registriert - 192350002: In Bearbeitung - 192350003: Registriert - 192350004: Fehler Hinweis: OptionSet ist eine Liste von Optionen mit Beschriftung/Wert-Zuordnung wie ein Dropdownlisten-Steuerelement.
DeviceId	string	Die ID des Geräts im IoT-Anbietersystem
Nachricht	string	Alle detaillierten Meldungen beim Connected Field Service-Benutzenden bezüglich der Registrierung

Beispielausgabe:

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

Aggregierte Ablesungen für Gerät

Die Aktion „Aggregierte Ablesungen für Gerät“ ruft aggregierte Gerätedaten vom IoT-Anbieter ab. Aggregierte Daten bieten einen schnelle Momentaufnahme des Zustand des Geräts in Zusammenfassungskacheln in Connected Field Service.

Screenshot eines IoT-Geräts im Field Service, der die aggregierten Auslesungen darstellt

Die folgende Tabelle beschreibt die Eingabeparameter der Aktion „Aggregierte Ablesungen für Gerät“.

Parameter	Type	Informationen
deviceId	string	Die GUID-Geräte-ID (msdyn_iotdevice) in Connected Field Service, in eine Zeichenfolge konvertiert
measures	string	Eine Liste von Messungen im JSON-Format; Beispiele finden Sie im folgenden Codeausschnitt

Beispieleingabe:

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

Die Aktion „Aggregierte Auslesungen für Gerät“ gibt die Messungen im serialisierten JSON-Format zurück. Die folgende Tabelle zeigt die Ausgabeparameter an.

JSON-Eigenschaft	Type	Informationen
measuresOutput	string	Die Werte der zurückgegebenen Messungen im JSON-Format; Beispiele finden Sie im folgenden Codeausschnitt

Beispielausgabe:

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

Aggregierte Geräteauslesungen basieren auf der Entität des Gerätedatenverlaufs, wenn Sie die Aktion „Aggregierte Auslösungen für Gerät“ nicht verwenden.

Abfrage-Geräteauslesung

Die Aktion „Abfrage-Geräteauslesung“ ruft historische Gerätedaten wie Temperatur und Luftfeuchtigkeit vom IoT-Anbieter ab und zeigt sie als Zeitreihendiagramm an.

Screenshot der Gerätetemperatur und Luftfeuchtigkeit im Zeitverlauf.

Die folgende Tabelle beschreibt die Eingabeparameter der Aktion „Abfrage-Geräteauslesung“.

Parameter	Type	Informationen
From	DateTime	Die Startzeit des Auslese-(Mess-)punktes im ISO-Format, zum Beispiel „2020-04-10T13:51:55.781Z“
To	DateTime	Die Endzeit des Auslese-(Mess-)punktes im ISO-Format
IoTDeviceId	string	Die GUID-Geräte-ID (msdyn_iotdevice) in Connected Field Service, in eine Zeichenfolge konvertiert
Intervall	string	Die Intervallgröße des im ISO-8601-Dauerformat angegebenen Plotpunkts; beispielsweise ist 1 Minute „PT1M“, 1 Millisekunde ist „PT0.001S“ Alle Intervalle sind gleich groß. Ein Monat wird immer in 30 Tage umgewandelt, und ein Jahr ist immer 365 Tage.

Beispieleingabe:

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

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

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

    "Interval":"P1D"
}

Die Aktion „Abfrage-Geräteauslösung“ gibt die Daten im serialisierten JSON-Format zurück. Die folgende Tabelle zeigt die Ausgabeparameter an.

JSON-Eigenschaft	Type	Informationen
AggregatedDeviceReadings	Zeichenfolge	Die Werte der zurückgegebenen Messungen im JSON-Format; Beispiele finden Sie im folgenden Codeausschnitt

Beispielausgabe:

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

Geräte-Ereignisse abrufen

Die Aktion „Geräte-Ereignisse abrufen“ ruft Ereignisse aus dem Serviceverlauf des Geräts ab und zeigt sie als Stecknadeln am unteren Rand des Diagramms an, das durch die Aktion „Abfrage-Geräteauslesung“ erstellt wurde. Sie können beliebige benutzerdefinierte Entitäten einschließen, z. B. das letzte Mal, als Sie eine Anlagenaktualisierung durchgeführt haben.

Screenshot von Ereignissen, die als Stecknadeln unter dem Gerätetemperatur- und -feuchtigkeitsverlaufsdiagramm angezeigt werden.

Anmerkung

Sie müssen keine neue Aktion erstellen. Registrieren Sie ein benutzerdefiniertes Plug-In für die Aktion msdyn_IoTGetDeviceEvents, z. B. Plug-Ins zum Erstellen von Ereignissen.

Die folgende Tabelle beschreibt die Eingabeparameter der Aktion „Geräte-Ereignisse abrufen“.

JSON-Eigenschaft	Type	Informationen
From	DateTime	Die Startzeit des Auslese-(Mess-)punktes im ISO-Format, zum Beispiel „2020-04-10T13:51:55.781Z“
To	DateTime	Die Endzeit des Auslese-(Mess-)punktes im ISO-Format
IoTDeviceId	string	Die GUID-Geräte-ID (msdyn_iotdevice) in Connected Field Service, in eine Zeichenfolge konvertiert

Beispieleingabe:

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

Die Aktion „Geräte-Ereignisse abrufen“ gibt die Daten im serialisierten JSON-Format zurück. Die folgende Tabelle zeigt die Ausgabeparameter an.

JSON-Eigenschaft	Type	Informationen
EventsName	string	Kurze Beschreibung der Kategorie des Ereignisses; verwenden Sie es, um alle Ereignisse in dieser Kategorie anzuzeigen oder auszublenden
Zeitstempel	string	Der Zeitstempel des Ereignisses, formatiert als Zeichenfolge im ISO-Format; der x-Achsen-Zeitstempel für die Ereignis-Stecknadel
Color	string	Die Farbe der Ereignis-Stecknadel als Hex-Code-Zeichenfolge
Beschreibung	string	Eine kurze Beschreibung des Ereignisses wird angezeigt, wenn der Benutzer mit der Maus über die Stecknadel fährt oder die Stecknadel auswählt, um sich die Details anzusehen
Kennung	string	Die ID des Ereignisses; kann ein Name oder ein anderer benutzerfreundlicher Wert sein, wie die Arbeitsauftragsnummer oder der Buchungsbestätigungscode
Entity	string	Der Dataverse-Name der Entität im Zusammenhang mit dem Ereignis; zum Beispiel „msdyn_workorder“
URL	string	Die URL der Detailseite für das Ereignis, z. B. ein Link zum Arbeitsauftragsformular Wenn Sie eine Entität und eine GUID übergeben, generiert das System automatisch einen Hyperlink.
GUID	string	Die in eine Zeichenfolge konvertierte GUID des Entitätsdatensatzes in Dataverse

Beispielausgabe:

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

Freigeben über

IoT-Anbieteraktionen einrichten

Gerätedaten abrufen

Gerät registrieren

Aggregierte Ablesungen für Gerät

Abfrage-Geräteauslesung

Geräte-Ereignisse abrufen

Nächste Schritte,

Feedback

Zusätzliche Ressourcen