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

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

ปัญหา

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

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

สาเหตุ

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

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

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

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

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

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

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

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

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

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

• load(options)

• load(propertyNames)

• load(propertyNamesAndPaths)

การแก้ปัญหา

• Word บนเว็บ: ไม่ได้รับผลกระทบ

• Word บน Windows

  • ช่องเบต้า: ได้รับผลกระทบ แต่รุ่นหลังจาก 16.0.16815.20000 มีการแก้ไข

  • แชนเนลปัจจุบัน (ตัวอย่าง): ได้รับผลกระทบ แต่รุ่นหลังจาก 16.0.16731.20170 มีการแก้ไข

  • ตัวเลือกรายเดือน: ไม่ได้รับผลกระทบ

  • MEC: ไม่ได้รับผลกระทบ

• Word บน Mac

  • รุ่นเบต้า: ได้รับผลกระทบ แต่รุ่นหลังจาก 16.77.23082006 มีการแก้ไข

  • การผลิต: ได้รับผลกระทบ แต่รุ่นหลังจาก 16.76.23082301 มีการแก้ไข