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

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

Model komposit khusus (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 terorganisir dengan mengelompokkan properti terkait dan menggunakan kembali definisi subkomponen.

Ada dua jenis model komposit khusus:

  • Model komposit kustom sebaris mendefinisikan satu set properti yang dikelompokkan yang berlaku untuk model aset atau model komponen yang menjadi milik 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.

  • Model komposit omponent-model-based kustom C mereferensikan model komponen yang ingin Anda sertakan dalam model aset atau model komponen Anda. Anda menggunakannya untuk memasukkan subassemblies standar dalam model Anda. Mereka terdiri dari nama, deskripsi, dan ID dari model komponen yang direferensikannya. Mereka tidak memiliki properti mereka sendiri; model komponen yang direferensikan menyediakan properti terkait untuk setiap aset yang dibuat.

Bagian berikut menggambarkan cara menggunakan model komposit khusus 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 memiliki sifat 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 subassemblies, atau subassemblies itu sendiri mungkin memiliki banyak properti. Dalam kasus ini, mungkin ada begitu banyak properti sehingga menjadi rumit untuk direferensikan dan dipertahankan dalam satu daftar datar di root model, seperti pada contoh sebelumnya.

Untuk menghadapi situasi seperti itu, Anda dapat menggunakan model komposit kustom sebaris untuk mengelompokkan properti. Model komposit kustom inline 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-nama model komposit kustom inline yang didefinisikan dalam model aset. robot_model Masing-masing model komposit ini kemudian mendefinisikan sifat-sifatnya sendiri.

catatan

Dalam hal ini, setiap model komposit khusus 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 disebutservo, maka membuat perubahan ke servo dalam robot_model tidak akan memengaruhi 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 component-model-basedkomposit yang mereferensikannya. Lihat bagian berikut untuk detailnya.

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

C model komposit omponent-model-based 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 Anda yang lain. Anda melakukan ini dengan menambahkan model komposit component-model-based khusus 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, misalkan 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 sekali saja 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 mendefinisikan model aset, sepertirobot_model, yang merujuk 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 khusus (komponen).

Gunakan jalur untuk mereferensikan properti model komposit khusus

Saat 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 referensikan ada pada model komposit khusus, Anda mungkin merasa lebih berguna untuk mereferensikannya berdasarkan jalur.

Path adalah urutan urutan 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 khususservo, yang memiliki propertiposition. Jika Anda memanggil DescribeAssetModelCompositeModelservo, 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 referensi properti lain. Untuk informasi lebih lanjut tentang bekerja dengan variabel, lihatGunakan variabel dalam ekspresi rumus.

Saat Anda mendefinisikan variabel untuk mereferensikan properti, Anda dapat menggunakan ID properti atau jalurnya.

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

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

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