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

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

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

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