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

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.

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.

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.

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.

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.

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

Próximas etapas

• Criar seu primeiro suplemento do Outlook