Çok sayıda cihaz (onlarca veya yüzlerce) eklemeniz gerektiğinde, cihazları tek tek değil, bir CSV dosyasından ekleyin. Her içe aktarma önce kontrol edilir (“Her içe aktarma önce kuru çalıştırılır: biri neyin olacağını inceleyene kadar hiçbir şey yazılmaz.”), ardından uygulanır ve geri alınabilir. Yeni cihazlar kimlik bilgilerini hemen alır; bunlar yalnızca bir kez indirilebilen bir dosyada sunulur.
İçe aktarmalar İçe Aktarmalar sayfasında yapılır (adres /admin/settings/imports, menünün Kuruluş bölümünde). Sayfa, kuruluşunuzda içe aktarma modülü açık olduğunda görünür. Cihaz oluşturma iznine ihtiyacınız vardır.
Dosyayı hazırlayın
Dosya UTF-8 olarak kaydedilmiş, virgül, noktalı virgül veya sekme ile ayrılmış bir CSV dosyasıdır ve ilk satırında sütun adları bulunur. Dosya başına en fazla 1.000 satır. Tüm sütunları ve bir örnek satırı içeren bir dosya almak için içe aktarma sihirbazında Şablon indir seçeneğini seçin.
| Sütun | Anlamı | Kurallar |
|---|---|---|
name | Cihaz adı (bu hesapta benzersiz) | Zorunlu. |
label | Etiket | İsteğe bağlı serbest metin. |
type | Cihaz türü | İsteğe bağlı, örneğin pump-controller. |
profile | Cihaz profili adı (boş = varsayılan profil) | Profil mevcut olmalıdır. |
serial | Seri numarası | İsteğe bağlı, A–Z a–z 0–9 . _ : - karakterlerinden en fazla 32 karakter. Platformda benzersiz. |
mac | MAC adresi | İsteğe bağlı. Cihazın ek bilgilerinde saklanır. |
credentialType | Kimlik bilgisi türü (boş = ACCESS_TOKEN) | ACCESS_TOKEN veya MQTT_BASIC. X.509 hiçbir zaman içe aktarılmaz. |
mqttUsername | MQTT kullanıcı adı (MQTT_BASIC; boş = otomatik üretilir) | Platformda benzersiz. |
mqttClientId | MQTT istemci kimliği (MQTT_BASIC, isteğe bağlı) | A–Z a–z 0–9 . _ : - karakterlerinden 1 ila 64 karakter. |
attr:<key> | Bir sunucu özniteliği | En fazla 50 öznitelik sütunu, değerler en fazla 4.096 karakter. |
shared:<key> | Bir paylaşılan öznitelik | Yukarıdakiyle aynı. |
Örnek:
name,label,profile,serial,credentialType,attr:maxTemp,shared:cfg.report_interval_s
pump-house-01,Pump house north,Water pumps,SN-000123,ACCESS_TOKEN,80,300
pump-house-02,Pump house south,Water pumps,SN-000124,MQTT_BASIC,75,300Uyarı
Dosyaya asla gizli bilgi koymayın. Gizli bilgi gibi adlandırılmış bir sütun (token, password, secret, key, credential, claim code) reddedilir; erişim belirteci gibi görünen bir hücre de reddedilir. Hermetry kimlik bilgilerini kendisi oluşturur.
İçe aktarma
- İçe Aktarmalar sayfasını açın ve Yeni içe aktarma seçeneğini seçin.
- Dosya: Neyi içe aktarmak istiyorsunuz altından IoT cihazları seçin, CSV dosyası seçin ve İlk satır sütun adlarını içerir seçeneğini açık bırakın. Sihirbaz bulduğu satır sayısını gösterir.
- Sütunlar: her alanın dosyanızdaki doğru sütuna karşılık geldiğini kontrol edin (“Adları eşleşen sütunlar zaten doldurulmuştur.”).
attr:veyashared:ile başlayan sütunlar olduğu gibi alınır. Kayıt zaten varsa seçeneğini belirleyin:
| Strateji | Etkisi |
|---|---|
| Yalnızca yeni kayıtları ekle; mevcut olanları bildir | Var olan bir ad hata sayılır. |
| Yalnızca mevcut kayıtları güncelle | Yalnızca var olan adlar değiştirilir; diğerleri atlanır. |
| Yeni kayıtları ekle ve mevcut olanları güncelle | İkisi de. |
| Yeni kayıtları ekle ve mevcut olanları atla | Var olan adlar atlanır. |
- Dosyayı kontrol et seçeneğini seçin. Her satır kontrol edilir; henüz hiçbir şey yazılmaz. Kontrol adımı Dosyadaki satırlar, İçe aktarmaya hazır, Atlanacak ve Sorunu olan sayılarını ve Sorunlu satırlar (Satır, Alan, Sorun) tablosunu gösterir.
- Dosyayı düzeltin ve Başka dosya seç seçeneğini kullanın ya da İçe aktar n satır seçeneğini seçip onaylayın. Sorunlu satırlar dışarıda bırakılır.
Kontrolün reddettikleri
| Sorun | Anlamı |
|---|---|
| Bu ad dosyada birden fazla kez geçiyor. | Her ad dosya içinde bir kez geçebilir. Seri numaraları ve MQTT kullanıcı adları için de geçerlidir. |
| “…” adında bir cihaz profili yok. | Önce profili oluşturun ya da varsayılan profil için sütunu boş bırakın. |
| “…” adında bir cihaz zaten var. | Yalnızca yeni satırları içe aktarmak için “yinelenenleri atla”, mevcut cihazları değiştirmek için “güncelle” seçeneğini seçin. |
| Bir içe aktarma, mevcut bir cihazın seri numarasını değiştirmez. | Seri numaraları sabittir. |
| “…” profili … yapılmasına izin vermiyor. | Profil bu kimlik bilgisi türüne izin vermiyor. Başka bir profil veya kimlik bilgisi türü seçin. |
| Bu seri numarasına sahip bir cihaz zaten kayıtlı. | Lisanslı bir birim içe aktarmayla değil, sahiplenilerek eklenir. |
| Bu MQTT kullanıcı adı zaten kullanımda. | Kullanıcı adları platformda benzersizdir. |
Planınızın cihaz sınırı, hiçbir şey yazılmadan önce tüm dosya için kontrol edilir: sığmayan bir dosya, sayılarla birlikte tamamen reddedilir.
Bir güncellemenin değiştirdikleri
Bir güncelleme etiketi, türü, profili, MAC adresini ve öznitelikleri değiştirir ve geri alma için eski değerleri saklar. Seri numarasını veya kimlik bilgisini asla değiştirmez (“Mevcut bir cihazın kimlik bilgisi içe aktarmayla değiştirilmez; cihaz sayfasından yenileyin.”). Aynı dosyayı yeniden yüklemek güvenlidir: hiçbir şey iki kez oluşturulmaz ve kimlik bilgisi yeniden üretilmez; sihirbaz tam dosyanın daha önce içe aktarıldığı konusunda uyarır.
Kimlik bilgilerini indirin
Cihaz ekleyen bir içe aktarmadan sonra Sonuç adımı Bir adım daha seçeneğini sunar: Yeni cihazların kimlik bilgilerini indir. “Bu içe aktarmanın eklediği cihazların erişim belirteçleri ve MQTT parolaları, içe aktarmadan sonraki 15 dakika içinde bir kez indirilebilen tek bir dosyada sunulur. Güvenle saklayın: bir daha gösterilmez.”
- Yalnızca içe aktarmayı çalıştıran kişi indirebilir.
- İndirildikten sonra veya 15 dakika geçtikten sonra dosya kaybolur (“Tamamlandı. Bu tekrarlanamaz.”).
- Dosyası kaybolan bir cihaz, cihaz sayfasındaki Sırrı döndür seçeneğiyle kendi sayfasından yeni kimlik bilgileri alır.
Geri alma
Sonuç adımı ve içe aktarma listesi Bu içe aktarmayı geri al seçeneğini sunar: “Eklenen kayıtlar kaldırılır ve değiştirilen kayıtlar eski hallerine döndürülür.” Cihazlar için:
- oluşturulan bir cihaz, yalnızca hiç bağlanmamışsa kaldırılır,
- güncellenen bir cihaz, içe aktarmadan önceki değerlerine döndürülür.
Geri döndürülemeyen satırlar sayılır (“n satır geri döndürülemedi.”).