Browsers e controlos webview utilizados pelos Suplementos do Office

Os Suplementos do Office são aplicações Web que são apresentadas com iframes quando são executados no Office na Web. No Office para clientes de ambiente de trabalho e dispositivos móveis, os Suplementos do Office utilizam um controlo de browser incorporado (também conhecido como webview). Os suplementos também precisam de um mecanismo JavaScript para executar o JavaScript. Tanto o browser incorporado como o motor são fornecidos por um browser instalado no computador do utilizador. Neste artigo, "webview" refere-se à combinação de um controlo webview e de um motor JavaScript.

A vista Web utilizada depende de:

• O sistema operativo do computador.
• Quer o suplemento esteja a ser executado no Office na Web, no Office transferido a partir de uma subscrição do Microsoft 365 ou no Office 2016 ou posterior perpétuo.
• Nas versões perpétuas do Office no Windows, se o suplemento está em execução na variação "revenda" ou "licenciamento em volume".

As secções seguintes especificam que browser é utilizado para as várias plataformas e sistemas operativos.

Plataformas não Windows

Para estas plataformas, só a plataforma determina o browser que é utilizado.

Windows

Um suplemento em execução no Windows pode utilizar qualquer uma das três webviews diferentes:

• WebView2, fornecido pelo Microsoft Edge (baseado em Chromium).
• EdgeHTML, que é fornecido por Versão Prévia do Microsoft Edge.
• Trident+, fornecido pela Internet Explorer 11. O "+" no final indica que os Suplementos do Office utilizam funcionalidades adicionais da Internet Explorer 11 que não estão incorporadas no próprio Trident.

Versões perpétuas do Office no Windows

Para versões perpétuas do Office no Windows, o browser utilizado é determinado pela versão do Office, se a licença é de revenda ou de licenciamento em volume e se o Edge WebView2 (baseado em Chromium) está instalado. A versão do Windows não importa, mas tenha em atenção que os Suplementos do Office não são suportados em versões anteriores ao Windows 7 e Office 2021 e posteriores não são suportados em versões anteriores a Windows 10.

Para determinar se o Office 2016 ou o Office 2019 é revenda ou licenciado em volume, utilize o formato da versão do Office e do número de compilação. (Por Office 2021 e posteriores, a distinção entre o licenciamento em volume e o retalho não importa.)

• Revenda: para o Office 2016 e 2019, o formato é YYMM (xxxxx.xxxxxx), terminando com dois blocos de cinco dígitos; por exemplo, 2206 (Build 15330.20264).
• Licenciado em volume:
  • Para o Office 2016, o formato é 16.0.xxxx.xxxxx, terminando com dois blocos de quatro dígitos; por exemplo, 16.0.5197.1000.
  • Para o Office 2019, o formato é 1808 (xxxxx.xxxxxx), terminando com dois blocos de cinco dígitos; por exemplo, 1808 (Build 10388.20027). Tenha em atenção que o ano e o mês são sempre 1808.

¹ Nas versões do Windows anteriores a Windows 11, o controlo WebView2 tem de ser instalado para que o Office o possa incorporar. É instalado com Office 2021 perpétua ou posterior, mas não é instalado automaticamente com o Microsoft Edge. Se tiver uma versão anterior do Office perpétuo, utilize as instruções para instalar o controlo no Microsoft Edge WebView2/Incorporar conteúdo Web... com o Microsoft Edge WebView2.

² Quando utiliza o EdgeHTML ou o WebView2, o Narrador do Windows (por vezes denominado "leitor de ecrã") lê a <title> etiqueta na página que é aberta no painel de tarefas. Em Trident+, o Narrador lê a barra de título do painel de tarefas, que provém do nome do suplemento especificado no manifesto do suplemento.

³ Se o seu suplemento utilizar um manifesto apenas de suplemento e incluir o <elemento Runtimes> no manifesto ou utilizar o manifesto unificado e incluir uma propriedade "extensions.runtimes.lifetime", não utilizará EdgeHTML. Se as condições para utilizar o WebView2 forem cumpridas, o suplemento utiliza o WebView2. Caso contrário, utiliza Trident+. Para obter mais informações, veja Runtimes e Configure your Outlook add-in for event-based activation (Configurar o suplemento do Outlook para ativação baseada em eventos).

Versões de subscrição do Microsoft 365 do Office no Windows

Para a subscrição do Office no Windows, o browser utilizado é determinado pelo sistema operativo, a versão do Office e se o controlo WebView2 está instalado.

¹ Consulte a página do histórico de atualizações e como encontrar a versão do cliente do Office e o canal de atualização para obter mais detalhes.

² Nas versões do Windows anteriores ao Windows 11, o controlo WebView2 tem de ser instalado para que o Office o possa incorporar. Está instalado com o Microsoft 365, Versão 2101 ou posterior, mas não é instalado automaticamente com o Microsoft Edge. Se tiver uma versão anterior do Microsoft 365, utilize as instruções para instalar o controlo no Microsoft Edge WebView2/Incorporar conteúdo Web... com o Microsoft Edge WebView2. Nas versões anteriores à versão 16.0.14326.xxxxx do Microsoft 365, também tem de criar a chave de registo HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\16.0\WEF\Win32WebView2 e definir o respetivo valor como dword:00000001.

