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

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

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

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

ข้อความแสดงข้อผิดพลาดที่นำไปปฏิบัติได้มีโครงสร้างดังนี้

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

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

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

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

ข้อผิดพลาดที่นำไปปฏิบัติได้

ผู้ใช้ขอให้แอป 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 จะตอบกลับด้วยข้อความแสดงข้อผิดพลาด