Compartilhar via

Gerir um manifesto unificado e uma versão de manifesto XML do seu Suplemento do Office

  • Artigo

A Microsoft está fazendo várias melhorias na plataforma de desenvolvedor do Microsoft 365. Estas melhorias proporcionam mais consistência no desenvolvimento, implementação, instalação e administração de todos os tipos de extensões do Microsoft 365, incluindo Suplementos do Office.

Uma melhoria importante em que estamos a trabalhar é a capacidade de criar uma única unidade de distribuição para todas as extensões do Microsoft 365 através do mesmo formato de manifesto: o manifesto unificado formatado em JSON para o Microsoft 365.

Dica

Para obter informações sobre como converter um suplemento existente para utilizar o manifesto unificado, consulte Converter um suplemento para utilizar o manifesto unificado do Microsoft 365.

Depois de criar uma versão do seu suplemento que utiliza o manifesto unificado, tem de ligar o suplemento existente e a aplicação criada com o manifesto unificado para garantir que os utilizadores não veem duas cópias da IU do suplemento no Outlook.

Observação

A configuração descrita abaixo não entrará em vigor até 24 horas após a instalação da nova versão no computador de um utilizador. Durante esse período, a IU de ambas as versões está visível. Por exemplo, se ambas as versões tiverem um botão do friso personalizado, ambos os botões serão apresentados no friso.

Utilize os seguintes passos.

  1. Abra o objeto de extensão na matriz "extensões".

  2. Crie uma propriedade de matriz "alternativas", se ainda não existir uma.

  3. Na matriz "alternativas", crie um objeto "alternativo" que tenha uma propriedade "ocultar".

  4. Se o suplemento existente for comercializado através do AppSource, atribua ao objeto "ocultar" uma propriedade "storeOfficeAddin". Caso contrário, avance para o passo 6.

  5. Atribua ao objeto "storeOfficeAddin" duas propriedades:

    • Um "officeAddinId" com o GUID do suplemento antigo como valor.
    • Um "assetId" com o ID do recurso do AppSource como o respetivo valor.

    O que se segue é um exemplo:

    "extensions": [
    ...
    {
        ...
        "alternates": [
            ...
            {
                ...
                "hide": {
                    "storeOfficeAddin": {
                        "officeAddinId": "b5a2794d-4aa5-4023-a84b-c60a3cbd33d4",
                        "assetId": "WA999999999"
                    }
                }
            }
        ]
    }
]

    Observação

    • O ID do recurso do suplemento no manifesto unificado tem de corresponder a um suplemento existente que tenha sido publicado pela sua conta de vendedor no Centro de Parceiros. Se o ID do recurso do suplemento que ligou no manifesto unificado não corresponder a uma oferta existente publicada pela sua conta de vendedor, a submissão do manifesto unificado falhará. Terá de atualizar o manifesto para utilizar o ID de recurso do suplemento correto e submeter novamente o manifesto unificado.
    • Um suplemento existente só pode ser ocultado por um único manifesto unificado. Neste momento, não pode utilizar vários manifestos unificados para ocultar o mesmo suplemento. Se tentar ocultar um suplemento já ligado com um manifesto unificado diferente, a submissão falhará. Terá de remover a ligação e submeter novamente o manifesto unificado.

  6. Se o suplemento antigo não for distribuído através do AppSource, atribua ao objeto "ocultar" uma propriedade "customOfficeAddin".

  7. Atribua ao objeto "customOfficeAddin" uma propriedade "officeAddinId" com o GUID do suplemento antigo como o respetivo valor. Apresentamos um exemplo a seguir.

    "extensions": [
    ...
    {
        ...
        "alternates": [
            ...
            {
                ...
                "hide": {
                    "customOfficeAddin": {
                        "officeAddinId": "b5a2794d-4aa5-4023-a84b-c60a3cbd33d4"
                    }
                }
            }
        ]
    }
]

Não remova o suplemento existente do AppSource ou do Centro de Administração do Microsoft 365 ou as versões anteriores do Office deixarão de poder utilizar o seu suplemento.

Manter ambas as versões para o futuro imediato

Geralmente, os suplementos que utilizam o manifesto unificado só podem ser instalados no Microsoft 365 Versão 2307 (Compilação 16626.20132) e posterior. No entanto, existem duas exceções que permitem que estes suplementos sejam instalados em versões mais antigas do Microsoft 365 e em versões de licença perpétua do Office.

  • O administrador do Microsoft 365 do utilizador implementa o suplemento para todos os utilizadores.
  • O utilizador instala o suplemento noutra aplicação cliente do Microsoft 365 com a versão 2307 (Compilação 16626.20132) e posterior. Isto disponibiliza o suplemento noutros clientes do Office do mesmo utilizador, incluindo licenças mais antigas ou perpétuas.

Se tiver utilizadores em versões de licenças mais antigas ou perpétuas para as quais estas exceções não se aplicam, terá de manter ambas as versões do suplemento. Quando todos os seus utilizadores estiverem a trabalhar com versões do Office que suportam o manifesto unificado, pode remover a versão XML da implementação.

Existem também alguns cenários em que poderá querer manter ambas as versões do suplemento durante um período prolongado. Por exemplo, existem duas funcionalidades de suplementos que não são suportadas com o manifesto unificado porque são pouco utilizados ou preteridos. Pode optar por manter uma versão do seu suplemento que utilize estas funcionalidades. Seguem-se as funcionalidades que não são suportadas no manifesto unificado.

O requisito crítico para disponibilizar duas versões é garantir que as duas aparecem distintas na IU do Outlook.

  • Atribua um nome diferente à nova versão do suplemento existente.
  • Crie e utilize ícones diferentes para a nova versão.
  • Certifique-se de que a propriedade "id" do manifesto unificado na nova versão é um GUID diferente do <elemento ID> no manifesto XML do suplemento existente.

Observação

Se utilizar o mesmo nome e ícone, as soluções antigas e novas aparecem indistinguíveis na IU do Outlook para instalação de suplementos.