Solucionar erros de desenvolvimento com Suplementos do Office

Aqui está uma lista de problemas comuns que você pode encontrar ao desenvolver um suplemento do Office.

Não é possível carregar o suplemento no painel de tarefas ou outros problemas relacionados ao manifesto do suplemento

Confira Validar o manifesto de suplemento do Office e Depurar seu suplemento com o log do tempo de execução para depurar problemas de manifesto de suplemento.

As personalizações da faixa de opções não estão sendo renderizadas conforme o esperado

• Com o sideload e a execução do suplemento, cole as URLs dos ícones da faixa de opções do suplemento na barra de navegação do navegador e veja se os arquivos de ícone abrem.

• Por padrão, erros de suplemento conectados à interface do usuário do Office são suprimidos. Você pode ativar essas mensagens de erro com as seguintes etapas.

  1. Com o suplemento removido, abra a guia Arquivo do aplicativo do Office.
  2. Selecione Opções.
  3. Na caixa de diálogo Opções , selecione Avançado.
  4. Na seção Geral (a seção Desenvolvedores para Outlook), habilite Mostrar erros da interface do usuário do suplemento.

  Faça o sideload do suplemento novamente e veja se há algum erro.

Alterações nos comandos de suplemento, incluindo botões da faixa de opções e itens de menu, não entram em vigor

Limpar o cache ajuda a garantir que a versão mais recente do manifesto do suplemento esteja sendo usada. Para limpar o cache do Office, siga as instruções em Limpar o cache do Office. Se você estiver usando o Office na Web, limpe o cache do navegador por meio da interface do usuário do navegador.

Comandos de suplemento de suplementos de desenvolvimento antigos permanecem na faixa de opções mesmo depois que o cache é limpo

Às vezes, os botões ou menus de um suplemento que você estava desenvolvendo no passado aparecem na faixa de opções quando você executa um aplicativo do Office, mesmo depois de limpar o cache. Experimente estas técnicas:

• Se você desenvolver suplementos em mais de um computador e as configurações de usuário estiverem sincronizadas entre os computadores, tente limpar o cache do Office em todos os computadores. Feche todos os aplicativos do Office em todos os computadores e limpe o cache de todos eles antes de abrir qualquer aplicativo do Office em qualquer um deles.
• Se você publicou o manifesto do suplemento antigo em um compartilhamento de rede, desligue todos os aplicativos do Office, limpe o cache e verifique se o manifesto do suplemento foi removido da pasta compartilhada.

Alterações em arquivos estáticos, como JavaScript, HTML e CSS, não entram em vigor

O navegador pode estar armazenando esses arquivos em cache. Para evitar isso, desative o cache do lado do cliente ao desenvolver. Os detalhes dependerão do tipo de servidor que você estiver usando. Na maioria dos casos, envolve adicionar determinados cabeçalhos às respostas HTTP. Sugerimos o seguinte conjunto.

• Controle de cache: "privado, sem cache, sem armazenamento"
• Pragma: "sem cache"
• Expira: "-1"

Para um exemplo de como fazer isso em um servidor Node.JS Express, confira este arquivo app.js. Para um exemplo em um projeto ASP.NET, confira este arquivo cshtml.

Se o seu suplemento estiver hospedado no Servidor de Informações da Internet (IIS), você também poderá adicionar o seguinte ao web.config.

<system.webServer>
  <staticContent>
    <clientCache cacheControlMode="UseMaxAge" cacheControlMaxAge="0.00:00:00" cacheControlCustom="must-revalidate" />
  </staticContent>

Se essas etapas não parecerem funcionar a princípio, talvez seja necessário limpar o cache do navegador. Faça isso através da interface do usuário do navegador. Às vezes, o cache do Microsoft Edge não é limpo com êxito quando você tenta limpá-lo na interface do usuário do Edge. Se isso acontecer, execute o seguinte comando em um prompt de comando do Windows.

del /s /f /q %LOCALAPPDATA%\Packages\Microsoft.Win32WebViewHost_cw5n1h2txyewy\AC\#!123\INetCache\

As alterações feitas nos valores das propriedades não ocorrem e não há nenhuma mensagem de erro

Verifique a documentação de referência da propriedade para ver se ela é somente leitura. Além disso, as definições de TypeScript para o Office JS especificam quais propriedades de objeto são somente leitura. Se você tentar definir uma propriedade somente leitura, a operação de gravação falhará silenciosamente, sem nenhum erro gerado. O exemplo a seguir tenta erroneamente definir a propriedade somente leitura Chart.id. Consulte também Algumas propriedades não podem ser definidas diretamente.

// This will do nothing, since `id` is a read-only property.
myChart.id = "5";

Obtendo o erro: "Este suplemento não está mais disponível"

