Eszközsablon szerkesztése

Az eszközsablonok olyan modellt tartalmaznak, amely leírja, hogyan működik az eszköz az IoT Centrallal. Ez a modell határozza meg az eszköz képességeit, és azt, hogy az IoT Central hogyan kommunikál velük. Az eszközök telemetriai és tulajdonságértékeket küldhetnek az IoT Centralnak, az IoT Central pedig tulajdonságfrissítéseket és parancsokat küldhet egy eszközre. Az IoT Central emellett a modell használatával határozza meg az IoT Central funkcióival, például a feladatokkal, szabályokkal és exportálásokkal való interakciókat.

Az eszközsablon modelljének módosítása hatással lehet a teljes alkalmazásra, beleértve a csatlakoztatott eszközöket is. A szabályok, exportálások, eszközcsoportok vagy feladatok által használt képességek módosítása váratlan viselkedést okozhat, vagy egyáltalán nem működik. Ha például eltávolít egy telemetriadefiníciót egy sablonból:

• Az IoT Central már nem tudja értelmezni ezt az értéket. Az IoT Central megjeleníti azokat az eszközadatokat, amelyeket nem tud feldolgozatlan adatként értelmezni az eszköz Nyers adatok lapján.
• Az IoT Central már nem foglalja magába az adatexportok értékét.

Annak érdekében, hogy elkerülhesse az eszközsablonok szerkesztésének nem szándékos következményeit, ez a cikk az aktuális fejlesztési életciklus-szakasz alapján tartalmaz javaslatokat. Általában minél korábban jár a fejlesztési életciklusban, annál toleránsabb lehet az eszközsablonok módosítása.

Ha többet szeretne megtudni az eszközsablonokról és az eszközsablonok létrehozásáról, olvassa el az Eszközsablonok éseszközsablonok létrehozása az Azure IoT Central-alkalmazásban című témakört.

Ha tudni szeretné, hogyan kezelheti az eszközsablonokat az IoT Central REST API-val, olvassa el az IoT Central REST API használatát az eszközsablonok kezeléséhez.

Eszközsablon módosítása

Az additív változtatások, mint például egy képesség vagy interfész hozzáadása egy modellhez, nem okoznak törést. A modellen a fejlesztési életciklus bármely szakaszában végezhet additív módosításokat.

A kompatibilitástörő változások közé tartozik a modell részeinek eltávolítása, illetve a képességnév vagy sématípus módosítása. Ezek a módosítások olyan alkalmazásfunkciókat okozhatnak, mint a szabályok, az exportálások vagy az irányítópultok, amelyek hibaüzeneteket jelenítenek meg, és nem működnek.

A korai eszközfejlesztési fázisokban, amikor még az eszközmodell tervezésével és tesztelésével foglalkozik, nagyobb a tolerancia az eszközmodell közvetlen módosítására. Mielőtt gyártási eszközöket csatlakoztat egy eszközsablonhoz, közvetlenül szerkesztheti az eszközsablont. Az IoT Central automatikusan alkalmazza ezeket a módosításokat az eszközökre az eszközsablon közzétételekor.

Miután éles eszközöket csatolt egy eszközsablonhoz, értékelje ki a módosítások hatását az eszközsablon szerkesztése előtt. Éles környezetben nem szabad kompatibilitástörő módosításokat végeznie egy eszközsablonon. Az ilyen módosítások elvégzéséhez hozza létre az eszközsablon új verzióját. Tesztelje az új eszközsablont, majd egy ütemezett állásidő során migrálja az éles eszközöket az új sablonhoz.

IoT Edge-eszközsablon frissítése

IoT Edge-eszköz esetén a modell az eszközön futó IoT Edge-moduloknak megfelelő modulok szerint csoportosítja a képességeket. Az üzembehelyezési jegyzék egy különálló JSON-dokumentum, amely közli egy IoT Edge-eszközrel, hogy mely modulokat kell telepíteni, hogyan konfigurálhatja őket, és milyen tulajdonságokkal rendelkezik a modul. Ha módosít egy üzembehelyezési jegyzékfájlt, frissítheti az eszközsablont úgy, hogy az tartalmazza a jegyzékben meghatározott modulokat és tulajdonságokat:

1. Lépjen az eszközsablon Modulok csomópontjához.
2. A Modulok összegzése lapon válassza a Modulok importálása a jegyzékből lehetőséget.
3. Válassza ki a megfelelő üzembehelyezési jegyzékfájlt, és válassza az Importálás lehetőséget.

További információ: IoT Edge-eszközök és IoT Central.

