Word JavaScript-API gibt den Fehler "RichApi.Error: NotImplemented" mit Office-Add-Ins mithilfe von Inhaltssteuerelementen aus.

Letzte Aktualisierung: 31. August 2023

PROBLEM

Add-Ins, die Inhaltssteuerelemente über Word JavaScript-API verwenden, können in bestimmten Szenarien Fehler vom Typ "RichApi.Error: NotImplemented" anzeigen. 

Dies wurde erstmals nach dem Office.js Update vom 10. August 2023 bemerkt, insbesondere unter macOS (Build 16.76).

URSACHE

Die ContentControl.load()-Methode wird verwendet, um alle Eigenschaften eines Inhaltssteuerelements instance zu laden. Diese Methode lädt intern alle Eigenschaften des Inhaltssteuerelements nacheinander. Anstatt jedoch nur alle veröffentlichten Eigenschaften einzubeziehen, sind auch neue Eigenschaften enthalten, die sich noch in der Entwicklung befinden oder noch nicht veröffentlicht wurden. 

Dieses Problem wurde durch eine kürzlich eingeführte neue Eigenschaft verursacht, deren anfängliche Implementierung den Fehler "NotImplemented" zurückgibt und daher einige der Aufrufe der load()-Methode fehlschlagen. 

Es folgt ein Beispiel für potenziell betroffenen Code.

STATUS: BEHOBEN

PROBLEMUMGEHUNG

Aktualisieren Sie auf die neueste Version von Word.

Damit Entwickler ihre Add-Ins für betroffene Builds verwenden können

Die Möglichkeit, unbekannte Eigenschaften zu vermeiden, die beim Laden eines Inhaltssteuerelements Probleme verursachen, besteht darin, explizit den Satz von Eigenschaften anzugeben, die gemäß der gewünschten Logik erforderlich sind. 

Wenn das vorherige Beispiel des betroffenen Codes aktualisiert wird, lädt der folgende Code nur die erforderlichen Eigenschaften der Inhaltssteuerelemente.

Siehe auch:

• load(options)

• load(propertyNames)

• load(propertyNamesAndPaths)

Auflösung

• Word im Web: Nicht betroffen.

• Word unter Windows

  • Betakanal: Betroffen, aber Builds nach 16.0.16815.20000 enthalten den Fix.

  • Aktueller Kanal (Vorschau): Betroffen, aber Builds nach 16.0.16731.20170 enthalten den Fix.

  • Monatlicher Kanal: Nicht betroffen.

  • MEC: Nicht betroffen.

• Word unter Mac

  • Beta: Betroffen, aber Builds nach 16.77.23082006 enthalten den Fix.

  • Produktion: Betroffen, aber Builds nach 16.76.23082301 enthalten den Fix.