Veja a seguir algumas das causas desse erro. Se você descobrir outras causas, informe-nos com a ferramenta de comentários na parte inferior da página.

• Se você estiver usando o Visual Studio, pode haver um problema com o sideload. Feche todas as instâncias do host do Office e do Visual Studio. Reinicie o Visual Studio e tente pressionar F5 novamente.

• O manifesto do suplemento foi removido de seu local de implantação, como Implantação Centralizada, um catálogo do SharePoint ou um compartilhamento de rede.

• Se o manifesto somente do suplemento estiver sendo usado, uma das opções a seguir poderá ser aplicada.

  • O valor do elemento ID no manifesto foi alterado diretamente na cópia implantada. Se, por qualquer motivo, você quiser alterar essa ID, primeiro remova o suplemento do host do Office e, em seguida, substitua o manifesto original pelo manifesto alterado. Você precisa limpar o cache do Office para remover todos os vestígios do original. Consulte o artigo Limpar o cache do Office para obter instruções sobre como limpar o cache do sistema operacional.
  • O manifesto do suplemento tem um resid que não está definido em nenhum lugar na seção Recursos do manifesto ou há uma incompatibilidade na ortografia do resid entre onde ele é usado e onde é definido na <Resources> seção.
  • Há um resid atributo em algum lugar no manifesto com mais de 32 caracteres. Um resid atributo e o id atributo do recurso correspondente na <Resources> seção não podem ter mais de 32 caracteres.

• O suplemento tem um comando de suplemento personalizado, mas você está tentando executá-lo em uma plataforma que não dá suporte a eles. Para obter mais informações, consulte Conjuntos de requisitos de comandos de suplemento.

O suplemento não funciona no Microsoft Edge, mas funciona em outros navegadores

Consulte Solucionar problemas do WebView2.

O suplemento do Excel gera erros, mas não de forma consistente

Consulte Solucionar problemas de suplementos do Excel para possíveis causas.

O suplemento do Word gera erros ou exibe um comportamento quebrado

Consulte Solucionar problemas de suplementos do Word para possíveis causas.

Somente manifesto de suplementos de erros de validação de esquema em projetos do Visual Studio

Se você estiver usando recursos mais recentes que exigem alterações no arquivo de manifesto somente do suplemento, poderá obter erros de validação no Visual Studio. Por exemplo, ao adicionar o <Runtimes> elemento para implementar o runtime compartilhado, você poderá ver o seguinte erro de validação.

O elemento 'Host' no namespace 'http://schemas.microsoft.com/office/taskpaneappversionoverrides' tem o elemento filho inválido 'Runtimes' no namespace 'http://schemas.microsoft.com/office/taskpaneappversionoverrides'

Se isso ocorrer, você poderá atualizar os arquivos XSD que o Visual Studio usa para as versões mais recentes. As versões mais recentes do esquema estão em [MS-OWEMXML]: Apêndice A: Esquema XML completo.

Localize os arquivos XSD

1. Abra seu projeto no Visual Studio.
2. No Gerenciador de Soluções, abra o arquivo manifest.xml. Normalmente, o manifesto está no primeiro projeto em sua solução.
3. Selecionea janela Exibir> propriedades (F4).
4. Defina a seleção do cursor no manifest.xml para que a janela Propriedades mostre as propriedades do documento XML .
5. Na janela Propriedades , selecione a propriedade Esquemas e, em seguida, selecione as reticências (...) para abrir o editor de Esquemas XML . Aqui você pode encontrar a localização exata da pasta de todos os arquivos de esquema que seu projeto usa.

Atualizar os arquivos XSD

1. Abra o arquivo XSD que você deseja atualizar em um editor de texto. O nome do esquema do erro de validação será correlacionado ao nome do arquivo XSD. Por exemplo, abra TaskPaneAppVersionOverridesV1_0.xsd.
2. Localize o esquema atualizado em [MS-OWEMXML]: Apêndice A: Esquema XML completo. Por exemplo, TaskPaneAppVersionOverridesV1_0 está em taskpaneappversionoverrides Schema.
3. Copie o texto em seu editor de texto.
4. Salve o arquivo XSD atualizado.
5. Reinicie o Visual Studio para selecionar as novas alterações do arquivo XSD.

Você pode repetir o processo anterior para quaisquer esquemas adicionais que estejam desatualizados.

Confira também

• Depurar suplementos no Office na Web
• Fazer sideload de um suplemento do Office no Mac
• Fazer sideload de um Suplemento do Office no iPad
• Depurar Suplementos do Office em um Mac
• Validar o manifesto de suplemento do Office
• Depurar seu suplemento com o log do tempo de execução
• Solucionar erros de usuários com Suplementos do Office
• Runtimes em Suplementos do Office
• Microsoft Q&R (Desenvolvimento do Office)