Műveletek szerkesztése és közzététele

Az eszközsablonok szerkesztésekor az alábbi műveletek hasznosak:

• Mentés. Az eszközsablon egy részének módosításakor a módosítások mentése létrehoz egy vázlatot, amelybe visszatérhet. Ezek a módosítások még nem érintik a csatlakoztatott eszközöket. A sablonból létrehozott eszközök nem rendelkeznek a mentett módosításokkal, amíg közzé nem teszi azt.
• Közzététel. Az eszközsablon közzétételekor a meglévő eszközpéldányokra alkalmazza a mentett módosításokat. Az újonnan létrehozott eszközpéldányok mindig a legújabb közzétett sablont használják.
• Verziózzon egy sablont. Amikor egy eszközsablonról verziót készít, létrehoz egy új sablont az összes legutolsó mentett módosítással. Az új verzió módosításai nem érintik a meglévő eszközpéldányokat. További információért lásd: Eszközsablon verziózása.
• Felület verziója. Amikor egy felületet verziószámba ad, az új felületet hoz létre a legújabb mentett funkciókkal. A sablonon belül több helyen is újra felhasználhatja a felületet. Ez az újrafelhasználás az oka annak, hogy egy felületre mutató hivatkozás módosítása megváltoztatja a sablon összes olyan helyét, amely az interfészt használja. A felület verziójakor ez a viselkedés megváltozik, mivel az új verzió már egy külön felület. További információért lásd: Felület verzióinak kezelése.
• Eszköz áttelepítése. Az eszköz áttelepítésekor az eszközpéldány felcserél egy eszközsablont egy másikra. Az eszközök migrálása rövid időre okozhat fennakadásokat, amíg az IoT Central feldolgozza a módosításokat. További információ: Eszköz áttelepítése verziók között.

Verziószámok

Az eszközmodellek és a felületek egyaránt rendelkeznek verziószámmal. A különböző verziószámok lehetővé teszik, hogy a modellek vagy felületek megosszák egymással az @id értéket, miközben a frissítések előzményeit biztosítják. A verziószámok csak akkor növekednek, ha a sablon vagy a felület verziószámát választja, vagy ha szándékosan módosítja a verziószámot. Ha jelentős módosítást tesz egy sablonon vagy felületen, módosítania kell egy verziószámot.

Az alábbi kódrészlet egy termosztátos eszköz eszközmodelljét mutatja be. Az eszközmodell egyetlen felülettel rendelkezik. A verziószám 1a mező végén@id látható.

{
  "@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": [
    // ...
  ]
}

Ha meg szeretné tekinteni ezeket az információkat az IoT Central felhasználói felületén, válassza az Identitás szerkesztése lehetőséget az eszközsablon-szerkesztőben:

Eszköz sablon verziója

Eszközsablon verziózásához:

1. Nyissa meg az Eszközsablonok lapot.
2. Válassza ki a verziózni kívánt eszközsablont.
3. Válassza a Lap tetején található Verzió lehetőséget, és adjon új nevet a sablonnak. Az IoT Central új nevet javasol, amelyet szerkesztheti.
4. Válassza a Create gombot.

Most létrehozott egy új sablont, amely egy olyan egyedi identitással rendelkezik, amely nincs meglévő eszközökhöz csatolva.

Interfész verzió

Felület verziószámának beállítása:

1. Nyissa meg az Eszközsablonok lapot.
2. Válassza ki a piszkozat módban lévő eszközsablont.
3. Válassza ki a szerkeszteni és verziózni kívánt közzétett felületet.
4. Válassza a Verzió lehetőséget a felületoldal tetején.
5. Válassza a Create gombot.

Most létrehozott egy új, egyedi identitással rendelkező felületet, amely nem szinkronizálva van az előző felület verziójával.

Eszköz migrálása verziók között

Az eszközsablon több verzióját is létrehozhatja. Idővel több csatlakoztatott eszköz is lesz az eszközsablonok használatával. Az eszközöket áttelepítheti az eszközsablon egyik verziójából egy másikba. Az alábbi lépések az eszközök migrálását ismertetik:

1. Lépjen az Eszközök lapra .

2. Válassza ki azt az eszközt, amelyről át szeretne migrálni egy másik verzióra.

3. Válassza a Migrálás lehetőséget:

   

4. Válassza ki azt az eszközsablont, amelybe át szeretné telepíteni az eszközt, és válassza az Áttelepítés lehetőséget.

Jótanács

A feladatokkal egyszerre migrálhatja az eszközcsoport összes eszközét egy új eszközsablonba.