³ Quando utiliza o EdgeHTML ou o WebView2, o Narrador do Windows (por vezes denominado "leitor de ecrã") lê a <title> etiqueta na página que é aberta no painel de tarefas. Em Trident+, o Narrador lê a barra de título do painel de tarefas, que provém do nome do suplemento especificado no manifesto do suplemento.

⁴ Se o seu suplemento utilizar um manifesto apenas de suplemento e incluir o <elemento Runtimes> no manifesto ou utilizar o manifesto unificado e incluir uma propriedade "extensions.runtimes.lifetime", não utilizará EdgeHTML. Se as condições para utilizar o WebView2 forem cumpridas, o suplemento utiliza o WebView2. Caso contrário, utiliza Trident+. Para obter mais informações, veja Runtimes e Configure your Outlook add-in for event-based activation (Configurar o suplemento do Outlook para ativação baseada em eventos).

Trabalhar com Trident+ (Internet Explorer 11)

O Trident+ não suporta versões JavaScript posteriores ao ES5. Se algum dos utilizadores do seu suplemento tiver plataformas que utilizem Trident+, para utilizar a sintaxe e as funcionalidades do ECMAScript 2015 ou posterior, tem duas opções.

• Escreva o código no ECMAScript 2015 (também denominado ES6) ou javaScript posterior, ou em TypeScript e, em seguida, compile o seu código para ES5 JavaScript com um compilador, como babel ou tsc.
• Escreva no ECMAScript 2015 ou javaScript posterior, mas também carregue uma biblioteca de polifill , como core-js , que permite ao IE executar o seu código.

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.

Resolver problemas do EdgeHTML e WebView2 (Microsoft Edge)

Os Trabalhadores de Serviços não estão a funcionar

Os Suplementos do Office não suportam Funções de Trabalho de Serviço quando o EdgeHTML é utilizado. São suportados com o WebView2.

A barra de deslocamento não aparece no painel de tarefas

Por predefinição, as barras de deslocamento no EdgeHTML e webView2 estão ocultas até pairar o cursor do rato. Para garantir que a barra de rolagem fique sempre visível, o estilo de CSS que se aplica ao elemento <body> das páginas no painel de tarefas deve incluir a propriedade (-ms- reoverflow-style) e deve ser definida como scrollbar.

Ao depurar com o Microsoft Edge DevTools, o suplemento falha ou recarrega

Definir pontos de interrupção nas DevTools do Microsoft Edge para EdgeHTML pode fazer com que o Office pense que o suplemento está bloqueado. Ele recarrega automaticamente o suplemento quando isso acontece. Para evitar isso, adicione a seguinte chave do registro e valor ao computador de desenvolvimento [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\16.0\Wef]"AlertInterval"=dword:00000000:.

Quando o suplemento tentar abrir, o erro “ADD-IN ERROR não é possível abrir este suplemento a partir do localhost" acontece

Uma causa conhecida é que o EdgeHTML requer que seja dada ao localhost uma isenção de loopback no computador de desenvolvimento. Siga as instruções em não é possível abrir o suplemento do localhost.

Obter erros ao tentar transferir um ficheiro PDF

A transferência direta de blobs como ficheiros PDF num suplemento não é suportada com o EdgeHTML ou WebView2. A solução é criar uma aplicação Web simples que transfira blobs como ficheiros PDF. No seu suplemento, chame o Office.context.ui.openBrowserWindow(url) método e transmita o URL da aplicação Web. Esta ação irá abrir a aplicação Web numa janela do browser fora do Office.

Documentos protegidos pelo WIP

É necessário um passo adicional para que os Suplementos sejam executados num documento com o WIP (Windows Proteção de Informações) e utilizem o WebView2 (microsoft Edge baseado em Chromium). Adicione o processo WebView2, msedgewebview2.exe, à lista de aplicações protegidas na política WIP da sua empresa. Um administrador adiciona esta política wip através de Intune com os seguintes valores.

• Nome: Webview2
• Publisher: O=MICROSOFT CORPORATION, L=REDMOND, S=WASHINGTON, C=US
• Nome do Produto: WEBVIEW2 DO MICROSOFT EDGE
• Ficheiro: MSEDGEWEBVIEW2.EXE
• Versão Mínima: *
• Versão Máxima: *

Se a política wip não tiver sido adicionada, o suplemento é predefinido para um runtime mais antigo. Nas secções Versões perpétuas do Office no Windows e versões de subscrição do Microsoft 365 do Office no Windows anteriormente neste artigo, substitua EdgeHTML (Versão Prévia do Microsoft Edge) por WebView2 (baseado no Microsoft Edge Chromium) onde quer que seja apresentado.

Para determinar se um documento está protegido por WIP, siga estes passos.

1. Abra o ficheiro.
2. Selecione o separador Ficheiro no friso.
3. Selecione Informações.
4. Na secção superior da página Informações , imediatamente abaixo do nome do ficheiro, um documento compatível com WIP terá um ícone de pasta seguido de Gerido por Trabalho (...).

Confira também

• Requisitos para a Execução de Suplementos do Office
• Runtimes nos Suplementos do Office