Mengedit templat perangkat

Templat perangkat menyertakan model yang menjelaskan cara perangkat berinteraksi dengan IoT Central. Model ini mendefinisikan kemampuan perangkat dan cara IoT Central berinteraksi dengan kemampuan-kemampuan tersebut. Perangkat dapat mengirim nilai telemetri dan properti ke IoT Central, IoT Central dapat mengirim pembaruan dan perintah properti ke perangkat. IoT Central juga menggunakan model untuk menentukan interaksi dengan fitur IoT Central seperti pekerjaan, aturan, dan ekspor.

Perubahan pada model dalam templat perangkat dapat memengaruhi seluruh aplikasi Anda, termasuk perangkat apa pun yang tersambung. Perubahan pada kemampuan yang digunakan oleh aturan, ekspor, grup perangkat, atau pekerjaan dapat menyebabkannya berperilaku tidak terduga atau tidak berfungsi sama sekali. Misalnya, jika Anda menghapus definisi telemetri dari templat:

• IoT Central tidak lagi mampu menginterpretasi nilai itu. IoT Central menampilkan data perangkat yang tidak dapat diinterpretasikan sebagai Data yang tidak dimodelkan di halaman Data mentah perangkat.
• IoT Central tidak lagi menyertakan nilai dalam setiap ekspor data.

Untuk membantu Anda menghindari konsekuensi yang tidak diinginkan dari mengedit templat perangkat, artikel ini menyertakan rekomendasi berdasarkan tahap siklus hidup pengembangan Anda saat ini. Secara umum, semakin awal Anda berada dalam siklus hidup pengembangan, Anda menjadi semakin toleran terhadap perubahan templat perangkat.

Untuk mempelajari lebih lanjut templat perangkat dan cara membuatnya, lihat Apa itu templat perangkat? dan Menyiapkan templat perangkat.

Untuk mempelajari cara mengelola templat perangkat dengan menggunakan IoT Central REST API, lihat Cara menggunakan REST API IoT Central untuk mengelola templat perangkat.

Mengubah templat perangkat

Perubahan aditif, seperti menambahkan kemampuan atau antarmuka ke model adalah perubahan yang tidak pecah. Anda dapat membuat perubahan penambahan pada model di setiap tahap siklus hidup perkembangan.

Perubahan yang melanggar termasuk menghapus bagian model atau mengubah nama kemampuan atau jenis skema. Perubahan ini dapat menyebabkan fitur aplikasi seperti aturan, ekspor, atau dasbor menampilkan pesan kesalahan dan berhenti bekerja.

Pada fase pengembangan perangkat awal, saat Anda masih merancang dan menguji model, ada toleransi yang lebih besar untuk membuat perubahan secara langsung ke model perangkat Anda. Sebelum Anda menyambungkan perangkat produksi ke templat perangkat, Anda dapat mengedit templat perangkat secara langsung. IoT Central menerapkan perubahan tersebut secara otomatis ke perangkat saat Anda memublikasikan templat perangkat.

Setelah Anda melampirkan perangkat produksi ke templat perangkat, evaluasi dampak perubahan apa pun sebelum Anda mengedit templat perangkat. Anda tidak boleh membuat perubahan yang melanggar pada templat perangkat dalam produksi. Untuk membuat perubahan tersebut, buat versi baru templat perangkat. Uji templat perangkat baru lalu migrasikan perangkat produksi Anda ke templat baru pada periode nonaktif terjadwal.

Memperbarui templat perangkat IoT Edge

Untuk perangkat IoT Edge, model mengelompokkan kemampuan berdasarkan modul yang sesuai dengan modul IoT Edge yang berjalan pada perangkat. Manifes penyebaran adalah dokumen JSON terpisah yang memberi tahu perangkat IoT Edge modul mana yang akan diinstal, cara mengonfigurasinya, dan properti apa yang dimiliki modul. Jika Anda memodifikasi manifes penyebaran, Anda dapat memperbarui templat perangkat untuk menyertakan modul dan properti yang ditentukan dalam manifes:

1. Navigasikan ke node Modul di templat perangkat.
2. Pada halaman Ringkasan modul , pilih Impor modul dari manifes.
3. Pilih manifes penyebaran yang sesuai dan pilih Impor.

Untuk mempelajari selengkapnya, lihat Perangkat IoT Edge dan IoT Central.

Mengedit dan menerbitkan tindakan

Tindakan berikut ini berguna saat Anda mengedit templat perangkat:

