Partilhar via


Faça seu suplemento do Office ser compatível com um suplemento COM existente

Se tiver um suplemento COM existente, pode criar funcionalidades equivalentes no seu Suplemento do Office, permitindo assim que a sua solução seja executada noutras plataformas, como o Office na Web ou Mac. Em alguns casos, o seu Suplemento do Office poderá não conseguir fornecer todas as funcionalidades disponíveis no suplemento COM correspondente. Nestas situações, o seu suplemento COM pode proporcionar uma melhor experiência de utilizador no Windows do que o suplemento do Office correspondente pode fornecer.

Importante

Os suplementos COM e VSTO não são suportados no novo Outlook no Windows que está atualmente em pré-visualização. Estes suplementos ainda são suportados no cliente de ambiente de trabalho clássico do Outlook no Windows. Para saber mais, consulte Desenvolver suplementos do Outlook para o novo Outlook no Windows.

Pode configurar o seu Suplemento do Office para que, quando o suplemento COM equivalente já estiver instalado no computador de um utilizador, o Office no Windows execute o suplemento COM em vez do Suplemento do Office. O suplemento COM chama-se "equivalente" porque o Office fará uma transição totalmente integrada entre o suplemento COM e o Suplemento do Office, de acordo com o qual está instalado no computador de um utilizador.

Importante

A funcionalidade de suplemento equivalente é suportada pela seguinte plataforma e aplicações. Os suplementos COM não podem ser instalados em nenhuma outra plataforma, por isso, nessas plataformas, o elemento de manifesto que é abordado mais adiante neste artigo, EquivalentAddins, é ignorado.

  • Excel, Word e PowerPoint no Windows (Versão 1904 ou posterior)
  • Outlook Clássico no Windows (Versão 2102 ou posterior) numa versão suportada do Exchange Server
    • Exchange Online
    • Atualização Cumulativa 10 ou posterior do Exchange 2019 (KB5003612)
    • Atualização Cumulativa 21 ou posterior do Exchange 2016 (KB5003611)

Especificar um suplemento COM equivalente

Obter o ProgId de um suplemento COM

Antes de poder especificar um suplemento COM equivalente, primeiro tem de identificar o respetivo ProgId. Para obter o ProgId de um suplemento COM:

  1. Abra o Editor de Registo do Windows no computador onde o suplemento COM está instalado.
  2. Aceda a HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\<aplicação> do Office\Suplementos ou HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\<aplicação> do Office\Suplementos, onde <a aplicação> do Office é o Excel, Outlook, PowerPoint ou Word. Por exemplo, HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\Excel\Addins.
  3. Copie o nome da chave de registo associada ao suplemento COM de que precisa. Tenha em atenção que os nomes são sensíveis às maiúsculas e minúsculas.

Configurar o manifesto

Importante

Aplica-se ao Excel, Outlook, PowerPoint e Word.

Para ativar a compatibilidade entre o suplemento do Office e o suplemento COM, identifique o suplemento COM equivalente no manifesto do seu Suplemento do Office. Em seguida, o Office no Windows utilizará o suplemento COM em vez do Suplemento do Office, se ambos estiverem instalados.

O exemplo seguinte mostra a parte do manifesto que especifica um suplemento COM como um suplemento equivalente. O valor do ProgId elemento identifica o suplemento COM e o elemento EquivalentAddins tem de ser posicionado imediatamente antes da etiqueta de fecho VersionOverrides .

<VersionOverrides>
  ...
  <EquivalentAddins>
    <EquivalentAddin>
      <ProgId>ContosoCOMAddin</ProgId>
      <Type>COM</Type>
    </EquivalentAddin>
  </EquivalentAddins>
</VersionOverrides>

Dica

Para obter informações sobre o suplemento COM e a compatibilidade xlL UDF, veja Tornar as suas funções personalizadas compatíveis com funções definidas pelo utilizador XLL. Não aplicável ao Outlook.

Configurar a definição da Política de Grupo

Importante

Aplica-se apenas ao Outlook.

