Création de modèles composites personnalisés (composants)

Les modèles composites personnalisés, ou composants si vous utilisez la console, fournissent un autre niveau d'organisation pour vos modèles d'actifs et vos modèles de composants. Vous pouvez les utiliser pour structurer vos modèles en regroupant les propriétés ou en référençant d'autres modèles. Pour plus d'informations sur l'utilisation de modèles composites personnalisés, consultezModèles composites personnalisés (composants).

Vous créez un modèle composite personnalisé au sein d'un modèle d'actif ou d'un modèle de composant existant. Il existe deux types de modèles composites personnalisés. Pour regrouper les propriétés associées au sein d'un modèle, vous pouvez créer un modèle composite personnalisé en ligne. Pour référencer un modèle de composant dans votre modèle d'actif ou de composant, vous pouvez créer un modèle composite component-model-basedpersonnalisé.

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

Création d'un composant en ligne (console)

Vous pouvez utiliser la AWS IoT SiteWise console pour créer un composant en ligne qui définit ses propres propriétés.

Note

Comme il s'agit d'un composant intégré, ces propriétés ne s'appliquent qu'au modèle d'actif actuel et ne sont partagées nulle part ailleurs.

Si vous devez produire un modèle réutilisable (par exemple, pour le partager entre plusieurs modèles d'actifs ou pour inclure plusieurs instances au sein d'un même modèle d'actif), vous devez plutôt créer un composant basé sur un modèle de composant. Consultez la section suivante pour plus de détails.

Pour créer un composant (console)

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

2. Dans le panneau de navigation, choisissez Models (Modèles).

3. Choisissez le modèle d'actif auquel vous souhaitez ajouter un composant.

4. Dans l'onglet Propriétés, sélectionnez Composants.

5. Choisissez Créer un composant.

6. Sur la page Créer un composant, procédez comme suit :

   1. Entrez un nom pour le composant, tel que ServoMotor ouServoMotor Model. Ce nom doit être unique pour tous les composants de votre compte dans cette région.

   2. (Facultatif) Ajoutez des définitions d'attributs pour le modèle. Les attributs représentent des informations qui changent rarement. Pour plus d’informations, consultez Définition de données statiques (attributs).

   3. (Facultatif) Ajoutez des définitions de mesures pour le modèle. Les mesures représentent des flux de données provenant de votre équipement. Pour plus d’informations, consultez Définition des flux de données provenant des équipements (mesures).

   4. (Facultatif) Ajoutez des définitions de transformations pour le modèle. Les transformations sont des formules qui font correspondre les données d'un formulaire à un autre. Pour plus d’informations, consultez Transformation des données (transformations).

   5. (Facultatif) Ajoutez des définitions de métriques pour le modèle. Les métriques sont des formules qui regroupent les données sur des intervalles de temps. Les métriques peuvent saisir des données provenant des actifs associés, afin que vous puissiez calculer des valeurs représentant votre activité ou un sous-ensemble de celle-ci. Pour plus d’informations, consultez Agrégation de données provenant de propriétés et d'autres actifs (métriques).

   6. Choisissez Créer un composant.

Création d'un modèle composite personnalisé en ligne ()AWS CLI

Vous pouvez utiliser le AWS Command Line Interface (AWS CLI) pour créer un modèle composite personnalisé en ligne qui définit ses propres propriétés.

Utilisez cette CreateAssetModelCompositeModelopération pour créer un modèle en ligne avec des propriétés. Cette opération attend une charge utile avec la structure suivante.

Note

Comme il s'agit d'un modèle composite en ligne, ces propriétés ne s'appliquent qu'au modèle d'actif actuel et ne sont partagées nulle part ailleurs. Ce qui le rend « intégré », c'est qu'il ne fournit pas de valeur pour le composedAssetModelId champ.

Si vous devez produire un modèle réutilisable (par exemple, pour le partager entre plusieurs modèles d'actifs ou pour inclure plusieurs instances au sein d'un même modèle d'actif), vous devez plutôt créer un modèle component-model-basedcomposite. Consultez la section suivante pour plus de détails.

{
    "assetModelCompositeModelName": "CNCLathe_ServoMotorA",
    "assetModelCompositeModelType": "CUSTOM",
    "assetModelCompositeModelProperties": [
        {
            "dataType": "DOUBLE",
            "name": "Servo Motor Temperature",
            "type": {
            "measurement": {}
            },
            "unit": "Celsius"
        },
        {
            "dataType": "DOUBLE",
            "name": "Spindle speed",
            "type": {
            "measurement": {}
            },
            "unit": "rpm"
        }
    ]
}

Création d'un component-model-based composant (console)

Vous pouvez utiliser la AWS IoT SiteWise console pour créer un composant à partir d'un modèle de composant.

Pour créer un component-model-based composant (console)

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

2. Dans le panneau de navigation, choisissez Models (Modèles).

3. Choisissez le modèle d'actif auquel vous souhaitez ajouter un composant.

4. Dans l'onglet Propriétés, sélectionnez Composants.

5. Choisissez Créer un composant.

6. Sur la page Créer un composant, procédez comme suit :

   1. Sélectionnez le modèle de composant sur lequel vous souhaitez baser le composant.

   2. Entrez un nom pour le composant, tel que ServoMotor ouServoMotor Model. Ce nom doit être unique pour tous les composants de votre compte dans cette région.

   3. Choisissez Créer un composant.

Création d'un modèle composite component-model-based personnalisé (AWS CLI)

Vous pouvez utiliser le AWS CLI pour créer un modèle composite component-model-based personnalisé au sein de votre modèle d'actif. Un modèle composite component-model-based personnalisé est une référence à un modèle de composant que vous avez déjà défini ailleurs.

Utilisez cette CreateAssetModelCompositeModelopération pour créer un modèle composite component-model-based personnalisé. Cette opération attend une charge utile avec la structure suivante.

Note

Dans cet exemple, la valeur de composedAssetModelId est l'ID du modèle d'actif ou l'ID externe d'un modèle de composant existant. Pour plus d’informations, consultez Référencement d'objets avec des identifiants externes dans le Guide de l’utilisateur AWS IoT SiteWise . Pour un exemple de création d'un modèle de composant, consultezCréation d'un modèle de composant (AWS CLI).

{
    "assetModelCompositeModelName": "CNCLathe_ServoMotorA",
    "assetModelCompositeModelType": "CUSTOM",
    "composedAssetModelId": component model ID
]

Comme il ne s'agit que d'une référence, un modèle composite component-model-based personnalisé ne possède aucune propriété propre, à part un nom.

Si vous souhaitez ajouter plusieurs instances du même composant à votre modèle d'actif (par exemple, une machine CNC dotée de plusieurs servomoteurs), vous pouvez ajouter plusieurs modèles composites component-model-based personnalisés portant chacun leur propre nom mais faisant tous référence au mêmecomposedAssetModelId.

Vous pouvez imbriquer des composants dans d'autres composants. Pour ce faire, vous pouvez ajouter un modèle component-model-based composite, comme indiqué dans cet exemple, à l'un de vos modèles de composants.