Compartilhar via

Tornar o seu Suplemento do Office compatível com um suplemento COM ou VSTO existente

Se tiver um suplemento COM ou suplemento VSTO existente, pode criar funcionalidades quase equivalentes no seu Suplemento Web do Office, permitindo assim que a sua solução seja executada noutras plataformas, como no Office na Web ou no Mac. Neste cenário, os dois suplementos são denominados "equivalentes" e pode utilizar o manifesto do Suplemento Web do Office para controlar que suplemento está disponível para os utilizadores em computadores Windows (ou dar aos utilizadores a escolha).

Observação

Uma vez que os suplementos COM e VSTO só podem ser instalados no Windows, este artigo refere-se aos suplementos COM e VSTO coletivamente como suplementos "apenas para Windows".

Regra geral, os suplementos devem ser tratados como equivalentes apenas quando as seguintes condições forem cumpridas, mas podem existir cenários excecionais em que os suplementos não cumprem estas condições podem ser tratados como equivalentes.

  • Ambos são criados pelo mesmo programador, normalmente a entidade especificada na "developer" propriedade do manifesto unificado ou o elemento ProviderName no manifesto apenas do suplemento.
  • Ambos foram concebidos para serem instalados na mesma aplicação ou aplicações do Office e abordam a mesma carga de trabalho com funcionalidades principalmente sobrepostas.
  • Têm nomes públicos idênticos ou altamente semelhantes e interfaces de utilizador, incluindo nomes de controlo e ícones.

Importante

A funcionalidade de suplemento equivalente é suportada pela seguinte plataforma e aplicações. Os suplementos COM, VSTO e XLL não podem ser instalados em nenhuma outra plataforma, por isso, nessas plataformas, a marcação de manifesto que é abordada mais à frente neste artigo é ignorada.

  • 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
    • Exchange Server Subscription Edition (SE)
    • Atualização Cumulativa 10 ou posterior do Exchange 2019 (KB5003612)
    • Atualização Cumulativa 21 ou posterior do Exchange 2016 (KB5003611)

Importante

Os suplementos COM e VSTO não são suportados no novo Outlook no Windows. 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.

Uma vez que o suplemento apenas para Windows e o Suplemento do Office podem não ter exatamente as mesmas funcionalidades, existem três cenários que tem de considerar.

Obter o nome do suplemento apenas para Windows

Antes de poder configurar o manifesto do Suplemento do Office, primeiro tem de identificar o nome do suplemento apenas para Windows no Registo do Windows com estes passos:

  1. Abra o Editor de Registo do Windows em qualquer computador onde o suplemento apenas para Windows esteja 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, em que <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 apenas para Windows de que precisa. Tenha em atenção que os nomes são sensíveis às maiúsculas e minúsculas.

Ocultar o Suplemento do Office

Pode configurar o seu Suplemento do Office para que, quando o suplemento equivalente apenas para Windows já estiver instalado no computador de um utilizador, o Office no Windows execute o suplemento apenas para Windows em vez do Suplemento do Office. Se o suplemento apenas para Windows for desinstalado, o Office ativará automaticamente o Suplemento do Office da próxima vez que a aplicação anfitriã do Office for iniciada. Se o suplemento apenas para Windows estiver instalado após o Suplemento do Office, quando a aplicação do Office for reiniciada, o Suplemento do Office será ocultado. Para obter mais informações, consulte Comportamento dos utilizadores quando o Suplemento do Office está oculto.

Configurar o manifesto

Importante

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

Para ativar a compatibilidade entre o seu Suplemento do Office e o suplemento apenas para Windows, identifique o suplemento apenas windows equivalente no manifesto do seu Suplemento do Office com o nome que obteve na secção Obter o nome do suplemento apenas para Windows. Em seguida, o Office no Windows utilizará o suplemento apenas para Windows em vez do Suplemento do Office, se ambos estiverem instalados. A configuração depende do tipo de manifesto que está a ser utilizado.

O exemplo seguinte mostra a parte do manifesto que especifica um suplemento apenas para Windows como um suplemento equivalente. O valor da "alternates.prefer.comAddin.progId" propriedade identifica o suplemento apenas para Windows.

Observação

