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.

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.

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

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>

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

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.

   

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).

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

• Tornar as Suas Funções Personalizadas compatíveis com as Funções Definidas pelo Utilizador XLL