Skema model data

Integrasi terkelola mendukung dua jenis skema: kemampuan dan definisi tipe. Jika Anda membuat model data kustom, Anda menggunakan dokumen skema JSON untuk menentukan salah satu jenis skema. Setiap dokumen skema memiliki batas 50.000 karakter.

Skema kemampuan

Kemampuan adalah blok bangunan mendasar yang mewakili fungsionalitas tertentu dalam titik akhir. Dengan kemampuan, Anda dapat memodelkan status dan perilaku perangkat menggunakan properti, tindakan, dan peristiwa. Properti memungkinkan Anda memodelkan atribut status perangkat secara fleksibel dengan tipe data deklaratif apa pun. Tindakan dan peristiwa memodelkan perilaku perangkat, termasuk perintah yang dapat dijalankan dan sinyal yang dapat dilaporkan.

Berikut ini menampilkan struktur tingkat tinggi dari skema kemampuan.

Capability
  |
  |-- Action
  |-- Event      
  |-- Property

Tindakan

Entitas yang mewakili interaksi dengan kemampuan perangkat. Misalnya, membunyikan bel atau melihat siapa yang ada di pintu.

Peristiwa

Entitas yang mewakili peristiwa dari kemampuan perangkat. Perangkat dapat mengirim peristiwa untuk melaporkan insiden, alarm, atau aktivitas dari sensor seperti ketukan di pintu.

Properti

Entitas yang mewakili atribut tertentu dalam keadaan perangkat. Misalnya, bel berdering atau lampu teras menyala

Setiap kemampuan mencakup pengenal namespaced unik, informasi versi, dan deskripsi tujuannya. Dokumen skema menggunakan versi semantik untuk mempertahankan kompatibilitas mundur sambil mengaktifkan fitur baru.

Untuk informasi selengkapnya, lihat Skema untuk definisi kemampuan.

Skema definisi tipe

Definisi tipe adalah tipe data terstruktur deklaratif yang memungkinkan penggunaan kembali dan kemampuan komposisi. Ini mendefinisikan bagaimana informasi harus diformat dan dibatasi. Gunakan definisi tipe untuk membuat format data standar di seluruh solusi IoT Anda.

Setiap definisi jenis meliputi:

• Pengenal namespaced unik

• Judul

• Deskripsi

• Properti yang menentukan pemformatan dan kendala data

Jenis dapat berupa primitif sederhana, seperti bilangan bulat atau string dengan batas yang ditentukan, atau struktur kompleks seperti enumerasi atau objek khusus dengan beberapa bidang. Definisi tipe menggunakan sintaks skema JSON untuk menentukan batasan termasuk nilai minimum dan maksimum, panjang string, dan pola yang diijinkan.

Untuk informasi selengkapnya, lihat Skema untuk definisi tipe.