• Simpan. Saat Anda mengubah bagian templat perangkat Anda, menyimpan perubahan akan membuat draf yang bisa Anda buka kembali. Perubahan ini belum memengaruhi perangkat yang tersambung. Perangkat apa pun yang dibuat dari templat ini tidak memiliki perubahan tersimpan hingga Anda menerbitkannya.
• Terbitkan. Saat Anda memublikasikan templat perangkat, templat tersebut akan menerapkan perubahan yang disimpan ke instans perangkat yang ada. Instans perangkat yang baru dibuat selalu menggunakan templat terbaru yang diterbitkan.
• Membuat versi templat. Saat Anda membuat versi templat perangkat, templat tersebut akan membuat templat baru dengan semua perubahan terbaru yang disimpan. Perubahan yang dilakukan pada versi baru tidak memengaruhi instans perangkat yang ada. Untuk mempelajari lebih lanjut, lihat Membuat versi perangkat.
• Membuat versi antarmuka. Ketika Anda membuat versi antarmuka, antarmuka akan membuat antarmuka baru dengan semua kemampuan tersimpan terbaru. Anda dapat menggunakan kembali antarmuka di beberapa lokasi dalam templat. Itulah sebabnya perubahan yang dilakukan pada satu referensi ke antarmuka mengubah semua tempat dalam templat yang menggunakan antarmuka. Ketika Anda membuat versi antarmuka, perilaku ini berubah karena versi baru sekarang menjadi antarmuka terpisah. Untuk mempelajari lebih lanjut, lihat Membuat versi antarmuka.
• Memigrasikan perangkat. Saat Anda memigrasikan perangkat, instans perangkat bertukar dari satu templat perangkat ke templat lainnya. Migrasi perangkat dapat memakan waktu beberapa saat untuk IoT Central memproses perubahan. Untuk mempelajari lebih lanjut, lihat Memigrasikan perangkat di seluruh versi.

Nomor versi

Baik model perangkat maupun antarmuka memiliki nomor versi. Nomor versi yang berbeda memungkinkan model atau antarmuka berbagi nilai @id, sekaligus memberikan riwayat pembaruan. Nomor versi hanya tahapan jika Anda memilih untuk membuat versi templat atau antarmuka, atau jika Anda sengaja mengubah nomor versi. Anda harus mengubah nomor versi saat membuat perubahan besar pada templat atau antarmuka.

Cuplikan berikut menunjukkan model perangkat untuk perangkat termostat. Model perangkat memiliki satu antarmuka. Anda dapat melihat nomor versi, 1, di akhir bidang @id.

{
  "@context": "dtmi:dtdl:context;2",
  "@id": "dtmi:com:example:Thermostat;1",
  "@type": "Interface",
  "displayName": "Thermostat",
  "description": "Reports current temperature and provides desired temperature control.",
  "contents": [
    // ...
  ]
}

Untuk menampilkan informasi ini di antarmuka pengguna IoT Central, pilih Tampilkan identitas di penyunting templat perangkat:

Membuat versi templat perangkat

Untuk membuat versi templat perangkat:

1. Buka halaman Templat perangkat.
2. Pilih templat perangkat yang ingin Anda buat versinya.
3. Pilih Versi di bagian atas halaman dan beri nama baru pada templat. IoT Central menyarankan nama baru, yang dapat Anda edit.
4. Pilih Buat.

Sekarang Anda telah membuat templat baru dengan identitas unik yang tidak dilampirkan ke perangkat yang sudah ada.

Menerapkan versi antarmuka

Untuk membuat versi antarmuka:

1. Buka halaman Templat perangkat.
2. Pilih templat perangkat yang berada dalam mode draf.
3. Pilih antarmuka yang telah dipublikasikan yang ingin Anda buat versinya dan edit.
4. Pilih Versi di bagian atas halaman antarmuka.
5. Pilih Buat.

Sekarang Anda telah membuat antarmuka baru dengan identitas unik yang tidak disinkronkan dengan versi antarmuka sebelumnya.

Melakukan migrasi perangkat di seluruh versi

Anda dapat membuat beberapa versi templat perangkat. Seiring waktu, Anda akan memiliki beberapa perangkat tersambung yang menggunakan templat perangkat ini. Anda dapat memigrasikan perangkat dari satu versi templat perangkat ke versi lain. Langkah-langkah berikut menjelaskan cara memigrasikan perangkat:

1. Buka halaman Perangkat.

2. Pilih perangkat yang perlu Anda migrasikan ke versi lain.

3. Pilih Migrasi:

   

4. Pilih templat perangkat dengan versi yang ingin Anda migrasikan ke perangkat tujuan dan pilih Migrasi.

Tip

Anda dapat menggunakan pekerjaan untuk memigrasikan semua perangkat dalam grup perangkat ke templat perangkat baru secara bersamaan.