A API JavaScript do Word fornece o erro "RichApi.Error: NotImplemented" com complementos do Office usando controles de conteúdo

Aplica-se a
Word para Microsoft 365 Word para Microsoft 365 para Mac

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

PROBLEMA

Suplementos que usam controles de conteúdo via API JavaScript do Word podem mostrar erros "RichApi.Error: NotImplemented" em determinados cenários. 

Isso foi notado pela primeira vez após a atualização do Office.js em 10 de agosto de 2023, principalmente 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 lançadas, novas propriedades que ainda estão em desenvolvimento ou ainda não lançadas também são incluídas. 

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

Veja a seguir um exemplo de código potencialmente afetado.

Exemplo de código JavaScript do Word captura de tela

STATUS: CORRIGIDO

SOLUÇÃO ALTERNATIVA

Atualize para a versão mais recente do Word.

Para os desenvolvedores fazerem seus suplementos funcionarem em builds afetados

A maneira de evitar que propriedades desconhecidas causem 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.

Captura de tela de solução alternativa do código da API JavaScript do Word

Consulte também:

RESOLUÇÃO

  • Word na Web: não afetado.

  • Word no Windows

    • Canal Beta: afetado, mas as compilações posteriores a 16.0.16815.20000 contêm a correção.
    • Canal Atual (Pré-visualização): afetado, mas as compilações posteriores à versão 16.0.16731.20170 contêm a correção.
    • Canal Mensal: não afetado.
    • MEC: Não afetado.
  • Word no Mac

    • Beta: afetado, mas builds posteriores a 16.77.23082006 contêm a correção.
    • Produção: afetado, mas os builds posteriores a 16.76.23082301 contêm a correção.

Mais recursos

Ícone de Especialistas (cérebro, engrenagens) Pergunte aos especialistas

Conecte-se com especialistas, participe de discussões sobre as mais recentes novidades, atualizações e práticas recomendadas do Word e leia o nosso blog.

Word Tech Community

Ícone da Comunidade Obter ajuda na comunidade

Faça uma pergunta e encontre as soluções com os Agentes de Suporte, MVPs, Engenheiros e outros usuários do Word.

Fórum do Word no Answers

Ícone de solicitação de recursos (lâmpada, ideia) Sugira um novo recurso

É um prazer ler seus comentários e sugestões! Compartilhe suas ideias. Estamos ouvindo.

Fazer comentários

Ícone de Especialistas (cérebro, engrenagens) Pergunte aos especialistas

Conecte-se com especialistas, participe de discussões sobre as mais recentes novidades, atualizações e práticas recomendadas do Word e leia o nosso blog.

Word Tech Community

Ícone da Comunidade Obter ajuda na comunidade

Faça uma pergunta e encontre as soluções com os Agentes de Suporte, MVPs, Engenheiros e outros usuários do Word.

Fórum do Word no Answers

Ícone de solicitação de recursos (lâmpada, ideia) Sugira um novo recurso

É um prazer ler seus comentários e sugestões! Compartilhe suas ideias. Estamos ouvindo.

Fazer comentários

Veja Também

Correções ou soluções alternativas para problemas recentes no Word para PC

Correções ou soluções alternativas para problemas recentes no Word para Mac