Compartilhar via

Comparar o manifesto apenas do suplemento com o manifesto unificado do Microsoft 365

  • Artigo

Este artigo destina-se a ajudar os leitores que estão familiarizados com o manifesto apenas do suplemento a compreender o manifesto unificado ao comparar os dois. Os leitores também devem ver os Suplementos do Office com o manifesto unificado do Microsoft 365.

Observação

Atualmente, o manifesto unificado só suporta suplementos do Outlook e apenas no Office associados a uma subscrição do Microsoft 365 e instalados no Windows, num dispositivo móvel ou em Outlook na Web. Estamos a trabalhar para expandir o suporte para o Excel, PowerPoint e Word, bem como para o Outlook para Mac e para versões perpétuas do Office.

Esquemas e pontos gerais

Existe apenas um esquema para o manifesto unificado, em contraste com o manifesto apenas do suplemento que tem um total de sete esquemas.

Mapeamento conceptual dos manifestos unificados e apenas de suplementos

Esta secção descreve o manifesto unificado para leitores que estão familiarizados com o manifesto apenas do suplemento. Alguns pontos a serem considerados:

  • O manifesto unificado está formatado em JSON.

  • O JSON não distingue entre o atributo e o valor do elemento, tal como o XML. Normalmente, o JSON que mapeia para um elemento XML torna o valor do elemento e cada um dos atributos uma propriedade filho. O exemplo a seguir mostra algumas marcações XML e seu equivalente JSON.

    <MyThing color="blue">Some text</MyThing>

    "myThing" : {
    "color": "blue",
    "text": "Some text"
}

  • Existem muitos locais no manifesto apenas do suplemento onde um elemento com um nome plural tem subordinados com a versão singular do mesmo nome. Por exemplo, a margem de lucro para configurar um menu personalizado inclui um <elemento Items> que pode ter vários <elementos subordinados do elemento Item> . O equivalente JSON desses elementos plurais é uma propriedade que tem uma matriz como seu valor. Os membros da matriz são objetos anônimos, não propriedades chamadas "item" ou "item1", "item2", etc. O item a seguir é um exemplo.

    "items": [
    {
        -- markup for a menu item is here --
    },
    {
        -- markup for another menu item is here --
    }
]

Estrutura de nível superior

O nível de raiz do manifesto unificado, que corresponde aproximadamente ao <elemento OfficeApp> no manifesto apenas de suplemento, é um objeto anónimo.

Os subordinados do< OfficeApp> estão normalmente divididos em duas categorias noções. O <elemento VersionOverrides> é uma categoria. O outro consiste em todos os outros subordinados do <OfficeApp>, que são coletivamente referidos como o manifesto base. Também o manifesto unificado tem uma divisão semelhante. Existe uma propriedade de "extensões" de nível superior que corresponde aproximadamente às respetivas finalidades e propriedades subordinadas ao <elemento VersionOverrides> . O manifesto unificado também tem mais de 10 outras propriedades de nível superior que servem coletivamente as mesmas finalidades que o manifesto base do manifesto apenas de suplemento. Estas outras propriedades podem ser consideradas coletivamente como o manifesto base do manifesto unificado.

Manifesto base

As propriedades do manifesto base especificam características do suplemento que qualquer tipo de extensão do Microsoft 365 deve ter. Isso inclui guias do Teams e extensões de mensagem, não apenas suplementos do Office. Essas características incluem um nome público e uma ID exclusiva. A tabela seguinte mostra um mapeamento de algumas propriedades críticas de nível superior no manifesto unificado para os elementos XML no manifesto atual, em que o princípio de mapeamento é o objetivo da marcação.

Propriedade JSON Objetivo Elementos XML Comentários
"$schema" Identifica o esquema do manifesto. atributos de <OfficeApp> e <VersionOverrides> Nenhum
"id" GUID do suplemento. <Id> Nenhum
"versão" A versão do suplemento. <Versão> Nenhum
"manifestVersion" Versão do esquema do manifesto. atributos do <OfficeApp> Nenhum
"nome" O nome do suplemento. <DisplayName> Nenhum
"descrição" Descrição pública do suplemento. <Descrição> Nenhum
"accentColor" Nenhum Nenhum Esta propriedade não tem equivalente no manifesto apenas do suplemento e não é utilizada no manifesto unificado. Mas ela deve estar presente.
"developer" Identifica o desenvolvedor do suplemento. <ProviderName> Nenhum
"localizationInfo" Configura a localidade padrão e outras localidades com suporte. <DefaultLocale> e <Substituição> Nenhum
"webApplicationInfo" Identifica o aplicativo Web do suplemento como ele é conhecido no Azure Active Directory. <WebApplicationInfo> No manifesto apenas do suplemento, o <elemento WebApplicationInfo> está dentro <de VersionOverrides> e não do manifesto base.
"autorização" Identifica todas as permissões do Microsoft Graph que o suplemento precisa. <WebApplicationInfo> No manifesto apenas do suplemento, o <elemento WebApplicationInfo> está dentro <de VersionOverrides> e não do manifesto base.