Para declarar compatibilidade entre o suplemento Web do Outlook e o suplemento COM, identifique o suplemento COM equivalente nos suplementos Web Desativar Outlook cujo suplemento COM ou VSTO equivalente está instalado . Tem de ser configurado no computador do utilizador. Em seguida, o Outlook clássico no Windows utilizará o suplemento COM em vez do suplemento Web, se ambos estiverem instalados.

  1. Transfira a ferramenta Modelos Administrativos mais recente, prestando atenção às Instruções de Instalação da ferramenta.

  2. Abra o Editor de Política de Grupo Local (gpedit.msc).

  3. Navegue paraModelos Administrativos> de Configuração> do UtilizadorMicrosoft Outlook 2016>Diversos.

  4. Selecione a definição Desativar suplementos Web do Outlook cujo suplemento COM ou VSTO equivalente está instalado.

  5. Abra a ligação para editar a definição de política.

  6. Na caixa de diálogo, os suplementos Web do Outlook para desativar:

    1. Defina o Nome do valor como o Id encontrado no manifesto do suplemento Web. Importante: não adicione chavetas {} à volta da entrada.
    2. Defina Valor para o ProgId do suplemento COM equivalente.
    3. Selecione OK para colocar a atualização em vigor.

    A caixa de diálogo

Comportamento equivalente para utilizadores

Quando é especificado um suplemento COM equivalente, o Office no Windows não apresentará a interface de utilizador (IU) do suplemento do Office se o suplemento COM equivalente estiver instalado. O Office apenas oculta os botões do friso do Suplemento do Office e não impede a instalação. Por conseguinte, o seu Suplemento do Office continuará a aparecer nas seguintes localizações na IU.

  • Em Os meus suplementos.
  • Como entrada no gestor do friso (apenas no Excel, Word e PowerPoint).

Observação

Especificar um suplemento COM equivalente no manifesto não tem qualquer efeito noutras plataformas, como o Office na Web ou no Mac.

Os seguintes cenários descrevem o que acontece consoante a forma como o utilizador adquire o Suplemento do Office.

Aquisição do AppSource de um Suplemento do Office

Se um utilizador adquirir o Suplemento do Office a partir do AppSource e o suplemento COM equivalente já estiver instalado, o Office irá:

  1. Instale o Suplemento do Office.
  2. Oculte a IU do Suplemento do Office no friso.
  3. Apresentar uma chamada para o utilizador que aponta o botão do friso do suplemento COM.

Implementação centralizada do Suplemento do Office

Se um administrador implementar o Suplemento do Office no respetivo inquilino através da implementação centralizada e o suplemento COM equivalente já estiver instalado, o utilizador terá de reiniciar o Office antes de ver quaisquer alterações. Depois de o Office reiniciar, irá:

  1. Instale o Suplemento do Office.
  2. Oculte a IU do Suplemento do Office no friso.
  3. Apresentar uma chamada para o utilizador que aponta o botão do friso do suplemento COM.

Documento partilhado com o Suplemento do Office incorporado

Se um utilizador tiver o suplemento COM instalado e, em seguida, obtiver um documento partilhado com o Suplemento incorporado do Office, quando abrir o documento, o Office irá:

  1. Peça ao utilizador para confiar no Suplemento do Office.
  2. Se for fidedigno, o Suplemento do Office será instalado.
  3. Oculte a IU do Suplemento do Office no friso.

Outro comportamento do suplemento COM

Excel, PowerPoint, Word

Se um utilizador desinstalar o suplemento COM equivalente, o Office no Windows restaura a IU do Suplemento do Office.

Depois de especificar um suplemento COM equivalente para o seu Suplemento do Office, o Office deixa de processar as atualizações do seu Suplemento do Office. Para adquirir as atualizações mais recentes do Suplemento do Office, o utilizador tem primeiro de desinstalar o suplemento COM.

Outlook

O suplemento COM tem de estar ligado quando o Outlook é iniciado para que o suplemento Web correspondente seja desativado.

Se o suplemento COM for desligado durante uma sessão subsequente do Outlook, é provável que o suplemento Web permaneça desativado até que o Outlook seja reiniciado.

Confira também