Word javascriptového rozhraní API zobrazí chybu RichApi.Error: NotImplemented s doplňky pro Office pomocí ovládacích prvků obsahu

Poslední aktualizace: 31. srpna 2023

PROBLÉM

Doplňky používající ovládací prvky obsahu prostřednictvím rozhraní WORD JavaScript API můžou v určitých scénářích zobrazovat chyby RichApi.Error: NotImplemented. 

Poprvé jsme si toho všimli po aktualizaci Office.js 10. srpna 2023, zejména v systému MacOS (build 16.76).

PŘÍČINA

Metoda ContentControl.load() se používá k načtení všech vlastností instance ovládacího prvku obsahu. Tato metoda interně načte všechny vlastnosti ovládacího prvku obsahu jeden po druhém. Místo zahrnutí všech vydaných vlastností jsou však zahrnuty také nové vlastnosti, které jsou stále ve vývoji nebo ještě nebyly vydány. 

Tento problém způsobila nedávno zavedená nová vlastnost, jejíž počáteční implementace vracela chybu NotImplemented, což způsobilo selhání některých volání metody load(). 

Následuje příklad potenciálně ovlivněného kódu.

STAV: OPRAVENO

ALTERNATIVNÍ ŘEŠENÍ

Aktualizujte na nejnovější verzi Word.

Pro vývojáře, aby jejich doplňky fungovaly na ovlivněných buildech

Způsob, jak se vyhnout neznámým vlastnostem způsobujícím potíže při načítání ovládacího prvku obsahu, je explicitně zadat sadu vlastností, které jsou požadovány podle požadované logiky. 

Následující kód aktualizuje předchozí příklad ovlivněného kódu a načte pouze požadované vlastnosti ovládacích prvků obsahu.

Viz taky:

• load(options)

• load(propertyNames)

• load(propertyNamesAndPaths)

ŘEŠENÍ

• Word na webu: Není ovlivněno.

• Word ve Windows

  • Kanál beta verze: Ovlivněno, ale buildy po verzi 16.0.16815.20000 obsahují opravu.

  • Aktuální kanál (Preview): Ovlivněno, ale buildy po verzi 16.0.16731.20170 obsahují opravu.

  • Měsíční kanál: Není ovlivněno.

  • MeC: Není ovlivněno.

• Word na Macu

  • Beta verze: Ovlivněno, ale buildy po verzi 16.77.23082006 tuto opravu obsahují.

  • Produkční prostředí: Ovlivněno, ale buildy po verzi 16.76.23082301 tuto opravu obsahují.