Embora a propriedade seja denominada "comAddin", na verdade refere-se a qualquer suplemento apenas para Windows, independentemente de o suplemento ser COM ou VSTO. Da mesma forma, o termo "progId" está normalmente associado apenas a suplementos COM, mas no manifesto refere-se ao nome do suplemento apenas para Windows.

"extensions" [
  ...
  "alternates" [
    {
      "prefer": {
        "comAddin": {
          "progId": "ContosoAddin"
        }
      }
    }
  ]
]

Dica

Se não conseguir especificar a alternates.prefer propriedade no manifesto do seu suplemento Web do Outlook, tem de configurar Política de Grupo. Isto aplica-se apenas ao Outlook. Para obter orientações, consulte Configurar a definição de Política de Grupo para suplementos do Outlook.

Dica

Configurar a definição de Política de Grupo para suplementos do Outlook

Um utilizador com poderes de administrador no respetivo computador pode configurar um suplemento apenas para Windows para ser o equivalente a um suplemento do Outlook ao utilizar os suplementos Web Desativar o Outlook cujo suplemento COM ou VSTO equivalente está instalado Política de Grupo definição no computador. Isto pode ser conseguido mesmo quando o manifesto do suplemento do Outlook não tem a marcação de suplemento equivalente. Em seguida, o Outlook clássico no Windows utiliza o suplemento apenas para Windows em vez do suplemento do Outlook, se ambos estiverem instalados. Seguem-se os passos para configurar a política.

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

  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 para o ID do manifesto do suplemento do Outlook. No manifesto apenas do suplemento, utilize o valor do <ID> elemento . No manifesto unificado, utilize o valor da id propriedade na raiz do manifesto. Não adicione chavetas {} à volta da entrada.
    2. Defina Valor para o nome do suplemento equivalente apenas para Windows. Consulte a secção Obter o nome do suplemento apenas para Windows.
    3. Selecione OK para colocar a atualização em vigor.

    A caixa de diálogo

Comportamento dos utilizadores quando o Suplemento do Office está oculto

Quando é especificado um suplemento equivalente apenas para Windows, o Office no Windows não apresentará a interface de utilizador (IU) do suplemento do Office se o suplemento equivalente apenas para Windows estiver instalado. No entanto, 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 no PowerPoint).

Observação

Especificar um suplemento equivalente apenas para Windows no manifesto não tem qualquer efeito noutras plataformas, como Office na Web ou mac.

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

Aquisição do Microsoft Marketplace do Suplemento do Office

Se um utilizador adquirir o Suplemento do Office a partir do Microsoft Marketplace e o suplemento equivalente apenas para Windows 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 apenas para Windows.

Implementação centralizada do Suplemento do Office

Se um administrador implementar o Suplemento do Office no respetivo inquilino através de uma implementação centralizada e o suplemento equivalente apenas para Windows 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 apenas para Windows.

Documento partilhado com o Suplemento do Office incorporado

Se um utilizador tiver o suplemento apenas para Windows instalado e, em seguida, obtiver um documento partilhado com o Suplemento do Office incorporado, 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 apenas para Windows

Excel, PowerPoint, Word

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

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

Outlook

O suplemento apenas para Windows tem de estar ligado quando o Outlook é iniciado para que o suplemento do Outlook correspondente seja desativado.

Se o suplemento apenas para Windows for desligado durante uma sessão subsequente do Outlook, o suplemento do Outlook provavelmente permanecerá desativado até que o Outlook seja reiniciado.

Ocultar o suplemento apenas para Windows

Observação

A opção descrita nesta secção tem as seguintes limitações.

  • Só é suportado para o Excel, PowerPoint e Word.
  • A versão mínima do Office que suporta a funcionalidade é a subscrição do Office na Versão 2506 do Windows (Compilação 19029.20004).

Configurar o manifesto

Os detalhes para configurar esta funcionalidade dependem do tipo de manifesto que está a ser utilizado pelo Suplemento do Office.

Para desativar o suplemento apenas para Windows, siga os seguintes passos.

  1. Se ainda não existir, crie uma "extensions.alternates.hide.windowsExtensions" propriedade.
  2. Adicione uma propriedade subordinada effect à propriedade e defina o windowsExtensions respetivo valor para disableWithNotification.
  3. Adicione uma propriedade subordinada "comAddin" à windowsExtensions propriedade .
  4. Adicione uma propriedade de matriz subordinada progIds à comAddin propriedade .
  5. Adicione os nomes de todos os suplementos apenas do Windows que pretende ocultar à progIds matriz. Para obter informações sobre como obter estes nomes, consulte Obter o nome do suplemento apenas para Windows.

