Word’API JavaScript génère l’erreur « RichApi.Error : NotImplemented » avec les compléments Office utilisant des contrôles de contenu

Dernière mise à jour : 31 août 2023

PROBLÈME

Les compléments utilisant des contrôles de contenu via Word’API JavaScript peuvent afficher des erreurs « RichApi.Error : NotImplemented » dans certains scénarios. 

Cela a été remarqué pour la première fois après la mise à jour Office.js du 10 août 2023, en particulier sur MacOS (build 16.76).

CAUSE

La méthode ContentControl.load() est utilisée pour charger toutes les propriétés d’un contrôle de contenu instance. Cette méthode charge en interne toutes les propriétés de contrôle de contenu une par une. Toutefois, au lieu d’inclure uniquement toutes les propriétés publiées, les nouvelles propriétés qui sont encore en cours de développement ou qui ne sont pas encore publiées sont également incluses. 

Ce problème a été provoqué par une nouvelle propriété récemment introduite, dont l’implémentation initiale renvoyait une erreur « NotImplemented », ce qui a entraîné l’échec de certains appels à la méthode load(). 

Voici un exemple de code potentiellement affecté.

ÉTAT : RÉSOLU

SOLUTION DE CONTOURNEMENT

Mettez à jour vers la dernière version de Word.

Permettre aux développeurs de faire fonctionner leurs compléments sur les builds affectées

La façon d’éviter que des propriétés inconnues ne provoquent des problèmes lors du chargement d’un contrôle de contenu consiste à spécifier explicitement l’ensemble des propriétés requises en fonction de la logique souhaitée. 

En mettant à jour l’exemple précédent de code affecté, le code suivant charge uniquement les propriétés requises des contrôles de contenu.

Voir aussi :

• load(options)

• load(propertyNames)

• load(propertyNamesAndPaths)

RÉSOLUTION

• Word sur le web : non affecté.

• Word sur Windows

  • Canal bêta : affecté, mais les builds postérieures à 16.0.16815.20000 contiennent le correctif.

  • Canal actuel (préversion) : les builds affectées mais postérieures à 16.0.16731.20170 contiennent le correctif.

  • Canal mensuel : non affecté.

  • MEC : Non affecté.

• Word sur Mac

  • Bêta : affecté, mais les builds après 16.77.23082006 contiennent le correctif.

  • Production : les builds affectées mais après 16.76.23082301 contiennent le correctif.