Assettypen

Assettypen in RealityTwin zijn voorgedefinieerde sjablonen die worden gebruikt om de reeks eigenschappen te definiëren die een asset zal dragen wanneer deze wordt aangemaakt. Door een assettype aan een asset toe te wijzen, worden alle bijbehorende voorgedefinieerde eigenschappen automatisch gekoppeld, wat consistentie garandeert en krachtige zoek- en filtermogelijkheden mogelijk maakt. Als “Pomp” bijvoorbeeld als assettype is gedefinieerd, kunt u later naar alle pompen in uw project zoeken door eenvoudig op dat type te filteren.

Assettypen & categorieën configureren

Om assettypen te configureren:

Ga naar Organisatie-instellingen → Assetinstellingen
Maak een nieuw assettype/categorie aan of bewerk een bestaande.
Nadat u wijzigingen hebt aangebracht, klikt u op Publiceren om ze toe te passen.

Categorieën

Assettypen kunnen worden gegroepeerd onder categorieën voor betere organisatie.
Categorieën zijn puur structureel — ze dragen zelf geen eigenschappen, maar helpen bij het organiseren van gerelateerde assettypen.

Voorbeeld:

Mechanisch (categorie)
- Pomp (assettype)
- Motor (assettype)
- Klep (assettype)

U kunt een nieuwe categorie aanmaken door op de knop “Nieuw” rechtsboven op de assettypepagina te drukken.

Eigenschappen organiseren in secties

Binnen een assettype kunnen eigenschappen worden gegroepeerd in secties om de duidelijkheid en gegevensinvoer te verbeteren.
Elke sectie kan een of meer gerelateerde eigenschappen bevatten.

Voorbeeld:

Identificatie:
Technische specificaties
Bewaking & instrumentatie
Onderhoud & levenscyclus

Eigenschapdefinitie

Elke eigenschap die in een assettype is gedefinieerd, omvat:

Sleutel — de naam/identificator van de eigenschap.
Waardetype — het formaat van de gegevens die de eigenschap zal bevatten, zoals:
- Getal (zie meer details hieronder)
- Korte tekst
- Bijlage
- URL-link
- Schakelaar (boolean)
- Dropdown (voorgedefinieerde keuzes, zie meer details hieronder)
- Integratieveld (gekoppeld aan een extern systeem)

Eenheden configureren voor getalvelden

Bij het aanmaken van een nieuwe eigenschap met het waardetype ingesteld op Getal, kunt u optioneel eenheden definiëren.

Het eenhedenveld is een vrij tekstveld waarin u een willekeurig label kunt invoeren (bijv. mm, °C, kg).
De eenheidsdefinitie maakt deel uit van de configuratie van het assettype en is van toepassing op alle assets die dat type gebruiken.

Eenheden fungeren als een achtervoegsel wanneer de waarde in het metadatapaneel van de asset wordt weergegeven.

Bij het aanmaken van een nieuwe eigenschap met het waardetype ingesteld op Dropdown, verschijnt er rechts op het scherm een paneel waarmee u de dropdown-opties kunt definiëren.

Voer elke optie op een aparte regel in (druk na elke invoer op Enter).
U kunt deze opties op elk moment opnieuw bewerken door op het overloopmenu naast de eigenschap te klikken en Dropdown-opties bewerken te selecteren.

Eigenschappen verbinden met een externe integratie

Net als bij de reguliere configuratie van assettypen is het mogelijk om secties met gegevens of individuele velden aan te maken die zijn toegewezen aan integratiequery’s. Het algemene idee is dat telkens wanneer een asset van een specifiek type wordt geladen, een reeks integratiequery’s wordt gegenereerd als er koppelingen bestaan. Wanneer de integratiequery’s worden uitgevoerd, wordt het resultaat georganiseerd in secties of velden binnen het assettype.

Voordat u eigenschappen in assettypen toewijst, moet de integratie al volledig geconfigureerd zijn. Dit omvat het instellen van de integratieserver en het tot stand brengen van een verbinding met het externe systeem.

