Partilhar via

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

  • Artigo

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