Compare o manifesto somente do suplemento com o manifesto unificado do Microsoft 365

Este artigo destina-se a ajudar os leitores que estão familiarizados com o manifesto somente do suplemento a entender o manifesto unificado comparando os dois. Os leitores também devem ver os Suplementos do Office com o manifesto unificado para o Microsoft 365.

Esquemas e pontos gerais

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

Mapeamento conceitual dos manifestos unificado e somente suplemento

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

• O manifesto unificado é formatado em JSON.

• O JSON não distingue entre atributo e valor do elemento 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"
  }
  

• Há muitos lugares no manifesto exclusivo do suplemento em que um elemento com um nome plural tem filhos com a versão singular do mesmo nome. Por exemplo, a marcação para configurar um menu personalizado inclui um elemento <Items> que pode ter vários elementos filhos <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 raiz do manifesto unificado, que corresponde aproximadamente ao <OfficeApp> elemento no manifesto somente do suplemento, é um objeto anônimo.

Os filhos de <OfficeApp> são geralmente divididos em duas categorias nocionais. O elemento <VersionOverrides> é uma categoria. O outro consiste de todos os outros filhos de <OfficeApp>, que são coletivamente referidos como o manifesto base. Da mesma forma, o manifesto unificado tem uma divisão semelhante. Há uma propriedade de nível "extensions" superior que corresponde aproximadamente em suas finalidades e propriedades filho ao <VersionOverrides> elemento. O manifesto unificado também tem mais de 10 outras propriedades de nível superior que, coletivamente, servem às mesmas finalidades que o manifesto base do manifesto somente do suplemento. Essas outras propriedades podem ser pensadas coletivamente como o manifesto básico 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 a seguir 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 é a finalidade da marcação.

Os <Hosts>elementos , <Requirements>e <ExtendedOverrides> fazem parte do manifesto base no manifesto somente do suplemento. Mas os conceitos e propósitos associados a esses elementos são configurados dentro da propriedade do manifesto "extensions" unificado.

"extensions" de propriedade

A "extensions" propriedade 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, os aplicativos do Office que o suplemento estende (como Excel, PowerPoint, Word e Outlook) são especificados dentro da "extensions" propriedade, assim como as personalizações da faixa de opções de aplicativos do Office. As finalidades de configuração da "extensions" propriedade correspondem às do <VersionOverrides> elemento no manifesto somente do suplemento.

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

"ribbons" pontos de dados

A tabela a seguir mapeia as propriedades filho dos objetos filho anônimos na "ribbons" matriz para elementos XML no manifesto atual.

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

Próximas etapas

• Criar seu primeiro suplemento do Outlook