คู่มือการใช้งาน Radio Test Monthly Report

ภาพรวม

รายงานนี้สรุปผล ทดสอบวิทยุ (Radio Test) รายเดือนของแต่ละสถานี โดยแยก 3 ประเภทไว้คนละคอลัมน์คือ Hand Held / VHF / Party Line และแสดงผลล่าสุดของเดือนนั้น ๆ ต่อ สถานี × ประเภท ในรูปแบบข้อความสั้นอ่านง่าย:

Macc S/C | <SUB> s/c | DD MMM YY(พ.ศ.)

ตัวอย่าง: Macc 5/5 | BK 5/5 | 30 ส.ค. 68

• Macc = คะแนนฝั่ง “ศูนย์ฯ” (ใช้ soundQualityScore / clarityScore)

• = รหัสสถานี พร้อมคะแนนฝั่งสถานี (แปลงจาก soundQualityText / clarityText ให้เป็นตัวเลข 1–5)

---

การเข้าใช้งาน

• เปิดหน้าเว็บที่ติดตั้งโค้ด “Radio Test Monthly Report” (หน้าเดียวกับ Fire Alarm รูปแบบรายเดือน แต่เป็นเวอร์ชัน Radio)

• หากมีปุ่มลัดบนหน้าอื่น ให้กดปุ่มที่ตั้งชื่อไว้ เช่น “Radio Test Monthly Report”

---

ส่วนประกอบบนหน้า

1. เลือกเดือน (Month picker)

2. ปุ่ม แสดงรายงาน

3. ปุ่ม Export CSV

4. หัวรายงาน (ขึ้นว่า “การทดสอบระบบวิทยุ สถานีไฟฟ้าแรงสูง – ประจำเดือน …”)

5. ตาราง 2 ฝั่ง (ซ้าย/ขวา) โดยแต่ละฝั่งมีคอลัมน์:

   • สฟ.

   • Hand Held

   • VHF

   • Party Line

   • หมายเหตุ

เค้าโครงรายชื่อสถานีทั้งสองฝั่งถูกกำหนดไว้ล่วงหน้า เพื่อให้จัดหน้าได้สวยและพิมพ์ได้พอดี

---

วิธีเรียกรายงาน

1. เลือกเดือนที่ต้องการจากช่อง Month (เช่น 2025-08)

2. คลิก แสดงรายงาน

3. ระบบจะ:

   • ดึงข้อมูลจากปลายทาง (Apps Script)

   • กรองเฉพาะรายการของเดือนนั้นด้วย clientDateTime

   • สำหรับสถานีเดียวกันและประเภทเดียวกัน หากในเดือนนั้นมีหลายบันทึก จะเลือก รายการล่าสุด โดยอิง localDateTime

4. ตารางจะแสดงผล 1 แถว/สถานี:

   • แยก 3 ประเภทเป็น 3 ช่อง

   • แต่ละช่องมีข้อความสรุป: Macc S/C | SUB s/c | วันที่

   • หมายเหตุ จะรวมจากโน้ต/ข้อความท้ายชื่อผู้รายงาน (ตัวอย่างด้านล่าง)

---

การอ่านผลในเซลล์

ตัวอย่างข้อความในช่อง Hand Held / VHF / Party Line:

Macc 5/5 | BK 4/4 | 30 ส.ค. 68

• Macc 5/5 = คะแนนจากฝั่งศูนย์ฯ (soundQualityScore/clarityScore)

• BK 4/4 = คะแนนฝั่งสถานี (แปลงจากข้อความ soundQualityText/clarityText เป็นตัวเลข 1–5)

  • ระบบจะพยายามอ่านเลขจากข้อความรูปแบบ “5 = Excellent” หรือ map คีย์เวิร์ดเช่น

    • Excellent / Very clear → 5

    • Good / Clear → 4

    • Average / OK → 3

    • Fair → 2

    • Poor / Unclear → 1

• วันที่จะแสดงเป็น รูปแบบไทยย่อ + พ.ศ. 2 หลัก เช่น 30 ส.ค. 68

หากสถานี/ประเภทนั้น ๆ ไม่มีข้อมูลในเดือนนั้น ช่องจะแสดงเครื่องหมาย — จาง ๆ

---

หมายเหตุ (Note)

ระบบจะดึง “หมายเหตุ” จากข้อความในช่องผู้รายงาน (reporter) ถ้าพิมพ์ท้ายชื่อในรูปแบบที่รองรับ เช่น:

• รัฐพล | หมายเหตุ: ทดสอบจุด B

• กฤษณะ 📝 โน้ต: ตรวจคุณภาพเสียง/ความชัด

• พัลลภ Note: ใช้เสาอากาศสำรอง

รองรับกรณีถูก encode เป็น หมายเหตุ: ด้วย

---

Export CSV

• คลิก Export CSV เพื่อดาวน์โหลดไฟล์ชื่อ RadioTest3Types_MMMYYYY.csv

  • ตัวอย่าง: เดือน 2025-08 → RadioTest3Types_Aug2025.csv

• ไฟล์ CSV มีหัวคอลัมน์:
  Substation, HandHeld, VHF, PartyLine, Note

• ใส่ BOM (UTF-8 with BOM) เรียบร้อย เปิดด้วย Excel ได้ภาษาไทยถูกต้อง

---

เคล็ดลับการพิมพ์

• สั่งพิมพ์จากเบราว์เซอร์ได้เลย (Ctrl/Cmd + P)

• หน้าออกแบบให้ซ่อนส่วนควบคุมตอนพิมพ์ ตารางจะพอดีหน้า

---

การแก้ปัญหาเบื้องต้น

• เปลี่ยนเดือนแล้วค่าค้าง: กด แสดงรายงาน อีกครั้ง (หน้าจอเคลียร์ก่อนโหลดใหม่เสมอ)

• ไม่มีข้อมูลในเดือนนั้น: ตรวจว่า clientDateTime ของรายการอยู่ในเดือนที่เลือกจริงหรือไม่

• ช่องประเภทว่าง: ตรวจว่า radioType เป็นหนึ่งใน 3 แบบที่รองรับ (Hand Held / VHF / Party Line)

• คะแนนฝั่งสถานีไม่เป็นตัวเลข: ตรวจฟอร์มว่ากรอกเป็นรูปแบบมาตรฐาน เช่น 5 = Excellent / 4 = Clear (ระบบแมปคำให้แล้ว แต่ถ้าใช้คำอื่นแปลกมาก ๆ อาจตีความไม่ได้)

• หมายเหตุไม่ขึ้น: ตรวจรูปแบบข้อความท้ายชื่อผู้รายงานให้ตรงกับตัวอย่าง (“หมายเหตุ: …” / “Note: …” / “📝 …”)

---

หมายเหตุสำหรับผู้ดูแล

• ลิสต์สถานีซ้าย/ขวา: ปรับในตัวแปร COL_LEFT และ COL_RIGHT

• ประเภทวิทยุ: ปรับ/เพิ่มใน RADIO_TYPES (กำหนด matcher สำหรับจับคำ)

• กติกาแปลงข้อความ→คะแนน: ปรับในฟังก์ชัน scoreFromText()

• แหล่งข้อมูล / รหัสผ่าน: ปรับ WEBAPP_URL และ PASSCODE ให้ตรงกับ Apps Script ของคุณ

---