View a markdown version of this page

Model komposit kustom (komponen) - AWS IoT SiteWise
Model komposit kustom sebarisComponent-model-based model komposit kustomGunakan jalur untuk mereferensikan properti model komposit kustom

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Model komposit kustom (komponen)

Ketika Anda memodelkan aset industri yang sangat kompleks, seperti mesin rumit yang memiliki banyak bagian, dapat menjadi tantangan untuk menjaga model aset Anda tetap teratur dan dapat dipelihara.

Dalam kasus seperti itu, Anda dapat menambahkan model komposit khusus, atau komponen jika Anda menggunakan konsol, ke model aset dan model komponen yang ada. Ini membantu Anda tetap teratur dengan mengelompokkan properti terkait dan menggunakan kembali definisi subkomponen.

Ada dua jenis model komposit kustom:

  • Model komposit kustom sebaris menentukan sekumpulan properti yang dikelompokkan yang berlaku untuk model aset atau model komponen yang dimiliki model komposit kustom. Anda menggunakannya untuk mengelompokkan properti terkait. Mereka terdiri dari nama, deskripsi, dan satu set properti model aset. Mereka tidak dapat digunakan kembali.

  • Component-model-basedmodel komposit kustom mereferensikan model komponen yang ingin Anda sertakan dalam model aset atau model komponen Anda. Anda menggunakannya untuk menyertakan subrakitan standar dalam model Anda. Mereka terdiri dari nama, deskripsi, dan ID model komponen yang dirujukkannya. Mereka tidak memiliki properti mereka sendiri; model komponen yang direferensikan menyediakan properti terkait untuk aset yang dibuat.

Bagian berikut menggambarkan cara menggunakan model komposit kustom dalam desain Anda.

Model komposit kustom sebaris

Model komposit kustom sebaris menyediakan cara untuk mengatur model aset Anda dengan mengelompokkan properti terkait.

Misalnya, Anda ingin memodelkan aset robot. Robot termasuk servomotor, catu daya, dan baterai. Masing-masing bagian penyusun tersebut memiliki propertinya sendiri yang ingin Anda sertakan dalam model. Anda dapat mendefinisikan model aset robot_model yang disebut yang memiliki properti seperti berikut ini.

  • robot_model

    • servo_status(bilangan bulat)

    • servo_position(ganda)

    • powersupply_status(bilangan bulat)

    • powersupply_temperature(ganda)

    • battery_status(bilangan bulat)

    • battery_charge(ganda)

Namun, dalam beberapa kasus, mungkin ada banyak subrakitan, atau subrakitan itu sendiri mungkin memiliki banyak properti. Dalam kasus ini, mungkin ada begitu banyak properti sehingga menjadi rumit untuk dirujuk dan dipertahankan dalam satu daftar datar di root model, seperti pada contoh sebelumnya.

Untuk menangani situasi seperti itu, Anda dapat menggunakan model komposit kustom sebaris untuk mengelompokkan properti. Model komposit kustom sebaris adalah model komposit khusus yang mendefinisikan propertinya sendiri. Misalnya, Anda dapat memodelkan robot Anda seperti berikut ini.

  • robot_model

    • servo

      • status(bilangan bulat)

      • position(ganda)

    • powersupply

      • status(bilangan bulat)

      • temperature(ganda)

    • battery

      • status(bilangan bulat)

      • charge(ganda)

Dalam contoh sebelumnya,, servopowersupply, dan battery adalah nama model komposit kustom sebaris yang ditentukan dalam model robot_model aset. Masing-masing model komposit ini kemudian mendefinisikan propertinya sendiri.

catatan

Dalam hal ini, setiap model komposit kustom mendefinisikan propertinya sendiri, sehingga semua properti adalah bagian dari model aset itu sendiri (robot_modeldalam hal ini). Properti ini tidak dibagikan dengan model aset atau model komponen lainnya. Misalnya, jika Anda membuat beberapa model aset lain yang juga memiliki model komposit kustom sebaris yang dipanggilservo, maka membuat perubahan servo pada robot_model bagian dalam tidak akan mempengaruhi servo definisi model aset lainnya.

Jika Anda ingin menerapkan berbagi seperti itu (misalnya, hanya memiliki satu definisi untuk servo, yang dapat dibagikan oleh semua model aset Anda), Anda akan membuat model komponen untuknya, dan kemudian membuat model komposit berbasis model komponen yang mereferensikannya. Lihat bagian berikut untuk detailnya.

Untuk informasi tentang cara membuat model komposit kustom sebaris, lihatBuat model komposit kustom (komponen).