Observação

A cadeia "com" está no nome comAddin por razões históricas. No manifesto, a propriedade refere-se aos suplementos COM ou VSTO. Da mesma forma, o termo "progIds" está normalmente associado apenas a suplementos COM, mas os nomes dos suplementos VSTO também podem ser incluídos na progIds matriz.

O exemplo seguinte mostra o aspeto que o JSON deve ter.

"extensions" [
  {   
    ...
    "alternates": [
      {
        "hide": {
          "windowsExtensions": {
            "effect": "disableWithNotification",
            "comAddin": {
              "progIds": [
                "ContosoAddin"
              ]
            }
          }
        }
      }
    ]
  }
]

Comportamento dos utilizadores quando o suplemento apenas para Windows está oculto

Quando um suplemento apenas para Windows está oculto, o Office no Windows não apresentará a respetiva interface de utilizador (IU) se o Suplemento do Office equivalente estiver instalado. Uma caixa de diálogo de pop-up notifica o utilizador de que isto está a acontecer. No entanto, o Office apenas oculta o suplemento apenas para Windows e não impede a instalação.

Dar ao utilizador a escolha do suplemento a utilizar

Observação

A opção descrita nesta secção tem as seguintes limitações.

  • Só é suportado para o Excel, PowerPoint e Word.
  • A versão mínima do Office que suporta a funcionalidade é a subscrição do Office na Versão 2506 do Windows (Compilação 19029.20004).

Configurar o manifesto

Os detalhes para configurar esta funcionalidade dependem do tipo de manifesto que está a ser utilizado pelo Suplemento do Office.

Para dar ao utilizador uma escolha do suplemento a ocultar, siga os seguintes passos.

  1. Se ainda não existir, crie uma "extensions.alternates.hide.windowsExtensions" propriedade.
  2. Adicione uma propriedade subordinada effect à propriedade e defina o windowsExtensions respetivo valor como userOptionToDisable.
  3. Adicione uma propriedade subordinada "comAddin" à windowsExtensions propriedade .
  4. Adicione uma propriedade de matriz subordinada progIds à comAddin propriedade .
  5. Adicione os nomes de todos os suplementos equivalentes apenas do Windows à progIds matriz. Para obter informações sobre como obter estes nomes, consulte Obter o nome do suplemento apenas para Windows.

Observação

A cadeia "com" está no nome comAddin por razões históricas. No manifesto, a propriedade refere-se aos suplementos COM ou VSTO. Da mesma forma, o termo "progIds" está normalmente associado apenas a suplementos COM, mas os nomes dos suplementos VSTO também podem ser incluídos na progIds matriz.

O exemplo seguinte mostra o aspeto que o JSON deve ter.

"extensions" [
  {   
    ...
    "alternates": [
      {
        "hide": {
          "windowsExtensions": {
            "effect": "userOptionToDisable",
            "comAddin": {
              "progIds": [
                "ContosoAddin"
              ]
            }
          }
        }
      }
    ]
  }
]

Comportamento dos utilizadores quando têm a escolha do suplemento que está oculto

Se configurar o manifesto para dar a escolha ao utilizador, o utilizador verá uma caixa de diálogo semelhante à seguinte quando instalar o Suplemento do Office. A ligação Saiba mais na caixa de diálogo aponta para a seguinte página de ajuda que fornece informações para ajudar o utilizador a tomar a decisão: Resolver conflitos de versões para Suplementos do Office.

Uma caixa de diálogo intitulada

Se o utilizador escolher Sim e o Office desativar e ocultar o suplemento apenas para Windows, é aberta uma caixa de diálogo semelhante à seguinte que aconselha o utilizador a reiniciar a aplicação do Office.

Uma caixa de diálogo intitulada

Se o utilizador escolher Sim , mas o Office não conseguir desativar o suplemento apenas para Windows por qualquer motivo, é aberta uma caixa de diálogo semelhante à seguinte, que aconselha o utilizador a desativar manualmente o suplemento apenas para Windows.

Uma caixa de diálogo intitulada

Confira também

  • Last updated on