Bir sayaç verisi CSV şema sürümü sözleşmesi, her sütunun ne anlama geldiğini, hangi değerlere izin verildiğini ve hangi içe aktarıcı sürümlerinin dosyayı güvenli bir şekilde okuyabileceğini tanımlar. Bir dışa aktarma işlemini değiştirmeden önce bu sözleşme üzerinde alıcı sistemle mutabakata varın, hem uyumlu hem de uyumsuz örnekleri test edin ve bilinmeyen sürümlerin açıkça hata vermesini sağlayın. Bir dosyanın elektronik tablo programında başarıyla açılması, elektriksel ölçümlerinin doğru yorumlanacağının kanıtı değildir.
Bu kılavuz, harici bir veri dışa aktarıcısı ile içe aktarıcısı arasındaki anlaşmayı ele alır. Herhangi bir sayaç için yerleşik bir CSV işlevi tanımlamaz. Endüstriyel bir tesisatta ölçümler, CSV dosyası oluşturulmadan önce bir ağ geçidi, denetleyici uygulama veya raporlama hizmetinden geçebilir.
Dosya sözdizimini ölçüm anlamından ayırın
CSV, içeriğin tam mühendislik anlamını değil, metinsel düzenini tanımlar. RFC 4180 kayıtlar, alanlar ve tırnak işaretlerinin kullanımı dâhil olmak üzere yaygın CSV kurallarını belgelendirir. Bilgilendirici niteliktedir; sayaç tanımlayıcılarınızı, enerji yönünü, kalite kodlarını veya zaman sınırlarını tanımlamaz. İki dosya aynı tırnak işareti kuralına uyarken tamamen farklı ölçümleri temsil edebilir.
The W3C tablo veri modeli tablo değerleri ile bunları açıklamaya veya doğrulamaya yardımcı olan meta veriler arasında kullanışlı bir ayrım sunar. Kendi veri alışverişinizi tanımlarken bu ayrımdan yararlanın. Hem bir değerin nasıl yazıldığını hem de alıcı sistemin bu değerden hangi sonuçları çıkarmasına izin verildiğini belgeleyin.
Örneğin, energy adlı bir sütun kümülatif bir sayaç kaydını veya belirli bir aralıktaki enerji tüketimini temsil edebilir. Bu anlamı yeni bir sözleşme oluşturmadan değiştirmek, sütunun adını değiştirmekten çok daha önemli sonuçlar doğurur. Ölçüm sınırını, yönünü ve birimini açıkça belirtin. Aksi takdirde bir içe aktarıcı, yanlış büyüklükten makul görünen bir grafik oluşturabilir.
Satırları işlemeden önce sözleşmeyi tanımlayın
Biçime sabit bir tanımlayıcı ve yorumuna kontrollü bir revizyon atayın. Alıcı sistemin bunları nereden edineceğini kaydedin: eşlik eden bir meta veri kaydı, üzerinde anlaşılmış bir dosya kapsayıcısı veya açıkça tanımlanmış bir sütun. Dosya adı, yalnızca alıcı iş akışı bu adı doğruluyor ve işleme boyunca dosyayla olan ilişkisini koruyorsa uygun bir yöntemdir.
Sütun sayısından hareketle bir revizyon tahmin etmeyin. Farklı revizyonlar aynı sayıda alana sahip olabilir. Benzer şekilde, dosya adındaki yakın tarihli bir tarihe bakarak tahminde bulunmayın. Bu tarih, verinin üretildiği sürümü değil, verinin dışa aktarıldığı zamanı gösterebilir.
Dışa aktarıcı yazılım sürümünü veri alışverişi sözleşmesi sürümünden ayrı tutun. Bir yazılım yaması dosyayı değiştirmeden bırakabilir; bir yapılandırma ayarı ise yürütülebilir dosya güncellenmeden alanların anlamını değiştirebilir. Sözleşme, gerçek veri alışverişini tanımlamalı; ayrı bir kaynak kaydı ise dosyayı neyin oluşturduğunu belirtmelidir.
Asgari alan mutabakatını hazırlayın
İkinci bir mühendisin orijinal yazara soru sormadan kullanabileceği kısa ve kontrollü bir belge oluşturun. Her alan için sabit adını, anlamını, türünü, izin verilen boş değer durumunu ve doğrulama kuralını kaydedin. Yalnızca en kolay durumu gösteren örnekler yerine belirsizlikleri ortaya çıkaran örnekler ekleyin.
| Sözleşme öğesi | Açıkça kaydedilecek bilgiler | Şu durumlarda reddedin veya karantinaya alın |
|---|---|---|
| Sayaç kimliği | Kararlı varlık tanımlayıcısı ve onaylanmış eşleme | Tanımlayıcı bilinmiyor veya birden fazla varlığa eşleniyor |
| Miktar | Fiziksel miktar, yön ve ölçüm sınırı | Anlam onaylanan hesaplamadan farklıdır |
| Unit and scale | Birim, çarpan ve uygulama konumu | Ölçeklendirme iki kez uygulanabilir veya belirlenemeyebilir |
| Zaman | Bölge, aralık kuralı ve zaman damgası yorumu | Bir zaman damgası net şekilde atanamaz |
| Eksik okuma | Eksik, geçersiz ve ölçülen sıfır arasındaki fark | Boşluk sessizce sıfıra dönüşebilir |
| Kalite | İzin verilen kodlar ve aşağı akış işlemleri | Yeni bir kodun üzerinde anlaşılmış bir yorumu yok |
| Revizyon | Desteklenen sözleşme tanımlayıcıları ve geçiş kuralı | Alıcı sürümü tanımıyor |
Bunlar proje tasarım kontrolleridir, evrensel sayaç özellikleri değildir. Yukarıdaki sözdizimi ve meta veri referansları ayrımı destekler; gerçek izin verilen değerler, belgelenmiş kurulum ve alma uygulamanızdan gelir.
Bir değişikliği alıcı üzerindeki etkisine göre sınıflandırın
Ek bir isteğe bağlı alan, bilinen sütunları ada göre seçen ve onaylanmış ek alanları bilinçli olarak yok sayan bir alıcıyla uyumlu olabilir. Ancak tam olarak belirlenmiş bir sıralı düzen bekleyen bir alıcıda sorun yaratabilir. Bu nedenle isteğe bağlı olması, otomatik olarak güvenli olduğu anlamına gelmez. Uyumluluk, belgelenmiş veri üreticisi ve tüketicisi çiftinin bir özelliğidir.
Zorunlu bir alanın kaldırılması, birimin değiştirilmesi, enerji yönünün tersine çevrilmesi veya bir aralık sınırının değiştirilmesi normalde açık bir geçiş çalışması gerektirir. Değişen bir kalite kodunun anlamını, sayısal bir alanın değişmesiyle aynı ciddiyetle ele alın. Sayı aynı kalabilir ancak izin verilen kullanım şekli değişebilir.
Sütunların yeniden sıralanması ayrı bir testi hak eder. Sözleşme ada dayalı eşleştirme vaat ediyorsa alıcının bu vaade uyduğunu doğrulayın. Veri alışverişi sıralı konumlara dayanıyorsa beklenmeyen bir sıralamayı reddedin. Bir kişinin elektronik tablo başlığının yer değiştirdiğini fark etmesine asla güvenmeyin.
Küçük ama bilinçli bir test paketi oluşturun
Desteklenen her sürüm için onaylanmış bir dosya ve ayrıca kasıtlı olarak reddedilmesi gereken örneklerden oluşan ayrı bir küme bulundurun. Tırnak içine alınmış virgüller, boş bir alan, bilinmeyen bir varlık tanımlayıcısı, desteklenmeyen bir kalite kodu ve seçilen zaman standardını test eden bir zaman damgası ekleyin. Oluşturulmuş test okumalarını test verisi olarak etiketleyin ve bunları üretim veri alım sürecinden uzak tutun.
Bir birim değişikliği için yanlış yorumlandığında hatanın açıkça anlaşılabileceği sentetik bir örnek seçin. Yalnızca içe aktarma işleminin başarılı olduğu mesajını değil, beklenen yorumlanmış miktarı alıcının gerçek çıktısıyla karşılaştırın. Yalnızca bir dosyanın kabul edildiğini kanıtlayan bir test, ölçümlerin korunup korunmadığı hakkında hiçbir şey söylemez.
Geçiş sınırını da test edin. Bir toplu işlem, değişiklikten önce ve sonra oluşturulmuş dosyalar içerebilir. Her iki sürümün birlikte bulunup bulunamayacağına, ayrı kuyruklar kullanıp kullanmayacaklarına ve düzeltilmiş geçmiş dosyaların nasıl işleneceğine karar verin. Daha sonraki bir yeniden içe aktarma işleminin belleğe bağlı kalmaması için bu kararı test kanıtlarıyla birlikte saklayın.
Uygulamalı bir geçiş örneği
Harici bir raporlama hizmetinin şu anda kümülatif enerji gönderdiğini ve planlanan bir güncellemenin aralık enerjisini eklediğini varsayalım. Kümülatif alanın mevcut anlamını koruyun ve ek miktara farklı bir ad verin. Alıcı raporu güncellenmeden önce bu alanın birimini, aralık süresini, zaman damgası sınırını ve eksik veri davranışını belirtin.
Onaylanmış bir örneği üretim dışı bir alıcı üzerinden çalıştırın. Mevcut kümülatif gösterimin değişmeden kaldığını ve yeni aralık serisinin sözleşmeye uygun olarak hesaplandığını veya saklandığını kontrol edin. Ardından kasıtlı olarak yanlış etiketlenmiş bir örnek gönderin ve içe aktarıcının bunu yararlı bir açıklamayla reddettiğini doğrulayın.
Önerilen güncelleme yeni bir alan eklemek yerine orijinal alanı değiştiriyorsa eski sözleşme tanımlayıcısını yeniden kullanmayın. Bir geçiş eşlemesi hazırlayın ve hangi geçmiş çıktıların sürüm işaretleyicisine ihtiyaç duyduğuna karar verin. Bu örnek veri alışverişi tasarımını açıklar; belirli bir cihaz için dışa aktarma özelliği, doğruluk derecelendirmesi veya faturalandırma onayı oluşturmaz.
Reddedilme sırasında orijinal kanıtları koruyun
Reddedilen bir dosya; reddedilme nedeni, dosyayı alan yazılımın sürümü ve denenen sözleşme tanımlayıcısıyla birlikte, kontrollü bir kanıt saklama konumunda erişilebilir durumda tutulmalıdır. Alınan baytları aynen koruyun. Düzeltilmiş bir dosya sağlanırsa, ona farklı bir revizyon numarası verin ve reddedilen orijinal dosyanın üzerine yazmak yerine hangi dosyanın yerini aldığını kaydedin.
Alıcı, sözdizimi hatalarını sözleşme hatalarından ve mühendislik doğrulama hatalarından ayırt etmelidir. Eşleşmeyen bir tırnak işareti, desteklenmeyen birimden; her ikisi de makul olmayan bir ölçüm değerinden farklıdır. Ayrı hata nedenleri, geçerli bir kaynak dosyanın tekrar tekrar değiştirilmesine gerek kalmadan sorunun doğru kişi tarafından çözülmesine yardımcı olur.
İlgili kontroller için sayaç dışa aktarma dosyası bütünlüğü kılavuzunu alınan dosyaları korumak amacıyla, CSV başlığı ve kodlama kılavuzunu ise metin yorumlama sorunlarını gidermek amacıyla kullanın. Bu kontroller bir sürüm sözleşmesini tamamlar; ancak bunların hiçbiri tek başına anlamsal uyumluluğu garanti etmez.
Onay ve operasyonel sorumluluğu belirleyin
Dışa aktarıcı yapılandırmasının, alıcı içe aktarma kurallarının ve elektriksel yorumlamanın sorumlusunu belirleyin. Bir kişi birden fazla rolü üstlenebilir, ancak onay kaydı yine de her soruyu yanıtlamalıdır. Bir veri uzmanı, ölçüm sınırındaki bir değişikliği onaylama yetkisine sahip olmadan alan türlerini doğrulayabilir.
Bir geçiş tarihi ve geri alma karar noktası belirleyin. Değişiklik sırasında kuyrukta bekleyen dosyalara ne olacağını kaydedin. Alıcı sistem önceki sürüme döndürülürse, daha yeni dosyaların karantinada tutulup tutulmayacağını veya ayrıca doğrulanmış bir dönüştürme işlemine ihtiyaç duyup duymayacağını belirleyin. Eski yazılımın dosya yapısını kabul etmesi nedeniyle bu dosyaları hiçbir zaman sessizce eski bir sözleşmeye göre yeniden yorumlamayın.
Destek ekibine devir işlemi; onaylanmış sözleşmeyi, örnek dosyaları, beklenen sonuçları, bilinen ret mesajlarını ve güncel uyumluluk matrisini içermelidir. Bu, gelecekteki değişikliklerin test edilebilir olmasını sağlar ve yeni bir entegratörün formatı yalnızca uygun görünen tek bir dosyadan tersine mühendislik yoluyla çözmeye çalışması riskini azaltır.
Veri alışverişini kurulu gerçek sayaçla ilişkilendirin
Doğru cihaz ve belgelenmiş ayarlarıyla başlayın. Bu BY194 çok fonksiyonlu cihaz ürün sayfası ürün, bu makalenin ürün referansıdır. Sipariş edilen tam varyantı ve mevcut ölçüm özelliklerini ayrıca doğrulayın; bir ürün fotoğrafı dışa aktarma formatını, ağ geçidi işlevini veya arşivleme kapasitesini kanıtlayamaz.
Kullan ölçüm bağlamı için üç fazlı elektrik güç sayacı genel bakışını inceleyin, ardından her bir harici alanı onaylanmış nokta eşlemesine kadar geriye doğru izleyin. İyi yazılmış bir CSV sözleşmesi, üst sistemdeki yanlış bir akım trafosu oranını veya uyumsuz bir kayıt yorumlamasını düzeltemez.
Aşağıdaki Computerphile dersi, paylaşılan süreçlerdeki yarış koşullarını açıklar. Bu içerik, üretici ve tüketici değişikliklerinin koordinasyonuna yönelik kavramsal bir arka plan sunar; sayaca özgü bir yapılandırma prosedürü değildir ve burada açıklanan testlerin yerine geçmez.
Sık sorulan sorular
Yeni isteğe bağlı bir sütun her zaman yeni bir sözleşme revizyonu gerektirir mi?
Geriye dönük uyumlu olsa bile, kontrol ettiğiniz revizyon politikası altında değişikliği kaydedin. Bir alıcının sütunu kabul edip etmeyeceği, belgelenmiş eşleme ve doğrulama davranışına bağlıdır. Her ithalatçının ekstra alanları güvenli şekilde görmezden geldiğini varsaymak yerine, bu davranışı gerçek bir testle doğrulayın.
Alıcı, bilinmeyen bir CSV sürümünü otomatik olarak tahmin edebilir mi?
Otomatik tahmin yürütmek, geçerli görünen sayılara yanlış anlamlar yüklenmesi riskini taşır. Bilinmeyen bir sürümü karantinaya alın ve inceleme için gereken kanıtları bildirin. Bir dönüştürme işlemi daha sonra onaylanabilir; ancak bu işlem açıkça tanımlanmalı, test edilmeli ve orijinal dosyayla ilişkilendirilerek izlenebilir olmalıdır.
Bir kontrol toplamı uyumluluğu kanıtlamak için yeterli midir?
Sağlama toplamı, güvenilir bir referansa kıyasla bayt düzeyindeki değişikliklerin tespit edilmesine yardımcı olur. Ancak alanların anlamını, ölçü birimlerini veya alıcının formatı destekleyip desteklemediğini açıklamaz. Bütünlük kanıtlarını koruyun ve sözleşmeyi ayrı bir adım olarak doğrulayın.
Tarihî dosyalar sözleşme değiştiğinde yeniden yazılmalı mı?
Orijinal kanıtları ve bunların orijinal sözleşmeyle olan ilişkisini koruyun. Normalize edilmiş bir kopya gerekiyorsa dönüşümünü, sürümünü ve kaynakla olan ilişkisini kaydedin. Geçmişte türetilmiş çıktıların da yeniden oluşturulup oluşturulmayacağına karar vermeden önce saklama ve raporlama yükümlülüklerini gözden geçirin.