Word API של JavaScript מציג את השגיאה "RichApi.Error: NotImplemented" עם תוספות Office באמצעות פקדי תוכן

עדכון אחרון: 31 באוגוסט 2023

בעיה

תוספות המשתמשות בפקדי תוכן באמצעות Word API של JavaScript עשויות להציג שגיאות "RichApi.Error: NotImplemented" בתרחישים מסוימים. 

זוהתה לראשונה לאחר העדכון Office.js באוגוסט 2023, במיוחד ב- MacOS (גירסת Build מס' 16.76).

סיבה

פעולת השירות ContentControl.load() משמשת לטעינת כל המאפיינים של מופע פקד תוכן. שיטה זו תטען באופן פנימי את כל מאפייני פקד התוכן בנפרד. עם זאת, במקום לכלול רק את כל המאפיינים שהופצו, נכללים גם מאפיינים חדשים שעדיין נמצאים בפיתוח או שלא הופצו עדיין. 

בעיה זו נגרמה על-ידי מאפיין חדש שהוצג לאחרונה, שהיישום הראשוני שלו החזיר שגיאת "NotImplemented", ולכן גרם לכשל של חלק מהקריאות לפעולת השירות load(). 

להלן דוגמה של קוד שעשוי להיות מושפע.

מצב: תוקן

פתרון

עדכן לגירסה העדכנית ביותר של Word.

כדי שמפתחים יבצעו את התוספות שלהם על גירסאות Build מושפעות

הדרך להימנע ממאפיינים לא ידועים הגורמים לבעיות בעת טעינת פקד תוכן היא לציין באופן מפורש את קבוצת המאפיינים הנדרשים בהתאם ללוגיקה הרצויה. 

עדכון הדוגמה הקודמת של הקוד המושפע, הקוד הבא טוען רק את המאפיינים הדרושים של פקדי התוכן.

למידע נוסף:

• טעינה(אפשרויות)

• load(propertyNames)

• load(propertyNamesAndPaths)

רזולוציה

• Word באינטרנט: לא מושפע.

• Word ב- Windows

  • ערוץ ביתא: מושפע אך גירסאות Build לאחר 16.0.16815.20000 מכילות את התיקון.

  • ערוץ שוטף (תצוגה מקדימה): מושפע אך גירסאות Build לאחר 16.0.16731.20170 מכילות את התיקון.

  • ערוץ חודשי: לא מושפע.

  • לא מושפע.

• Word ב- Mac

  • גירסת ביתא: מושפעת אך גירסאות Build לאחר 16.77.23082006 מכילות את התיקון.

  • ייצור: מושפע אך גירסאות Build לאחר 16.76.23082301 מכילות את התיקון.