การตรวจสอบการเข้ารหัสหัวข้อ CSV ของมิเตอร์ไฟฟ้าช่วยให้แอปพลิเคชันที่รับข้อมูลอ่านชื่อคอลัมน์และอักขระที่ตั้งใจไว้ก่อนที่จะนำเข้าข้อมูลวัดผลใดๆ ยืนยันตัวคั่นในเอ็กซ์พอร์ต กฎการใช้คำพูด การเข้ารหัสอักขระ พฤติกรรมของเครื่องหมายบีบอัดข้อมูลแบบ Byte-Order-Mark และสัญญาหัวข้อ เปิดไฟล์ต้นฉบับเป็นข้อความ รวมทั้งผ่านตัวแยกวิเคราะห์ที่ควบคุม เปรียบเทียบหัวข้อที่ถอดรหัสแล้วกับโครงสร้างที่ต้องการ และทดสอบตัวอย่างขนาดเล็ก ห้ามเปลี่ยนชื่อคอลัมน์หรือบันทึกไฟล์ต้นฉบับซ้ำจนกว่าจะเข้าใจสาเหตุของความไม่ตรงกัน.
เอ็กซ์พอร์ตอาจมาจากเกตเวย์ภายนอก นักประวัติศาสตร์ หรือแอปพลิเคชันการจัดการพลังงาน แทนที่จะมาจากมิเตอร์แผงโดยตรง สำหรับการติดตั้ง CNBYG ให้ระบุเครื่องมือที่ให้มาและซอฟต์แวร์ที่รับผิดชอบไฟล์ การนำเข้า CSV ที่สำเร็จไม่ได้รับรองความถูกต้องทางไฟฟ้าของการอ่านข้อมูล และภาพถ่ายผลิตภัณฑ์ไม่ได้รับรองว่ามีฟังก์ชันการส่งออก CSV ในตัว.
แยกการถอดรหัสข้อความออกจากความหมายของคอลัมน์
การเข้ารหัสอักขระกำหนดวิธีที่ไบต์กลายเป็นอักขระ การกำหนดขอบเขตและการใช้คำพูดกำหนดวิธีที่ข้อความกลายเป็นฟิลด์ โครงสร้างกำหนดความหมายของฟิลด์เหล่านั้นและชื่อที่ยอมรับได้ นี่เป็นชั้นที่แตกต่างกัน ไฟล์สามารถถอดรหัสได้อย่างถูกต้องแต่ใช้ตัวคั่นผิด หรือแยกเป็นคอลัมน์ได้อย่างถูกต้องในขณะที่หัวข้อแรกมีอักขระที่มองไม่เห็นที่ไม่คาดคิด.
เริ่มต้นด้วยข้อกำหนดที่เอกสารของแอปพลิเคชันที่รับข้อมูลระบุไว้ คุณคาดหวังแถวหัวข้อหรือไม่? ชื่อมีความสำคัญตามตัวอักษรหรือไม่? เว้นวรรคได้รับอนุญาตหรือไม่? ต้องการลำดับเฉพาะหรือไม่ หรือแมปคอลัมน์ตามชื่อ? ถามคำถามเหล่านี้ก่อนเปลี่ยนไฟล์เพราะตัวนำเข้ารายงานว่ามีฟิลด์ที่ไม่รู้จัก ข้อความอาจเป็นอาการของการถอดรหัส การวิเคราะห์ หรือความไม่ตรงกันของโครงสร้างจริง.
ใช้ หน้ากระดาษครอบครัว BY194 เพื่อสร้างบริบทของผลิตภัณฑ์และค้นหาเอกสารที่เกี่ยวข้อง แยกการจัดการข้อมูลภายนอกออกจากความสามารถของเครื่องมือ การ คู่มือมิเตอร์สามเฟส can help define the measurement boundary, but it does not replace the exporter’s file specification.
รักษาไบต์ต้นฉบับไว้
บันทึกเอ็กซ์พอร์ตที่ไม่แตะต้องและบันทึกแหล่งที่มา เวลาในการสร้าง เวอร์ชันซอฟต์แวร์ หน้าต่างที่เลือก ชื่อไฟล์ และขนาด ใช้สำเนาทำงานสำหรับการตรวจสอบและการแปลง การเปิด CSV ในสเปรดชีตและกดบันทึกอาจเปลี่ยนการเข้ารหัส การใช้คำพูด วันที่ ศูนย์นำหน้า และการนำเสนอเชิงตัวเลข ซึ่งอาจซ่อนสาเหตุเดิมของความล้มเหลวในการนำเข้า.
หากมีเวิร์กโฟลว์เช็คซัมที่ได้รับการอนุมัติ ให้ระบุไฟล์ต้นฉบับก่อนแก้ไข เก็บเวอร์ชันที่แปลงแล้วแยกต่างหากและบันทึกสิ่งที่เปลี่ยนแปลง การทดสอบการนำเข้าควรชี้ไปยังเวอร์ชันที่ใช้โดยตรง หลีกเลี่ยงโฟลเดอร์ที่มีไฟล์หลายไฟล์ที่ตั้งชื่อว่า final เพราะการนำเข้าที่สำเร็จในภายหลังจะยากต่อการทำซ้ำ.
ตรวจสอบข้อความผ่านโปรแกรมแก้ไขหรือเครื่องวิเคราะห์ที่เหมาะสมซึ่งสามารถรายงานการเข้ารหัสและเปิดเผยอักขระผิดปกติ หลีกเลี่ยงการพึ่งพาเพียงตารางคอลัมน์ในสเปรดชีต หัวข้อที่ดูปกติทางสายตาอาจมีเครื่องหมายบีบอัดข้อมูลแบบ Byte-Order-Mark ช่องว่างที่ไม่แตกหัก ช่องว่างท้าย หรืออักขระ Unicode ที่แตกต่างกันซึ่งคล้ายกับตัวอักษรที่คุ้นเคย.
เข้าใจ UTF-8 และเครื่องหมายบีบอัดข้อมูลแบบ Byte-Order-Mark
เดอะ Unicode Consortium’s UTF and BOM FAQ อธิบายเครื่องหมายบีบอัดข้อมูลแบบ Byte-Order-Mark และพฤติกรรมของมันในแต่ละการเข้ารหัส Unicode ใน UTF-8 BOM อาจทำหน้าที่เป็นลายเซ็นของการเข้ารหัส แต่ไม่จำเป็นต้องใช้เพื่อกำหนดลำดับไบต์ บางแอปพลิเคชันจัดการโดยอัตโนมัติ บางแอปพลิเคชันสามารถแสดงมันเป็นส่วนหนึ่งของฟิลด์แรกถ้าการถอดรหัสของพวกเขาไม่เหมาะสม.
อย่าสันนิษฐานว่าชื่อคอลัมน์แรกที่แปลกทุกชื่อเป็นผลมาจาก BOM ให้ตรวจสอบไบต์จริงและพฤติกรรมการถอดรหัสด้วยเครื่องมือที่เหมาะสม ฟิลด์แรกอาจมีอักขระที่ไม่ต้องการอย่างตรงตัว ตัวคั่นผิดอาจรวมบรรทัดทั้งหมด หรือโครงสร้างข้อมูลที่รับอาจคาดหวังชื่ออื่น แทนที่จะใช้กฎลบอักขระตัวแรกแบบสากล.
ตัวเลือกการถอดรหัสที่รองรับ BOM อาจเหมาะสมในกรณีที่ตัวนำเข้า รองรับมัน และข้อตกลงของอินเทอร์เฟซอนุญาตให้ไฟล์ หากต้องการแปลง ให้ดำเนินการบนสำเนาแยกต่างหากโดยใช้วิธีการที่เอกสารรับรอง เก็บบันทึกการเข้ารหัสต้นทางและปลายทาง และตรวจสอบให้แน่ใจว่าป้ายชื่อที่ไม่ใช่ ASCII ยังคงอยู่ การลบไบต์โดยไม่เลือกสรรอาจทำลายอักขระที่ถูกต้องตามกฎหมาย.
| อาการ | สาเหตุที่เป็นไปได้ในการตรวจสอบ | การตรวจสอบที่เป็นประโยชน์ |
|---|---|---|
| เฉพาะหัวข้อแรกเท่านั้นที่ไม่ตรงกัน | BOM หรืออักขระนำหน้าตัวอื่น | ตรวจสอบไบต์ต้นฉบับและการแสดงผลของฟิลด์แรกที่ถอดรหัส |
| หัวข้อทั้งหมดปรากฏเป็นคอลัมน์เดียว | ความไม่ตรงกันของตัวคั่นหรือการใช้เครื่องหมายคำพูด | วิเคราะห์ด้วยกฎตัวคั่นและเครื่องหมายคำพูดที่ระบุไว้ในเอกสาร |
| ป้ายชื่อที่มีเครื่องหมายวรรณยุกต์ปรากฏเสียหาย | การถอดรหัสอักขระไม่ถูกต้อง | เปรียบเทียบการเข้ารหัสต้นฉบับกับการตั้งค่าการนำเข้า |
| ชื่อดูถูกต้องแต่การแมปไม่สำเร็จ | ความแตกต่างของตัวพิมพ์, ช่องว่าง หรือโครงสร้างข้อมูล | เปรียบเทียบสตริงที่ถอดรหัสอย่างแม่นยำกับชื่อฟิลด์ที่ต้องการ |
| ตัวระบุสูญเสียเลขศูนย์นำหน้า | การแปลงประเภทสเปรดชีต | ตรวจสอบข้อความต้นฉบับและกำหนดค่าฟิลด์เป็นข้อความ |
| ค่าที่ป้อนเข้าไปในคอลัมน์ผิด | ตัวคั่นฝังอยู่ภายในหรือเครื่องหมายคำพูดผิดรูปแบบ | ตรวจสอบความถูกต้องของบันทึกทั้งหมดแทนที่จะแยกตามเครื่องหมายจุลภาคทุกตัว |
นี่เป็นความเป็นไปได้ในการวินิจฉัย ไม่ใช่ข้อสรุปอัตโนมัติ บันทึกหลักฐานที่สังเกตได้และยืนยันสาเหตุก่อนนำไปใช้การแก้ไข.
แยกวิเคราะห์ไฟล์ CSV โดยใช้กฎการใส่เครื่องหมายอัญประกาศที่ถูกต้อง
เดอะ คำอธิบาย RFC 4180 CSV อธิบายหลักปฏิบัติทั่วไปของ CSV รวมถึงการมีหรือไม่มีส่วนหัวคอลัมน์ และการใช้เครื่องหมายอัญประกาศครอบฟิลด์ที่มีเครื่องหมายจุลภาคหรือการขึ้นบรรทัดใหม่ ข้อมูลนี้มีไว้เพื่อให้ความรู้เท่านั้น ไม่ได้หมายความว่าโปรแกรมส่งออกข้อมูลทั้งหมดจะใช้รูปแบบเดียวกัน การส่งออกข้อมูลที่คั่นด้วยเครื่องหมายอัฒภาคอาจถูกต้องตามข้อกำหนดของระบบนั้น แม้ว่าจะแตกต่างจากรูปแบบมาตรฐานที่ใช้เครื่องหมายจุลภาคก็ตาม.
อย่าแยกข้อความทุกบรรทัดด้วยเครื่องหมายจุลภาค แล้วถือว่าส่วนที่ได้เป็นฟิลด์ข้อมูล อย่าใช้วิธีนี้ เพราะข้อความที่ครอบด้วยเครื่องหมายอัญประกาศอาจมีเครื่องหมายจุลภาคอยู่ภายใน และฟิลด์ที่ครอบด้วยเครื่องหมายอัญประกาศอาจครอบคลุมหลายบรรทัด ให้ใช้ตัวแยกวิเคราะห์ที่กำหนดค่าตามรูปแบบที่ระบุไว้ ตรวจสอบว่าส่วนหัวคอลัมน์และระเบียนข้อมูลมีจำนวนฟิลด์ตรงตามที่คาดหวังภายใต้ตัวแยกวิเคราะห์ดังกล่าว แทนการนับด้วยสายตาอย่างง่าย.
เดอะ คู่มือการตรวจสอบความถูกต้องของ locale CSV ครอบคลุมปฏิสัมพันธ์ระหว่างตัวคั่นและการตั้งค่ารูปแบบตัวเลขตามภูมิภาค ควรแยกประเด็นนี้ออกจากเรื่องการเข้ารหัส การถอดรหัส UTF-8 อย่างถูกต้องไม่ได้เป็นตัวกำหนดว่าเครื่องหมายจุลภาคเป็นตัวคั่นทศนิยมหรือตัวคั่นฟิลด์ ควรบันทึกการตัดสินใจทั้งสองประเด็นไว้ในการกำหนดค่าการนำเข้าข้อมูล.
เปรียบเทียบข้อกำหนดของส่วนหัวคอลัมน์อย่างตรงตามต้นฉบับ
จัดทำตารางเปรียบเทียบขนาดเล็ก โดยระบุชื่อที่ได้รับหลังการถอดรหัส ชื่อที่จำเป็น ความหมายที่ต้องการ และการจับคู่ฟิลด์ที่เสนอ ตรวจสอบตัวพิมพ์ใหญ่และตัวพิมพ์เล็ก ช่องว่าง เครื่องหมายวรรคตอน และคำต่อท้ายที่ระบุหน่วย หลีกเลี่ยงการตัดช่องว่างหรือเปลี่ยนชื่อทั้งหมดเป็นตัวพิมพ์เล็กโดยอัตโนมัติ เว้นแต่ข้อกำหนดของระบบปลายทางจะอนุญาตให้ปรับรูปแบบดังกล่าวได้อย่างชัดเจน มิฉะนั้น ฟิลด์ที่แตกต่างกันสองฟิลด์อาจถูกแปลงเป็นชื่อเดียวกันหลังการปรับรูปแบบ.
ตรวจสอบส่วนหัวคอลัมน์ที่ซ้ำกันก่อนนำเข้าข้อมูล ตัวแยกวิเคราะห์อาจปฏิเสธชื่อที่ซ้ำกัน เปลี่ยนชื่อให้แตกต่างกัน หรือเก็บค่าไว้เพียงค่าเดียว ขึ้นอยู่กับการออกแบบ หากไฟล์มีสองฟิลด์ที่ชื่อ energy อย่าคาดเดาว่าฟิลด์ใดเป็นพลังงานสะสม และฟิลด์ใดเป็นปริมาณการใช้พลังงานในช่วงเวลาใดช่วงเวลาหนึ่ง ให้ขอไฟล์ส่งออกที่แก้ไขแล้ว หรือขอการจับคู่ฟิลด์อย่างชัดเจนที่ได้รับอนุมัติจากผู้ดูแลระบบ.
หน่วยควรระบุไว้ในโครงสร้างข้อมูลหรือในคำจำกัดความของฟิลด์ที่มีการบันทึกไว้อย่างชัดเจน ส่วนหัวคอลัมน์ที่ระบุเพียง value นั้นไม่เพียงพอที่จะแยกความแตกต่างระหว่าง kW, kWh, กระแสไฟฟ้า หรือค่าดิบจากรีจิสเตอร์ที่ผ่านการปรับสเกลแล้ว การตรวจสอบการแมปของเฟสและรวมทั้งหมด อธิบายว่าเหตุใดคอลัมน์ที่ดูเหมือนถูกต้องและสมเหตุสมผลจึงยังจำเป็นต้องตรวจสอบขอบเขตการวัด การแยกวิเคราะห์ข้อมูลสำเร็จเป็นเพียงจุดเริ่มต้นของการตรวจสอบความถูกต้องทางวิศวกรรมเท่านั้น.
ทดสอบข้อความและตัวระบุที่ไม่ใช่ ASCII อย่างตั้งใจ
ใช้ชุดข้อมูลตัวอย่างที่ได้รับอนุญาตและมีป้ายกำกับที่เป็นตัวแทนของข้อมูลจริง รวมถึงอักขระที่ไม่ใช่ ASCII หากชุดข้อมูลจริงมีอักขระเหล่านั้น ตรวจสอบว่าระบบนำเข้ารักษาป้ายกำกับดังกล่าวไว้ได้อย่างถูกต้อง และการส่งออกจากระบบปลายทางไม่ทำให้ข้อมูลเสียหาย การทดสอบที่มีเฉพาะอักขระ ASCII ธรรมดาอาจผ่านได้ แม้ว่าขั้นตอนการทำงานจะจัดการอักขระประเภทอื่นอย่างไม่ถูกต้องก็ตาม.
ตัวระบุต้องได้รับการตรวจสอบเป็นพิเศษ รหัสสายป้อน หมายเลขประจำเครื่องของมิเตอร์ หรือรหัสอ้างอิงสถานที่ อาจมีลักษณะเป็นตัวเลข แต่ทำหน้าที่เป็นข้อความ ควรรักษาเลขศูนย์ที่อยู่ด้านหน้าไว้ และหลีกเลี่ยงการแปลงเป็นรูปแบบสัญกรณ์วิทยาศาสตร์หรือการแปลงเป็นวันที่โดยไม่ตั้งใจ ให้เปรียบเทียบตัวระบุต้นฉบับกับค่าที่นำเข้า แทนการสันนิษฐานว่าค่าที่แสดงโดยประมาณนั้นเทียบเท่ากัน ควรระบุตัวระบุทดสอบที่ใช้แทนข้อมูลจริงให้ชัดเจนว่าเป็นเพียงตัวอย่าง.
ดำเนินการนำเข้าตัวอย่างที่ควบคุมได้
สร้างตัวอย่างขนาดเล็กที่รู้จักจากสำเนาทำงานภายในนโยบายการจัดการข้อมูลของโครงการ รวมถึงขอบเขตวันที่ การแทนค่าขาดข้อมูล และตัวระบุที่เป็นตัวแทนในกรณีที่เกี่ยวข้อง นำเข้าไปยังพื้นที่ทดสอบแทนที่จะเพิ่มเข้าไปในคลังข้อมูลผลิตภัณฑ์ทันที ตรวจสอบหัวข้อที่ถอดรหัส คอลัมน์ที่แมป จำนวนบันทึก หน่วย เวลาที่บันทึก และข้อมูลคุณภาพ.
ตรวจสอบความล้มเหลวในชั้นที่เหมาะสม หากการถอดรหัสล้มเหลว อย่าไปวิเคราะห์ค่าการวัด หากการแยกวิเคราะห์สำเร็จแต่การแมปล้มเหลว ให้เปรียบเทียบชื่อและโครงสร้างอย่างแม่นยำ หากการแมปสำเร็จแต่ค่าดูผิด ให้ตรวจสอบประเภท ภูมิภาค การปรับสเกล และความหมายของแหล่งที่มา ลำดับนี้ช่วยป้องกันไม่ให้การเปลี่ยนชื่อหัวข้ออย่างรวดเร็วปกปิดปัญหาข้อมูลที่สำคัญกว่า.
บทเรียนด้านพลังงานและกำลังต่อไปนี้ให้ข้อมูลพื้นฐานสำหรับการแยกแยะหน่วยวัดทั่วไปหลังจากไฟล์ถูกถอดรหัสและแมปแล้ว ไม่ใช่บทเรียน CSV หรือการพิสูจน์คุณสมบัติการส่งออกอุปกรณ์ คำตรวจสอบด้านบนเป็นแนวทางการทำงานของหัวข้อและการเข้ารหัสโดยไม่ขึ้นกับวิดีโอ.
เก็บการกำหนดค่าการนำเข้าที่ได้รับการยอมรับ
บันทึกตัวคั่นที่ได้รับการอนุมัติ กฎการอ้างอิง การเข้ารหัส การจัดการ BOM การมีอยู่ของหัวข้อ การแมปฟิลด์อย่างแม่นยำ ค่าประเภท และคำจำกัดความหน่วยพร้อมบันทึกอินเทอร์เฟซ รวมถึงเวอร์ชันซอฟต์แวร์และไฟล์ตัวอย่างที่อนุญาต หากผู้ส่งออกเปลี่ยนรูปแบบ ให้ถือเป็นการเปลี่ยนแปลงอินเทอร์เฟซและทำการตรวจสอบตัวอย่างใหม่ก่อนประมวลผลคลังข้อมูลขนาดใหญ่.
การส่งมอบที่ชัดเจนระบุทั้งสิ่งที่ผ่านและสิ่งที่อยู่นอกขอบเขต เช่น ไฟล์ที่ระบุถูกถอดรหัสตามการตั้งค่าที่บันทึกไว้ หัวข้อจับคู่กับโครงสร้างที่ได้รับการอนุมัติ และตัวอย่างที่เลือกนำเข้าอย่างถูกต้อง ไม่ควอ้างว่าสถิติในประวัติทั้งหมดถูกต้องหรือมิเตอร์ได้รับการสอบเทียบ ข้อสรุปเหล่านั้นต้องการหลักฐานที่แตกต่างกัน.
เมื่อขอความช่วยเหลือจากผู้จำหน่ายหรือผู้บูรณาการ ให้แนบข้อความผิดพลาด บรรทัดหัวข้อที่ทำความสะอาด ข้อกำหนดไฟล์ และการตั้งค่าการนำเข้า หลีกเลี่ยงการส่งฐานข้อมูลการดำเนินงานทั้งหมดเมื่อสามารถสร้างตัวอย่างแคบๆ เพื่อทำซ้ำปัญหาได้ คงไว้ซึ่งต้นฉบับภายในเพื่อให้สามารถตรวจสอบการแปลงที่เสนอได้กับไบต์ต้นทางจริง.
คำถามที่มักถูกถาม
ทำไมเฉพาะหัวข้อ CSV แรกเท่านั้นที่ล้มเหลว?
BOM นำหน้าหรืออักขระที่มองไม่เห็นอื่นเป็นไปได้ แต่ไม่ใช่เพียงอย่างเดียว ตรวจสอบไบต์ต้นฉบับ ฟิลด์ที่ถอดรหัส ตัวคั่น และโครงสร้างที่จำเป็นก่อนที่จะทำการแก้ไข ห้ามลบอักขระแรกโดยไม่คิดหน้าคิดหลัง.
ไฟล์ CSV ทุกไฟล์ควรแปลงเป็น UTF-8 โดยไม่มี BOM หรือไม่?
ไม่มีหลักเกณฑ์สากลที่เหมาะกับทุกอินเทอร์เฟซ ให้ปฏิบัติตามสัญญาที่เอกสารของแอปพลิเคชันรับข้อมูลและใช้ตัวเลือกการถอดรหัสที่รองรับ หากจำเป็นต้องแปลงข้อมูล ควรเก็บรักษาข้อมูลต้นฉบับ เอกสารวิธีการ และทดสอบอักขระและตัวระบุที่เป็นตัวแทน.
การนำเข้าที่สำเร็จพิสูจน์ได้หรือไม่ว่าการวัดเป็นข้อมูลที่ถูกต้อง?
ไม่ใช่ มันเป็นเพียงการตรวจสอบที่ดำเนินการจริงบนการถอดรหัส การแยกวิเคราะห์ การแมป และบันทึกที่เลือก ตรวจสอบหน่วย เวลาที่บันทึก การปรับสเกล ขอบเขตการวัด และข้อมูลคุณภาพแยกต่างหาก.
เครื่องวัด BY194 จำเป็นต้องส่งออกไฟล์ CSV หรือไม่?
ไม่ใช่. ไฟล์อาจถูกสร้างโดยซอฟต์แวร์ภายนอก ยืนยันรุ่นที่ให้มา เครื่องมือที่รองรับ และการออกแบบระบบก่อนที่จะอธิบายความสามารถในการส่งออกในระดับอุปกรณ์ ภาพประกอบแสดงเอกสารแนวคิดสำหรับการตรวจสอบภายนอก.