De AWS SiteWise-integratie configureren en testen

Vereisten

• Integratieserver geïmplementeerd en geregistreerd op het platform

• AWS SiteWise geconfigureerd

• Een IAM-profiel geconfigureerd op de clientmachine of rechtstreeks op de integratieserver met de vereiste rechten om toegang te krijgen tot AWS SiteWise.

Ondersteunde querytypen

• De huidige eigenschapwaarden ophalen voor een AWS SiteWise-asset

Ondersteunde functies

• Automatische UoM-ondersteuning

Configuratiestappen

Deze gids beschrijft hoe u de AWS SiteWise-integratie configureert om gegevens op te halen in een RealityAsset. Deze gids gaat ervan uit dat er al een IAM-profiel met de juiste rechten beschikbaar is.

De belangrijkste stappen om de AWS SiteWise-integratie te configureren zijn de volgende:

1. De AWS SiteWise-gegevensbron registreren op RealityPlatform

2. De integratie koppelen aan een assettype

3. Een testquery verzenden om de verbinding met AWS te valideren

De AWS SiteWise-gegevensbron registreren op de integratieserver

1. Voeg de nieuwe gegevensbron toe

2. Selecteer het type AWS_IOT_SITEWISE

3. Vul de vereiste parameters in om de verbinding tot stand te brengen

Parameters van de AWS IoT SiteWise-gegevensbron

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

profile (optioneel)

Het IAM-profiel dat wordt gebruikt om te authenticeren bij AWS IoT SiteWise. Als er geen is geselecteerd, wordt het standaardprofiel gebruikt.

region (optioneel)

De naam van de AWS-regio waarmee de integratie verbinding maakt.

Mogelijke waarden

De lijst met ondersteunde regio’s is hier beschikbaar.

Assettype-eigenschappen koppelen aan AWS IOT SiteWise

Zorg er vóór het koppelen voor dat u het volgende hebt:

• Een bestaand assettype met een eigenschap om de vereiste AWS IOT SiteWise-parameterwaarden te bevatten (bijv. Asset ID). Dit moet een eigenschapstype “Korte tekst” zijn.

• Een integratieserver die is geconfigureerd met een AWS IOT SiteWise-gegevensbron en query’s.

Om een assettype-eigenschap aan AWS IOT SiteWise te koppelen:

1. Open in Assetinstellingen → Assettypen het assettype dat u wilt koppelen.

2. Klik in het paneel Integratiekoppelingen (rechterkant) op Integratiekoppeling aanmaken.

   

3. Voer een koppelingsnaam in en selecteer de integratieserver die voor AWS IOT SiteWise is geconfigureerd.

4. Kies de juiste gegevensbron

5. Kies de gewenste query:
   -Get AWS SiteWise Asset attributes values
   Haalt de attributen van de asset op.

   Parameters:

   • AssetId

6. Selecteer voor elke vereiste parameter (bijv. AssetId) de assettype-eigenschap die de waarde ervan moet leveren (bijv. Asset ID).

   

7. Klik op Opslaan om de koppeling aan te maken.

Wanneer dit assettype aan assets wordt toegewezen, worden de gekoppelde eigenschapwaarden automatisch doorgegeven aan AWS SiteWise bij het uitvoeren van de integratie.

Een testquery verzenden om de connectiviteit tussen RealityPlatform en AWS IOT SiteWise te valideren

1. Klik op de pagina Assettype-instellingen op de afspeelknop naast de integratiekoppeling die de AWS IOT SiteWise-gegevensbron target. Dit opent het testquerymenu.

2. Voer een Asset ID in onder de parameterconfiguratie en klik op Testquery om het resultaat te zien. De asset-id kan rechtstreeks uit AWS SiteWise worden verkregen.

Opmerking

• De hier ingevoerde waarden zijn alleen voor testdoeleinden. Ze worden niet opgeslagen in het assettype of gekoppelde assets. Deze test simuleert wat RealityTwin zal doen wanneer een asset wordt aangemaakt, dit assettype krijgt toegewezen en de bijbehorende eigenschap (bijv. Asset ID) wordt ingevuld. Gebruik een geldige Asset ID om de connectiviteit te valideren.