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