Word JavaScript API แสดงข้อผิดพลาด "RichApi.Error: NotImplemented" กับ Add-in ของ Office ที่ใช้ตัวควบคุมเนื้อหา

นำไปใช้กับ

Word for Microsoft 365 Word for Microsoft 365 for Mac

อัปเดตล่าสุด: 31 สิงหาคม 2023

ปัญหา

Add-in ที่ใช้ตัวควบคุมเนื้อหาผ่าน Word JavaScript API อาจแสดงข้อผิดพลาด "RichApi.Error: NotImplemented" ในบางสถานการณ์

ปัญหานี้ถูกสังเกตเห็นเป็นครั้งแรกหลังจากการอัปเดต Office.js เมื่อวันที่ 10 สิงหาคม 2023 โดยเฉพาะบน MacOS (รุ่น 16.76)

สาเหตุ

เมธอด ContentControl.load() ใช้เพื่อโหลดคุณสมบัติทั้งหมดของอินสแตนซ์ตัวควบคุมเนื้อหา วิธีนี้จะโหลด คุณสมบัติตัวควบคุมเนื้อหา ทั้งหมดแบบทีละรายการภายใน อย่างไรก็ตามแทนที่จะรวมเฉพาะคุณสมบัติที่ปล่อยออกมาทั้งหมดเท่านั้นคุณสมบัติใหม่ที่ยังคงอยู่ระหว่างการพัฒนาหรือยังไม่ได้เผยแพร่ก็รวมอยู่ด้วย

ปัญหานี้เกิดจากคุณสมบัติใหม่เมื่อเร็วๆ นี้ซึ่งมีการใช้งานครั้งแรกส่งกลับข้อผิดพลาด "NotImplemented" ดังนั้นจึงทําให้การเรียกไปยังวิธีการ load() บางอย่างล้มเหลว

ต่อไปนี้เป็นตัวอย่างของโค้ดที่อาจได้รับผลกระทบ

ตัวอย่างภาพหน้าจอรหัส JavaScript API Word

สถานะ: แก้ไขแล้ว

แก้ไขปัญหาชั่วคราว

อัปเดตเป็น Word เวอร์ชันล่าสุด

เพื่อให้นักพัฒนาสามารถใช้งาน Add-in ของตนกับรุ่นที่ได้รับผลกระทบได้

วิธีการหลีกเลี่ยงคุณสมบัติที่ไม่รู้จักทําให้เกิดปัญหาใดๆ เมื่อโหลดตัวควบคุมเนื้อหาคือการระบุชุดคุณสมบัติที่จําเป็นตามตรรกะที่ต้องการอย่างชัดเจน

การอัปเดตตัวอย่างก่อนหน้าของโค้ดที่ได้รับผลกระทบ โค้ดต่อไปนี้จะโหลดเฉพาะคุณสมบัติที่จําเป็นของตัวควบคุมเนื้อหาเท่านั้น

Word สกรีนช็อตการแก้ไขปัญหาชั่วคราวของโค้ด JavaScript API

ดูเพิ่มเติม:

การแก้ปัญหา

Word บนเว็บ: ไม่ได้รับผลกระทบ
Word บน Windows
- ช่องเบต้า: ได้รับผลกระทบ แต่รุ่นหลังจาก 16.0.16815.20000 มีการแก้ไข
- แชนเนลปัจจุบัน (ตัวอย่าง): ได้รับผลกระทบ แต่รุ่นหลังจาก 16.0.16731.20170 มีการแก้ไข
- ตัวเลือกรายเดือน: ไม่ได้รับผลกระทบ
- MEC: ไม่ได้รับผลกระทบ
Word บน Mac
- รุ่นเบต้า: ได้รับผลกระทบ แต่รุ่นหลังจาก 16.77.23082006 มีการแก้ไข
- การผลิต: ได้รับผลกระทบ แต่รุ่นหลังจาก 16.76.23082301 มีการแก้ไข