Word API javaScript apresenta o erro "RichApi.Error: NotImplemented" com suplementos do Office através de controlos de conteúdo

Última Atualização: 31 de agosto de 2023

PROBLEMA

Os suplementos que utilizam controlos de conteúdo através de Word API JavaScript podem mostrar erros "RichApi.Error: NotImplemented" em determinados cenários. 

Isto foi notado pela primeira vez após a atualização de Office.js a 10 de agosto de 2023, particularmente no MacOS (Compilação 16.76).

CAUSA

O método ContentControl.load() é utilizado para carregar todas as propriedades de uma instância de controlo de conteúdo. Este método carrega internamente todas as propriedades de controlo de conteúdo , uma a uma. No entanto, em vez de incluir apenas todas as propriedades lançadas, também estão incluídas novas propriedades que ainda estão em desenvolvimento ou ainda não foram lançadas. 

Este problema foi causado por uma nova propriedade recentemente introduzida cuja implementação inicial estava a devolver um erro "NotImplemented" e, por conseguinte, causava a falha de algumas das chamadas para o método load(). 

Segue-se um exemplo de código potencialmente afetado.

ESTADO: CORRIGIDO

SOLUÇÃO

Atualize para a versão mais recente do Word.

Para os programadores fazerem com que os suplementos funcionem em compilações afetadas

A forma de evitar propriedades desconhecidas que causam problemas ao carregar um controlo de conteúdo é especificar explicitamente o conjunto de propriedades que são necessárias de acordo com a lógica pretendida. 

Ao atualizar o exemplo anterior do código afetado, o código seguinte carrega apenas as propriedades necessárias dos controlos de conteúdo.

Consulte também:

• load(options)

• load(propertyNames)

• load(propertyNamesAndPaths)

RESOLUÇÃO

• Word na Web: Não afetado.

• Word no Windows

  • Canal Beta: afetado, mas as compilações após a versão 16.0.16815.20000 contêm a correção.

  • Canal Atual (Pré-visualização): afetado, mas as compilações posteriores a 16.0.16731.20170 contêm a correção.

  • Via de Atualizações Mensais: não afetada.

  • MEC: Não afetado.

• Word no Mac

  • Beta: afetada, mas compilações após 16.77.23082006 contêm a correção.

  • Produção: afetada, mas compilações após 16.76.23082301 contêm a correção.