Vergleichen Des reinen Add-In-Manifests mit dem einheitlichen Manifest für Microsoft 365

Dieser Artikel soll Lesern, die nur mit dem Add-In-Manifest vertraut sind, helfen, das einheitliche Manifest zu verstehen, indem die beiden verglichen werden. Leser sollten auch Office-Add-Ins mit dem einheitlichen Manifest für Microsoft 365 sehen.

Schemas und allgemeine Punkte

Es gibt nur ein Schema für das einheitliche Manifest, im Gegensatz zum reinen Add-In-Manifest, das insgesamt sieben Schemas aufweist.

Konzeptionelle Zuordnung der einheitlichen Manifeste und nur Add-In-Manifeste

In diesem Abschnitt wird das einheitliche Manifest für Leser beschrieben, die mit dem reinen Add-In-Manifest vertraut sind. Einige Punkte, die Sie beachten sollten:

• Das einheitliche Manifest ist JSON-formatiert.

• JSON unterscheidet nicht wie XML zwischen Attribut- und Elementwert. In der Regel macht der JSON-Code, der einem XML-Element zugeordnet ist, sowohl den Elementwert als auch jedes der Attribute zu einer untergeordneten Eigenschaft. Das folgende Beispiel zeigt ein XML-Markup und sein JSON-Äquivalent.

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

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

• Es gibt viele Stellen im reinen Add-In-Manifest, an denen ein Element mit einem Pluralnamen über untergeordnete Elemente mit der Singularversion desselben Namens verfügt. Beispielsweise enthält das Markup zum Konfigurieren eines benutzerdefinierten Menüs ein <Items-Element> , das mehrere <untergeordnete Elemente des Elementelements> aufweisen kann. Das JSON-Äquivalent dieser Pluralelemente ist eine Eigenschaft mit einer Matrix als Wert. Die Elemente des Arrays sind anonyme Objekte, keine Eigenschaften mit dem Namen "Element" oder "Element1", "Element2" usw. Im Folgenden sehen Sie ein Beispiel.

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

Struktur der obersten Ebene

Die Stammebene des einheitlichen Manifests, das ungefähr dem <OfficeApp-Element> im reinen Add-In-Manifest entspricht, ist ein anonymes Objekt.

Die untergeordneten Elemente von <OfficeApp> sind häufig in zwei fiktive Kategorien unterteilt. Das <VersionOverrides-Element> ist eine Kategorie. Das andere besteht aus allen anderen untergeordneten Elementen von <OfficeApp>, die zusammen als Basismanifest bezeichnet werden. Auch das einheitliche Manifest weist eine ähnliche Unterteilung auf. Es gibt eine "extensions"-Eigenschaft der obersten Ebene, die in ihren Zwecken und untergeordneten Eigenschaften ungefähr dem <VersionOverrides-Element> entspricht. Das einheitliche Manifest verfügt auch über mehr als 10 weitere Eigenschaften der obersten Ebene, die zusammen die gleichen Zwecke wie das Basismanifest des reinen Add-In-Manifests erfüllen. Diese anderen Eigenschaften können zusammen als Basismanifest des einheitlichen Manifests betrachtet werden.

Basismanifest

Die Basismanifesteigenschaften geben Merkmale des Add-Ins an, die jede Art von Erweiterung von Microsoft 365 aufweisen soll. Dazu gehören Teams-Registerkarten und Nachrichtenerweiterungen, nicht nur Office-Add-Ins. Zu diesen Merkmalen gehören ein öffentlicher Name und eine eindeutige ID. Die folgende Tabelle zeigt eine Zuordnung einiger kritischer Eigenschaften der obersten Ebene im einheitlichen Manifest zu den XML-Elementen im aktuellen Manifest, wobei das Zuordnungsprinzip der Zweck des Markups ist.

Die <Elemente Hosts>, <Requirements> und <ExtendedOverrides> sind Teil des Basismanifests im reinen Add-In-Manifest. Konzepte und Zwecke, die diesen Elementen zugeordnet sind, werden jedoch in der Eigenschaft "extensions" des einheitlichen Manifests konfiguriert.

Eigenschaft "extensions"

Die Eigenschaft "extensions" im einheitlichen Manifest stellt in erster Linie Merkmale des Add-Ins dar, die für andere Arten von Microsoft 365-Erweiterungen nicht relevant wären. Beispielsweise werden die Office-Anwendungen, die das Add-In erweitert (z. B. Excel, PowerPoint, Word und Outlook), in der Eigenschaft "extensions" angegeben, ebenso wie Anpassungen des Menübands der Office-Anwendung. Die Konfigurationszwecke der Eigenschaft "extensions" stimmen genau mit denen des <VersionOverrides-Elements> im reinen Add-In-Manifest überein.

Die folgende Tabelle zeigt eine Zuordnung einiger übergeordneter untergeordneter Eigenschaften der Eigenschaft "extensions" im einheitlichen Manifest zu XML-Elementen im aktuellen Manifest. Punktnotation wird verwendet, um auf untergeordnete Eigenschaften zu verweisen.

Tabelle "Menübänder"

In der folgenden Tabelle werden die untergeordneten Eigenschaften der anonymen untergeordneten Objekte in der Matrix "Menübänder" den XML-Elementen im aktuellen Manifest zugeordnet.

Ein vollständiges Beispiel für ein einheitliches Manifest finden Sie unter Beispiel für ein einheitliches Manifest.

Nächste Schritte

• Erstellen des ersten Outlook-Add-Ins