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 modèles composites personnalisés en ligne définissent un ensemble de propriétés groupées qui s'appliquent au modèle d'actif ou au modèle de composant auquel appartient le modèle composite personnalisé. Vous les utilisez pour regrouper les propriétés associées. Ils se composent d'un nom, d'une description et d'un ensemble de propriétés du modèle d'actif. Ils ne sont pas réutilisables.

• Les modèles composites personnalisés basés sur des modèles de composants font référence à un modèle de composant que vous souhaitez inclure dans votre modèle d'actif ou de composant. Vous les utilisez pour inclure des sous-assemblages standard dans votre modèle. Ils se composent d'un nom, d'une description et de l'ID du modèle de composant auquel il fait référence. Ils n'ont aucune propriété propre ; le modèle de composant référencé fournit ses propriétés associées à tous les actifs créé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 un actif 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.

robot_model servo_status(entier) servo_position(double) powersupply_status(entier) powersupply_temperature(double) battery_status(entier) battery_charge(double)

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.

robot_model servo status(entier) position(double) powersupply status(entier) temperature(double) battery status(entier) charge(double)

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.

Note

Dans ce cas, chaque modèle composite personnalisé définit ses propres propriétés, de sorte que toutes les propriétés font partie du modèle de ressources lui-même (robot_modeldans ce cas). Ces propriétés ne sont partagées avec aucun autre modèle d'actif ou modèle de composant. Par exemple, si vous avez créé un autre modèle d'actif qui portait également le nom de modèle composite personnalisé en ligneservo, le fait d'apporter une modification au modèle interne servo n'robot_modelaffecterait pas la servo définition de l'autre modèle d'actif.

Si vous souhaitez implémenter un tel partage (par exemple, pour n'avoir qu'une seule définition pour un servo, que tous vos modèles d'actifs peuvent partager), vous devez plutôt créer un modèle de composant pour celui-ci, puis créer des modèles composites basés sur des modèles de composants qui le référencent. Consultez la section suivante pour plus de détails.

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 toute modification apportée à un modèle de composant sera répercutée 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.

servo_component_model status(entier) position(double)

powersupply_component_model status(entier) temperature(double)

battery__component_model status(entier) charge(double)

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.

robot_model servo1(référence :servo_component_model) servo2(référence :servo_component_model) servo3(référence :servo_component_model) powersupply(référence :powersupply_component_model) battery(référence :battery_component_model)

Pour plus d'informations sur la création de modèles de composants, consultezCré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).

Utilisation de chemins pour référencer les propriétés de modèles composites personnalisés

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 des chemins de propriété

Vous pouvez obtenir le chemin d'une propriété à partir du path champ de sa AssetModelpropriété.

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 appelez DescribeAssetModelCompositeModel onservo, la 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, consultezUtilisation de variables dans des 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
                                ]
                            }
                        }
                    ],
                    ...
                }
            },
            ...
        },
        ...
    ],
    ...
}