Сравнение манифеста только надстройки с унифицированным манифестом для Microsoft 365

Эта статья предназначена для того, чтобы помочь читателям, знакомым с манифестом надстройки, понять унифицированный манифест путем сравнения этих двух. Читатели также должны увидеть надстройки Office с унифицированным манифестом для Microsoft 365.

Схемы и общие точки

Существует только одна схема для единого манифеста, в отличие от манифеста только надстройки, который содержит в общей сложности семь схем.

Концептуальное сопоставление унифицированных манифестов и манифестов только надстроек

В этом разделе описывается унифицированный манифест для читателей, знакомых только с манифестом надстройки. Некоторые моменты, которые следует учитывать:

• Унифицированный манифест имеет формат JSON.

• JSON не различает атрибут и значение элемента, как xml. Обычно JSON, сопоставляемый с XML-элементом, превращает значение элемента и каждый атрибут в дочернее свойство. В следующем примере показана разметка XML и ее эквивалент JSON.

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

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

• В манифесте надстройки есть много мест, где элемент с именем во множественном числе имеет дочерние элементы с единственной версией с тем же именем. Например, разметка для настройки настраиваемого меню включает <элемент Items> , который может иметь несколько дочерних <элементов Элемента> . Эквивалент JSON этих элементов во множественном числе — это свойство с массивом в качестве значения. Элементы массива являются анонимными объектами, а не свойствами с именами item или item1, item2 и т. д. Ниже приведен пример.

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

Структура верхнего уровня

Корневой уровень унифицированного манифеста, который примерно соответствует элементу <OfficeApp> в манифесте только надстройки, является анонимным объектом.

Дочерние элементы <OfficeApp> обычно делятся на две категории. Элемент <VersionOverrides> является одной категорией. Второй состоит из всех остальных дочерних элементов <OfficeApp>, которые в совокупности называются базовым манифестом. Таким образом, унифицированный манифест имеет аналогичное деление. Существует свойство верхнего уровня extensions, которое примерно соответствует по назначению и дочерним <свойствам элемента VersionOverrides> . Унифицированный манифест также имеет более 10 других свойств верхнего уровня, которые в совокупности служат тем же целям, что и базовый манифест только манифеста надстройки. Эти другие свойства можно рассматривать в совокупности как базовый манифест единого манифеста.

Базовый манифест

Свойства базового манифеста указывают характеристики надстройки, которые должен содержать любой тип расширения Microsoft 365. Это относится ко вкладкам и расширениям для сообщений Teams, а не только к надстройкам Office. К этим характеристикам относятся общедоступное имя и уникальный идентификатор. В следующей таблице показано сопоставление некоторых критически важных свойств верхнего уровня в унифицированном манифесте с XML-элементами в текущем манифесте, где принцип сопоставления является целью разметки.

Элементы <Hosts>, <Requirements> и <ExtendedOverrides> являются частью базового манифеста только в манифесте надстройки. Но понятия и цели, связанные с этими элементами, настраиваются в свойстве extensions унифицированного манифеста.

Свойство extensions

Свойство extensions в унифицированном манифесте в основном представляет характеристики надстройки, которые не будут иметь отношения к другим типам расширений Microsoft 365. Например, приложения Office, которые расширяет надстройка (например, Excel, PowerPoint, Word и Outlook), указываются в свойстве extensions, как и настройки ленты приложения Office. Назначение конфигурации свойства extensions точно совпадает с целями <элемента VersionOverrides> в манифесте только надстройки.

В следующей таблице показано сопоставление некоторых высокоуровневых дочерних свойств свойства extensions в унифицированном манифесте с XML-элементами в текущем манифесте. Точечная нотация используется для ссылки на дочерние свойства.

Таблица "ribbons"

В следующей таблице дочерние свойства анонимных дочерних объектов в массиве "ribbons" сопоставлены с XML-элементами текущего манифеста.

Полный пример унифицированного манифеста см. в разделе Пример унифицированного манифеста.

Дальнейшие действия

• Создание первой надстройки Outlook