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

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

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