VersionOverrides 1.0-Element in der Manifestdatei für ein Mail-Add-In

Dieses Element enthält Informationen zu Features, die im Basismanifest nicht unterstützt werden.

Hinweis

In diesem Artikel wird davon ausgegangen, dass Sie mit der Übersicht über das VersionOverrides-Element vertraut sind, das wichtige Informationen zu den Attributen und Variationen des Elements enthält.

Add-In-Typ: Mail

Nur in den folgenden VersionOverrides-Schemas gültig:

• Mail 1.0

Weitere Informationen finden Sie unter Versionsüberschreibungen im reinen Add-In-Manifest.

Diesen Anforderungssätzen zugeordnet:

• Mailbox 1.3
• Einige untergeordnete Elemente können zusätzlichen Anforderungssätzen zugeordnet sein.

Untergeordnete Elemente

Die folgende Tabelle gilt nur für Version 1.0 von <VersionOverrides-Elementen> und nur für Mail-Add-Ins.

Hinweis

In iOS wird nur <WebApplicationInfo> unterstützt. Alle anderen untergeordneten Elemente von <VersionOverrides> werden ignoriert.

Element	Erforderlich	Beschreibung
Beschreibung	Nein	Beschreibt das Add-In.
Anforderungen	Nein	Gibt die Mindestanforderungssätze an, die unterstützt werden müssen, damit das Markup im übergeordneten <VersionOverrides> wirksam wird. Dies sollte immer restriktiver sein als das <Requirements-Element> im Basisteil des Manifests.
Hosts	Ja	Gibt eine Auflistung von Office-Anwendungen an. Das untergeordnete <Hosts-Element> überschreibt das <Hosts-Element> im übergeordneten Teil des Manifests.
Ressourcen	Ja	Definiert eine Auflistung von Ressourcen (Zeichenfolgen, URLs und Bilder), auf die von anderen Elementen des Manifests verwiesen wird.
<VersionOverrides>	Nein	Definiert Add-In-Befehle unter einer neueren Schemaversion. Einzelheiten finden Sie unter Implementieren mehrerer Versionen.
WebApplicationInfo	Nein	Gibt Details zur Registrierung des Add-Ins bei Ausstellern sicherer Token an, z. B. Azure Active Directory V2.0.

Beschreibung

Beschreibt das Add-In. Dadurch wird das <Description-Element> in jedem übergeordneten Teil des Manifests überschrieben. Der Text der Beschreibung ist in einem untergeordneten Element des LongString-Elements enthalten, das im Resources-Element enthalten ist. Das resid Attribut des <Description-Elements> darf nicht mehr als 32 Zeichen lang sein und muss mit dem Wert des id Attributs eines untergeordneten Elements des <ShortString-Elements> übereinstimmen, das im Resources-Element enthalten ist.

Add-In-Typ: Aufgabenbereich, E-Mail

Nur in den folgenden VersionOverrides-Schemas gültig:

• Aufgabenbereich 1.0
• Mail 1.0
• Mail 1.1

Weitere Informationen finden Sie unter Versionsüberschreibungen im reinen Add-In-Manifest.

Diesen Anforderungssätzen zugeordnet:

• AddinCommands 1.1 , wenn der übergeordnete <VersionOverrides-Typ> Taskpane 1.0 ist.
• Postfach 1.3 , wenn die übergeordnete <VersionOverrides> den Typ Mail 1.0 hat.
• Postfach 1.5 , wenn die übergeordnete <VersionOverrides> den Typ Mail 1.1 hat.

Beispiel

Nachfolgend sehen Sie ein einfaches Beispiel. Komplexere Beispiele finden Sie in den Manifesten für die Beispiel-Add-Ins in Den Office-Add-In-Codebeispielen.

<OfficeApp ... xsi:type="MailApp">
...
  <VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides" xsi:type="VersionOverridesV1_0">
    <Description resid="residDescription" />
    <Requirements>
      <!-- add information on requirements -->
    </Requirements>
    <Hosts>
      <Host xsi:type="MailHost">
        <!-- add information on form factors -->
      </Host>
    </Hosts>
    <Resources>
      <!-- add information on resources -->
    </Resources>
  </VersionOverrides>
...
</OfficeApp>

Implementieren mehrerer Versionen

Ein Manifest kann mehrere Versionen des <VersionOverrides-Elements> implementieren, die verschiedene Versionen des VersionOverrides-Schemas unterstützen. Dies kann erfolgen, um optional neue Features in einem neueren Schema zu unterstützen und gleichzeitig ältere Clients zu unterstützen, die die neuen Features nicht unterstützen.

Um mehrere Versionen zu implementieren, muss das <VersionOverrides-Element> für die neuere Version ein untergeordnetes Element des VersionOverrides Elements für die ältere Version sein. Das untergeordnete <VersionOverrides-Element erbt> keine Werte vom übergeordneten Element.

Um sowohl das VersionOverrides v1.0- als auch das v1.1-Schema zu implementieren, würde das Manifest ähnlich wie im folgenden Beispiel aussehen.

<OfficeApp ... xsi:type="MailApp">
...
  <VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides" xsi:type="VersionOverridesV1_0">
    <Description resid="residDescription" />
    <Requirements>
      <!-- add information on requirements -->
    </Requirements>
    <Hosts>
      <Host xsi:type="MailHost">
        <!-- add information on form factors -->
      </Host>
    </Hosts>
    <Resources>
      <!-- add information on resources -->
    </Resources>

    <VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides/1.1" xsi:type="VersionOverridesV1_1">
      <Description resid="residDescription" />
      <Requirements>
        <!-- add information on requirements -->
      </Requirements>
      <Hosts>
        <Host xsi:type="MailHost">
          <!-- add information on form factors -->
        </Host>
      </Hosts>
      <Resources>
        <!-- add information on resources -->
      </Resources>
    </VersionOverrides>  
  </VersionOverrides>
...
</OfficeApp>