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éez des modèles d'actifs dans AWS IoT SiteWise
AWS IoT SiteWise les modèles d'actifs favorisent la standardisation de vos données industrielles. Un modèle de ressource contient un nom, une description, des propriétés de ressource et des définitions de hiérarchie de ressources. Par exemple, vous pouvez définir un modèle d'éolienne avec des propriétés de température, de rotation par minute (tr/min) et de puissance. Ensuite, vous pouvez définir un modèle de parc éolien avec une propriété de puissance de sortie nette et une définition de hiérarchie d'éoliennes.
**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 votre modèle d'éolienne avant de créer votre modèle de parc éolien. Les définitions de hiérarchie des ressources contiennent des références à des modèles de ressources existants. En suivant cette approche, vous pouvez définir des hiérarchies de ressources lors de la création de vos modèles.
Les modèles d'actifs ne peuvent pas contenir d'autres modèles d'actifs. Si vous devez définir un modèle auquel vous pouvez faire référence en tant que sous-assemblage au sein d'un autre modèle, vous devez plutôt créer un modèle composant-->. Pour de plus amples informations, veuillez consulter [Création de modèles de composants](create-component-models.md).
Les sections suivantes décrivent comment utiliser la AWS IoT SiteWise console ou l'API pour créer des modèles d'actifs. Les sections suivantes décrivent également les différents types de propriétés et de hiérarchies de ressources que vous pouvez utiliser pour créer des modèles.
**Topics**
+ [Création d'un modèle d'actif (console)](#create-asset-model-console)
+ [Création d'un modèle d'actifs (AWS CLI)](#create-asset-model-cli)
+ [Exemples de modèles de ressources](#asset-model-examples)
+ [Définir les hiérarchies des modèles d'actifs](define-asset-hierarchies.md)
## Création d'un modèle d'actif (console)
Vous pouvez utiliser la AWS IoT SiteWise console pour créer un modèle d'actif. La AWS IoT SiteWise console fournit diverses fonctionnalités, telles que la saisie automatique des formules, qui peuvent vous aider à définir des modèles d'actifs valides.
**Pour créer un modèle de ressource (console)**
1. Accédez à la [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. Dans le panneau de navigation, choisissez **Models (Modèles)**.
1. Choisissez **Créer un modèle d'actif**.
1. Sur la page **Créer un modèle**, procédez comme suit :
1. Saisissez un **nom** pour le modèle de ressource, tel que **Wind Turbine** ou **Wind Turbine Model**. Ce nom doit être unique pour tous les modèles de votre compte dans cette région.
1. (Facultatif) Ajoutez un **ID externe** pour le modèle. Il s'agit d'un identifiant défini par l'utilisateur. Pour plus d’informations, consultez [Objets de référence avec interface externe IDs](object-ids.md#external-id-references) dans le *Guide de l’utilisateur AWS IoT SiteWise *.
1. (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 de plus amples informations, veuillez consulter [Définir les flux de données provenant de l'équipement (mesures)](measurements.md).
1. (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 de plus amples informations, veuillez consulter [Transformer les données (transformations)](transforms.md).
1. (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 de plus amples informations, veuillez consulter [Données agrégées provenant de propriétés et d'autres actifs (métriques)](metrics.md).
1. (Facultatif) Ajoutez des **définitions de hiérarchies** pour le modèle. Les hiérarchies sont des relations entre les actifs. Pour de plus amples informations, veuillez consulter [Définir les hiérarchies des modèles d'actifs](define-asset-hierarchies.md).
1. (Facultatif) Ajoutez des balises pour le modèle de ressource. Pour de plus amples informations, veuillez consulter [Marquez vos AWS IoT SiteWise ressources](tag-resources.md).
1. Sélectionnez **Créer un modèle**.
Lorsque vous créez un modèle de ressource, la AWS IoT SiteWise console accède à la page du nouveau modèle. Sur cette page, vous pouvez voir l’**état** du modèle, qui est initialement **CRÉATION**. Cette page est automatiquement mise à jour, de sorte que vous pouvez attendre la mise à jour de l'état du modèle.
**Note**
Le processus de création de modèles de ressources peut prendre jusqu'à quelques minutes pour les modèles complexes. Une fois que le statut du modèle d'**actif est ACTIF**, vous pouvez utiliser le modèle d'actif pour créer des actifs. Pour de plus amples informations, veuillez consulter [État des ressources et des modèles](asset-and-model-states.md).
1. (Facultatif) Après avoir créé votre modèle d'actif, vous pouvez configurer votre modèle d'actif pour la périphérie. Pour plus d'informations sur SiteWise Edge, consultez[Configuration des fonctionnalités Edge sur AWS IoT SiteWise Edge](edge-data-collection-and-processing.md).
1. Sur la page du modèle, choisissez **Configurer pour Edge**.
**Note**
La fonctionnalité du pack de traitement des données (DPP) n’est plus disponible pour les nouveaux clients. Les clients existants peuvent continuer à utiliser le service normalement. Pour plus d’informations, consultez [Data processing pack availability change](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-dpp-availability-change.html).
1. Sur la page de configuration du modèle, choisissez la configuration des bords pour votre modèle. Cela contrôle les endroits où les propriétés associées à ce modèle d'actif AWS IoT SiteWise peuvent être calculées et stockées. Pour plus d'informations sur la configuration de votre modèle pour le bord, consultez[Configuration d'une source OPC UA dans Edge SiteWise](configure-opcua-source.md).
1. Pour la **configuration personnalisée de la périphérie**, choisissez l'emplacement où vous AWS IoT SiteWise souhaitez calculer et stocker chacune des propriétés de votre modèle d'actifs.
**Note**
Les transformations et les métriques associées doivent être configurées pour le même emplacement. Pour plus d'informations sur la configuration de votre modèle pour le bord, consultez[Configuration d'une source OPC UA dans Edge SiteWise](configure-opcua-source.md).
1. Choisissez **Enregistrer**. Sur la page du modèle, votre **configuration Edge** doit maintenant être **configurée**.
## Création d'un modèle d'actifs (AWS CLI)
Vous pouvez utiliser le AWS Command Line Interface (AWS CLI) pour créer un modèle d'actif.
Utilisez l'opération [CreateAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAssetModel.html) pour créer un modèle de ressource avec des propriétés et des hiérarchies. Cette opération attend une charge utile avec la structure suivante.
```
{
"assetModelType": "ASSET_MODEL",
"assetModelName": "String",
"assetModelDescription": "String",
"assetModelProperties": Array of AssetModelProperty,
"assetModelHierarchies": Array of AssetModelHierarchyDefinition
}
```
**Pour créer un modèle d'actif (AWS CLI)**
1. Créez un fichier nommé `asset-model-payload.json` et copiez l'objet JSON suivant dans le fichier.
```
{
"assetModelType": "ASSET_MODEL",
"assetModelName": "",
"assetModelDescription": "",
"assetModelProperties": [
],
"assetModelHierarchies": [
],
"assetModelCompositeModels": [
]
}
```
1. Utilisez votre éditeur de texte JSON préféré pour modifier le fichier `asset-model-payload.json` pour les éléments suivants :
1. Saisissez un nom (`assetModelName`) pour le modèle de ressource, tel que **Wind Turbine** ou **Wind Turbine Model**. Ce nom doit être unique pour tous les modèles d'actifs et modèles de composants de votre compte dans ce cas Région AWS.
1. (Facultatif) Entrez un ID externe (`assetModelExternalId`) pour le modèle d'actif. Il s'agit d'un identifiant défini par l'utilisateur. Pour plus d’informations, consultez [Objets de référence avec interface externe IDs](object-ids.md#external-id-references) dans le *Guide de l’utilisateur AWS IoT SiteWise *.
1. (Facultatif) Saisissez une description (`assetModelDescription`) pour le modèle de ressource ou supprimez la paire clé-valeur `assetModelDescription`.
1. (Facultatif) Définissez les propriétés de ressources (`assetModelProperties`) pour le modèle. Pour de plus amples informations, veuillez consulter [Définir les propriétés des données](asset-properties.md).
1. (Facultatif) Définissez les hiérarchies de ressources (`assetModelHierarchies`) pour le modèle. Pour de plus amples informations, veuillez consulter [Définir les hiérarchies des modèles d'actifs](define-asset-hierarchies.md).
1. (Facultatif) Définissez les alarmes pour le modèle. Les alarmes surveillent d'autres propriétés afin que vous puissiez identifier les équipements ou les processus nécessitant une attention particulière. Chaque définition d'alarme est un modèle composite (`assetModelCompositeModels`) qui normalise l'ensemble de propriétés utilisées par l'alarme. Pour plus d’informations, consultez [Surveillez les données avec des alarmes AWS IoT SiteWise](industrial-alarms.md) et [Définissez des alarmes sur les modèles d'actifs dans AWS IoT SiteWise](define-alarms.md).
1. (Facultatif) Ajoutez des balises (`tags`) pour le modèle de ressource. Pour de plus amples informations, veuillez consulter [Marquez vos AWS IoT SiteWise ressources](tag-resources.md).
1. Exécutez la commande suivante pour créer un modèle de ressource à partir de la définition du fichier JSON.
```
aws iotsitewise create-asset-model --cli-input-json file://asset-model-payload.json
```
L'opération renvoie une réponse qui contient l'élément `assetModelId` auquel vous faites référence lors de la création d'une ressource. La réponse contient également l'état du modèle (`assetModelStatus.state`), qui est initialement `CREATING`. L'état du modèle de ressource correspond à `CREATING` jusqu'à ce que les modifications se propagent.
**Note**
Le processus de création de modèles de ressources peut prendre jusqu'à quelques minutes pour les modèles complexes. Pour vérifier l'état actuel de votre modèle d'actif, utilisez l'[DescribeAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModel.html)opération en spécifiant le`assetModelId`. Une fois que le statut du modèle de ressource est `ACTIVE`, vous pouvez l'utiliser pour créer des ressources. Pour de plus amples informations, veuillez consulter [État des ressources et des modèles](asset-and-model-states.md).
1. (Facultatif) Créez des modèles composites personnalisés pour votre modèle d'actif. Avec les modèles composites personnalisés, vous pouvez regrouper les propriétés au sein du modèle ou inclure un sous-assemblage en faisant référence à un modèle de composant. Pour de plus amples informations, veuillez consulter [Création de modèles composites personnalisés (composants)](create-custom-composite-models.md).
## Exemples de modèles de ressources
Cette section contient des exemples de définitions de modèles d'actifs que vous pouvez utiliser pour créer des modèles d'actifs avec le AWS CLI et AWS IoT SiteWise SDKs. Ces modèles d'actifs représentent une éolienne et un parc éolien. Les actifs des éoliennes ingèrent les données brutes des capteurs et calculent des valeurs telles que la puissance et la vitesse moyenne du vent. Les actifs du parc éolien calculent des valeurs telles que la puissance totale de toutes les éoliennes du parc éolien.
**Topics**
+ [Modèle de ressource d’éolienne](#example-wind-turbine)
+ [Modèle de ressource de parc éolien](#example-wind-farm)
### Modèle de ressource d’éolienne
Le modèle de ressource suivant représente une éolienne dans un parc éolien. L'éolienne ingère les données des capteurs pour calculer des valeurs telles que la puissance et la vitesse moyenne du vent.
**Note**
Cet exemple de modèle ressemble au modèle d'éolienne de la AWS IoT SiteWise démo. Pour de plus amples informations, veuillez consulter [Utiliser la AWS IoT SiteWise démo](getting-started-demo.md).
```
{
"assetModelType": "ASSET_MODEL",
"assetModelName": "Wind Turbine Asset Model",
"assetModelDescription": "Represents a turbine in a wind farm.",
"assetModelProperties": [
{
"name": "Location",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "Renton"
}
}
},
{
"name": "Make",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "Amazon"
}
}
},
{
"name": "Model",
"dataType": "INTEGER",
"type": {
"attribute": {
"defaultValue": "500"
}
}
},
{
"name": "Torque (KiloNewton Meter)",
"dataType": "DOUBLE",
"unit": "kNm",
"type": {
"measurement": {}
}
},
{
"name": "Wind Direction",
"dataType": "DOUBLE",
"unit": "Degrees",
"type": {
"measurement": {}
}
},
{
"name": "RotationsPerMinute",
"dataType": "DOUBLE",
"unit": "RPM",
"type": {
"measurement": {}
}
},
{
"name": "Wind Speed",
"dataType": "DOUBLE",
"unit": "m/s",
"type": {
"measurement": {}
}
},
{
"name": "RotationsPerSecond",
"dataType": "DOUBLE",
"unit": "RPS",
"type": {
"transform": {
"expression": "rpm / 60",
"variables": [
{
"name": "rpm",
"value": {
"propertyId": "RotationsPerMinute"
}
}
]
}
}
},
{
"name": "Overdrive State",
"dataType": "DOUBLE",
"type": {
"transform": {
"expression": "gte(torque, 3)",
"variables": [
{
"name": "torque",
"value": {
"propertyId": "Torque (KiloNewton Meter)"
}
}
]
}
}
},
{
"name": "Average Power",
"dataType": "DOUBLE",
"unit": "Watts",
"type": {
"metric": {
"expression": "avg(torque) * avg(rps) * 2 * 3.14",
"variables": [
{
"name": "torque",
"value": {
"propertyId": "Torque (Newton Meter)"
}
},
{
"name": "rps",
"value": {
"propertyId": "RotationsPerSecond"
}
}
],
"window": {
"tumbling": {
"interval": "5m"
}
}
}
}
},
{
"name": "Average Wind Speed",
"dataType": "DOUBLE",
"unit": "m/s",
"type": {
"metric": {
"expression": "avg(windspeed)",
"variables": [
{
"name": "windspeed",
"value": {
"propertyId": "Wind Speed"
}
}
],
"window": {
"tumbling": {
"interval": "5m"
}
}
}
}
},
{
"name": "Torque (Newton Meter)",
"dataType": "DOUBLE",
"unit": "Nm",
"type": {
"transform": {
"expression": "knm * 1000",
"variables": [
{
"name": "knm",
"value": {
"propertyId": "Torque (KiloNewton Meter)"
}
}
]
}
}
},
{
"name": "Overdrive State Time",
"dataType": "DOUBLE",
"unit": "Seconds",
"type": {
"metric": {
"expression": "statetime(overdrive_state)",
"variables": [
{
"name": "overdrive_state",
"value": {
"propertyId": "Overdrive State"
}
}
],
"window": {
"tumbling": {
"interval": "5m"
}
}
}
}
}
],
"assetModelHierarchies": []
}
```
### Modèle de ressource de parc éolien
Le modèle de ressource suivant représente un parc éolien qui comprend plusieurs éoliennes. Ce modèle d'actif définit une [hiérarchie](define-asset-hierarchies.md) par rapport au modèle d'éolienne. Cela permet au parc éolien de calculer des valeurs (telles que la puissance moyenne) à partir des données de toutes les éoliennes du parc éolien.
**Note**
Cet exemple de modèle ressemble au modèle de parc éolien présenté dans la AWS IoT SiteWise démo. Pour de plus amples informations, veuillez consulter [Utiliser la AWS IoT SiteWise démo](getting-started-demo.md).
Ce modèle de ressource dépend du [Modèle de ressource d’éolienne](#example-wind-turbine). Remplacez les valeurs `propertyId` et `childAssetModelId` par celles d'un modèle de ressource d'éolienne existant.
```
{
"assetModelName": "Wind Farm Asset Model",
"assetModelDescription": "Represents a wind farm.",
"assetModelProperties": [
{
"name": "Code",
"dataType": "INTEGER",
"type": {
"attribute": {
"defaultValue": "300"
}
}
},
{
"name": "Location",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "Renton"
}
}
},
{
"name": "Reliability Manager",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "Mary Major"
}
}
},
{
"name": "Total Overdrive State Time",
"dataType": "DOUBLE",
"unit": "seconds",
"type": {
"metric": {
"expression": "sum(overdrive_state_time)",
"variables": [
{
"name": "overdrive_state_time",
"value": {
"propertyId": "ID of Overdrive State Time property in Wind Turbine Asset Model",
"hierarchyId": "Turbine Asset Model"
}
}
],
"window": {
"tumbling": {
"interval": "5m"
}
}
}
}
},
{
"name": "Total Average Power",
"dataType": "DOUBLE",
"unit": "Watts",
"type": {
"metric": {
"expression": "sum(turbine_avg_power)",
"variables": [
{
"name": "turbine_avg_power",
"value": {
"propertyId": "ID of Average Power property in Wind Turbine Asset Model",
"hierarchyId": "Turbine Asset Model"
}
}
],
"window": {
"tumbling": {
"interval": "5m"
}
}
}
}
}
],
"assetModelHierarchies": [
{
"name": "Turbine Asset Model",
"childAssetModelId": "ID of Wind Turbine Asset Model"
}
]
}
```
# Définir les hiérarchies des modèles d'actifs
Vous pouvez définir des hiérarchies de modèles d'actifs afin de créer des associations logiques entre les modèles d'actifs de votre exploitation industrielle. Par exemple, vous pouvez définir un parc éolien composé de parcs éoliens terrestres et offshore. Un parc éolien terrestre comprend une turbine et un emplacement à terre. Un parc éolien en mer contient une turbine et un emplacement en mer.
![\[AWS IoT SiteWise hiérarchies des parcs éoliens entre les modèles d'actifs.\]](http://docs.aws.amazon.com/fr_fr/iot-sitewise/latest/userguide/images/asset-model-hierarchies.png)
Lorsque vous associez un modèle d'actif enfant à un modèle d'actif parent par le biais d'une hiérarchie, les métriques du modèle d'actif parent peuvent entrer des données à partir des métriques du modèle d'actif enfant. Vous pouvez utiliser les hiérarchies et les métriques des modèles d'actifs pour calculer des statistiques qui fournissent un aperçu de votre activité ou d'un sous-ensemble de celle-ci. Pour de plus amples informations, veuillez consulter [Données agrégées provenant de propriétés et d'autres actifs (métriques)](metrics.md).
Chaque hiérarchie définit une relation entre un modèle d'actif parent et un modèle d'actif enfant. Dans un modèle d'actif parent, vous pouvez définir plusieurs hiérarchies pour le même modèle d'actif enfant. Par exemple, si vous avez deux types d'éoliennes différents dans vos parcs éoliens, où toutes les éoliennes sont représentées par le même modèle d'actif, vous pouvez définir une hiérarchie pour chaque type. Vous pouvez ensuite définir des mesures dans le modèle de parc éolien afin de calculer des statistiques indépendantes et combinées pour chaque type d'éolienne.
Un modèle d'actif parent peut être associé à plusieurs modèles d'actifs enfants. Par exemple, si vous avez un parc éolien terrestre et un parc éolien offshore représentés par deux modèles d'actifs différents, vous pouvez associer ces modèles d'actifs au même modèle d'actif de parc éolien parent.
Un modèle d'actif enfant peut également être associé à plusieurs modèles d'actifs parents. Par exemple, si vous avez deux types de parcs éoliens différents, où toutes les éoliennes sont représentées par le même modèle d'actif, vous pouvez associer le modèle d'actif d'éolienne à différents modèles d'actifs de parcs éoliens.
**Note**
Lorsque vous définissez une hiérarchie de modèles d'actifs, le modèle d'actif enfant doit être `ACTIVE` ou avoir une `ACTIVE` version précédente. Pour de plus amples informations, veuillez consulter [État des ressources et des modèles](asset-and-model-states.md).
Après avoir défini des modèles de ressources hiérarchiques et créé des ressources, vous pouvez associer les ressources pour terminer la relation parent-enfant. Pour plus d’informations, consultez [Créez des actifs pour les modèles d'actifs dans AWS IoT SiteWise](create-assets.md) et [Associer et dissocier des actifs](add-associated-assets.md).
**Topics**
+ [Définition de hiérarchies de modèles d'actifs (console)](#define-asset-hierarchies-console)
+ [Définir des hiérarchies d'actifs ()AWS CLI](#define-asset-hierarchies-cli)
## Définition de hiérarchies de modèles d'actifs (console)
Lorsque vous définissez une hiérarchie pour un modèle d'actif dans la AWS IoT SiteWise console, vous spécifiez les paramètres suivants :
+ **Nom** de la hiérarchie : nom de la hiérarchie, par exemple**Wind Turbines**.
+ **Modèle hiérarchique : modèle** d'actif enfant.
+ **ID externe de hiérarchie** (facultatif) : il s'agit d'un identifiant défini par l'utilisateur. Pour plus d’informations, consultez [Objets de référence avec interface externe IDs](object-ids.md#external-id-references) dans le *Guide de l’utilisateur AWS IoT SiteWise *.
Pour de plus amples informations, veuillez consulter [Création d'un modèle d'actif (console)](create-asset-models.md#create-asset-model-console).
## Définir des hiérarchies d'actifs ()AWS CLI
Lorsque vous définissez une hiérarchie pour un modèle d'actif à l'aide de l' AWS IoT SiteWise API, vous spécifiez les paramètres suivants :
+ `name`— Le nom de la hiérarchie, par exemple**Wind Turbines**.
+ `childAssetModelId`— L'ID ou l'ID externe du modèle d'actif enfant pour la hiérarchie. Vous pouvez utiliser cette [ListAssetModels](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssetModels.html)opération pour trouver l'ID d'un modèle d'actif existant.
**Example Exemple de définition de hiérarchie**
L'exemple suivant illustre une hiérarchie de modèles d'actifs qui représente la relation entre un parc éolien et les éoliennes. Cet objet est un exemple de [AssetModelHierarchy](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_AssetModelHierarchy.html). Pour de plus amples informations, veuillez consulter [Création d'un modèle d'actifs (AWS CLI)](create-asset-models.md#create-asset-model-cli).
```
{
...
"assetModelHierarchies": [
{
"name": "Wind Turbines",
"childAssetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"
},
]
}
```