Share via

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

  • Artigo

Se você tiver um suplemento COM existente, poderá criar uma funcionalidade equivalente no Suplemento do Office, permitindo que sua solução seja executada em outras plataformas, como Office na Web ou Mac. Em alguns casos, o Suplemento do Office pode não ser capaz de fornecer toda a funcionalidade disponível no suplemento COM correspondente. Nessas situações, o suplemento COM pode fornecer uma melhor experiência do usuário no Windows do que o Suplemento do Office correspondente pode fornecer.

Importante

Suplementos COM e VSTO não têm suporte no novo Outlook no Windows que está atualmente em versão prévia. Esses suplementos ainda têm suporte no cliente clássico do Outlook na área de trabalho do Windows. Para saber mais, confira Desenvolver suplementos do Outlook para novo Outlook no Windows (versão prévia).

Você pode configurar o Suplemento do Office para que, quando o suplemento COM equivalente já estiver instalado no computador de um usuário, o Office no Windows execute o suplemento COM em vez do Suplemento do Office. O suplemento COM é chamado de "equivalente" porque o Office fará a transição entre o suplemento COM e o Suplemento do Office de acordo com o qual está instalado no computador de um usuário.

Importante

O recurso de suplemento equivalente é compatível com a plataforma e os aplicativos a seguir. Os suplementos COM não podem ser instalados em nenhuma outra plataforma, portanto, nessas plataformas, o elemento manifesto que é discutido posteriormente neste artigo, EquivalentAddinsé ignorado.

  • Excel, Word e PowerPoint no Windows (versão 1904 ou posterior)
  • Outlook no Windows (versão 2102 ou posterior) em uma versão com suporte do servidor exchange
    • 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

Manifesto

Importante

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

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

O exemplo a seguir 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 deve ser posicionado imediatamente antes da marca de fechamento 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 com o UDF XLL, consulte Tornar suas funções personalizadas compatíveis com funções definidas pelo usuário XLL. Não aplicável ao Outlook.

Política de grupo

Importante

Aplica-se apenas ao Outlook.

Para declarar compatibilidade entre o suplemento web do Outlook e o suplemento COM/VSTO, identifique o suplemento COM equivalente na política de grupo Desativar suplementos Web do Outlook cujo suplemento COM ou VSTO equivalente está instalado configurando-o no computador do usuário. Em seguida, o Outlook no Windows usará o suplemento COM em vez do suplemento da Web, se ambos estiverem instalados.

  1. Baixe a ferramenta Modelos Administrativos mais recentes, 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 atéModelos Administrativos> de Configuração> do UsuárioMicrosoft Outlook 2016>Miscellaneous.

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

  5. Abra o link para editar a configuração da política.

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

    1. Defina o nome valor como o Id encontrado no manifesto do suplemento da Web. Importante: não adicione chaves encaracoladas {} ao redor da entrada.
    2. Defina Valor como o ProgId do suplemento COM/VSTO equivalente.
    3. Selecione OK para colocar a atualização em vigor.

    A caixa de diálogo

Comportamento equivalente para usuários

Quando um suplemento COM equivalente for especificado, o Office no Windows não exibirá a interface do usuário (interface do usuário) do Seu Suplemento do Office se o suplemento COM equivalente estiver instalado. O Office oculta apenas os botões de faixa de opções do Suplemento do Office e não impede a instalação. Portanto, seu Suplemento do Office ainda aparecerá nos seguintes locais dentro da interface do usuário.

  • Em Meus suplementos.
  • Como uma entrada no gerenciador de faixas de opções (somente Excel, Word e PowerPoint).

Observação

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

Os cenários a seguir descrevem o que acontece dependendo de como o usuário adquire o Suplemento do Office.

Aquisição do AppSource de um Suplemento do Office

Se um usuário adquirir o Suplemento do Office do AppSource e o suplemento COM equivalente já estiver instalado, o Office terá:

  1. Instale o Suplemento do Office.
  2. Ocultar a interface do usuário do Suplemento do Office na faixa de opções.
  3. Exiba uma chamada para o usuário que aponta o botão de faixa de opções de suplemento COM.

Implantação centralizada do Suplemento do Office

Se um administrador implantar o Suplemento do Office em seu locatário usando a implantação centralizada e o suplemento COM equivalente já estiver instalado, o usuário deverá reiniciar o Office antes de ver qualquer alteração. Depois que o Office for reiniciado, ele será:

  1. Instale o Suplemento do Office.
  2. Ocultar a interface do usuário do Suplemento do Office na faixa de opções.
  3. Exiba uma chamada para o usuário que aponta o botão de faixa de opções de suplemento COM.

Documento compartilhado com suplemento do Office inserido

Se um usuário tiver o suplemento COM instalado e receber um documento compartilhado com o Suplemento do Office inserido, quando abrir o documento, o Office terá:

  1. Solicitar que o usuário confie no Suplemento do Office.
  2. Se for confiável, o Suplemento do Office será instalado.
  3. Ocultar a interface do usuário do Suplemento do Office na faixa de opções.

Outro comportamento de suplemento COM

Excel, PowerPoint, Word

Se um usuário desinstalar o suplemento COM equivalente, o Office no Windows restaurará a interface do usuário do Suplemento do Office.

Depois de especificar um suplemento COM equivalente para seu Suplemento do Office, o Office interrompe o processamento de atualizações para seu Suplemento do Office. Para adquirir as atualizações mais recentes para o Suplemento do Office, o usuário deve primeiro desinstalar o suplemento COM.

Outlook

O suplemento COM/VSTO deve estar conectado quando o Outlook for iniciado para que o suplemento web correspondente seja desabilitado.

Se o suplemento COM/VSTO for desconectado durante uma sessão subsequente do Outlook, o suplemento da Web provavelmente permanecerá desabilitado até que o Outlook seja reiniciado.

Confira também