Os <elementos Anfitriões>, <Requisitos> e <ExtendedOverrides> fazem parte do manifesto base no manifesto apenas do suplemento. No entanto, os conceitos e objetivos associados a estes elementos são configurados dentro da propriedade "extensões" do manifesto unificado.

Propriedade "extensões"

A propriedade "extensions" no manifesto unificado representa principalmente características do suplemento que não seriam relevantes para outros tipos de extensões do Microsoft 365. Por exemplo, as aplicações do Office que o suplemento expande (por exemplo, Excel, PowerPoint, Word e Outlook) são especificadas dentro da propriedade "extensões", tal como as personalizações do friso da aplicação do Office. As finalidades de configuração da propriedade "extensões" correspondem de perto às do <elemento VersionOverrides> no manifesto apenas do suplemento.

Observação

A <secção VersionOverrides> do manifesto apenas do suplemento tem um sistema de "duplo salto" para muitos recursos de cadeia. As cadeias, incluindo URLs, são especificadas e atribuídas um ID no <elemento subordinado Recursos> de <VersionOverrides>. Os elementos que requerem uma cadeia têm um resid atributo que corresponde ao ID de uma cadeia no <elemento Recursos> . A propriedade "extensions" do manifesto unificado simplifica as coisas ao definir cadeias diretamente como valores de propriedade. Não existe nada no manifesto unificado que seja equivalente ao <elemento Recursos> .

A tabela seguinte mostra um mapeamento de algumas propriedades subordinadas de alto nível da propriedade "extensões" no manifesto unificado para elementos XML no manifesto atual. A notação de ponto é usada para referenciar propriedades filho.

Observação

Esta tabela contém apenas algumas propriedades representativas descendentes selecionadas de "extensões". Não é uma lista exaustiva de todas as propriedades subordinadas de "extensões". Para obter a referência completa do manifesto unificado, veja Manifesto unificado do Microsoft 365. Para obter a referência de manifesto que inclui todas as funcionalidades de pré-visualização mais recentes, consulte Pré-visualização do programador público para o manifesto unificado do Microsoft 365.

Propriedade JSON Objetivo Elementos XML Comentários
"requirements.capabilities" Identifica os conjuntos de requisitos que o suplemento precisa de ser instalável. que o suplemento tem de ser instalável. <Requisitos e Conjuntos><> Nenhum
"requirements.scopes" Identifica os aplicativos do Office nos quais o suplemento pode ser instalado. <Hosts> Nenhum
"faixas de opções" As faixas de opções que o suplemento personaliza. <Anfitriões>, ExtensionPoints e várioselementos *FormFactor As propriedade "faixas de opções" é uma matriz de objetos anônimos que mesclam as finalidades desses três elementos. Consulte a tabela "faixas de opções".
"alternativas" Especifica a compatibilidade de versões anteriores com um suplemento COM equivalente, XLL ou ambos. <EquivalentAddins> Consulte EquivalentAddins - Consulte também para obter informações de segundo plano.
"runtimes" Configura os runtimes incorporados que o suplemento utiliza, incluindo vários tipos de suplementos que têm pouca ou nenhuma IU, como suplementos só de função personalizados e comandos de função. <Runtimes>. <FunctionFile> e <ExtensionPoint> (do tipo CustomFunctions) Nenhum
"autoRunEvents" Remove um manipulador de eventos de um evento especificado. <ExtensionPoint> (do tipo LaunchEvent) Nenhum

tabela "faixas de opções"

A tabela a seguir mapeia as propriedades filho dos objetos filho anônimos nas "faixas de opções" matriz em elementos XML no manifesto atual.

Propriedade JSON Objetivo Elementos XML Comentários
"contextos" Especifica as superfícies de comando que o suplemento personaliza. Vários elementos *CommandSurface , como PrimaryCommandSurface e MessageReadCommandSurface Nenhum.
"guias" Configura guias personalizadas da faixa de opções. <CustomTab> Os nomes e a hierarquia das propriedades descendentes de "separadores" correspondem de perto aos descendentes de <CustomTab>.
"fixedControls" (pré-visualização do programador) Configura e adiciona o botão de um suplemento integrado de relatórios de spam ao friso do Outlook. <Controlar> elemento subordinado de <ReportPhishingCustomization> Nenhum.
"spamPreProcessingDialog" (pré-visualização do programador) Configura a caixa de diálogo de pré-processamento apresentada após a seleção do botão de um suplemento de relatório de spam no friso do Outlook. <Elemento subordinado PreProcessingDialog> de <ReportPhishingCustomization> Nenhum.

Para obter um manifesto unificado de exemplo completo, veja Manifesto unificado de exemplo.

Próximas etapas