Partilhar via

Testar o seu Suplemento do Office no Tridente

  • Artigo

Se planeia suportar versões mais antigas do Windows e do Office, o seu suplemento tem de funcionar no controlo de browser incorporado denominado "Trident" fornecido pelo Internet Explorer 11. Pode utilizar uma linha de comandos para mudar de uma vista Web mais moderna utilizada pelos suplementos para o Trident para este teste. Para obter informações sobre as versões do Windows e do Office que utilizam o controlo webview do Internet Explorer 11, consulte Browsers e controlos webview utilizados pelos Suplementos do Office. Neste artigo, "webview" refere-se à combinação de um controlo webview e de um motor JavaScript.

Importante

Os Webviews do Internet Explorer e do Microsoft Edge Legado ainda são utilizados nos Suplementos do Office

Algumas combinações de plataformas e versões do Office, incluindo versões perpétuas licenciadas em volume através do Office 2019, ainda utilizam os controlos webview fornecidos com o Internet Explorer 11 (denominado "Trident") e o Microsoft Edge Legado (denominado "EdgeHTML") para alojar suplementos, conforme explicado em Browsers e controlos webview utilizados pelos Suplementos do Office. O Internet Explorer 11 foi desativado no Windows 10 e Windows 11 em fevereiro de 2023 e a IU para o iniciar foi removida; mas ainda está instalado com esses sistemas operativos. Assim, o Trident e outras funcionalidades do Internet Explorer ainda podem ser chamados através de programação pelo Office.

Recomendamos (mas não necessite) que suporte estas combinações, pelo menos de forma mínima, ao fornecer aos utilizadores do seu suplemento uma mensagem de falha correta quando o suplemento for iniciado nestas webviews. Tenha estes pontos adicionais em mente:

  • O Office na Web já não é aberto no Internet Explorer ou no Microsoft Edge Legado. Consequentemente, o AppSource não testa suplementos no Office na Web nestes browsers.
  • O AppSource ainda testa combinações de plataformas e versões de ambiente de trabalho do Office que utilizam Trident ou EdgeHTML. No entanto, apenas emite um aviso quando o suplemento não suporta estas webviews; o suplemento não é rejeitado pelo AppSource.
  • A ferramenta Script Lab já não suporta Trident.

Se planeia suportar versões mais antigas do Windows e do Office, o seu suplemento tem de funcionar no controlo de browser incorporado denominado "Trident" fornecido pelo Internet Explorer 11. Pode utilizar uma linha de comandos para mudar de uma vista Web mais moderna utilizada pelos suplementos para o Trident para este teste. Para obter informações sobre as versões do Windows e do Office que utilizam o controlo webview do Internet Explorer 11, consulte Browsers e controlos webview utilizados pelos Suplementos do Office.

Importante

O Trident não suporta versões JavaScript posteriores ao ES5. Se quiser utilizar a sintaxe e as funcionalidades do ECMAScript 2015 ou posterior, tem de utilizar um transpiler ou polifill ou ambos. Para obter mais informações sobre estas opções, consulte Suportar webviews mais antigos da Microsoft e versões do Office.

Além disso, o Trident não suporta algumas funcionalidades HTML5, como multimédia, gravação e localização. Para saber mais, consulte Determinar o webview em que o suplemento está a ser executado no runtime.

Observação

  • O Office na Web não pode ser aberto no Internet Explorer 11, pelo que não pode (e não precisa) testar o seu suplemento no Office na Web com o Internet Explorer.

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

Mudar para a vista Web tridente

Dica

