Mappez les flux de données industriels aux propriétés des actifs - AWS IoT SiteWise
Définir un alias de propriété (console)Définissez un alias de propriété (AWS CLI)

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Mappez les flux de données industriels aux propriétés des actifs

Vous pouvez définir un alias de propriété sur la propriété de l'actif. Cela vous aide à identifier la propriété d'un actif lorsque vous ingérez ou récupérez des données relatives à un actif. Si votre actif possède des propriétés de mesure, vous pouvez définir des alias de propriété pour mapper vos flux de données à ces propriétés de mesure.

Ce processus nécessite que vous connaissiez l'alias de votre propriété.

  • Si vous ingérez des données provenant de serveurs OPC UA à l'aide d'une source de données OPC UA dans une passerelle SiteWise Edge, votre alias de propriété est le chemin d'accès à une variable située sous le nœud Objects, en commençant / par.

    Exemple

    Si le chemin d'accès à votre variable estcompany/windfarm/3/turbine/7/temperature, l'alias de votre propriété est/company/windfarm/3/turbine/7/temperature.

    Pour plus d'informations sur l'architecture des informations de l'OPCUA, consultez la section Cartographie du modèle d'information et de l'espacement des adresses dans le manuel OPCUA Online Reference.

    Remarques

    • Si vous configurez un préfixe de flux de données pour votre source OPC UA, vous devez inclure ce préfixe dans l'alias de propriété pour tous les flux de données provenant de cette source.

      Exemple

      S'il s'/RentonWAagit d'un préfixe, l'alias précédent est/RentonWA/company/windfarm/3/turbine/7/temperature.

    • Les alias de propriété peuvent contenir jusqu'à 1 000 octets. OPCLes chemins des variables UA peuvent contenir jusqu'à 4 096 octets. Actuellement, AWS IoT SiteWise ne prend pas en charge l'ingestion de données à partir de variables OPC UA avec de longs chemins.

  • Si vous ingérez des données provenant de serveurs Modbus à l'aide d'une source de TCP données Modbus dans une passerelle SiteWise Edge, l'alias de votre propriété est le suivant :

    Modbus register set tag name

    Utilisez cette valeur pour envoyer les données de cet ensemble de registres vers une propriété d'actif.

  • Si vous ingérez des données provenant d'autres sources, par exemple à l'aide de AWS IoT règles ou du API, vous devez définir les alias de vos propriétés. Vous pouvez définir un système d'attribution de noms d'alias de propriété applicable à la configuration de votre appareil. Par exemple, si vous ingérez des données à partir d'objets AWS IoT , vous pouvez inclure le nom de l'objet dans les alias de propriété pour identifier de manière unique les flux de données. Pour plus d'informations sur cet exemple, consultez le didacticiel sur l'ingestion de données depuis AWS IoT des objets.

Les alias de propriété doivent être uniques au sein d'une région et d'un AWS compte. AWS IoT SiteWise renvoie une erreur si vous définissez un alias de propriété sur un alias qui existe déjà sur une autre propriété d'actif.

Si plusieurs sources OPC UA possèdent des chemins de flux de données identiques, ajoutez un préfixe aux chemins de chaque source pour former des alias uniques. Pour de plus amples informations, veuillez consulter OPCSources de données UA.

Note

Cette section explique comment définir des alias de propriété pour les propriétés de mesure. Pour plus d'informations sur la façon de définir des alias de propriété pour les propriétés d'état des alarmes externes, consultezCartographier les flux d'état d'alarme externes.

Définir un alias de propriété (console)

Vous pouvez utiliser la AWS IoT SiteWise console pour définir un alias pour une propriété d'actif.

Pour définir un alias de propriété (console)

  1. Accédez à la console AWS IoT SiteWise.

  2. Dans le panneau de navigation, choisissez Ressources.

  3. Choisissez la ressource pour laquelle vous souhaitez définir un alias de propriété.

    Astuce

    Vous pouvez cliquer sur l'icône en forme de flèche pour développer une hiérarchie de ressources afin de trouver votre ressource.

  4. Choisissez Modifier.

  5. Recherchez la propriété pour laquelle vous souhaitez définir un alias, puis saisissez l'alias de propriété.

    AWS IoT SiteWise Capture d'écran de la page « Modifier un actif » avec un alias de propriété surligné.

  6. Choisissez Save (Enregistrer).

Définissez un alias de propriété (AWS CLI)

Utilisez le AWS Command Line Interface (AWS CLI) pour définir un alias pour une propriété d'actif.

Vous devez connaître l'assetId de votre ressource et le propertyIdde la propriété pour effectuer cette procédure. Vous pouvez également utiliser l'identifiant externe. Si vous avez créé un actif et que vous ne le connaissez pasassetId, utilisez le ListAssetsAPIpour répertorier tous les actifs d'un modèle spécifique. Utilisez cette DescribeAssetopération pour afficher les propriétés de votre actif, y compris les propriétésIDs.

Utilisez cette UpdateAssetPropertyopération pour mapper un flux de données à la propriété de votre actif. Spécifiez les paramètres suivants :

  • assetId— L'identifiant ou l'identifiant externe de l'actif. Pour plus d’informations, consultez Objets de référence avec interface externe IDs dans le Guide de l’utilisateur AWS IoT SiteWise .

  • propertyId— L'ID ou l'ID externe de la propriété de l'actif.

  • propertyAlias— Le chemin du flux de données vers l'alias de la propriété.

  • propertyNotificationState— État de notification de la valeur de la propriété : ENABLED ouDISABLED. Spécifiez l'état de notification existant de la propriété lorsque vous mettez à jour l'alias de propriété. Vous pouvez récupérer l'état de notification existant avec l'DescribeAssetPropertyopération.

    Si vous omettez ce paramètre, le nouvel état de notification est DISABLED. Pour de plus amples informations sur les notifications de propriété, veuillez consulter Interagissez avec d'autres AWS services.

Pour définir un alias de propriété (AWS CLI)

  1. Exécutez la commande suivante pour récupérer l'état de notification actuel de la propriété. Remplacez asset-id and property-id avec les propriétés de l'actifIDs.

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

    L'opération renvoie une réponse qui contient les informations de propriété de ressource au format suivant. L'état de notification de la propriété est assetProperty.notification.state activé dans l'JSONobjet.

    {
  "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. Exécutez la commande suivante pour définir l'alias de la propriété de ressource. Remplacez property-alias avec l'alias de propriété et notification-state avec l'état de notification, ou omettez --property-notification-state de désactiver les notifications. Vous pouvez éventuellement mettre à jour l'unité de l'actif avec une nouvelle unit and --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. Pour vérifier que l'alias a été défini, exécutez la commande suivante pour récupérer les détails de la propriété. Remplacez asset-id and property-id avec les propriétés de l'actifIDs.

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

    L'opération renvoie une réponse qui contient les informations de propriété de ressource au format suivant. L'alias de propriété se trouve assetProperty.alias dans l'JSONobjet et est défini sur myAlias dans cet exemple.

    {
  "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": {}
    }
  }
}