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

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

Hinweis

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

Add-In-Typ: Mail

Nur in diesen VersionOverrides-Schemas gültig:

  • Mail 1.1

Weitere Informationen finden Sie unter Versionsüberschreibungen im Nur-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 E-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 in der übergeordneten <VersionOverrides> wirksam wird. Dies sollte immer restriktiver sein als das<> Anforderungselement im Basisteil des Manifests.
Hosts Nein Gibt eine Sammlung von Office-Anwendungen an. Das untergeordnete Hosts-Element überschreibt das Hosts-Element im übergeordneten Teil des Manifests.
Ressourcen Nein Definiert eine Auflistung von Ressourcen (Zeichenfolgen, URLs und Bilder), auf die von anderen Elementen des Manifests verwiesen wird.
EquivalentAddins Nein Gibt die systemeigenen Add-Ins (COM/XLL) an, die dem Web-Add-In entsprechen. Das Web-Add-In wird nicht aktiviert, wenn ein entsprechendes natives Add-In installiert ist.
<VersionOverrides> Nein Derzeit nicht verwendbar in VersionOverrides 1.1 für E-Mail-Add-Ins.
WebApplicationInfo Nein Gibt Details über die Registrierung des Add-Ins bei sicheren Tokenausstellern wie Azure Active Directory V2.0 an.
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 länger als 32 Zeichen 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, Mail

Nur in diesen VersionOverrides-Schemas gültig:

  • Aufgabenbereich 1.0
  • Mail 1.0
  • Mail 1.1

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

Diesen Anforderungssätzen zugeordnet:

  • AddinCommands 1.1 , wenn die übergeordnete <VersionOverrides> vom Typ Taskbereich 1.0 ist.
  • Postfach 1.3 , wenn die übergeordnete <VersionOverrides> vom Typ Mail 1.0 ist.
  • Postfach 1.5 , wenn die übergeordnete <VersionOverrides> vom Typ Mail 1.1 ist.

Beispiel

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

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 das VersionOverrides-Schema v1.0 und v1.1 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>
  • Last updated on