Asigne flujos de datos industriales a propiedades de activos - AWS IoT SiteWise
Establezca un alias de propiedad (consola)Establece un alias de propiedad (AWS CLI)

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Asigne flujos de datos industriales a propiedades de activos

Puede definir un alias de propiedad en la propiedad de un activo. Esto le ayuda a identificar la propiedad de un activo cuando ingiere o recupera los datos del activo. Si el activo tiene propiedades de medición, debe definir los alias de propiedad para mapear los flujos de datos a esas propiedades de medición.

Este proceso requiere que conozca el alias de su propiedad.

  • Si ingiere datos de servidores de OPC UA mediante una fuente de datos de OPC UA en una puerta de enlace SiteWise Edge, el alias de su propiedad es la ruta a una variable situada en el nodo Objetos, empezando por. /

    ejemplo

    Si la ruta a su variable escompany/windfarm/3/turbine/7/temperature, entonces el alias de su propiedad es/company/windfarm/3/turbine/7/temperature.

    Para obtener más información sobre la arquitectura de información de la OPC UA, consulte el modelo de información y el mapeo del espaciado de direcciones en la referencia en línea de la OPC UA.

    Notas

    • Si configura un prefijo de flujo de datos para su fuente de OPC UA, debe incluir ese prefijo en el alias de la propiedad para todos los flujos de datos de esa fuente.

      ejemplo

      Si /RentonWA es un prefijo, entonces el alias anterior lo es. /RentonWA/company/windfarm/3/turbine/7/temperature

    • Los alias de propiedades pueden contener hasta 1000 bits. OPCLas rutas de las variables UA pueden contener hasta 4.096 bytes. Actualmente, AWS IoT SiteWise no admite la ingesta de datos de variables de OPC UA con rutas largas.

  • Si ingiere datos de servidores Modbus mediante una fuente de TCP datos Modbus en una puerta de enlace SiteWise Edge, el alias de su propiedad es:

    Modbus register set tag name

    Utilice este valor para enviar datos de este conjunto de registros a una propiedad de activo.

  • Si ingiere datos de otras fuentes, por ejemplo, mediante AWS IoT reglas o el API, debe definir los alias de sus propiedades. Puede definir un sistema de nombres de alias de propiedad que sea aplicable a la configuración de su dispositivo. Por ejemplo, si ingiere datos de elementos de AWS IoT , puede incluir el nombre del elemento en alias de propiedad para identificar de forma exclusiva las secuencias de datos. Para obtener más información sobre este ejemplo, consulta el tutorial sobre cómo ingerir datos de AWS IoT cosas.

Los alias de propiedad deben ser únicos dentro de una región y AWS una cuenta. AWS IoT SiteWise devuelve un error si se establece un alias de propiedad como uno que ya existe en otra propiedad del activo.

Si tiene varias fuentes de OPC UA con rutas de flujo de datos idénticas, añada un prefijo a las rutas de cada fuente para formar alias únicos. Para obtener más información, consulte OPCFuentes de datos UA.

nota

En esta sección se describe cómo establecer alias para las propiedades de medición. Para obtener más información sobre cómo configurar alias para las propiedades de los estados de las alarmas externas, consulte Mapee los flujos de estados de alarma externos.

Establezca un alias de propiedad (consola)

Puede usar la AWS IoT SiteWise consola para establecer un alias para una propiedad de un activo.

Para configurar un alias de propiedad (consola)

  1. Vaya a la consola de AWS IoT SiteWise.

  2. En el panel de navegación, elija Activos.

  3. Elija el activo para el que desea configurar un alias de propiedad.

    sugerencia

    Puede elegir el icono de flecha para expandir una jerarquía de activos y encontrar su activo.

  4. Seleccione Editar.

  5. Encuentre la propiedad para la que desea configurar un alias y, a continuación, escriba el alias de propiedad.

    AWS IoT SiteWise Captura de pantalla de la página «Editar activo» con el alias de una propiedad resaltado.

  6. Seleccione Guardar.

Establece un alias de propiedad (AWS CLI)

Utilice el AWS Command Line Interface (AWS CLI) para establecer un alias para la propiedad de un activo.

Debe conocer los assetId de sus activos y los propertyId de las propiedades para completar este procedimiento. También puede usar el ID externo. Si has creado un activo y no lo sabesassetId, úsalo ListAssetsAPIpara enumerar todos los activos de un modelo específico. Utilice la DescribeAssetoperación para ver las propiedades de su activo, incluidas las propiedadesIDs.

Utilice la UpdateAssetPropertyoperación para asignar un flujo de datos a la propiedad de su activo. Especifique los siguientes parámetros:

  • assetId— El identificador del activo o el identificador externo. Para obtener más información, consulte Haga referencia a objetos con objetos externos IDs en la Guía del usuario de AWS IoT SiteWise .

  • propertyId— El identificador de la propiedad del activo o el identificador externo.

  • propertyAlias: la ruta del flujo de datos hasta el alias de la propiedad.

  • propertyNotificationState: el estado de notificación del valor de la propiedad, ENABLED o DISABLED. Especifique el estado de notificación existente de la propiedad cuando actualice el alias de propiedad. Puede recuperar el estado de notificación existente con la DescribeAssetPropertyoperación.

    Si omite este parámetro, el nuevo estado de notificación será DISABLED. Para obtener más información acerca de las notificaciones de propiedades, consulte Interactúa con otros AWS servicios.

Para establecer un alias de propiedad (AWS CLI)

  1. Ejecute el siguiente comando para recuperar el estado de notificación actual de la propiedad. Reemplazar asset-id y property-id con la propiedad del activoIDs.

    aws iotsitewise describe-asset-property \
  --asset-id asset-id \
  --property-id property-id

    La operación devuelve una respuesta que contiene detalles de la propiedad del activo en el siguiente formato. El estado de notificación de la propiedad se encuentra assetProperty.notification.state en el JSON objeto.

    {
  "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
  "assetName": "Wind Turbine 7",
  "assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
  "assetProperty": {
    "id": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
    "name": "Wind Speed",
    "notification": {
      "topic": "$aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
      "state": "ENABLED"
    },
    "dataType": "DOUBLE",
    "unit": "m/s",
    "type": {
      "measurement": {}
    }
  }
}

  2. Ejecute el siguiente comando para configurar el alias de la propiedad del activo. Reemplazar property-alias con el alias de la propiedad y notification-state con el estado de la notificación, u omita --property-notification-state deshabilitar las notificaciones. Si lo desea, puede actualizar la unidad del activo con una nueva unit y --property-unit.

    aws iotsitewise update-asset-property \
  --asset-id asset-id \
  --property-id property-id \
  --property-alias property-alias \
  --property-notification-state notification-state \
  --property-unit unit

  3. Para comprobar que se ha establecido el alias, ejecute el siguiente comando para recuperar los detalles de la propiedad. Reemplazar asset-id y property-id con la propiedad del activoIDs.

    aws iotsitewise describe-asset-property \
  --asset-id asset-id \
  --property-id property-id

    La operación devuelve una respuesta que contiene detalles de la propiedad del activo en el siguiente formato. El alias de la propiedad está assetProperty.alias en el JSON objeto y se establece myAlias en este ejemplo.

    {
  "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
  "assetName": "Wind Turbine 7",
  "assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
  "assetProperty": {
    "alias": "myAlias",
    "id": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
    "name": "Wind Speed",
    "notification": {
      "topic": "$aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
      "state": "ENABLED"
    },
    "dataType": "DOUBLE",
    "unit": "m/s",
    "type": {
      "measurement": {}
    }
  }
}