Word API de JavaScript produce el error "RichApi.Error: NotImplemented" con complementos de Office mediante controles de contenido

Última actualización: 31 de agosto de 2023

PROBLEMA

Los complementos que usan controles de contenido a través de Word API de JavaScript pueden mostrar errores "RichApi.Error: NotImplemented" en algunos escenarios. 

Esto se notó por primera vez después de la actualización de Office.js el 10 de agosto de 2023, especialmente en MacOS (compilación 16.76).

CAUSA

El contentControl.load() método se utiliza para cargar todas las propiedades de una instancia de control de contenido. Ese método carga internamente todas las propiedades de control de contenido una por una. Sin embargo, en lugar de incluir solo todas las propiedades publicadas, también se incluyen nuevas propiedades que aún se están desarrollando o que aún no se han publicado. 

Este problema se producía por una nueva propiedad recientemente introducida cuya implementación inicial devolvía un error "NotImplemented" y, por tanto, provocaba errores en algunas de las llamadas al método load(). 

El siguiente es un ejemplo de código potencialmente afectado.

ESTADO: CORREGIDO

SOLUCIÓN ALTERNATIVA

Actualiza a la última versión de Word.

Para que los desarrolladores hagan que sus complementos funcionen en las compilaciones afectadas

La manera de evitar que propiedades desconocidas causen problemas al cargar un control de contenido es especificar explícitamente el conjunto de propiedades necesarias según la lógica deseada. 

Al actualizar el ejemplo anterior de código afectado, el código siguiente solo carga las propiedades necesarias de los controles de contenido.

Vea también:

• load(options)

• load(propertyNames)

• load(propertyNamesAndPaths)

SOLUCIÓN

• Word en la web: no se ve afectado.

• Word en Windows

  • Canal beta: las compilaciones afectadas, pero posteriores a 16.0.16815.20000, contienen la corrección.

  • Canal actual (versión preliminar): las compilaciones afectadas pero posteriores a la versión 16.0.16731.20170 contienen la corrección.

  • Canal mensual: no se ve afectado.

  • MEC: No se ve afectado.

• Word en Mac

  • Beta: Las compilaciones afectadas, pero posteriores a la 16.77.23082006, contienen la corrección.

  • Producción: las compilaciones afectadas, pero posteriores a la 16.76.23082301, contienen la corrección.