IoT Platform:Reenvío de datos a Function Compute

Requisitos previos

• Se creó una instancia de IoT Platform en una región compatible con el reenvío de datos a Function Compute. Para obtener más información, consulte Feature availability by region.

• Se creó un origen de datos llamado DataSource y se agregó un topic de comunicación TSL a dicho origen. Para obtener más información, consulte Add a data source.

• Cree un servicio y una función en Function Compute. Compruebe que la función esté configurada correctamente y se ejecute según lo esperado. Function Compute documentation.

  Importante

  • Al crear la función, establezca el parámetro Request Handler Type en Handle Event Request.

  • Para una instancia Enterprise Edition, el servicio y la función de Function Compute deben encontrarse en la misma región que la instancia.

Contexto

El motor de reglas reenvía los datos del dispositivo a Function Compute, donde scripts de funciones personalizadas ejecutan su lógica empresarial.

Notas de uso

También puede utilizar la versión nueva o anterior de la función de reenvío de datos para enviar información a Function Compute. Para obtener más información sobre la versión anterior, consulte Forward data to Function Compute (FC).

Creación de un destino de datos

1. Inicie sesión en la consola de IoT Platform.

2. En la página Overview, localice la instancia que desea gestionar y haga clic en su ID o nombre.

3. En el panel de navegación izquierdo, seleccione Message Forwarding > Data Forwarding.

4. En la página Data Forwarding, haga clic en Go to New Version en la esquina superior derecha.

   Nota

   Si ya realizó esta operación anteriormente, el sistema lo redirigirá automáticamente a la nueva versión de la página Data Forwarding.

5. Haga clic en la pestaña Data Destination. En dicha pestaña, haga clic en Create Data Destination.

6. En el cuadro de diálogo Create Data Destination, introduzca un nombre para el destino de datos. En este ejemplo se utiliza DataPurpose. Configure los parámetros y haga clic en OK.

   Parámetro	Descripción
   Operation	Seleccione Send data to Function Compute (FC).
   Region	Seleccione la región de su servicio de Function Compute.
   Service	Seleccione un servicio de Function Compute. Para crear un servicio en la consola de Function Compute, haga clic en Create Service. Manage services.
   Function Version	Seleccione una versión de la función: Use Default Version: Invoca la versión LATEST de la función. Select Version: Utiliza una versión publicada específica del servicio. Para crear una versión en la consola de Function Compute, haga clic en Create Version. Manage versions. Select Alias: Utiliza un alias preconfigurado para una versión del servicio. Para crear un alias en la consola de Function Compute, haga clic en Create Alias. Manage aliases.
   Function	Seleccione la función de destino. Para crear una función en la consola de Function Compute, haga clic en Create Function. Manage functions.
   Authorization	Otorga permiso a IoT Platform para escribir datos en Function Compute. Si no existe ningún rol de RAM, haga clic en Create RAM Role para crear un rol de RAM y una directiva de autorización en la consola de RAM. Create a RAM role.

Configuración e inicio de un analizador sintáctico

1. Cree un analizador sintáctico llamado DataParser. Para obtener más información, consulte Step 1: Create a parser.

2. En la página Parser Details, asocie el analizador sintáctico con el origen de datos creado.

   1. En el paso Data Source del asistente, haga clic en Associate Data Source.

   2. En el cuadro de diálogo que aparece, seleccione DataSource en la lista desplegable Data Source y luego haga clic en OK.

3. En la página Parser Details, asocie el analizador sintáctico con el destino de datos creado.

   1. Haga clic en Data Destination dentro del asistente. En la sección Data Destination, haga clic en Associate Data Destination.

   2. En el cuadro de diálogo que aparece, seleccione DataPurpose en la lista desplegable Data Destination y luego haga clic en OK.

   3. En la sección Data Destination, consulte y guarde el data destination ID. En este ejemplo, el ID es 1000.

      Al escribir el script del analizador sintáctico, debe utilizar el data destination ID.

4. En la página Parser Details, haga clic en Parser.

5. En el editor de código, introduzca un script. Para obtener más información sobre cómo modificar un script, consulte Script syntax.

   Para obtener más información sobre los parámetros de la función, consulte Function list.

   // Use the payload() function to obtain the data that is submitted by devices and convert the data to JSON-formatted data. 
   var data = payload("json");
   // Forward submitted TSL data. 
   writeFc(1000, data);

6. Haga clic en Debugging. En el cuadro de diálogo que aparece, seleccione un producto y un dispositivo, especifique un topic e introduzca datos de carga útil para comprobar si el script se ejecuta según lo esperado.

   Los parámetros son los siguientes:

   • Topic: El topic de reporte de propiedades del dispositivo. La ruta termina con /thing/event/property/post.

   • Payload data: Formato JSON. El campo items contiene Temperature (valor: 38) y Humidity (valor: 25), junto con los campos productKey, deviceName y gmtCreate.

   El siguiente resultado indica que el script se ejecuta correctamente. La pestaña Run Result en el cuadro de diálogo Debugging muestra la salida: action: y transmit to fc[destinationId=1000].

7. Haga clic en Publish.

8. Vaya a la pestaña Parser de la página Data Forwarding. Localice el analizador sintáctico DataParser y haga clic en Start en la columna Actions para iniciar el analizador.

9. Inicie sesión en la consola de Function Compute. En la página de detalles de la función, haga clic en la pestaña Logs para consultar los registros de ejecución. En la esquina superior derecha de la página de detalles, seleccione More > Monitoring para ver las estadísticas de monitoreo de la función.

   Importante

   Las estadísticas de monitoreo de una función se generan 5 minutos después de su ejecución.