เขียนข้อความแสดงข้อผิดพลาดที่นําไปใช้ได้จริง

หน้านี้อธิบายแนวทางปฏิบัติแนะนำในการเขียนข้อความแสดงข้อผิดพลาดที่นําไปใช้ได้จริง ซึ่งบอกผู้ใช้ถึงวิธีแก้ไขปัญหาเพื่อให้บรรลุเป้าหมาย

เมื่อผู้ใช้โต้ตอบกับแอป Google Chat การพบข้อความแสดงข้อผิดพลาดอาจทำให้ผู้ใช้หงุดหงิดเมื่อแก้ไขข้อผิดพลาดไม่ได้ ตัวอย่างเช่น ข้อความแสดงข้อผิดพลาด An error occurred นั้นไม่มีประโยชน์เนื่องจากไม่ได้อธิบายถึงสิ่งที่ผิดพลาด วิธีที่ผู้ใช้จะแก้ไขปัญหา หรือวิธีที่ผู้ใช้จะขอรับความช่วยเหลือ หน้านี้อธิบายวิธีจัดโครงสร้างข้อความแสดงข้อผิดพลาดเพื่อให้เป็นประโยชน์ต่อผู้ใช้ด้วยการแสดงตัวอย่างที่ดำเนินการได้และดำเนินการไม่ได้

โครงสร้างข้อความแสดงข้อผิดพลาด

ข้อความแสดงข้อผิดพลาดที่นําไปใช้ดำเนินการได้มีโครงสร้างดังนี้

  • สิ่งที่ผิดพลาด การระบุสาเหตุที่แอป Chat ดำเนินการตามคำขอไม่ได้จะช่วยให้ผู้ใช้แก้ปัญหาได้ การอธิบายสาเหตุที่ทำให้เกิดข้อผิดพลาดจะช่วยสร้างความน่าเชื่อถือ
  • วิธีที่ผู้ใช้สามารถดําเนินการต่อเพื่อบรรลุเป้าหมาย การบอกแค่ว่าเกิดข้อผิดพลาดขึ้นนั้นไม่เพียงพอ บอกให้ผู้ใช้ทราบวิธีแก้ไขข้อผิดพลาดและดำเนินการตามเป้าหมายให้เสร็จสมบูรณ์
  • วิธีรับความช่วยเหลือ หากผู้ใช้ยังพบปัญหาอยู่ โปรดแจ้งให้ผู้ใช้ทราบวิธีรับความช่วยเหลือเพิ่มเติม ซึ่งอาจเป็นคำสั่ง /help หรือลิงก์ไปยังเอกสารประกอบสำหรับแอป Chat

ตัวอย่างข้อความแสดงข้อผิดพลาด: รูปแบบวันที่ไม่ถูกต้อง

ในตัวอย่างนี้ ผู้ใช้ป้อนวันที่ในรูปแบบที่แอป Chat คาดไม่ถึง ผู้ส่งเขียนว่า November 19, 2021 แต่แอป Chat คาดหวังให้เขียนว่า 2021-11-19

ต่อไปนี้คือข้อความแสดงข้อผิดพลาดเวอร์ชันที่ดำเนินการได้และดำเนินการไม่ได้ซึ่งแอปแชทแสดง

ข้อผิดพลาดที่แก้ไขได้

ผู้ใช้ขอให้แอป Chat กำหนดเวลาการประชุมกับบุคคลอื่น แอป Chat จะตอบกลับด้วยข้อความแสดงข้อผิดพลาดที่มีประโยชน์และนำไปใช้ได้ ดังนี้

I don't recognize the date format you entered. Write dates as `yyyy-mm-dd`; for example, `2000-01-31`. For help, type `/help`.

ตัวอย่างข้อความแสดงข้อผิดพลาดที่บอกผู้ใช้ว่าเกิดข้อผิดพลาดอะไรขึ้น วิธีดำเนินการต่อ และวิธีรับความช่วยเหลือ

ข้อความแสดงข้อผิดพลาดนี้สามารถดำเนินการได้เนื่องจากเหตุผลต่อไปนี้

  • บอกสิ่งที่ผิดพลาด แอป Chat ไม่รู้จักรูปแบบวันที่
  • อธิบายวิธีแก้ไขข้อผิดพลาดโดยบอกผู้ใช้ถึงรูปแบบวันที่ที่คาดไว้ และแสดงตัวอย่างวันที่ที่จะช่วยให้ผู้ใช้เข้าใจว่าควรเขียนอะไร
  • ให้ความช่วยเหลือเพิ่มเติมด้วยคำสั่งเครื่องหมายทับ /help หากยังพบปัญหาอยู่ ผู้ใช้จะดูข้อมูลเพิ่มเติมได้

