VersionOverrides 1.1-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.1

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

Diesen Anforderungssätzen zugeordnet:

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

Untergeordnete Elemente

Die folgende Tabelle gilt nur für Version 1.1 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.
EquivalentAddins Nein Gibt die nativen (COM/XLL)-Add-Ins an, die dem Web-Add-In entsprechen. Das Web-Add-In wird nicht aktiviert, wenn ein entsprechendes natives Add-In installiert ist.
<VersionOverrides> Nein In VersionOverrides 1.1 kann derzeit nicht für Mail-Add-Ins verwendet werden.
WebApplicationInfo Nein Gibt Details zur Registrierung des Add-Ins bei Ausstellern sicherer Token an, z. B. Azure Active Directory V2.0.
ExtendedPermissions Nein Gibt eine Auflistung erweiterter Berechtigungen an.

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.

Im Folgenden finden Sie ein Beispiel für ein typisches <VersionOverrides-Element> , einschließlich einiger untergeordneter Elemente, die nicht erforderlich sind, aber in der Regel verwendet werden.

<OfficeApp ... xsi:type="MailApp">
...
  <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>
...
</OfficeApp>

Implementieren mehrerer Versionen

Ein Manifest kann mehrere Versionen des VersionOverrides-Elements implementieren, das unterschiedliche Versionen des VersionOverrides-Schemas unterstützt. Auf diese Weise können neue Features in einem neueren Schema unterstützt werden, während gleichzeitig ältere Clients unterstützt werden, 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 Element VersionOverrides 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>