Nas versões recentes do Office, uma forma de identificar o controlo webview que o Office está a utilizar é através do menu de personalidade em qualquer suplemento onde esteja disponível. (O menu de personalidade não é suportado 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 reporta o Microsoft Edge, o Microsoft Edge Legado ou o Internet Explorer. O runtime não está incluído na caixa de diálogo em versões mais antigas do Office.

Existem duas formas de mudar o Webview Trident. Pode executar um comando simples numa linha de comandos ou pode instalar uma versão do Office que utiliza o Trident por predefinição. Recomendamos o primeiro método, mas deve utilizar o segundo nos seguintes cenários.

  • O seu projeto foi desenvolvido com o Visual Studio e o IIS. Não se baseia Node.js.
  • Quer ser absolutamente robusto nos seus testes.
  • Não pode utilizar o canal Beta para o Microsoft 365 no seu computador de desenvolvimento.
  • Está a desenvolver num Mac.
  • Se, por algum motivo, a ferramenta de linha de comandos não funcionar.

Alternar através da linha de comandos

Se o seu projeto for baseado em Node.js (ou seja, não for desenvolvido com o Visual Studio e o servidor de Informação Internet (IIS)), pode forçar o Office no Windows a utilizar o controlo webview edgeHTML fornecido pelo Edge Legado ou o controlo de webview Trident fornecido pelo Internet Explorer para executar suplementos, mesmo que tenha uma combinação de versões do Windows e do Office que normalmente utilizaria uma descrição Web mais recente. Para obter mais informações sobre que browsers e webviews são utilizados por várias combinações de versões do Windows e do Office, consulte Browsers e controlos webview utilizados pelos Suplementos do Office.

Observação

A ferramenta utilizada para forçar a alteração no Webview só é suportada no canal de subscrição Beta do Microsoft 365. Adira ao programa Microsoft 365 Insider e selecione a opção Canal Beta para aceder às compilações do Office Beta. Consulte também Acerca do Office: Que versão do Office estou a utilizar?.

Estritamente, é a webview mudança desta ferramenta (consulte o Passo 2) que requer o canal Beta. A ferramenta tem outros comutadores que não têm este requisito.

  1. Se o seu projeto não tiver sido criado com a ferramenta Gerador Yeoman para Suplementos do Office , tem de instalar a ferramenta office-addin-dev-settings. Execute o seguinte comando numa linha de comandos.

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

    Importante

    A ferramenta office-addin-dev-settings não é suportada no Mac.

  2. Especifique o webview que pretende que o Office utilize com o seguinte comando numa linha de comandos na raiz do projeto. Substitua <path-to-manifest> pelo caminho relativo, que é apenas o nome do ficheiro de manifesto se estiver na raiz do projeto. Substitua por <webview> ou edge-legacyie . Tenha em atenção que as opções têm o nome dos browsers nos quais as webviews tiveram origem. A ie opção significa "Trident" e a opção edge-legacy significa "EdgeHTML".

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

    Eis alguns exemplos.

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

    npx office-addin-dev-settings webview manifest.json edge-legacy

    Deverá ver uma mensagem na linha de comandos a indicar que o tipo de webview está agora definido como IE (ou Edge Legado).

  3. Quando tiver terminado, defina o Office para retomar a utilização da vista Web predefinida para a sua combinação de versões do Windows e do Office com o seguinte comando.

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

Instalar uma versão do Office que utiliza o Internet Explorer

Utilize o procedimento seguinte para instalar uma versão do Office (transferida a partir de uma subscrição do Microsoft 365) que utiliza o Microsoft Edge Legacy Webview (EdgeHTML) para executar suplementos ou uma versão que utiliza o Internet Explorer (Trident).

  1. Em qualquer aplicação do Office, abra o separador Ficheiro no friso e, em seguida, selecione Conta ou Contado Office. Selecione o botão Acerca do nome do anfitrião (por exemplo, Acerca do Word).

  2. Na caixa de diálogo que é aberta, localize o número de compilação xx.x.xxxxx.xxxxx completo e faça uma cópia do mesmo algures.

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

  4. Execute o ficheiro transferido para extrair a ferramenta. É-lhe pedido para escolher onde instalar a ferramenta.

  5. Na pasta onde instalou a ferramenta (onde se encontra o setup.exe ficheiro), crie um ficheiro de texto com o nome config.xml e adicione os seguintes conteúdos.

    <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 utiliza o EdgeHTML, altere-a para 16.0.11929.20946.
    • Para instalar uma versão que utiliza o Trident, altere-a para 16.0.10730.20348.

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

  8. Abra uma linha de comandos como administrador.

  9. Navegue para a pasta com os setup.exe ficheiros e config.xml .

  10. Execute o seguinte comando:

    setup.exe /configure config.xml

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

  11. Limpe a cache do Office.

Importante

Após a instalação, certifique-se de que desativa a atualização automática do Office, para que o Office não seja atualizado para uma versão que não utilize a vista Web com a qual pretende trabalhar antes de concluir a sua utilização. Isto pode ocorrer a poucos minutos da instalação. Siga estas etapas.

  1. Inicie uma aplicação do Office e abra um novo documento.
  2. Abra o separador Ficheiro no friso e, em seguida, selecione Conta do Office ou Conta.
  3. Na coluna Informações do Produto , selecione Opções de Atualização e, em seguida, selecione Desativar Atualizações. Se essa opção não estiver disponível, o Office já está configurado para não atualizar automaticamente.

Quando terminar de utilizar a versão antiga do Office, reinstale a sua versão mais recente ao editar o config.xml ficheiro e ao alterar o Version para o número de compilação que copiou anteriormente. Em seguida, repita o setup.exe /configure config.xml comando numa linha de comandos de administrador. Opcionalmente, reativar as atualizações automáticas.

Confira também