Die Word-JavaScript-API gibt den Fehler "RichApi.Error: NotImplemented" bei Office-Add-Ins aus, die Inhaltssteuerelemente verwenden

Gilt für
Word für Microsoft 365 Word für Microsoft 365 für Mac

Letzte Aktualisierung: 31. August 2023

PROBLEM

Add-Ins, die Inhaltssteuerelemente über die Word JavaScript-API verwenden, zeigen möglicherweise in bestimmten Szenarien den Fehler "RichApi.Error: NotImplemented" an. 

Dies wurde erstmals nach dem Office.js Update am 10. August 2023 festgestellt, insbesondere unter MacOS (Build 16.76).

URSACHE

Die ContentControl.load()-Methode wird verwendet, um alle Eigenschaften einer Content-Control-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 ursprüngliche Implementierung einen "NotImplemented"-Fehler zurückgab und daher dazu führte, dass einige der Aufrufe der load()-Methode fehlschlugen. 

Im Folgenden finden Sie ein Beispiel für potenziell betroffenen Code.

Screenshot eines Word-JavaScript-API-Codebeispiels

STATUS: BEHOBEN

PROBLEMUMGEHUNG

Aktualisieren Sie auf die neueste Version von Word.

Damit Entwickler ihre Add-Ins für betroffene Builds funktionieren lassen

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

Beim Aktualisieren des vorherigen Beispiels für betroffenen Code lädt der folgende Code nur die erforderlichen Eigenschaften der Inhaltssteuerelemente.

Screenshot der Problemumgehung von Word-JavaScript-API-Code

Siehe auch:

LÖ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 für Mac

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

Weitere Ressourcen

Symbol Experten (Gehirn, Zahnräder) Experten fragen

Nehmen Sie Kontakt zu Experten auf, diskutieren Sie über aktuelle Neuigkeiten, Updates und bewährte Methoden für Word, und lesen Sie unseren Blog.

Word Tech Community

Symbol Community Hilfe in der Community erhalten

Stellen Sie eine Frage, und erhalten Sie Lösungen von Supportmitarbeitern, MVPs, Ingenieuren und anderen Word-Benutzern.

Word-Forum für Antworten

Symbol zum Anfordern von Features (Glühbirne, Idee) Neues Feature vorschlagen

Wir freuen uns auf Ihr Feedback und Ihre Vorschläge! Teilen Sie uns Ihre Meinung mit. Wir hören Ihnen zu.

Feedback geben

Symbol Experten (Gehirn, Zahnräder) Experten fragen

Nehmen Sie Kontakt zu Experten auf, diskutieren Sie über aktuelle Neuigkeiten, Updates und bewährte Methoden für Word, und lesen Sie unseren Blog.

Word Tech Community

Symbol Community Hilfe in der Community erhalten

Stellen Sie eine Frage, und erhalten Sie Lösungen von Supportmitarbeitern, MVPs, Ingenieuren und anderen Word-Benutzern.

Word-Forum für Antworten

Symbol zum Anfordern von Features (Glühbirne, Idee) Neues Feature vorschlagen

Wir freuen uns auf Ihr Feedback und Ihre Vorschläge! Teilen Sie uns Ihre Meinung mit. Wir hören Ihnen zu.

Feedback geben

Siehe auch

Korrekturen oder Problemumgehungen für aktuelle Probleme in Word für PC

Korrekturen oder Problemumgehungen für aktuelle Probleme in Word für Mac