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.

Modèles composites personnalisés (composants)

Lorsque vous modélisez un actif industriel particulièrement complexe, tel qu'une machine complexe comportant de nombreuses pièces, il peut être difficile de garder vos modèles d'actifs organisés et maintenables.

Dans ce cas, vous pouvez ajouter des modèles composites personnalisés, ou des composants si vous utilisez la console, à vos modèles d'actifs et modèles de composants existants. Ils vous aident à rester organisé en regroupant les propriétés associées et en réutilisant les définitions de sous-composants.

Il existe deux types de modèles composites personnalisés :

Les sections suivantes montrent comment utiliser des modèles composites personnalisés dans vos conceptions.

Modèles composites personnalisés en ligne

Les modèles composites personnalisés en ligne permettent d'organiser votre modèle d'actifs en regroupant les propriétés associées.

Supposons, par exemple, que vous souhaitiez modéliser une ressource robotique. Le robot comprend un servomoteur, une alimentation électrique et une batterie. Chacun de ces éléments constitutifs possède ses propres propriétés que vous souhaitez inclure dans le modèle. Vous pouvez définir un modèle d'actif appelé robot_model qui possède des propriétés telles que les suivantes.

Toutefois, dans certains cas, il peut y avoir de nombreux sous-assemblages ou les sous-assemblages eux-mêmes peuvent avoir de nombreuses propriétés. Dans ces cas, le nombre de propriétés peut être tel qu'il devient difficile de les référencer et de les gérer dans une seule liste plate à la racine du modèle, comme dans l'exemple précédent.

Pour faire face à de telles situations, vous pouvez utiliser un modèle composite personnalisé en ligne pour regrouper les propriétés. Un modèle composite personnalisé en ligne est un modèle composite personnalisé qui définit ses propres propriétés. Par exemple, vous pouvez modéliser votre robot comme suit.

Dans l'exemple précédent, servopowersupply, et battery sont les noms des modèles composites personnalisés en ligne définis dans le modèle robot_model d'actif. Chacun de ces modèles composites définit ensuite ses propres propriétés.

Pour plus d'informations sur la création de modèles composites personnalisés en ligne, consultezCréation de modèles composites personnalisés (composants).

Modèles composites omponent-model-based personnalisés C

Vous pouvez créer un modèle de composant AWS IoT SiteWise pour définir un sous-assemblage standard réutilisable. Une fois que vous avez créé un modèle de composant, vous pouvez y ajouter des références dans vos autres modèles d'actifs et modèles de composants. Pour ce faire, ajoutez un modèle composite component-model-based personnalisé à n'importe quel modèle dans lequel vous souhaitez référencer le composant. Vous pouvez ajouter des références à votre composant à partir de nombreux modèles ou à plusieurs reprises dans le même modèle.

De cette façon, vous pouvez éviter de dupliquer les mêmes définitions entre les modèles. Cela simplifie également la maintenance de vos modèles, car toutes les modifications que vous apportez à un modèle de composant seront répercutées sur tous les modèles d'actifs qui l'utilisent.

Supposons, par exemple, que votre installation industrielle possède de nombreux types d'équipements qui utilisent tous le même type de servomoteur. Certains d'entre eux ont de nombreux servomoteurs dans un seul équipement. Vous créez un modèle d'actif pour chaque type d'équipement, mais vous ne souhaitez pas dupliquer la définition à servo chaque fois. Vous souhaitez le modéliser une seule fois et l'utiliser dans vos différents modèles d'actifs. Si vous modifiez ultérieurement la définition deservo, elle sera mise à jour pour tous vos modèles et actifs.

Pour modéliser le robot de l'exemple précédent de cette manière, vous pouvez définir des servomoteurs, des alimentations et des batteries en tant que modèles de composants, comme ceci.

Vous pouvez ensuite définir des modèles d'actifsrobot_model, tels que ceux qui font référence à ces composants. Plusieurs modèles d'actifs peuvent faire référence au même modèle de composant. Vous pouvez également référencer le même modèle de composant plusieurs fois dans un même modèle d'actif, par exemple si votre robot comporte plusieurs servomoteurs.

Pour plus d'informations sur la création de modèles de composants, reportez-vous àCréation de modèles de composants.

Pour plus d'informations sur la façon de référencer vos modèles de composants dans d'autres modèles, consultezCréation de modèles composites personnalisés (composants).

Utiliser des chemins pour référencer les propriétés personnalisées du modèle composite

Lorsque vous créez une propriété sur un modèle d'actif, un modèle de composant ou un modèle composite personnalisé, vous pouvez la référencer à partir d'autres propriétés qui utilisent sa valeur, telles que les transformations et les métriques.

AWS IoT SiteWise vous propose différentes manières de référencer votre propriété. La méthode la plus simple consiste souvent à utiliser son identifiant de propriété. Toutefois, si la propriété que vous souhaitez référencer se trouve sur un modèle composite personnalisé, il peut être préférable de la référencer par chemin.

Un chemin est une séquence ordonnée de segments de chemin qui spécifie une propriété en termes de position parmi les modèles composites imbriqués au sein d'un modèle d'actif et d'un modèle composite.

Obtenir les chemins des propriétés

Vous pouvez obtenir le chemin d'une propriété à partir du path champ correspondant AssetModelProperty.

Supposons, par exemple, que vous disposiez d'un modèle robot_model d'actif contenant un modèle servo composite personnalisé doté d'une propriétéposition. Si vous appelezservo, DescribeAssetModelCompositeModella position propriété listera un path champ qui ressemble à ceci :

"path": [
    {
       "id": "asset model ID",
       "name": "robot_model"
    },
    {
       "id": "composite model ID",
       "name": "servo"
    },
    {
       "id": "property ID",
       "name": "position"
    }
]

Utilisation des chemins de propriété

Vous pouvez utiliser un chemin de propriété lorsque vous définissez une propriété qui fait référence à d'autres propriétés, telles qu'une transformation ou une métrique.

Une propriété utilise une variable pour référencer une autre propriété. Pour plus d'informations sur l'utilisation des variables, consultezUtiliser des variables dans les expressions de formule.

Lorsque vous définissez une variable pour référencer une propriété, vous pouvez utiliser l'ID de la propriété ou son chemin.

Pour définir une variable qui utilise le chemin de la propriété référencée, spécifiez le propertyPath champ de sa valeur.

Par exemple, pour définir un modèle d'actif dont une métrique fait référence à une propriété à l'aide d'un chemin, vous pouvez transmettre une charge utile comme celle-ci à CreateAssetModel:

{
    ...
    "assetModelProperties": [
        {
            ...
            "type": {
                "metric": {
                    ...
                    "variables": [
                        {
                            "name": "variable name",
                            "value": {
                                "propertyPath": [
                                    path segments
                                ]
                            }
                        }
                    ],
                    ...
                }
            },
            ...
        },
        ...
    ],
    ...
}