Configurar y probar la integración de AWS SiteWise

Requisitos previos

• Servidor de integración desplegado y registrado en la plataforma

• AWS SiteWise configurado

• Un perfil IAM configurado en la máquina cliente o directamente en el servidor de integración con los permisos requeridos para acceder a AWS SiteWise.

Tipos de consulta compatibles

• Obtener los valores actuales de las propiedades de un activo de AWS SiteWise

Funciones compatibles

• Compatibilidad automática con UoM

Pasos de configuración

Esta guía describe cómo configurar la integración de AWS SiteWise para recuperar datos en un RealityAsset. Esta guía asumirá que ya hay disponible un perfil IAM con los permisos correctos.

Los pasos principales para configurar la integración de AWS SiteWise son los siguientes:

1. Registrar la fuente de datos de AWS SiteWise en RealityPlatform

2. Vincular la integración a un tipo de activo

3. Enviar una consulta de prueba para validar la conexión con AWS

Registrar la fuente de datos de AWS SiteWise en el servidor de integración

1. Añade la nueva fuente de datos

2. Selecciona el tipo AWS_IOT_SITEWISE

3. Rellena los parámetros requeridos para establecer la conexión

Parámetros de la fuente de datos de AWS IoT SiteWise

{
  "profile": "exampleProfile",
  "region": "us-west-2"
}

profile (opcional)

El perfil IAM que se usará para autenticarse en AWS IoT SiteWise. Si no se selecciona ninguno, se usará el perfil predeterminado.

region (opcional)

El nombre de la región de AWS a la que se conectará la integración.

Valores posibles

La lista de regiones compatibles está disponible aquí.

Vincular las propiedades del tipo de activo a AWS IOT SiteWise

Antes de vincular, asegúrate de tener:

• Un tipo de activo existente con una propiedad para contener los valores de parámetro requeridos de AWS IOT SiteWise (por ejemplo, Asset ID). Debe ser un tipo de propiedad “Short text”.

• Un servidor de integración configurado con una fuente de datos y consultas de AWS IOT SiteWise.

Para vincular una propiedad del tipo de activo a AWS IOT SiteWise:

1. En Asset Settings → Asset Types, abre el tipo de activo que quieres vincular.

2. En el panel Integration Links (lado derecho), haz clic en Create Integration Link.

   

3. Introduce un nombre de enlace y selecciona el servidor de integración configurado para AWS IOT SiteWise.

4. Elige la fuente de datos apropiada

5. Elige la consulta deseada:
   -Get AWS SiteWise Asset attributes values
   Recupera los atributos del activo.

   Parámetros:

   • AssetId

6. Para cada parámetro requerido (por ejemplo, AssetId), selecciona la propiedad del tipo de activo que debe proporcionar su valor (por ejemplo, Asset ID).

   

7. Haz clic en Save para crear el enlace.

Cuando este tipo de activo se asigna a los activos, los valores de las propiedades vinculadas se pasarán automáticamente a AWS SiteWise al ejecutar la integración.

Enviar una consulta de prueba para validar la conectividad entre RealityPlatform y AWS IOT SiteWise

1. En la página de configuración del tipo de activo, haz clic en el botón de reproducción junto al enlace de integración que apunta a la fuente de datos de AWS IOT SiteWise. Esto abrirá el menú de consulta de prueba.

2. Introduce un Asset ID en la configuración de parámetros y haz clic en Test query para ver el resultado. El asset id se puede obtener directamente desde AWS SiteWise.

Nota

• Los valores introducidos aquí son solo para fines de prueba. No se guardan en el tipo de activo ni en los activos vinculados. Esta prueba simula lo que RealityTwin hará cuando se cree un activo, se le asigne este tipo de activo y se rellene la propiedad correspondiente (por ejemplo, Asset ID). Usa cualquier Asset ID válido para validar la conectividad.