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

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

เมื่อผู้ใช้กําลังโต้ตอบกับแอป 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
คุณต้องตรวจสอบสิทธิ์
ข้อความแสดงข้อผิดพลาดนี้ไม่สามารถดำเนินการได้ เนื่องจากไม่ได้บอกวิธีการ ตรวจสอบสิทธิ์แล้ว
ลงชื่อเข้าใช้
ข้อความแสดงข้อผิดพลาดนี้ไม่สามารถดำเนินการได้เพราะไม่ได้บอกวิธีลงนาม แต่บอกเป็นนัยว่าผู้ใช้ออกจากระบบแล้ว แทนที่จะบอกว่า ซึ่งทำให้สับสน
กำหนดเวลาการประชุมไม่ได้
ข้อความแสดงข้อผิดพลาดนี้ไม่สามารถดำเนินการได้ เนื่องจากไม่ได้บอกผู้ใช้ ทำไมจึงไม่สามารถกำหนดเวลาการประชุมได้ หรือผู้ใช้สามารถดำเนินการต่อได้อย่างไร ไม่มีความช่วยเหลือ ให้ไว้