Voor stapsgewijze instructies, zie onze Documentatie over integratie-installatie.

Over integratiesecties & -velden

Assettypen ondersteunen integraties om eigenschappen automatisch te koppelen en te vullen vanuit externe systemen (bijv. ERP, CMMS). Er zijn twee hoofdmanieren om integraties te configureren: Sectie uit integratie & Integratieveld.

Het is mogelijk om een hele sectie van een integratiequery toe te wijzen aan een sectie van een assettype. Bijvoorbeeld, een query die dit object retourneert:

{
  "TankLevel": {
    "value": 73.84190097508079,
    "uom": "%",
    "_p3d_type": "urn:primitive:obj:numeric"
  },
  "TankTemperature": {
    "value": 89.4061043417307,
    "uom": "degC",
    "_p3d_type": "urn:primitive:obj:numeric"
  }
}

Kan automatisch worden toegewezen aan een sectie van een assettype om er zo uit te zien:

Indien nodig kan ook een enkele waarde uit een query worden geëxtraheerd en aan een enkel veld worden toegewezen. Bijvoorbeeld, een query die een druk van 834 kan retourneren, kan zo worden weergegeven en worden gecombineerd met reguliere assettypevelden:

Configuratiesecties uit integratie

U kunt een hele sectie aanmaken die rechtstreeks uit een integratie afkomstig is:

Selecteer Uit integratie bij het toevoegen van een nieuwe sectie.
Kies de gewenste integratiekoppeling.
Voer het JSONPath in om te definiëren welk deel van de integratiepayload aan deze sectie moet worden gebonden (zie JSONPath-toewijzing voor details).
De sectie wordt automatisch gevuld met alle eigenschappen die uit de gekoppelde integratie worden opgehaald.
Eventuele updates van de integratie worden weerspiegeld in de gegevens van de asset op basis van de synchronisatieconfiguratie.

Configuratie-integratievelden

In plaats van een hele sectie te importeren, kunt u individuele eigenschappen aan een integratie toewijzen:

Voeg een nieuwe eigenschap toe en stel het waardetype in op Integratieveld.
Kies de gewenste integratiekoppeling.
Voer het JSONPath in om te definiëren welk deel van de integratiepayload aan deze sectie moet worden gebonden (zie JSONPath-toewijzing voor details).
Alleen die eigenschap wordt gesynchroniseerd met het externe systeem.

JSONPath-toewijzing

Zowel Uit integratie-secties als Integratievelden vereisen een JSONPath om gegevens te selecteren uit de JSON-payload die door de integratiekoppeling wordt geretourneerd.

Uit integratie (JSONPath op sectieniveau):
Voer een JSONPath in dat verwijst naar het object dat u aan de hele sectie wilt binden.
Voorbeeld: $.Identification bindt het hele Identification-object uit de payload aan uw assettypesectie.
Integratievelden (JSONPath op eigenschapniveau):
Voer een JSONPath in dat verwijst naar een enkele scalaire waarde (string/getal/boolean/datum).
Voorbeeld: $.Identification.serialNumber

Wijzigingen publiceren

Het publiceren van wijzigingen heeft onmiddellijk invloed op alle bestaande RealityAssets die dat assettype gebruiken.

Bijvoorbeeld:

Het hernoemen van een eigenschap werkt deze bij voor alle gekoppelde assets.
Het verwijderen van een eigenschap verwijdert de waarde ervan uit alle gekoppelde assets.

Toegangsbeheer

Standaard kunnen alleen superbeheerders assettypen beheren.
Via rolaanpassing kunnen deze beheerdersrechten indien nodig aan aanvullende leden worden verleend.

Voordelen van het gebruik van assettypen

Consistentie — alle assets van hetzelfde type delen dezelfde eigenschapstructuur.
Doorzoekbaarheid — maakt query’s mogelijk zoals “Toon me alle pompen.”
Organisatie — categorieën en secties houden informatie duidelijk en toegankelijk.
Schaalbaarheid — werk eenvoudig eigenschapdefinities bij voor alle toekomstige assets van een type.