Compartilhar via

Testar seu suplemento do Office no Trident

  • Artigo

Se você planeja dar suporte a versões mais antigas do Windows e do Office, seu suplemento deve funcionar no controle de navegador inserível chamado "Trident" fornecido pela Internet Explorer 11. Você pode usar uma linha de comando para alternar de uma visão web mais moderna usada por suplementos para Trident para este teste. Para obter informações sobre quais versões do Windows e do Office usam o controle webview da Internet Explorer 11, consulte Navegadores e controles de visão da Web usados pelos Suplementos do Office. Neste artigo, "webview" refere-se à combinação de um controle webview e um mecanismo JavaScript.

Importante

Webviews de Explorer e Versão Prévia do Microsoft Edge da Internet ainda são usados em Suplementos do Office

Algumas combinações de plataformas e versões do Office, incluindo versões perpétuas licenciadas por volume por meio do Office 2019, ainda usam os controles webview que vêm com o Internet Explorer 11 (chamado de "Trident") e Versão Prévia do Microsoft Edge (chamado "EdgeHTML") para hospedar suplementos, conforme explicado em Navegadores e controles webview usados pelos Suplementos do Office. A Internet Explorer 11 foi desabilitada no Windows 10 e Windows 11 em fevereiro de 2023, e a interface do usuário para iniciá-la foi removida, mas ainda está instalada com esses sistemas operacionais. Portanto, o Trident e outras funcionalidades da Internet Explorer ainda podem ser chamados programaticamente pelo Office.

Recomendamos (mas não requer) que você dê suporte a essas combinações, pelo menos de forma mínima, fornecendo aos usuários do seu suplemento uma mensagem de falha graciosa quando seu suplemento é iniciado nessas visões da Web. Tenha esses pontos adicionais em mente:

  • Office na Web não é mais aberto na Internet Explorer ou Versão Prévia do Microsoft Edge. Consequentemente, o AppSource não testa suplementos em Office na Web nesses navegadores.
  • O AppSource ainda testa combinações de versões da plataforma e da área de trabalho do Office que usam Trident ou EdgeHTML. No entanto, ele só emite um aviso quando o suplemento não dá suporte a essas visões da Web; o suplemento não é rejeitado pelo AppSource.
  • A ferramenta Script Lab não dá mais suporte ao Trident.

Se você planeja dar suporte a versões mais antigas do Windows e do Office, seu suplemento deve funcionar no controle de navegador inserível chamado "Trident" fornecido pela Internet Explorer 11. Você pode usar uma linha de comando para alternar de uma visão web mais moderna usada por suplementos para Trident para este teste. Para obter informações sobre quais versões do Windows e do Office usam o controle webview da Internet Explorer 11, consulte Navegadores e controles de visão da Web usados pelos Suplementos do Office.

Importante

O Trident não dá suporte a versões JavaScript posteriores ao ES5. Se você quiser usar a sintaxe e os recursos do ECMAScript 2015 ou posterior, você precisará usar um transpiler ou polifill ou ambos. Para obter mais informações sobre essas opções, consulte Suporte a versões mais antigas da Webviews da Microsoft e do Office.

Além disso, o Trident não dá suporte a alguns recursos HTML5, como mídia, gravação e localização. Para saber mais, confira Determinar a visão da Web em que o suplemento está em execução no runtime.

Observação

  • Office na Web não pode ser aberto na Internet Explorer 11, portanto, você não pode (e não precisa) testar seu suplemento em Office na Web com Explorer da Internet.

  • A Configuração de Segurança Aprimorada da (ESC) do Internet Explorer deve ser desativada para os suplementos Web do Office funcionarem. Se você estiver usando um computador Windows Server como seu cliente ao desenvolver suplementos, observe que o ESC está ativado por padrão no Windows Server.

Alternar para a webview do Trident

Dica

Em versões recentes do Office, uma maneira de identificar o controle webview que o Office está usando é por meio do menu de personalidade em qualquer suplemento em que ele está disponível. (O menu de personalidade não tem suporte no Outlook.) Abra o menu e selecione Informações de Segurança. Na caixa de diálogo Informações de Segurança no Windows, o Runtime relata microsoft Edge, Versão Prévia do Microsoft Edge ou Internet Explorer. O runtime não está incluído na caixa de diálogo em versões mais antigas do Office.

Há duas maneiras de alternar a visão web do Trident. Você pode executar um comando simples em um prompt de comando ou instalar uma versão do Office que usa o Trident por padrão. Recomendamos o primeiro método, mas você deve usar o segundo nos cenários a seguir.

  • Seu projeto foi desenvolvido com o Visual Studio e o IIS. Não é baseado Node.js.
  • Você deseja ser absolutamente robusto em seus testes.
  • Você não pode usar o canal Beta para o Microsoft 365 em seu computador de desenvolvimento.
  • Você está desenvolvendo em um Mac.
  • Se por algum motivo a ferramenta de linha de comando não funcionar.

Alternar pela linha de comando

