Configurar acciones del proveedor de IoT

Artículo
11/05/2023

Después de configurar un proveedor de IoT (Internet de las cosas), puede especificar un conjunto de acciones para activar en función de los datos capturados de los dispositivos IoT de su organización. Junto con cinco acciones predefinidas, puede crear acciones personalizadas que estén asociadas con su proveedor para automatizar varios aspectos de sus operaciones de Connected Field Service.

Las siguientes acciones vienen con Connected Field Service:

Extraer datos del dispositivo
Registrar dispositivo
Lecturas agregadas de dispositivos
Consulta de lecturas de dispositivos
Obtener eventos de dispositivo

Extraer datos del dispositivo

La acción Extraer datos del dispositivo obtiene los datos más recientes para un dispositivo o una colección de dispositivos del proveedor de IoT. Aparece en la pestaña Historial de datos del dispositivo .

Debido a que los datos pueden provenir de varios dispositivos, la acción Extraer datos del dispositivo requiere una EntityCollection como entrada. En la siguiente tabla se describen los parámetros de EntityCollection.

Parámetro	Type	Details
msdyn_iotdeviceid	string	El ID del dispositivo GUID (msdyn_iotdevice) en Connected Field Service, convertido en una cadena
msdyn_name	string	Nombre del dispositivo
@odata.type	string	El tipo de OData de la entidad

Ejemplo de entrada:

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

La acción Extraer datos del dispositivo devuelve los datos recuperados en formato JSON serializado. En la siguiente tabla se describen los parámetros de la salida de PullDeviceDataResultsJSON.

Propiedad JSON	Type	Details
ID	string	El ID del dispositivo GUID (msdyn_iotdevice) en Connected Field Service, convertido en una cadena
ConnectionState	booleano	Si el dispositivo está desconectado (falso) o conectado (verdadero)
ConnectionStateUpdatedTime	datetime	Marca de hora de la última actualizcacioń de estado de conexión del proveedor de IoT
DeviceReportedProperties	string	Propiedades notificadas del dispositivo, formateadas como una cadena JSON
LastActivityTime	datetime	Marca de hora de la última actividad notificada del dispositivo

Salida de muestra:

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

Registrar dispositivo

La acción Registrar dispositivo crea una asociación entre un dispositivo o una colección de dispositivos y el proveedor de IoT. Se pueden registrar nuevos dispositivos y dispositivos o componentes que un técnico reemplaza. Después de registrar un dispositivo, aparece en la pestaña Historial de registro del registro del dispositivo IoT.

Debido a que se pueden registrar varios dispositivos a la vez, la acción Registrar dispositivo requiere una EntityCollection como entrada. En la siguiente tabla se describen los parámetros de EntityCollection.

Parámetro	Type	Details
msdyn_iotdeviceid	string	El ID del dispositivo GUID (msdyn_iotdevice) en Connected Field Service, convertido en una cadena
msdyn_name	string	Nombre del dispositivo
@odata.type	string	El tipo de OData de la entidad

Ejemplo de entrada:

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

La acción Registrar dispositivo devuelve los resultados del registro en formato JSON serializado. En la siguiente tabla se describen los parámetros de la salida de RegistrationResultsJSON.

Propiedad JSON	Type	Details
ID	string	El ID del dispositivo GUID (msdyn_iotdevice) en Connected Field Service, convertido en una cadena
RegistrationStatus	OptionSetValue	El estado del registro del proveedor de IoT a Connected Field Service Valores y etiquetas: - 192350000: desconocido - 192350001: sin registrar - 192350002: en curso - 192350003: registrado - 192350004: error Nota: OptionSet es una lista de opciones con asignación de valor de etiqueta, como un control de lista desplegable.
DeviceId	string	ID del dispositivo en el sistema del proveedor de IoT
Publicación	string	Un mensaje detallado sobre el registro al usuario de Connected Field Service en relación con el registro

Salida de muestra:

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

Lecturas agregadas de dispositivos

La acción Lecturas agregadas de dispositivos recupera datos agregados del dispositivo del proveedor de IoT. Los datos agregados proporcionan una instantánea rápida de la condición del dispositivo en mosaicos de resumen en Connected Field Service.

Captura de pantalla de un dispositivo de IoT en Field Service, mostrando lecturas agregadas.

La tabla siguiente describe los parámetros de entrada de la acción de lecturas de requeridos por la acción lecturas de dispositivos agregadas.

Parámetro	Type	Details
deviceId	string	El ID del dispositivo GUID (msdyn_iotdevice) en Connected Field Service, convertido en una cadena
medidas	string	Una lista de medidas en formato JSON; consulte el siguiente fragmento de código para ver ejemplos

Ejemplo de entrada:

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

