View a markdown version of this page

Création de modèles de composants - AWS IoT SiteWise
Créez un modèle de composant (AWS CLI)Exemple de modèle de composant

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.

Création de modèles de composants

Utilisez des modèles de AWS IoT SiteWise composants pour définir des sous-assemblages auxquels vous pouvez faire référence à partir de modèles d'actifs ou d'autres modèles de composants. De cette façon, vous pouvez réutiliser la définition du composant dans plusieurs autres modèles, ou plusieurs fois dans le même modèle.

Le processus de définition d'un modèle de composants est très similaire à celui d'un modèle d'actif. Tout comme un modèle d'actif, un modèle de composant possède un nom, une description et des propriétés d'actif. Cependant, les modèles de composants ne peuvent pas inclure de définitions de hiérarchie des actifs, car les modèles de composants eux-mêmes ne peuvent pas être utilisés pour créer des actifs directement. Les modèles de composants ne peuvent pas non plus définir d'alarmes.

Par exemple, vous pouvez définir un composant pour un servomoteur avec la température du moteur, la température du codeur et les propriétés de résistance d'isolement. Vous pouvez ensuite définir un modèle d'actif pour les équipements contenant des servomoteurs, tels qu'une machine CNC.

Note

  • Nous vous recommandons de modéliser votre opération en commençant par les nœuds de niveau inférieur. Par exemple, créez le composant de votre servomoteur avant de créer le modèle d'actif de votre machine CNC. Les modèles d'actifs contiennent des références à des modèles de composants existants.

  • Vous ne pouvez pas créer un actif directement à partir d'un modèle de composant. Pour créer un actif qui utilise votre composant, vous devez créer un modèle d'actif pour votre actif. Vous créez ensuite un modèle composite personnalisé pour celui-ci qui fait référence à votre composant. Pour plus d'informations sur la création de modèles d'actifs, voir Créez des modèles d'actifs dans AWS IoT SiteWise Pour plus d'informations sur la création de modèles composites personnalisés, voirCréation de modèles composites personnalisés (composants).

Les sections suivantes décrivent comment utiliser l' AWS IoT SiteWise API pour créer des modèles de composants.

Créez un modèle de composant (AWS CLI)

Vous pouvez utiliser le AWS Command Line Interface (AWS CLI) pour créer un modèle de composant.

Utilisez cette CreateAssetModel opération pour créer un modèle de composant avec des propriétés. Cette opération nécessite une charge utile ayant la structure suivante :

{
  "assetModelType": "COMPONENT_MODEL",
  "assetModelName": "String",
  "assetModelDescription": "String",
  "assetModelProperties": Array of AssetModelProperty,
}
Pour créer un modèle de composant (AWS CLI)

  1. Créez un fichier appelé, component-model-payload.json puis copiez l'objet JSON suivant dans le fichier :

    {
  "assetModelType": "COMPONENT_MODEL",
  "assetModelName": "",
  "assetModelDescription": "",
  "assetModelProperties": [

  ]
}

  2. Utilisez votre éditeur de texte JSON préféré pour modifier le fichier component-model-payload.json pour les éléments suivants :

    1. Entrez un nom (assetModelName) pour le modèle de composant, tel que Servo Motor ouServo Motor Model. Ce nom doit être unique pour tous les modèles d'actifs et les modèles de composants de votre compte sur ce site Région AWS.

    2. (Facultatif) Entrez un ID externe (assetModelExternalId) pour le modèle de composant. Il s'agit d'un identifiant défini par l'utilisateur. Pour plus d’informations, consultez Objets de référence dotés d'identifiants externes dans le Guide de l’utilisateur AWS IoT SiteWise .

    3. (Facultatif) Saisissez une description (assetModelDescription) pour le modèle de ressource ou supprimez la paire clé-valeur assetModelDescription.

    4. (Facultatif) Définissez les propriétés de l'actif (assetModelProperties) pour le modèle de composant. Pour de plus amples informations, veuillez consulter Définir les propriétés des données.

    5. (Facultatif) Ajoutez des balises (tags) pour le modèle de ressource. Pour de plus amples informations, veuillez consulter Marquez votre AWS IoT SiteWise resources.

  3. Exécutez la commande suivante pour créer un modèle de composant à partir de la définition du fichier JSON.

    aws iotsitewise create-asset-model --cli-input-json file://component-model-payload.json

    L'opération renvoie une réponse contenant les informations assetModelId auxquelles vous faites référence lorsque vous ajoutez une référence à votre modèle de composant dans un modèle d'actif ou un autre modèle de composant. La réponse contient également l'état du modèle (assetModelStatus.state), qui est initialement CREATING. L'état du modèle de composant est maintenu CREATING jusqu'à ce que les modifications se propagent.

    Note

    Le processus de création du modèle de composant peut prendre jusqu'à quelques minutes pour les modèles complexes. Pour vérifier l'état actuel de votre modèle de composant, utilisez l'DescribeAssetModelopération en spécifiant leassetModelId. Une fois le statut du modèle de composant définiACTIVE, vous pouvez ajouter des références à votre modèle de composant dans les modèles d'actifs ou d'autres modèles de composants. Pour de plus amples informations, veuillez consulter État des ressources et des modèles.

  4. (Facultatif) Créez des modèles composites personnalisés pour votre modèle de composant. Avec les modèles composites personnalisés, vous pouvez regrouper des propriétés au sein du modèle ou inclure un sous-assemblage en faisant référence à un autre modèle de composant. Pour de plus amples informations, veuillez consulter Création de modèles composites personnalisés (composants).

Exemple de modèle de composant

Cette section contient un exemple de définition de modèle de composant que vous pouvez utiliser pour créer un modèle de composant à l'aide des AWS IoT SiteWise kits SDK AWS CLI et. Ce modèle de composant représente un servomoteur qui peut être utilisé dans un autre équipement, tel qu'une machine CNC.

Modèle de composant de servomoteur

Le modèle de composant suivant représente un servomoteur qui peut être utilisé dans des équipements tels que des machines CNC. Le servomoteur fournit diverses mesures, telles que les températures et la résistance électrique. Ces mesures sont disponibles sous forme de propriétés sur les actifs créées à partir de modèles d'actifs qui font référence au modèle de composant du servomoteur.

{
    "assetModelName": "ServoMotor",
    "assetModelType": "COMPONENT_MODEL",
    "assetModelProperties": [
        {
            "dataType": "DOUBLE",
            "name": "Servo Motor Temperature",
            "type": {
            "measurement": {}
            },
            "unit": "Celsius"
        },
        {
            "dataType": "DOUBLE",
            "name": "Spindle speed",
            "type": {
            "measurement": {}
            },
            "unit": "rpm"
        }
    ]
}