ข้อผิดพลาดที่แก้ไขไม่ได้

ผู้ใช้ขอให้แอป Chat กำหนดเวลาการประชุมกับบุคคลอื่น แอป Chat ตอบกลับด้วยข้อความแสดงข้อผิดพลาดที่ไร้ประโยชน์และดำเนินการไม่ได้ ดังนี้

Enter the correct date format.

ตัวอย่างข้อความแสดงข้อผิดพลาดที่ไม่ได้ให้ข้อมูลที่นําไปใช้ได้

ข้อความแสดงข้อผิดพลาดนี้ไม่สามารถดำเนินการได้เนื่องจากเหตุผลต่อไปนี้

  • ไม่ระบุว่าได้กำหนดเวลาการประชุมไว้หรือไม่ ผู้ใช้อาจลังเลที่จะกำหนดเวลาการประชุมใหม่ หรืออาจคิดว่ามีการกำหนดเวลาการประชุมไว้แล้ว
  • ไม่บอกผู้ใช้วิธีจัดรูปแบบวันที่ แทนที่จะสมมติว่าผู้ใช้ทราบวิธีจัดรูปแบบวันที่ ควรจะระบุว่าระบบต้องการรูปแบบวันที่ yyyy-mm-dd
  • ไม่เสนอความช่วยเหลือเพิ่มเติม เมื่อผู้ใช้ติดขัดและไม่ทราบว่าต้องทำอย่างไรต่อ ผู้ใช้อาจหยุดส่งข้อความในแอป Chat

ลองเลย

เมื่อทราบวิธีเขียนข้อผิดพลาดที่นําไปใช้ดำเนินการได้แล้ว คุณจะระบุข้อผิดพลาดที่นําไปใช้ดำเนินการได้ในสถานการณ์ต่อไปนี้

แอป Chat จะสร้างกิจกรรมในปฏิทินเมื่อผู้ใช้ส่งข้อความถึงแอป Chat ด้วยคีย์เวิร์ด schedule หากต้องการสร้างกิจกรรมในปฏิทิน แอป Chat จะต้องตรวจสอบสิทธิ์ของผู้ใช้ หากผู้ใช้ไม่ได้รับการตรวจสอบสิทธิ์ แอป Chat จะตอบกลับด้วยข้อความแสดงข้อผิดพลาด

ข้อความแสดงข้อผิดพลาดใดที่ดำเนินการได้
คุณต้องลงชื่อเข้าใช้โดยพิมพ์ /signin ก่อนจึงจะกำหนดเวลาการประชุมได้ หากต้องการดูข้อมูลเพิ่มเติม ให้พิมพ์ /help
ข้อความแสดงข้อผิดพลาดนี้ดำเนินการได้เนื่องจากมีข้อความต่อไปนี้
  • ปัญหาที่เกิดขึ้น แอป Chat ต้องมีการตรวจสอบสิทธิ์
  • วิธีดำเนินการต่อ พิมพ์ /signin เพื่อตรวจสอบสิทธิ์
  • วิธีรับความช่วยเหลือ หากต้องการข้อมูลเพิ่มเติม ผู้ใช้สามารถพิมพ์ /help
คุณต้องตรวจสอบสิทธิ์
ข้อความแสดงข้อผิดพลาดนี้ไม่สามารถดำเนินการได้เนื่องจากไม่ได้บอกวิธีตรวจสอบสิทธิ์
ลงชื่อเข้าใช้
ข้อความแสดงข้อผิดพลาดนี้ไม่สามารถดำเนินการได้เนื่องจากไม่ได้บอกวิธีลงชื่อเข้าใช้ และบอกเป็นนัยว่าผู้ใช้ออกจากระบบแล้วแทนที่จะพูดอย่างชัดเจน ซึ่งทำให้สับสน
กำหนดเวลาการประชุมไม่ได้
ข้อความแสดงข้อผิดพลาดนี้ไม่สามารถดำเนินการได้เนื่องจากไม่ได้บอกผู้ใช้ว่าเหตุใดจึงกำหนดเวลาการประชุมไม่ได้ หรือผู้ใช้ควรทำอย่างไรต่อ ไม่มีความช่วยเหลือ