Component-model-based model komposit kustom

Anda dapat membuat model komponen AWS IoT SiteWise untuk menentukan sub-rakitan standar yang dapat digunakan kembali. Setelah Anda membuat model komponen, Anda dapat menambahkan referensi ke model aset dan model komponen lainnya. Anda melakukan ini dengan menambahkan model komposit kustom berbasis model komponen ke model mana pun di mana Anda ingin mereferensikan komponen. Anda dapat menambahkan referensi ke komponen Anda dari banyak model, atau beberapa kali dalam model yang sama.

Dengan cara ini, Anda dapat menghindari duplikasi definisi yang sama di seluruh model. Ini juga menyederhanakan pemeliharaan model Anda, karena setiap perubahan yang Anda buat pada model komponen akan tercermin di semua model aset yang menggunakannya.

Misalnya, anggaplah instalasi industri Anda memiliki banyak jenis peralatan yang semuanya menggunakan jenis motor servo yang sama. Beberapa dari mereka memiliki banyak motor servo dalam satu peralatan. Anda membuat model aset untuk setiap jenis peralatan, tetapi Anda tidak ingin menduplikasi definisi servo setiap saat. Anda ingin memodelkannya hanya sekali dan menggunakannya dalam berbagai model aset Anda. Jika nanti Anda membuat perubahan pada definisiservo, itu akan diperbarui di semua model dan aset Anda.

Untuk memodelkan robot dari contoh sebelumnya dengan cara ini, Anda dapat mendefinisikan motor servo, catu daya, dan baterai sebagai model komponen, seperti ini.

  • servo_component_model

    • status(bilangan bulat)

    • position(ganda)

  • powersupply_component_model

    • status(bilangan bulat)

    • temperature(ganda)

  • battery__component_model

    • status(bilangan bulat)

    • charge(ganda)

Anda kemudian dapat menentukan model aset, sepertirobot_model, yang mereferensikan komponen-komponen ini. Beberapa model aset dapat mereferensikan model komponen yang sama. Anda juga dapat mereferensikan model komponen yang sama beberapa kali dalam satu model aset, seperti jika robot Anda memiliki beberapa servomotor di dalamnya.

  • robot_model

    • servo1(referensi: servo_component_model)

    • servo2(referensi: servo_component_model)

    • servo3(referensi: servo_component_model)

    • powersupply(referensi: powersupply_component_model)

    • battery(referensi: battery_component_model)

Untuk informasi tentang cara membuat model komponen, lihatBuat model komponen.

Untuk informasi tentang cara mereferensikan model komponen Anda di model lain, lihatBuat model komposit kustom (komponen).

Gunakan jalur untuk mereferensikan properti model komposit kustom

Saat Anda membuat properti pada model aset, model komponen, atau model komposit kustom, Anda dapat mereferensikannya dari properti lain yang menggunakan nilainya, seperti transformasi dan metrik.

AWS IoT SiteWise menyediakan berbagai cara bagi Anda untuk mereferensikan properti Anda. Cara paling sederhana adalah sering menggunakan ID propertinya. Namun, jika properti yang ingin Anda rujuk ada pada model komposit khusus, Anda mungkin merasa lebih berguna untuk mereferensikannya dengan jalur sebagai gantinya.

Jalur adalah urutan terurutan segmen jalur yang menentukan properti dalam hal posisinya di antara model komposit bersarang dalam model aset dan model komposit.

Dapatkan jalur properti

Anda bisa mendapatkan jalur properti dari path bidangnya AssetModelProperty.

Misalnya, Anda memiliki model aset robot_model yang berisi model komposit kustomservo, yang memiliki propertiposition. Jika Anda memang DescribeAssetModelCompositeModel gilservo, maka position properti akan mencantumkan path bidang yang terlihat seperti ini: 

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

Menggunakan jalur properti

Anda dapat menggunakan jalur properti saat menentukan properti yang mereferensikan properti lain, seperti transformasi atau metrik.

Properti menggunakan variabel untuk mereferensikan properti lain. Untuk informasi selengkapnya tentang bekerja dengan variabel, lihatGunakan variabel dalam ekspresi rumus.

Ketika Anda menentukan variabel untuk mereferensikan properti, Anda dapat menggunakan ID properti atau jalurnya.

Untuk menentukan variabel yang menggunakan jalur properti yang direferensikan, tent propertyPath ukan bidang nilainya.

Misalnya, untuk menentukan model aset yang memiliki metrik yang mereferensikan properti dengan menggunakan jalur, Anda dapat meneruskan payload seperti ini ke: CreateAssetModel 

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