Configurez et testez l'intégration AWS SiteWise

Prérequis

• Integration Server déployé et enregistré sur la plateforme

• AWS SiteWise configuré

• Un profil IAM configuré directement sur la machine client ou sur le serveur d’intégration avec les autorisations requises pour accéder à AWS SiteWise.

Types de requêtes pris en charge

• Obtenez la valeur actuelle des biens immobiliers pour un asset AWS SiteWise

Fonctionnalités prises en charge

• Support automatique de l’UoM

Étapes de configuration

Ce guide expliquera comment configurer l’intégration AWS SiteWise pour récupérer des données dans un RealityAsset. Ce guide supposera qu’un profil IAM avec les permissions appropriées est déjà disponible.

Les principales étapes pour configurer l’intégration AWS SiteWise sont les suivantes :

1. Inscrivez la source de données AWS SiteWise sur RealityPlatform

2. Liez l’intégration à un type d’actif

3. Envoyez une requête de test afin de valider la connexion vers AWS

Enregistrez la source de données AWS SiteWise sur le serveur d’intégration

1. Ajouter la nouvelle source de données

2. Sélectionnez le AWS_IOT_SITEWISE type

3. Remplissez les paramètres nécessaires pour établir la connexion

Paramètres de la source de données AWS IoT SiteWise

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

Profil (optionnel)

Le profil IAM qui sera utilisé pour s’authentifier contre AWS IoT SiteWise. Si aucune option n’est sélectionnée, le profil par défaut sera utilisé.

Région (optionnelle)

Le nom de la région AWS à laquelle l’intégration sera connectée.

Valeurs possibles

La liste des régions prises en charge est disponible ici.

Lier les propriétés du type d’actif à l’AWS IOT SiteWise

Avant de mettre le lien, assurez-vous d’avoir :

• Un type d’actif existant avec une propriété pour contenir les valeurs requises des paramètres AWS IOT SiteWise (par exemple, Asset ID). Il doit s’agir d’une propriété « Texte court ».

• Un serveur d’intégration configuré avec une source de données AWS IoT SiteWise et des requêtes.

Pour lier une propriété de type d’actif à AWS IoT SiteWise :

1. Dans les paramètres d’actifs → types d’actifs, ouvrez le type d’actif que vous souhaitez lier.

2. Dans le panneau Liens d’intégration (côté droit), cliquez sur Créer lien d’intégration.

   

3. Saisissez un nom de lien et sélectionnez le serveur d’intégration configuré pour AWS IOT SiteWise.

4. Choisissez la source de données appropriée

5. Choisissez la requête souhaitée :
   -Obtenir les valeurs des attributs d’actifs AWS SiteWise
   Récupère les attributs de l’actif.

   Paramètres :

   • AssetId

6. Pour chaque paramètre requis (par exemple, AssetId), sélectionnez la propriété Type d’Actif qui doit fournir sa valeur (par exemple, Asset ID).

   

7. Cliquez sur Enregistrer pour créer le lien.

Lorsque ce type d’actif est attribué aux actifs, les valeurs des propriétés liées seront automatiquement transmises à AWS SiteWise lors de l’exécution de l’intégration.

Envoyez une requête de test pour valider la connectivité entre RealityPlatform et AWS IoT SiteWise

1. Sur la page Paramètres du type d’actif, cliquez sur le bouton lecture à côté du lien d’intégration ciblant la source de données AWS IoT SiteWise. Cela ouvrira le menu de requêtes de test.

2. Saisissez un identifiant d’Asset dans la configuration des paramètres et cliquez sur Requête Test pour voir le résultat. L’identifiant de l’actif peut être obtenu directement auprès d’AWS SiteWise.

Note

• Les valeurs saisies ici ne sont qu’à des fins de test. Ils ne sont pas enregistrés sur le type d’actif ou les actifs liés. Ce test simule ce que RealityTwin fera lorsqu’un asset est créé, attribué à ce type d’actif, et que la propriété correspondante (par exemple, l’identifiant de l’actif) est remplie. Utilisez n’importe quel identifiant d’Asset valide pour valider la connectivité.