As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Exemplos de importação de metadados
Esta seção mostra como criar arquivos de metadados para importar modelos de ativo e ativos com uma única operação de importação em massa.
## Exemplo de uma importação em massa
Você pode importar muitos modelos de ativo e ativos com uma única operação de importação em massa. O exemplo a seguir mostra como criar um arquivo de metadados para isso.
Neste cenário de exemplo, há vários locais de trabalho que contêm robôs industriais em células de trabalho.
O exemplo define dois modelos de ativo:
+ `RobotModel1`: este modelo de ativo representa um tipo específico de robô disponível nos locais de trabalho. O robô tem uma propriedade de medição, `Temperature`.
+ `WorkCell`: este modelo de ativo representa um conjunto de robôs dentro de um dos locais de trabalho. O modelo de ativos define uma hierarquia, `robotHierarchyOEM1`, para representar a relação em que uma célula de trabalho contém robôs.
O exemplo também define alguns ativos:
+ `WorkCell1`: uma célula de trabalho dentro do local em Boston.
+ `RobotArm123456`: um robô dentro dessa célula de trabalho.
+ `RobotArm987654`: outro robô dentro dessa célula de trabalho.
O arquivo de metadados JSON a seguir define esses modelos de ativo e ativos. A execução de uma importação em massa com esses metadados cria os modelos de ativos e os ativos internos AWS IoT SiteWise, incluindo seus relacionamentos hierárquicos.
### Arquivo de metadados para importação
```
{
"assetModels": [
{
"assetModelExternalId": "Robot.OEM1.3536",
"assetModelName": "RobotModel1",
"assetModelProperties": [
{
"dataType": "DOUBLE",
"externalId": "Temperature",
"name": "Temperature",
"type": {
"measurement": {
"processingConfig": {
"forwardingConfig": {
"state": "ENABLED"
}
}
}
},
"unit": "fahrenheit"
}
]
},
{
"assetModelExternalId": "ISA95.WorkCell",
"assetModelName": "WorkCell",
"assetModelProperties": [],
"assetModelHierarchies": [
{
"externalId": "workCellHierarchyWithOEM1Robot",
"name": "robotHierarchyOEM1",
"childAssetModelExternalId": "Robot.OEM1.3536"
}
]
}
],
"assets": [
{
"assetExternalId": "Robot.OEM1.3536.123456",
"assetName": "RobotArm123456",
"assetModelExternalId": "Robot.OEM1.3536"
},
{
"assetExternalId": "Robot.OEM1.3536.987654",
"assetName": "RobotArm987654",
"assetModelExternalId": "Robot.OEM1.3536"
},
{
"assetExternalId": "BostonSite.Area1.Line1.WorkCell1",
"assetName": "WorkCell1",
"assetModelExternalId": "ISA95.WorkCell",
"assetHierarchies": [
{
"externalId": "workCellHierarchyWithOEM1Robot",
"childAssetExternalId": "Robot.OEM1.3536.123456"
},
{
"externalId": "workCellHierarchyWithOEM1Robot",
"childAssetExternalId": "Robot.OEM1.3536.987654"
}
]
}
]
}
```
## Exemplo de integração inicial de modelos e ativos
Neste cenário de exemplo, há vários locais de trabalho que contêm robôs industriais em uma empresa.
O exemplo define vários modelos de ativo:
+ `Sample_Enterprise`: este modelo de ativo representa a empresa da qual os locais fazem parte. O modelo de ativo define uma hierarquia, `Enterprise to Site`, para representar a relação dos locais com a empresa.
+ `Sample_Site`: este modelo de ativo representa os locais de fabricação dentro da empresa. O modelo de ativo define uma hierarquia, `Site to Line`, para representar a relação das linhas com o local.
+ `Sample_Welding Line`: este modelo de ativo representa uma linha de montagem dentro dos locais de trabalho. O modelo de ativo define uma hierarquia, `Line to Robot`, para representar a relação dos robôs com a linha.
+ `Sample_Welding Robot`: este modelo de ativo representa um tipo específico de robô nos locais de trabalho.
O exemplo também define ativos baseados nos modelos de ativo.
+ `Sample_AnyCompany Motor`: este ativo é criado com base no modelo de ativo `Sample_Enterprise`.
+ `Sample_Chicago`: este ativo é criado com base no modelo de ativo `Sample_Site`.
+ `Sample_Welding Line 1`: este ativo é criado com base no modelo de ativo `Sample_Welding Line`.
+ `Sample_Welding Robot 1`: este ativo é criado com base no modelo de ativo `Sample_Welding Robot`.
+ `Sample_Welding Robot 2`: este ativo é criado com base no modelo de ativo `Sample_Welding Robot`.
O arquivo de metadados JSON a seguir define esses modelos de ativo e ativos. A execução de uma importação em massa com esses metadados cria os modelos de ativos e os ativos internos AWS IoT SiteWise, incluindo seus relacionamentos hierárquicos.
### Arquivo JSON para integrar ativos e modelos para importação
```
{
"assetModels": [
{
"assetModelExternalId": "External_Id_Welding_Robot",
"assetModelName": "Sample_Welding Robot",
"assetModelProperties": [
{
"dataType": "STRING",
"externalId": "External_Id_Welding_Robot_Serial_Number",
"name": "Serial Number",
"type": {
"attribute": {
"defaultValue": "-"
}
},
"unit": "-"
},
{
"dataType": "DOUBLE",
"externalId": "External_Id_Welding_Robot_Cycle_Count",
"name": "CycleCount",
"type": {
"measurement": {}
},
"unit": "EA"
},
{
"dataType": "DOUBLE",
"externalId": "External_Id_Welding_Robot_Joint_1_Current",
"name": "Joint 1 Current",
"type": {
"measurement": {}
},
"unit": "Amps"
},
{
"dataType": "DOUBLE",
"externalId": "External_Id_Welding_Robot_Joint_1_Max_Current",
"name": "Max Joint 1 Current",
"type": {
"metric": {
"expression": "max(joint1current)",
"variables": [
{
"name": "joint1current",
"value": {
"propertyExternalId": "External_Id_Welding_Robot_Joint_1_Current"
}
}
],
"window": {
"tumbling": {
"interval": "5m"
}
}
}
},
"unit": "Amps"
}
]
},
{
"assetModelExternalId": "External_Id_Welding_Line",
"assetModelName": "Sample_Welding Line",
"assetModelProperties": [
{
"dataType": "DOUBLE",
"externalId": "External_Id_Welding_Line_Availability",
"name": "Availability",
"type": {
"measurement": {}
},
"unit": "%"
}
],
"assetModelHierarchies": [
{
"externalId": "External_Id_Welding_Line_TO_Robot",
"name": "Line to Robot",
"childAssetModelExternalId": "External_Id_Welding_Robot"
}
]
},
{
"assetModelExternalId": "External_Id_Site",
"assetModelName": "Sample_Site",
"assetModelProperties": [
{
"dataType": "STRING",
"externalId": "External_Id_Site_Street_Address",
"name": "Street Address",
"type": {
"attribute": {
"defaultValue": "-"
}
},
"unit": "-"
}
],
"assetModelHierarchies": [
{
"externalId": "External_Id_Site_TO_Line",
"name": "Site to Line",
"childAssetModelExternalId": "External_Id_Welding_Line"
}
]
},
{
"assetModelExternalId": "External_Id_Enterprise",
"assetModelName": "Sample_Enterprise",
"assetModelProperties": [
{
"dataType": "STRING",
"name": "Company Name",
"externalId": "External_Id_Enterprise_Company_Name",
"type": {
"attribute": {
"defaultValue": "-"
}
},
"unit": "-"
}
],
"assetModelHierarchies": [
{
"externalId": "External_Id_Enterprise_TO_Site",
"name": "Enterprise to Site",
"childAssetModelExternalId": "External_Id_Site"
}
]
}
],
"assets": [
{
"assetExternalId": "External_Id_Welding_Robot_1",
"assetName": "Sample_Welding Robot 1",
"assetModelExternalId": "External_Id_Welding_Robot",
"assetProperties": [
{
"externalId": "External_Id_Welding_Robot_Serial_Number",
"attributeValue": "S1000"
},
{
"externalId": "External_Id_Welding_Robot_Cycle_Count",
"alias": "AnyCompany/Chicago/Welding Line/S1000/Count"
},
{
"externalId": "External_Id_Welding_Robot_Joint_1_Current",
"alias": "AnyCompany/Chicago/Welding Line/S1000/1/Current"
}
]
},
{
"assetExternalId": "External_Id_Welding_Robot_2",
"assetName": "Sample_Welding Robot 2",
"assetModelExternalId": "External_Id_Welding_Robot",
"assetProperties": [
{
"externalId": "External_Id_Welding_Robot_Serial_Number",
"attributeValue": "S2000"
},
{
"externalId": "External_Id_Welding_Robot_Cycle_Count",
"alias": "AnyCompany/Chicago/Welding Line/S2000/Count"
},
{
"externalId": "External_Id_Welding_Robot_Joint_1_Current",
"alias": "AnyCompany/Chicago/Welding Line/S2000/1/Current"
}
]
},
{
"assetExternalId": "External_Id_Welding_Line_1",
"assetName": "Sample_Welding Line 1",
"assetModelExternalId": "External_Id_Welding_Line",
"assetProperties": [
{
"externalId": "External_Id_Welding_Line_Availability",
"alias": "AnyCompany/Chicago/Welding Line/Availability"
}
],
"assetHierarchies": [
{
"externalId": "External_Id_Welding_Line_TO_Robot",
"childAssetExternalId": "External_Id_Welding_Robot_1"
},
{
"externalId": "External_Id_Welding_Line_TO_Robot",
"childAssetExternalId": "External_Id_Welding_Robot_2"
}
]
},
{
"assetExternalId": "External_Id_Site_Chicago",
"assetName": "Sample_Chicago",
"assetModelExternalId": "External_Id_Site",
"assetHierarchies": [
{
"externalId": "External_Id_Site_TO_Line",
"childAssetExternalId": "External_Id_Welding_Line_1"
}
]
},
{
"assetExternalId": "External_Id_Enterprise_AnyCompany",
"assetName": "Sample_AnyEnterprise Motor",
"assetModelExternalId": "External_Id_Enterprise",
"assetHierarchies": [
{
"externalId": "External_Id_Enterprise_TO_Site",
"childAssetExternalId": "External_Id_Site_Chicago"
}
]
}
]
}
```
A captura de tela a seguir mostra os modelos exibidos Console do AWS IoT SiteWise após a execução do exemplo de código anterior.
A captura de tela a seguir mostra modelos, ativos e hierarquias que são exibidos Console do AWS IoT SiteWise após a execução do exemplo de código anterior.
## Exemplo de integração de ativos adicionais
Este exemplo define ativos adicionais a serem importados para um modelo de ativo existente na conta:
+ `Sample_Welding Line 2`: este ativo é criado com base no modelo de ativo `Sample_Welding Line`.
+ `Sample_Welding Robot 3`: este ativo é criado com base no modelo de ativo `Sample_Welding Robot`.
+ `Sample_Welding Robot 4`: este ativo é criado com base no modelo de ativo `Sample_Welding Robot`.
Para criar os ativos iniciais para esse exemplo, consulte [Exemplo de integração inicial de modelos e ativos](#example-scenario1).
O arquivo de metadados JSON a seguir define esses modelos de ativo e ativos. A execução de uma importação em massa com esses metadados cria os modelos de ativos e os ativos internos AWS IoT SiteWise, incluindo seus relacionamentos hierárquicos.
### Arquivo JSON para integrar ativos adicionais
```
{
"assets": [
{
"assetExternalId": "External_Id_Welding_Robot_3",
"assetName": "Sample_Welding Robot 3",
"assetModelExternalId": "External_Id_Welding_Robot",
"assetProperties": [
{
"externalId": "External_Id_Welding_Robot_Serial_Number",
"attributeValue": "S3000"
},
{
"externalId": "External_Id_Welding_Robot_Cycle_Count",
"alias": "AnyCompany/Chicago/Welding Line/S3000/Count"
},
{
"externalId": "External_Id_Welding_Robot_Joint_1_Current",
"alias": "AnyCompany/Chicago/Welding Line/S3000/1/Current"
}
]
},
{
"assetExternalId": "External_Id_Welding_Robot_4",
"assetName": "Sample_Welding Robot 4",
"assetModelExternalId": "External_Id_Welding_Robot",
"assetProperties": [
{
"externalId": "External_Id_Welding_Robot_Serial_Number",
"attributeValue": "S4000"
},
{
"externalId": "External_Id_Welding_Robot_Cycle_Count",
"alias": "AnyCompany/Chicago/Welding Line/S4000/Count"
},
{
"externalId": "External_Id_Welding_Robot_Joint_1_Current",
"alias": "AnyCompany/Chicago/Welding Line/S4000/1/Current"
}
]
},
{
"assetExternalId": "External_Id_Welding_Line_1",
"assetName": "Sample_Welding Line 1",
"assetModelExternalId": "External_Id_Welding_Line",
"assetHierarchies": [
{
"externalId": "External_Id_Welding_Line_TO_Robot",
"childAssetExternalId": "External_Id_Welding_Robot_1"
},
{
"externalId": "External_Id_Welding_Line_TO_Robot",
"childAssetExternalId": "External_Id_Welding_Robot_2"
},
{
"externalId": "External_Id_Welding_Line_TO_Robot",
"childAssetExternalId": "External_Id_Welding_Robot_3"
}
]
},
{
"assetExternalId": "External_Id_Welding_Line_2",
"assetName": "Sample_Welding Line 2",
"assetModelExternalId": "External_Id_Welding_Line",
"assetHierarchies": [
{
"externalId": "External_Id_Welding_Line_TO_Robot",
"childAssetExternalId": "External_Id_Welding_Robot_4"
}
]
},
{
"assetExternalId": "External_Id_Site_Chicago",
"assetName": "Sample_Chicago",
"assetModelExternalId": "External_Id_Site",
"assetHierarchies": [
{
"externalId": "External_Id_Site_TO_Line",
"childAssetExternalId": "External_Id_Welding_Line_1"
},
{
"externalId": "External_Id_Site_TO_Line",
"childAssetExternalId": "External_Id_Welding_Line_2"
}
]
}
]
}
```
A captura de tela a seguir mostra modelos, ativos e hierarquias que são exibidos Console do AWS IoT SiteWise após a execução do exemplo de código anterior.
## Exemplo de integração de novas propriedades
Este exemplo define novas propriedades em modelos de ativo existentes. Consulte [Exemplo de integração de ativos adicionais](#example-scenario2) para integrar ativos e modelos adicionais.
+ `Joint 1 Temperature`: esta propriedade é adicionada ao modelo de ativo `Sample_Welding Robot`. Essa nova propriedade também se propagará para cada ativo criado com base no modelo de ativo `Sample_Welding Robot`.
Para adicionar uma nova propriedade a um modelo de ativo existente, consulte o exemplo de arquivo de metadados JSON a seguir. Conforme mostrado no JSON, toda a definição do modelo de ativo `Sample_Welding Robot` existente deve ser fornecida com a nova propriedade. Se a lista de propriedades inteira da definição existente não for fornecida, AWS IoT SiteWise excluirá as propriedades omitidas.
### Arquivo JSON para integrar novas propriedades
Este exemplo adiciona uma nova propriedade `Joint 1 Temperature` ao modelo de ativo.
```
{
"assetModels": [
{
"assetModelExternalId": "External_Id_Welding_Robot",
"assetModelName": "Sample_Welding Robot",
"assetModelProperties": [
{
"dataType": "STRING",
"externalId": "External_Id_Welding_Robot_Serial_Number",
"name": "Serial Number",
"type": {
"attribute": {
"defaultValue": "-"
}
},
"unit": "-"
},
{
"dataType": "DOUBLE",
"externalId": "External_Id_Welding_Robot_Cycle_Count",
"name": "CycleCount",
"type": {
"measurement": {}
},
"unit": "EA"
},
{
"dataType": "DOUBLE",
"externalId": "External_Id_Welding_Robot_Joint_1_Current",
"name": "Joint 1 Current",
"type": {
"measurement": {}
},
"unit": "Amps"
},
{
"dataType": "DOUBLE",
"externalId": "External_Id_Welding_Robot_Joint_1_Max_Current",
"name": "Max Joint 1 Current",
"type": {
"metric": {
"expression": "max(joint1current)",
"variables": [
{
"name": "joint1current",
"value": {
"propertyExternalId": "External_Id_Welding_Robot_Joint_1_Current"
}
}
],
"window": {
"tumbling": {
"interval": "5m"
}
}
}
},
"unit": "Amps"
},
{
"dataType": "DOUBLE",
"externalId": "External_Id_Welding_Robot_Joint_1_Temperature",
"name": "Joint 1 Temperature",
"type": {
"measurement": {}
},
"unit": "degC"
}
]
}
]
}
```
## Exemplo de gerenciamento dos fluxos de dados
Este exemplo mostra duas maneiras de gerenciar fluxos de dados associados a uma propriedade do ativo. Durante a renomeação de um alias de propriedade do ativo, há duas opções para os dados históricos atualmente armazenados no fluxo de dados da propriedade do ativo.
+ Primeira opção: manter o fluxo de dados atual e renomear apenas o alias, permitindo que os dados históricos possam ser acessados com o novo alias.
No exemplo de arquivo de metadados JSON, a propriedade do ativo com ID `External_Id_Welding_Robot_Cycle_Count` muda de alias para `AnyCompany/Chicago/Welding Line/S3000/Count-Updated`. Os dados históricos dessa propriedade do ativo permanecerão os mesmos depois dessa alteração.
+ Segunda opção: atribuir um novo fluxo de dados à propriedade do ativo que pode ser acessado com o novo alias. O fluxo de dados anterior com os respectivos dados históricos ainda pode ser acessado com o alias anterior, mas não pode ser associado a nenhuma propriedade do ativo.
No exemplo de arquivo de metadados JSON, a propriedade do ativo com ID `External_Id_Welding_Robot_Joint_1_Current` muda de alias para `AnyCompany/Chicago/Welding Line/S4999/1/Current`. Desta vez, o valor adicional `retainDataOnAliasChange` está presente e definido como `False`. Com essa configuração, o fluxo de dados original é desassociado da propriedade do ativo e um novo fluxo de dados é criado sem dados históricos.
Para acessar o fluxo de dados antigo com os dados históricos originais AWS Console Home, acesse a página *Fluxos de dados* e pesquise o `AnyCompany/Chicago/Welding Line/S3000/1/Current` alias antigo.
### Arquivo JSON para atualizar aliases de propriedade
```
{
"assetExternalId": "External_Id_Welding_Robot_3",
"assetName": "Sample_Welding Robot 3",
"assetModelExternalId": "External_Id_Welding_Robot",
"assetProperties": [
{
"externalId": "External_Id_Welding_Robot_Serial_Number",
"attributeValue": "S3000"
},
{
"externalId": "External_Id_Welding_Robot_Cycle_Count",
"alias": "AnyCompany/Chicago/Welding Line/S3000/Count-Updated"
},
{
"externalId": "External_Id_Welding_Robot_Joint_1_Current",
"alias": "AnyCompany/Chicago/Welding Line/S4999/1/Current",
"retainDataOnAliasChange": "FALSE"
}
]
}
```