Word API JavaScript oferece erro "RichApi.Error: NotImplemented" com suplementos do Office usando controles de conteúdo

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

PROBLEMA

Suplementos usando controles de conteúdo por meio de Word API JavaScript podem mostrar erros "RichApi.Error: NotImplemented" em determinados cenários. 

Isso foi notado pela primeira vez após a atualização Office.js em 10 de agosto de 2023, especialmente no MacOS (Build 16.76).

CAUSA

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

Esse problema foi causado por uma nova propriedade recentemente introduzida cuja implementação inicial estava retornando um erro "NotImplemented" e, portanto, fazendo com que algumas das chamadas para o método load() falhassem. 

A seguir está um exemplo de código potencialmente afetado.

STATUS: CORRIGIDO

SOLUÇÃO ALTERNATIVA

Atualize para a versão mais recente do Word.

Para que os desenvolvedores façam seus suplementos funcionarem em builds afetados

A maneira de evitar propriedades desconhecidas que causam problemas ao carregar um controle de conteúdo é especificar explicitamente o conjunto de propriedades necessárias de acordo com a lógica desejada. 

Atualizando o exemplo anterior do código afetado, o código a seguir carrega apenas as propriedades necessárias dos controles 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 é criado após 16.0.16815.20000 conter a correção.

  • Canal atual (versão prévia): afetados, mas builds após 16.0.16731.20170 contêm a correção.

  • Canal Mensal: não afetado.

  • MEC: não afetado.

• Word no Mac

  • Beta: afetados, mas builds após 16.77.23082006 contêm a correção.

  • Produção: afetados, mas builds após 16.76.23082301 contêm a correção.