สัญญาโครงสร้างข้อมูล CSV ของมาตรวัดเวอร์ชันสัญญา กำหนดความหมายของแต่ละคอลัมน์ ค่าที่อนุญาต และเวอร์ชันของโปรแกรมนำเข้าที่สามารถอ่านไฟล์ได้อย่างปลอดภัย ก่อนที่จะเปลี่ยนการส่งออก ให้ตกลงสัญญานั้นกับระบบปลายทาง ทดสอบตัวอย่างที่เข้ากันได้และไม่เข้ากัน และทำให้เวอร์ชันที่ไม่รู้จักล้มเหลวอย่างเห็นได้ชัด การเปิดไฟล์สำเร็จในโปรแกรมสเปรดชีตไม่ใช่หลักฐานว่าการวัดไฟฟ้าจะถูกตีความอย่างถูกต้อง.
คู่มือนี้ครอบคลุมข้อตกลงระหว่างผู้ส่งออกข้อมูลภายนอกและผู้รับเข้า มันไม่ได้กำหนดฟังก์ชัน CSV ในตัวสำหรับมาตรวัดใด ๆ สำหรับการติดตั้งอุตสาหกรรม การวัดอาจผ่านเกตเวย์ แอปพลิเคชันควบคุม หรือบริการรายงานก่อนที่ไฟล์ CSV จะมีอยู่.
แยกไวยากรณ์ไฟล์ออกจากความหมายของการวัด
CSV อธิบายการจัดเรียงข้อความ ไม่ใช่ความหมายทางวิศวกรรมเต็มรูปแบบของเนื้อหา. RFC 4180 เอกสารแนวปฏิบัติทั่วไปของ CSV รวมถึงบันทึก ฟิลด์ และการอ้างอิงคำพูด เป็นข้อมูลเชิงข้อมูล; มันไม่ได้กำหนดตัวระบุมาตรวัด ทิศทางพลังงาน รหัสคุณภาพ หรือขอบเขตเวลา ไฟล์สองไฟล์สามารถปฏิบัติตามแนวปฏิบัติการอ้างอิงคำพูดเดียวกันในขณะที่แสดงการวัดที่แตกต่างกันโดยสิ้นเชิง.
เดอะ โมเดลข้อมูลตาราง W3C ให้ความแตกต่างที่เป็นประโยชน์ระหว่างค่าตารางและเมตาดาต้าที่ช่วยอธิบายหรือยืนยันค่าเหล่านั้น ใช้ความแตกต่างนี้เมื่อระบุการแลกเปลี่ยนของคุณ เอกสารทั้งวิธีการเขียนค่าและสิ่งที่ระบบปลายทางสามารถสรุปได้จากมัน.
ตัวอย่างเช่น คอลัมน์ชื่อพลังงานอาจแทนที่สมุดบันทึกสะสมหรือการใช้พลังงานในช่วงเวลา การเปลี่ยนชื่อเป็นสิ่งที่มีผลน้อยกว่าการเปลี่ยนความหมายโดยไม่มีสัญญาใหม่ ระบุขอบเขตการวัด ทิศทาง และหน่วยอย่างชัดเจน มิฉะนั้นผู้รับเข้าอาจสร้างแผนภูมิที่เป็นไปได้จากปริมาณที่ผิด.
ระบุสัญญาก่อนประมวลผลแถว
กำหนดตัวระบุที่เสถียรสำหรับรูปแบบและเวอร์ชันที่ควบคุมสำหรับการตีความ บันทึกว่าระบบปลายทางได้มาจากที่ใด: บันทึกเมตาดาตรร่วม สัญญาไฟล์ที่ตกลงกัน หรือคอลัมน์ที่ระบุอย่างชัดเจน ชื่อไฟล์เพียงอย่างเดียวเหมาะสมก็ต่อเมื่อเวิร์กโฟลว์ปลายทางตรวจสอบและรักษาความสัมพันธ์นี้ตลอดกระบวนการ.
อย่าสันนิษฐานเวอร์ชันจากจำนวนคอลัมน์ เวอร์ชันที่แตกต่างกันอาจมีจำนวนฟิลด์เท่ากัน เช่นเดียวกัน อย่าสันนิษฐานจากวันที่ในชื่อไฟล์ วันที่อาจบ่งชี้เวลาการดึงข้อมูลมากกว่ารุ่นที่ข้อมูลถูกสร้างขึ้น.
แยกเวอร์ชันซอฟต์แวร์ของผู้ส่งออกออกจากเวอร์ชันสัญญาการแลกเปลี่ยน แพทช์ซอฟต์แวร์อาจไม่เปลี่ยนแปลงไฟล์ การปรับแต่งการกำหนดค่าอาจเปลี่ยนความหมายของฟิลด์โดยไม่อัปเดตไฟล์ปฏิบัติการ สัญญาต้องอธิบายการแลกเปลี่ยนจริง ในขณะที่บันทึกแหล่งที่มาที่สร้างไฟล์นี้.
เขียนข้อตกลงฟิลด์ขั้นต่ำ
สร้างเอกสารควบคุมสั้น ๆ ที่วิศวกรคนที่สองสามารถใช้ได้โดยไม่ต้องถามผู้เขียนเดิม สำหรับแต่ละฟิลด์ บันทึกชื่อที่เสถียร ความหมาย ประเภท สถานะว่างที่อนุญาต และกฎการตรวจสอบ รวมตัวอย่างที่เปิดเผยความคลุมเครือ แทนตัวอย่างที่แสดงเพียงกรณีที่ง่ายที่สุด.
| รายการสัญญา | บันทึกอย่างชัดเจน | ปฏิเสธหรือกักกันเมื่อ |
|---|---|---|
| ตัวตนมิเตอร์ | ตัวระบุสินทรัพย์เสถียรและการแมปที่ได้รับการอนุมัติ | ตัวระบุไม่ทราบหรือแมปไปยังสินทรัพย์หลายรายการ |
| ปริมาณ | ปริมาณทางกายภาพ ทิศทาง และขอบเขตการวัด | ความหมายแตกต่างจากการคำนวณที่ได้รับการอนุมัติ |
| Unit and scale | หน่วย ตัวคูณ และตำแหน่งการใช้งาน | การปรับสเกลจะถูกนำไปใช้สองครั้งหรือไม่สามารถกำหนดได้ |
| เวลา | โซน ข้อกำหนดช่วงเวลา และการตีความเวลาประทับตรา | ไม่สามารถกำหนดเวลาประทับตราได้อย่างชัดเจน |
| การอ่านค่าที่ขาดหาย | ความแตกต่างระหว่างข้อมูลที่ขาดหาย ไม่ถูกต้อง และศูนย์ที่วัดได้ | ช่องว่างจะกลายเป็นศูนย์โดยเงียบๆ |
| คุณภาพ | รหัสที่อนุญาตและการจัดการในภายหลัง | รหัสใหม่ไม่มีการตีความที่ตกลงกันไว้ |
| การแก้ไข | ตัวระบุสัญญาที่รองรับและกฎการเปลี่ยนผ่าน | ผู้รับไม่รู้จักเวอร์ชัน |
นี่คือการตรวจสอบการออกแบบโครงการ ไม่ใช่มาตรฐานมิเตอร์สากล ไวยากรณ์และข้อมูลเมตาที่อ้างอิงข้างต้นสนับสนุนความแตกต่างนี้; ค่าที่อนุญาตจริงมาจากการติดตั้งและแอปพลิเคชันที่คุณบันทึกไว้.
จัดประเภทการเปลี่ยนแปลงตามผลกระทบต่อผู้รับ
ฟิลด์ตัวเลือกเพิ่มเติมอาจเข้ากันได้กับเครื่องรับที่เลือกคอลัมน์ที่รู้จักตามชื่อและละเว้นข้อมูลเพิ่มเติมที่ได้รับการอนุมัติอย่างตั้งใจ มันอาจทำให้เครื่องรับที่คาดหวังโครงสร้างตำแหน่งที่แน่นอนพังลงได้ ดังนั้นคำว่า 'ตัวเลือก' จึงไม่ได้หมายความว่าปลอดภัยโดยอัตโนมัติ ความเข้ากันได้เป็นคุณสมบัติของคู่ผู้ผลิตและผู้บริโภคที่ได้รับการบันทึกไว้.
การลบฟิลด์ที่จำเป็น การเปลี่ยนหน่วย การย้อนทิศทางพลังงาน หรือการเปลี่ยนแปลงขอบเขตช่วงเวลาโดยปกติจะต้องมีงานย้ายข้อมูลอย่างชัดเจน ให้ความสนใจกับความหมายของรหัสคุณภาพที่เปลี่ยนไปเช่นเดียวกับฟิลด์ตัวเลขที่เปลี่ยนแปลง ตัวเลขอาจยังคงเหมือนเดิมในขณะที่การใช้งานที่อนุญาตเปลี่ยนไป.
การจัดเรียงคอลัมน์ใหม่ควรมีการทดสอบเป็นของตัวเอง หากสัญญาสัญญาว่าการแมปตามชื่อ ให้ตรวจสอบว่าเครื่องรับปฏิบัติตามคำมั่นนั้น หากการแลกเปลี่ยนเป็นตามตำแหน่ง ให้ปฏิเสธลำดับที่ไม่คาดคิด อย่าพึ่งพาใครสังเกตเห็นว่าหัวข้อในสเปรดชีตได้ย้ายไปแล้ว.
สร้างชุดทดสอบเล็กๆ แต่ตั้งใจ
เก็บไฟล์ที่ได้รับการอนุมัติหนึ่งไฟล์สำหรับแต่ละเวอร์ชันที่รองรับ และชุดตัวอย่างที่ถูกปฏิเสธโดยตั้งใจแยกต่างหาก รวมถึงเครื่องหมายคำพูดที่มีเครื่องหมายจุลภาค ช่องว่าง รหัสทรัพย์สินที่ไม่รู้จัก รหัสคุณภาพที่ไม่ได้รับการสนับสนุน และเวลาที่ทดสอบตามแนวคิดเวลาที่เลือก ระบุการอ่านทดสอบที่คิดขึ้นเป็นข้อมูลทดสอบและเก็บให้ห่างจากการนำเข้าในระบบผลิต.
สำหรับการเปลี่ยนหน่วย ให้เลือกตัวอย่างสังเคราะห์ที่การตีความผิดชัดเจน เปรียบเทียบปริมาณที่คาดหวังในการแปลความหมายกับผลลัพธ์ของเครื่องรับจริง ไม่ใช่แค่ข้อความสำเร็จการนำเข้า การทดสอบที่พิสูจน์ได้เพียงว่าไฟล์ได้รับการยอมรับไม่ได้บอกอะไรเกี่ยวกับการรักษามาตราวัดของมัน.
ทดสอบขอบเขตการเปลี่ยนผ่านด้วยเช่นกัน ชุดข้อมูลอาจประกอบด้วยไฟล์ที่ผลิตก่อนและหลังการเปลี่ยนแปลง ตัดสินใจว่าทั้งสองเวอร์ชันสามารถอยู่ร่วมกันได้หรือไม่ ใช้คิวที่แยกต่างหากหรือไม่ และจัดการไฟล์ประวัติศาสตร์ที่ได้รับการแก้ไขอย่างไร บันทึกการตัดสินใจพร้อมหลักฐานการทดสอบเพื่อให้การนำเข้าใหม่ในภายหลังไม่ขึ้นอยู่กับความจำ.
ตัวอย่างการย้ายข้อมูลเชิงปฏิบัติ
สมมติว่าบริการรายงานภายนอกส่งข้อมูลพลังงานสะสมในปัจจุบัน และการอัปเดตที่วางแผนไว้เพิ่มพลังงานในช่วงเวลา เก็บความหมายของฟิลด์สะสมไว้ให้สมบูรณ์และตั้งชื่อปริมาณเพิ่มเติมให้แตกต่างกัน ระบุหน่วย ระยะเวลาช่วงเวลา ขอบเขตเวลาที่ใช้ และพฤติกรรมเมื่อข้อมูลขาดหายก่อนที่ใครก็ตามจะอัปเดตรายงานรับเข้า.
รันตัวอย่างที่ได้รับการอนุมัติผ่านเครื่องรับที่ไม่ใช่การผลิต ตรวจสอบว่าการแสดงผลสะสมเดิมยังคงไม่เปลี่ยนแปลงและชุดช่วงเวลาที่ใหม่ถูกคำนวณหรือเก็บตามสัญญา จากนั้นส่งตัวอย่างที่ตั้งใจใส่ป้ายผิดและยืนยันว่าตัวนำเข้าปฏิเสธด้วยคำอธิบายที่เป็นประโยชน์.
หากการอัปเดตที่เสนอทดแทนฟิลด์เดิมแทนที่จะเพิ่มฟิลด์ใหม่ อย่าใช้รหัสสัญญาเดิมอีกต่อไป จัดเตรียมแผนที่การย้ายข้อมูลและตัดสินใจว่าผลลัพธ์ในอดีตใดต้องมีเครื่องหมายเวอร์ชัน ตัวอย่างนี้อธิบายการออกแบบการแลกเปลี่ยน ไม่ได้สร้างคุณสมบัติการส่งออก ความแม่นยำ หรือการอนุมัติการเรียกเก็บเงินสำหรับเครื่องมือเฉพาะ.
รักษาหลักฐานเดิมในระหว่างการปฏิเสธ
ไฟล์ที่ถูกปฏิเสธควรยังคงสามารถเข้าถึงได้ในตำแหน่งหลักฐานที่ควบคุมไว้ พร้อมกับเหตุผล เวอร์ชันซอฟต์แวร์ที่รับ และรหัสสัญญาที่พยายามใช้งาน ควรรักษาไบต์ที่ได้รับไว้ หากมีการส่งไฟล์ที่แก้ไขแล้ว ให้ระบุเวอร์ชันที่แตกต่างและบันทึกสิ่งที่มันแทนที่ แทนที่จะเขียนทับไฟล์เดิมที่ถูกปฏิเสธ.
ผู้รับควรแยกแยะข้อผิดพลาดด้านไวยากรณ์ออกจากข้อผิดพลาดด้านสัญญาและข้อผิดพลาดด้านการตรวจสอบทางวิศวกรรม คำพูดที่ไม่ตรงกันแตกต่างจากหน่วยที่ไม่รองรับ และทั้งสองแตกต่างจากการอ่านค่าที่ไม่น่าเชื่อถือ เหตุผลที่แยกต่างหากช่วยให้บุคคลที่ถูกต้องแก้ไขปัญหาโดยไม่ต้องแก้ไขไฟล์ต้นฉบับที่ถูกต้องซ้ำๆ.
สำหรับการควบคุมที่เกี่ยวข้อง ให้ใช้ แนวทางความสมบูรณ์ของไฟล์ส่งออกมิเตอร์ เพื่อรักษาไฟล์ที่ได้รับและ แนวทางหัวข้อ CSV และการเข้ารหัส เพื่อแก้ไขปัญหาเกี่ยวกับการแปลข้อความ การตรวจสอบเหล่านี้เสริมสัญญาเวอร์ชัน; ทั้งสองไม่สามารถสร้างความเข้ากันได้ทางความหมายได้เพียงอย่างเดียว.
กำหนดเจ้าของการอนุมัติและการดำเนินงาน
ตั้งชื่อเจ้าของการกำหนดค่าของผู้ส่งออก กฎการนำเข้าที่รับ และการแปลความหมายทางไฟฟ้า บุคคลหนึ่งอาจรับบทหลายบทบาท แต่บันทึกการอนุมัติควรตอบคำถามแต่ละข้อ ผู้เชี่ยวชาญด้านข้อมูลสามารถตรวจสอบประเภทฟิลด์ได้โดยไม่ต้องได้รับอนุญาตให้อนุมัติการเปลี่ยนแปลงขอบเขตการวัด.
ตั้งวันที่เปลี่ยนผ่านและจุดตัดสินใจย้อนกลับ บันทึกสิ่งที่จะเกิดขึ้นกับไฟล์ที่รออยู่ในคิวในระหว่างการเปลี่ยนแปลง หากผู้รับถูกย้อนกลับ ให้พิจารณาว่าไฟล์ใหม่ยังคงอยู่ในสถานะกักกันหรือจำเป็นต้องแปลงข้อมูลที่ได้รับการตรวจสอบแยกต่างหาก ห้ามแปลความหมายโดยเงียบๆ ภายใต้สัญญาเก่าเพราะซอฟต์แวร์เก่าอาจรับรูปร่างของไฟล์เหล่านั้นได้.
การส่งต่อสนับสนุนควรรวมสัญญาที่ได้รับการอนุมัติ ไฟล์ตัวอย่าง ผลลัพธ์ที่คาดหวัง ข้อความปฏิเสธที่รู้จัก และแมทริกซ์ความเข้ากันได้ในปัจจุบัน ซึ่งช่วยให้สามารถทดสอบการเปลี่ยนแปลงในอนาคตและลดโอกาสที่ผู้รวมระบบทดแทนจะย้อนรอยรูปแบบจากไฟล์เดียวที่สะดวก.
เชื่อมโยงการแลกเปลี่ยนกับมิเตอร์ที่ติดตั้งจริง
เริ่มต้นด้วยอุปกรณ์ที่ถูกต้องและการตั้งค่าที่บันทึกไว้ เอกสาร หน้าสินค้าของเครื่องมือมัลติฟังก์ชัน BY194 เป็นอ้างอิงผลิตภัณฑ์สำหรับบทความนี้ ยืนยันรุ่นที่สั่งซื้ออย่างแม่นยำและการวัดที่มีอยู่แยกต่างหาก; รูปถ่ายผลิตภัณฑ์ไม่สามารถกำหนดรูปแบบส่งออก ฟังก์ชันเกตเวย์ หรือความสามารถในการเก็บถาวรได้.
ใช้ ภาพรวมของมิเตอร์ไฟฟ้าสามเฟส สำหรับบริบทการวัด จากนั้นย้อนรอยแต่ละฟิลด์ภายนอกผ่านการแมปจุดที่ได้รับอนุมัติ การทำสัญญา CSV ที่เขียนอย่างดีไม่สามารถซ่อมแซมอัตราแปลงกระแสผิดหรือการแปลความหมายของรีจิสเตอร์ที่ไม่ตรงกันในตอนต้นได้.
บทเรียน Computerphile ต่อไปนี้อธิบายเงื่อนไขการแข่งขันในกระบวนการแชร์ มันเป็นพื้นฐานแนวคิดสำหรับการประสานการเปลี่ยนแปลงของผู้ผลิตและผู้บริโภค ไม่ใช่กระบวนการกำหนดค่าที่เฉพาะเจาะจงสำหรับมิเตอร์ หรือทดแทนการทดสอบที่อธิบายไว้ที่นี่.
คำถามที่มักถูกถาม
คอลัมน์ตัวเลือกใหม่ที่เป็นตัวเลือกเสมอจำเป็นต้องมีการแก้ไขสัญญาใหม่หรือไม่?
บันทึกการเปลี่ยนแปลงภายในนโยบายเวอร์ชันที่ควบคุมของคุณ แม้ว่าจะสามารถย้อนกลับได้ก็ตาม การที่ผู้รับสามารถรับข้อมูลในคอลัมน์นั้นขึ้นอยู่กับการแมปและพฤติกรรมการตรวจสอบที่บันทึกไว้ ยืนยันพฤติกรรมนั้นด้วยการทดสอบจริง แทนที่จะสมมติว่าทุกการนำเข้าข้อมูลละเว้นฟิลด์เพิ่มเติมอย่างปลอดภัย.
ระบบรับข้อมูลสามารถคาดเดาเวอร์ชัน CSV ที่ไม่รู้จักได้โดยอัตโนมัติหรือไม่?
การเดาอัตโนมัติเสี่ยงที่จะกำหนดความหมายผิดให้กับตัวเลขที่ดูเหมือนถูกต้อง การกักกันเวอร์ชันที่ไม่รู้จักและรายงานหลักฐานที่จำเป็นสำหรับการตรวจสอบ การแปลงอาจได้รับการอนุมัติในภายหลัง แต่ควรเป็นการชัดเจน ทดสอบ และสามารถติดตามได้ถึงไฟล์ต้นฉบับ.
เช็คซัมเพียงอย่างเดียวพอที่จะพิสูจน์ความเข้ากันได้หรือไม่?
เช็คซัมช่วยในการตรวจจับการเปลี่ยนแปลงของไบต์เมื่อเทียบกับข้อมูลอ้างอิงที่เชื่อถือได้ มันไม่ได้อธิบายความหมายของฟิลด์ หน่วยวัด หรือว่าผู้รับรองรับรูปแบบนั้นหรือไม่ คงความสมบูรณ์ของหลักฐานและตรวจสอบสัญญาเป็นขั้นตอนแยกต่างหาก.
ไฟล์ประวัติศาสตร์ควรถูกเขียนใหม่เมื่อมีการเปลี่ยนแปลงสัญญาหรือไม่?
เก็บรักษาหลักฐานต้นฉบับและความเชื่อมโยงกับสัญญาฉบับเดิมไว้ หากจำเป็นต้องจัดทำสำเนาที่ผ่านการปรับมาตรฐาน ให้บันทึกรายละเอียดการแปลงข้อมูล เวอร์ชัน และความสัมพันธ์กับแหล่งข้อมูลต้นฉบับ ก่อนตัดสินใจว่าจะต้องสร้างผลลัพธ์ที่ได้จากการประมวลผลย้อนหลังขึ้นใหม่หรือไม่ ควรตรวจสอบข้อกำหนดเกี่ยวกับระยะเวลาการเก็บรักษาข้อมูลและภาระหน้าที่ในการรายงานก่อน.