Cihaz şablonunu sürüm oluşturma

  • 4 dakika

Cihaz şablonu, bir cihazın IoT Central ile nasıl etkileşim kurduğunu açıklayan bir model içerir. Bu model, cihazın özelliklerini ve IoT Central'ın bunlarla nasıl etkileşim kuracaklarını tanımlar. Cihaz şablonundaki modelde yapılan değişiklikler, bağlı cihazlar da dahil olmak üzere uygulamanızın tamamını etkileyebilir. Kurallar, dışarı aktarmalar, cihaz grupları veya işler tarafından kullanılan bir özellikte yapılan değişiklikler beklenmedik şekilde davranmalarına veya hiç çalışmamalarına neden olabilir. Örneğin, bir telemetri tanımını bir şablondan kaldırırsanız:

  • IoT Central artık bu değeri yorumlayamaz. IoT Central, cihazın Ham veri sayfasında modellenmemiş veriler olarak yorumlayamayan cihaz verilerini gösterir.
  • IoT Central artık veri dışarı aktarma işlemlerindeki değeri içermez.

Cihaz şablonunu değiştirme

Modele özellik veya arabirim ekleme gibi ek değişiklikler hataya neden olmayan değişikliklerdir. Geliştirme yaşam döngüsünün herhangi bir aşamasında bir modelde ek değişiklikler yapabilirsiniz.

Hataya neden olan değişiklikler arasında modelin bölümlerini kaldırma veya yetenek adını veya şema türünü değiştirme sayılabilir. Bu değişiklikler kurallar, dışarı aktarmalar veya panolar gibi uygulama özelliklerinin hata iletilerini görüntülemesine ve çalışmayı durdurmasına neden olabilir.

Erken cihaz geliştirme aşamalarında, modeli tasarlamaya ve test etmeye devam ederken, doğrudan cihaz modelinizde değişiklik yapmaya daha fazla tolerans vardır. Üretim cihazlarını bir cihaz şablonuna bağlamadan önce, cihaz şablonunu doğrudan düzenleyebilirsiniz. IoT Central, cihaz şablonunu yayımladığınızda bu değişiklikleri cihazlara otomatik olarak uygular.

Üretim cihazlarını bir cihaz şablonuna ekledikten sonra, bir cihaz şablonunu düzenlemeden önce değişikliklerin etkisini değerlendirin. Üretimdeki bir cihaz şablonunda hataya neden olan değişiklikler yapmayın. Bu tür değişiklikler yapmak için cihaz şablonunun yeni bir sürümünü oluşturun. Yeni cihaz şablonunu test edin ve üretim cihazlarınızı zamanlanmış kapalı kalma süresiyle yeni şablona geçirin.

Eylemleri düzenleme ve yayımlama

Bir cihaz şablonunu düzenlerken aşağıdaki eylemler yararlıdır:

  • Save. Cihaz şablonunuzun bir bölümünü değiştirdiğinizde, değişiklikleri kaydetmek geri dönebileceğiniz bir taslak oluşturur. Bu değişiklikler henüz bağlı cihazları etkilemez. Bu şablondan oluşturulan tüm cihazlarda, siz yayımlayana kadar kaydedilmiş değişiklikler olmaz.
  • Yayımla. Cihaz şablonunu yayımladığınızda, kaydedilen tüm değişiklikler mevcut cihaz örneklerine uygulanır. Yeni oluşturulan cihaz örnekleri her zaman en son yayımlanan şablonu kullanır.
  • Şablon sürümü oluşturma. Bir cihaz şablonunu sürüm oluşturduğunuzda, en son kaydedilen değişiklikleri içeren yeni bir şablon oluşturur. Mevcut cihaz örnekleri yeni bir sürümde yapılan değişikliklerden etkilenmez.
  • Arabirim sürümü. Bir arabirim sürümü oluşturduğunuzda, en son kaydedilen özellikleri içeren yeni bir arabirim oluşturur. Bir şablonun içindeki birden çok konumda bir arabirimi yeniden kullanabilirsiniz. Bu nedenle, bir arabirim başvurusunda yapılan bir değişiklik, şablonda arabirimi kullanan tüm yerleri değiştirir. Bir arabirim sürümü oluşturduğunuzda, yeni sürüm artık ayrı bir arabirim olduğundan bu davranış değişir.
  • Cihazı geçirme. Bir cihazı geçirdiğinizde, cihaz örneği bir cihaz şablonundan diğerine geçiş yapılır. IoT Central değişiklikleri işlerken cihaz geçişi kısa bir gecikmeye neden olabilir.

Sürüm numaraları

Hem cihaz modellerinin hem de arabirimlerin sürüm numaraları vardır. Farklı sürüm numaraları, güncelleştirme geçmişini sağlarken modellerin veya arabirimlerin bir @id değeri paylaşmasına olanak tanır. Sürüm numaraları yalnızca şablonun veya arabirimin sürümünü seçmeyi seçerseniz veya sürüm numarasını kasıtlı olarak değiştirirseniz artar. Şablon veya arabirimde önemli bir değişiklik yaptığınızda sürüm numarasını değiştirmeniz gerekir.

Cihaz şablonunu sürüm oluşturma

Cihaz şablonunun sürümünü oluşturmak için:

  1. Cihaz şablonları sayfasına gidin.
  2. Sürüm oluşturmak istediğiniz cihaz şablonunu seçin.
  3. Sayfanın üst kısmındaki Sürüm'e tıklayın ve şablona yeni bir ad verin. IoT Central, düzenleyebileceğiniz yeni bir ad önerir.
  4. Oluştur seçeneğini belirleyin.

Screenshot that shows device template versioning.

Artık mevcut cihazlara bağlı olmayan benzersiz bir kimliğe sahip yeni bir şablon oluşturdunuz.

Arabirim sürümü oluşturma

Bir arabirimi sürüm olarak kullanmak için:

  1. Cihaz şablonları sayfasına gidin.
  2. Taslak modunda sahip olduğunuz cihaz şablonunu seçin.
  3. Sürüm ve düzenleme yapmak istediğiniz yayımlanmış arabirimi seçin.
  4. Arabirim sayfasının üst kısmındaki Sürüm'e tıklayın.
  5. Oluştur seçeneğini belirleyin.

Şimdi benzersiz bir kimliğe sahip yeni bir arabirim oluşturdunuz.

Bir cihazı sürümler arasında geçirme

Cihaz şablonunun birden çok sürümünü oluşturabilirsiniz. Zaman içinde, bu cihaz şablonlarını kullanan birden çok bağlı cihazınız olur. Cihazları cihaz şablonunuzun bir sürümünden diğerine geçirebilirsiniz. Aşağıdaki adımlarda bir cihazın nasıl geçirıldığı açıklanmaktadır:

  1. Cihazlar sayfasına gidin.
  2. Başka bir sürüme geçirmek için ihtiyacınız olan cihazı seçin.
  3. Geçir'i seçin.
  4. Cihazı geçirmek istediğiniz sürüme sahip cihaz şablonunu seçin ve Ardından Geçir'i seçin.