Her varlığın bir tür (ne olduğu), bir kod (yollarda kullanılan kısa ve benzersiz bir ad) ve isteğe bağlı olarak öznitelikler (sizin kendi anahtar-değer verileriniz) olabilir. Bu sayfa her biri için kuralları ve bunların nerede önemli olduğunu açıklar.
Türler
Varlık formundaki Tür listesi şunları sunar:
| Tür | Tipik kullanım |
|---|---|
| Site | Bir tesis, bir istasyon, bir depo: konumu olan üst düzey bir yer |
| Bina | Bir sitenin binası |
| Kat | Bir binanın katı |
| Oda | Bir oda, bir soğuk oda, bir tesis odası |
| Alan | Bir katın veya bir avlunun bölgesi |
| Hat | Bir üretim veya proses hattı |
| Makine | Bir makine veya bir ekipman parçası |
| Diğer | Diğer her şey |
Kendi türünüzü de kullanabilirsiniz: Başka tür seçip bir Tür adı yazın, örneğin PUMP_STATION, TANK veya KITCHEN. Bir tür adı 1 ila 24 karakterden oluşur: önce bir harf, ardından harfler, rakamlar ve _ gelir. Büyük harflerle saklanır. Plant, Region, Zone ve Depot da çevrilmiş bir adla gösterilir.
Yeni bir üst düzey varlık Site olarak başlar; yeni bir alt öğe Bina olarak başlar. Kaydetmeden önce değiştirin.
Türün önemli olduğu yerler
| Yer | Etkisi |
|---|---|
| Siteler ve Varlıklar | Tür rozeti ve Tür filtresi |
| Siteler pano şablonu | “Siteler”, Site türündeki varlıklardır; Bir türdeki siteler bunları daha da daraltır |
| Ayrıntılama tabloları (Bir varlığın altındaki durum) | Yalnızca bu türdeki düğümler ve Altında bu türde düğüm olan yalnızca düğümler türe göre filtreler, örneğin ROOM,FLOOR |
| 3B durum tonlaması | Öğeler Oda ve Alan varlıklarından, koda göre eşleştirilerek tonlanır |
| Akışlar (İlgili veriler) | türler ayarı yalnızca listelenen türlerdeki varlıkları tutar, örneğin üç seviye yukarıdaki SITE |
| Hazır çözümler | Bazıları kendi türlerini kullanır, örneğin kişisel takipte ZONE türündeki bölgeler |
Türler ağacı sınırlamaz: herhangi bir tür herhangi başka bir türün altında yer alabilir.
Kodlar
Kod, bir varlığı yolunda adlandırır. Kurallar:
| Kural | Ayrıntı |
|---|---|
| Karakterler | harfler, rakamlar, ., _, -; ilki bir harf veya rakam olmalı; asla / olmaz |
| Uzunluk | 1 ila 32 |
| Büyük/küçük harf | Büyük harflerle saklanır: bld-a olur BLD-A |
| Benzersiz | Kuruluşunuzun varlıkları arasında: “Bu kodu zaten başka bir varlık kullanıyor.” |
| Boş | Addan üretilir: aksanlar kaldırılır, büyük harfe çevrilir, diğer karakterler - olur, en fazla 24 karakter, alınmışsa -2, -3, … eklenir. “Compressor room” olur COMPRESSOR-ROOM. |
Formdaki ipucu: “Harfler, rakamlar, . _ – (en fazla 32). Addan türetmek için boş bırakın; sonradan değiştirmek aşağıdaki yolları yeniden yazar.”
Yollar
Bir varlığın Yolu, üstten aşağıya kodların / ile birleştirilmesidir:
/IST/BLD-A/GF/COMPRESSOR-ROOMYol, çekmecenin Genel bakış bölümünde gösterilir ve bir varlığın altındaki her şeyi bulmak için kullanılır. Bir kodu değiştirmek, aynı adımda altındaki tüm varlıkların yollarını yeniden yazar. Bir yol en fazla 1.024 karakter olabilir.
Kalıcı kodlar seçin
- Kısa ve kararlı kodlar kullanın: bir site numarası, bir bina harfi, bir oda numarası (
IST,BLD-A,R101). - 3B sahnelerde odalar ve alanlar, kodlarıyla sahne öğelerine eşleştirilir. Bir kodu yeniden adlandırırsanız, öğe anahtarını da yeniden adlandırın.
- Kodları herhangi bir büyük/küçük harf biçiminde yazabilirsiniz: büyük harflerle saklanırlar, bu nedenle
r101veR101aynı koddur.
Öznitelikler
Öznitelikler, bir varlık üzerindeki kendi anahtar-değer verileriniz; bir alan, bir maliyet merkezi, bir sözleşme numarası, bir kat planı görüntü adresi gibi. Çekmecenin Öznitelikler bölümü bunları salt okunur gösterir. Bunları API üzerinden yazarsınız:
PATCH /tenant/<tenantId>/api/iot/assets/<assetId>
{ "attributes": { "area_m2": 42, "cost_centre": "CC-4410", "contract": { "number": "M-77", "until": "2027-06-30" } } }attributes ile yapılan bir PATCH, tüm öznitelik nesnesini değiştirir: tutmak istediğiniz her anahtarı gönderin. Bkz. Siteler ve varlıklar API.
| Kural | Değer |
|---|---|
| Anahtarlar | önce bir harf, ardından harfler, rakamlar, ., _, -; en fazla 64 karakter |
| Anahtar sayısı | en fazla 100 |
| Boyut | toplamda en fazla 16 KiB JSON |
| Değerler | sayılar, metin, mantıksal değerler, nesneler, listeler |
Özniteliklerin kullanıldığı yerler
- Panolar: Tek varlık sorgusu (ad, tür, sayılar, öznitelikler) bunları gösterir, örneğin bir sitenin üstbilgisinde.
- Akışlar: İlgili veriler bloğu bir varlığın özniteliklerini okur, örneğin bir sayacın bulunduğu sitenin tarifesi. Bkz. IoT veri blokları.
- Hazır çözümler: örneğin bir sensör bölgesinin kat planı görüntüsü veya bir kişisel takip bölgesinin beacon’ı.
Varlıklar telemetri saklamaz. Canlı değerler cihazlara aittir; bir varlık, altındaki cihazların değerlerini ve durumunu gösterir.
Diğer alanlar
| Alan | Ayarlandığı yer | Kullanım |
|---|---|---|
| Açıklama | Form | En fazla 1.000 karakter, çekmecede gösterilir |
| Saat dilimi, Enlem, Boylam | Form | Bkz. Konumlar ve saat dilimleri |
Adres (addressJson) | API | En fazla 12 metin alanı; bir sitenin sayfa üstbilgisi, üstünde varlık yoksa bunu gösterir |
Varsayılan pano (defaultDashboardId) | API | Çekmecenin Panoyu aç düğmesi bunu açar |