Buat model komponen - AWS IoT SiteWise
Buat model komponen (AWS CLI)Contoh model komponen

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

Buat model komponen

Gunakan model AWS IoT SiteWise komponen untuk menentukan subrakitan yang dapat Anda referensikan dari model aset atau model komponen lainnya. Dengan cara ini, Anda dapat menggunakan kembali definisi komponen di beberapa model lain, atau beberapa kali dalam model yang sama.

Proses mendefinisikan model komponen sangat mirip dengan mendefinisikan model aset. Seperti model aset, model komponen memiliki nama, deskripsi, dan properti aset. Namun, model komponen tidak dapat menyertakan definisi hierarki aset, karena model komponen itu sendiri tidak dapat digunakan untuk membuat aset secara langsung. Model komponen juga tidak dapat mendefinisikan alarm.

Misalnya, Anda dapat menentukan komponen untuk motor servo dengan suhu motor, suhu encoder, dan sifat resistansi isolasi. Kemudian, Anda dapat menentukan model aset untuk peralatan yang berisi motor servo, seperti CNC mesin.

catatan

  • Kami menyarankan Anda memodelkan operasi Anda dimulai dengan node tingkat terendah. Misalnya, buat komponen motor servo Anda sebelum Anda membuat model aset CNC mesin Anda. Model aset berisi referensi ke model komponen yang ada.

  • Anda tidak dapat membuat aset langsung dari model komponen. Untuk membuat aset yang menggunakan komponen Anda, Anda harus membuat model aset untuk aset Anda. Kemudian, Anda membuat model komposit khusus untuk itu yang mereferensikan komponen Anda. Untuk informasi selengkapnya tentang membuat model aset, lihat Buat model aset Untuk informasi selengkapnya tentang membuat model komposit kustom, lihatBuat model komposit khusus (komponen).

Bagian berikut menjelaskan cara menggunakan AWS IoT SiteWise API untuk membuat model komponen.

Buat model komponen (AWS CLI)

Anda dapat menggunakan AWS Command Line Interface (AWS CLI) untuk membuat model komponen.

Gunakan CreateAssetModeloperasi untuk membuat model komponen dengan properti. Operasi ini mengharapkan muatan dengan struktur berikut:

{
  "assetModelType": "COMPONENT_MODEL",
  "assetModelName": "String",
  "assetModelDescription": "String",
  "assetModelProperties": Array of AssetModelProperty,
}
Untuk membuat model komponen (AWS CLI)

  1. Buat file bernama component-model-payload.json dan kemudian salin JSON objek berikut ke dalam file:

    {
  "assetModelType": "COMPONENT_MODEL",
  "assetModelName": "",
  "assetModelDescription": "",
  "assetModelProperties": [

  ]
}

  2. Gunakan editor JSON teks pilihan Anda untuk mengedit component-model-payload.json file sebagai berikut:

    1. Masukkan nama (assetModelName) untuk model komponen, seperti Servo Motor atauServo Motor Model. Nama ini harus unik di semua model aset dan model komponen di akun Anda dalam hal ini Wilayah AWS.

    2. (Opsional) Masukkan ID eksternal (assetModelExternalId) untuk model komponen. Ini adalah ID yang ditentukan pengguna. Untuk informasi selengkapnya, lihat Referensi objek dengan eksternal IDs di AWS IoT SiteWise Panduan Pengguna.

    3. (Opsional) Masukkan deskripsi (assetModelDescription) untuk model aset, atau hapus pasangan assetModelDescription nilai kunci.

    4. (Opsional) Tentukan properti aset (assetModelProperties) untuk model komponen. Untuk informasi selengkapnya, lihat Tentukan properti data.

    5. (Opsional) Tambahkan tag (tags) untuk model aset. Untuk informasi selengkapnya, lihat Tandai AWS IoT SiteWise sumber daya Anda.

  3. Jalankan perintah berikut untuk membuat model komponen dari definisi dalam JSON file.

    aws iotsitewise create-asset-model --cli-input-json file://component-model-payload.json

    Operasi mengembalikan respons yang berisi assetModelId yang Anda rujuk saat menambahkan referensi ke model komponen Anda dalam model aset atau model komponen lain. Respons juga berisi status model (assetModelStatus.state), yang awalnyaCREATING. Status model komponen adalah CREATING sampai perubahan menyebar.

    catatan

    Proses pembuatan model komponen dapat memakan waktu hingga beberapa menit untuk model yang kompleks. Untuk memeriksa status model komponen Anda saat ini, gunakan DescribeAssetModeloperasi dengan menentukan. assetModelId Setelah status model komponenACTIVE, Anda dapat menambahkan referensi ke model komponen Anda dalam model aset atau model komponen lainnya. Untuk informasi selengkapnya, lihat Status aset dan model.

  4. (Opsional) Buat model komposit khusus untuk model komponen Anda. Dengan model komposit khusus, Anda dapat mengelompokkan properti dalam model, atau menyertakan subassembly dengan mereferensikan model komponen lain. Untuk informasi selengkapnya, lihat Buat model komposit khusus (komponen).

Contoh model komponen

Bagian ini berisi contoh definisi model komponen yang dapat Anda gunakan untuk membuat model komponen dengan AWS CLI dan AWS IoT SiteWise SDKs. Model komponen ini mewakili motor servo yang dapat digunakan dalam peralatan lain, seperti CNC mesin.

Model komponen motor servo

Model komponen berikut mewakili motor servo yang dapat digunakan dalam peralatan seperti CNC mesin. Motor servo menyediakan berbagai pengukuran, seperti suhu dan hambatan listrik. Pengukuran ini tersedia sebagai properti pada aset yang dibuat dari model aset yang merujuk pada model komponen motor servo.

{
    "assetModelName": "ServoMotor",
    "assetModelType": "COMPONENT_MODEL",
    "assetModelProperties": [
        {
            "dataType": "DOUBLE",
            "name": "Servo Motor Temperature",
            "type": {
            "measurement": {}
            },
            "unit": "Celsius"
        },
        {
            "dataType": "DOUBLE",
            "name": "Spindle speed",
            "type": {
            "measurement": {}
            },
            "unit": "rpm"
        }
    ]
}