La acción acción Lecturas de dispositivos agregadas devuelve las mediciones en formato JSON serializado. La siguiente tabla muestra los parámetros de salida.

Propiedad JSON	Type	Details
measuresOutput	string	Los valores de las medidas devueltas en formato JSON; consulte el siguiente fragmento de código para ver ejemplos

Salida de muestra:

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

Las lecturas de dispositivos agregadas se basan en la entidad del historial de datos de dispositivos si no utiliza la acción de lecturas de dispositivos agregadas.

Consulta de lecturas de dispositivos

La acción Consultar lecturas del dispositivo recupera datos históricos del dispositivo, como temperatura y humedad, del proveedor de IoT y los muestra como un gráfico de serie temporal.

Captura de pantalla de la temperatura y humedad del dispositivo a lo largo del tiempo.

La tabla siguiente describe los parámetros de entrada de la acción de lecturas de requeridos por la acción Consulta de lecturas de dispositivos.

Parámetro	Type	Details
From	datetime	La hora de inicio de la lectura (medida) en formato ISO; por ejemplo, "2020-04-10T13:51:55.781Z"
To	datetime	La hora de fin de la lectura (medida) en formato ISO
IoTDeviceId	string	El ID del dispositivo GUID (msdyn_iotdevice) en Connected Field Service, convertido en una cadena
Intervalo	string	El tamaño del intervalo del punto de trazado especificado en el formato de duración ISO-8601; por ejemplo, 1 minuto es "PT1M", 1 milisegundo es "PT0.001S" Todos los intervalos son del mismo tamaño. Un mes siempre se convierte en 30 días y un año siempre es 365 días.

Ejemplo de entrada:

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

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

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

    "Interval":"P1D"
}

La acción acción Consulta de lecturas de dispositivos devuelve los datos en formato JSON serializado. La siguiente tabla muestra los parámetros de salida.

Propiedad JSON	Type	Details
AggregatedDeviceReadings	String	Los valores de las medidas devueltas en formato JSON; consulte el siguiente fragmento de código para ver ejemplos

Salida de muestra:

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

Obtener eventos de dispositivo

La acción Obtener eventos del dispositivo recupera eventos del historial de servicio del dispositivo y los muestra como pines en la parte inferior del gráfico creado por la acción Consultar lecturas del dispositivo. Puede incluir cualquier entidad personalizada, como la última vez que realizó una actualización de activos.

Captura de pantalla de los eventos que se muestran como pines debajo del gráfico de temperatura y humedad del dispositivo a lo largo del tiempo.

Nota

No necesita crear una acción nueva. Registre un complemento personalizado en la acción msdyn_IoTGetDeviceEvents, como complementos para crear eventos.

La tabla siguiente describe los parámetros de entrada de la acción de lecturas de requeridos por la acción Obtener eventos de dispositivo.

Propiedad JSON	Type	Details
From	datetime	La hora de inicio de la lectura (medida) en formato ISO; por ejemplo, "2020-04-10T13:51:55.781Z"
To	datetime	La hora de fin de la lectura (medida) en formato ISO
IoTDeviceId	string	El ID del dispositivo GUID (msdyn_iotdevice) en Connected Field Service, convertido en una cadena

Ejemplo de entrada:

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

La acción acción Obtener eventos de dispositivo devuelve los datos en formato JSON serializado. La siguiente tabla muestra los parámetros de salida.

Propiedad JSON	Type	Details
EventsName	string	Breve descripción de la categoría del evento; Úselo para mostrar u ocultar todos los eventos en esa categoría
Marca de tiempo	string	La marca de tiempo del evento formateada como una cadena en formato ISO; la marca de tiempo del eje x para el pin del evento
Color	string	El color del pin de evento, proporcionado como cadena de código hexadecimal
Description	string	Una breve descripción del evento, que se muestra cuando el usuario pase el mouse sobre el marcador o cuando el usuario seleccione el marcador para ver los detalles
ID	string	El ID del evento; Puede ser un nombre u otro valor fácil de usar, como el número de orden de trabajo o el código de confirmación de la reserva
Entity	string	El nombre de la entidad de Dataverse relacionada con el evento; por ejemplo, "msdyn_workorder"
Dirección URL	string	La URL de la página de detalles del evento, como un enlace al formulario de orden de trabajo Si pasa una entidad y un GUID, el sistema genera automáticamente un hipervínculo.
GUID	string	El GUID, convertido en una cadena, del registro de entidad en Dataverse

Salida de muestra:

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

Compartir a través de

Configurar acciones del proveedor de IoT

Extraer datos del dispositivo

Registrar dispositivo

Lecturas agregadas de dispositivos

Consulta de lecturas de dispositivos

Obtener eventos de dispositivo

Pasos siguientes

Recursos adicionales