Word واجهة برمجة تطبيقات JavaScript تعطي الخطأ "RichApi.Error: NotImplemented" مع وظائف Office الإضافية باستخدام عناصر تحكم المحتوى

تاريخ التحديث الأخير: 31 أغسطس 2023

المشكلة

قد تظهر الوظائف الإضافية التي تستخدم عناصر تحكم المحتوى عبر Word JavaScript API أخطاء "RichApi.Error: NotImplemented" في سيناريوهات معينة. 

تم ملاحظة ذلك لأول مرة بعد تحديث Office.js في 10 أغسطس 2023، خاصة على MacOS (النسخة 16.76).

السبب

يتم استخدام أسلوب ContentControl.load() لتحميل جميع خصائص مثيل التحكم في المحتوى. يقوم هذا الأسلوب داخليا بتحميل جميع خصائص التحكم في المحتوى واحدا تلو الآخر. ومع ذلك، بدلا من تضمين جميع الخصائص التي تم إصدارها فقط، يتم أيضا تضمين الخصائص الجديدة التي لا تزال قيد التطوير أو لم يتم إصدارها بعد. 

حدثت هذه المشكلة بسبب خاصية جديدة تم تقديمها مؤخرا والتي كان تنفيذها الأولي يرجع خطأ "NotImplemented"، وبالتالي يتسبب في فشل بعض الاستدعاءات إلى أسلوب load(). 

فيما يلي مثال على التعليمات البرمجية التي يحتمل أن تتأثر.

الحالة: تم التصحيح

الحل البديل

التحديث إلى أحدث إصدار من Word.

للمطورين لجعل وظائفهم الإضافية تعمل على الإصدارات المتأثرة

طريقة تجنب الخصائص غير المعروفة التي تسبب أي مشكلة عند تحميل عنصر تحكم محتوى هي تحديد مجموعة الخصائص المطلوبة بشكل صريح وفقا للمنطق المطلوب. 

تحديث المثال السابق للتعليمات البرمجية المتأثرة، تحمل التعليمات البرمجية التالية الخصائص المطلوبة فقط لعناصر تحكم المحتوى.

انظر أيضاً:

• تحميل (خيارات)

• load(propertyNames)

• load(propertyNamesAndPaths)

الدقة

• Word على الويب: غير متأثر.

• Word على Windows

  • قناة بيتا: تتأثر ولكن الإصدارات بعد 16.0.16815.20000 تحتوي على الإصلاح.

  • التحديث الحالي (معاينة): يحتوي الإصدار المتأثر ولكن الإصدارات بعد 16.0.16731.20170 على الإصلاح.

  • التحديث الشهري: غير متأثر.

  • MEC: غير متأثر.

• Word على Mac

  • بيتا: المتأثرة ولكن الإصدارات بعد 16.77.23082006 تحتوي على الإصلاح.

  • الإنتاج: متأثر ولكن الإصدارات بعد 16.76.23082301 تحتوي على الإصلاح.