Se o seu projeto for baseado em Node.js (ou seja, não desenvolvido com o Visual Studio e o IIS (servidor de informações da Internet)), você poderá forçar o Office no Windows a usar o controle Webview do EdgeHTML fornecido pelo Edge Legacy ou o controle de webview trident fornecido pela Internet Explorer executar suplementos, mesmo que você tenha uma combinação de versões do Windows e do Office que normalmente usariam uma visão da Web mais recente. Para obter mais informações sobre quais navegadores e visões da Web são usados por várias combinações de versões do Windows e do Office, consulte Navegadores e controles webview usados pelos Suplementos do Office.

Observação

A ferramenta usada para forçar a alteração no Webview só tem suporte no canal de assinatura Beta do Microsoft 365. Ingresse no programa Do Microsoft 365 Insider e selecione a opção Canal Beta para acessar builds do Office Beta. Consulte também Sobre o Office: qual versão do Office estou usando?.

Estritamente, é a opção webview dessa ferramenta (consulte Etapa 2) que requer o canal Beta. A ferramenta tem outros comutadores que não têm esse requisito.

  1. Se o projeto não foi criado com a ferramenta gerador Yeoman para Suplementos do Office , você precisará instalar a ferramenta office-addin-dev-settings. Execute o comando a seguir em um prompt de comando.

    npm install office-addin-dev-settings --save-dev

    Importante

    A ferramenta office-addin-dev-settings não tem suporte no Mac.

  2. Especifique a visão da Web que você deseja que o Office use com o comando a seguir em um prompt de comando na raiz do projeto. Substitua <path-to-manifest> pelo caminho relativo, que é apenas o nome do arquivo de manifesto se ele estiver na raiz do projeto. Substitua por <webview> ou edge-legacyie . Observe que as opções são nomeadas em homenagem aos navegadores nos quais as visões da Web se originaram. A ie opção significa "Trident" e a opção edge-legacy significa "EdgeHTML".

    npx office-addin-dev-settings webview <path-to-manifest> <webview>

    Apresentamos um exemplo a seguir.

    npx office-addin-dev-settings webview manifest.xml ie

    Você deve ver uma mensagem na linha de comando de que o tipo de webview agora está definido como IE (ou Edge Legacy).

  3. Quando terminar, defina o Office para retomar usando o webview padrão para sua combinação de versões do Windows e do Office com o comando a seguir.

    npx office-addin-dev-settings webview <path-to-manifest> default

Instalar uma versão do Office que usa Explorer da Internet

Use o procedimento a seguir para instalar uma versão do Office (baixada de uma assinatura do Microsoft 365) que usa o Versão Prévia do Microsoft Edge Webview (EdgeHTML) para executar suplementos ou uma versão que usa o Explorer da Internet (Trident).

  1. Em qualquer aplicativo do Office, abra a guia Arquivo na faixa de opções e selecione Conta ou Conta do Office. Selecione o botão Sobre nome do host (por exemplo, Sobre Word).

  2. Na caixa de diálogo aberta, localize o número completo de build xx.x.xxxxx.xxxxx e faça uma cópia dele em algum lugar.

  3. Baixar a Ferramenta de Implantação do Office.

  4. Execute o arquivo baixado para extrair a ferramenta. Você deve escolher onde instalar a ferramenta.

  5. Na pasta em que você instalou a ferramenta (onde o setup.exe arquivo está localizado), crie um arquivo de texto com o nome config.xml e adicione o conteúdo a seguir.

    <Configuration>
  <Add OfficeClientEdition="64" Channel="SemiAnnual" Version="16.0.xxxxx.xxxxx">
    <Product ID="O365ProPlusRetail">
      <Language ID="en-us" />
    </Product>
  </Add>
</Configuration>

  6. Altere o Version valor.

    • Para instalar uma versão que usa EdgeHTML, altere-a para 16.0.11929.20946.
    • Para instalar uma versão que usa o Trident, altere-a para 16.0.10730.20348.

  7. Opcionalmente, altere o valor de OfficeClientEdition para "32" instalar o Office de 32 bits e altere o valor conforme necessário para instalar o Language ID Office em um idioma diferente.

  8. Abra um prompt de comando como administrador.

  9. Navegue até a pasta com os setup.exe arquivos e config.xml .

  10. Execute o seguinte comando:

    setup.exe /configure config.xml

    Esse comando instala o Office. Esse processo pode demorar alguns minutos.

  11. Desmarque o cache do Office.

Importante

Após a instalação, desative a atualização automática do Office para que o Office não seja atualizado para uma versão que não use a visão da Web com a qual você deseja trabalhar antes de concluir o uso. Isso pode acontecer em poucos minutos de instalação. Siga estas etapas.

  1. Inicie qualquer aplicativo do Office e abra um novo documento.
  2. Abra a guia Arquivo na faixa de opções e selecione Conta do Office ou Conta.
  3. Na coluna Informações do Produto, selecione Opções de Atualização e selecione Desabilitar Atualizações. Se essa opção não estiver disponível, o Office já está configurado para não ser atualizado automaticamente.

Quando terminar de usar a versão antiga do Office, reinstale sua versão mais recente editando o config.xml arquivo e alterando o para o Version número de build copiado anteriormente. Em seguida, repita o setup.exe /configure config.xml comando em um prompt de comando de administrador. Opcionalmente, habilite novamente as atualizações automáticas.

Confira também