Requirements-Element

Die Bedeutung dieses Elements hängt davon ab, ob es im Basismanifest, als untergeordnetes Element eines <VersionOverrides-Elements> oder als untergeordnetes Element des Override-Elements verwendet wird.

Im Basismanifest

Bei Verwendung im Basismanifest (d. h. als direktes untergeordnetes Element von OfficeApp) gibt das <Requirements-Element> den Mindestsatz an Office JavaScript-API-Anforderungen (Anforderungssätze und/oder Methoden), die Ihr Office-Add-In benötigt, um von Office aktiviert zu werden. Das Add-In wird nicht auf einer Kombination aus Office-Version und -Plattform (z. B. Windows, Mac, Web und iOS oder iPad) aktiviert, die die angegebenen Methoden und Anforderungssätze nicht unterstützt.

Add-In-Typ: Aufgabenbereich, Mail

Als untergeordnetes Element eines VersionOverrides-Elements

Gibt bei Verwendung als untergeordnetes Element von VersionOverride den Mindestsatz an Office JavaScript-API-Anforderungen (Anforderungssätze und/oder Methoden) an, die von der Office-Version und -Plattform (z. B. Windows, Mac, Web und iOS oder iPad) unterstützt werden müssen, damit die Einstellungen im VersionOverrides-Element>, die<die Einstellungen des Basismanifests außer Kraft setzen, wirksam werden.

Gehen Sie von einem Add-In aus, das Anforderung A im Basismanifest und Anforderung B innerhalb der <VersionOverrides> angibt.

• Wenn die Plattform und die Office-Version A nicht unterstützen, ist das Add-In nicht aktiviert, und Office analysiert den <VersionOverrides-Abschnitt> des Manifests nicht.
• Wenn sowohl A als auch B unterstützt werden, wird das Add-In aktiviert, und das gesamte Markup in den <VersionOverrides> wird wirksam.
• Wenn A unterstützt wird, B aber nicht, wird das Add-In aktiviert, und ein Teil des Markups in den <VersionOverrides> wird wirksam. Insbesondere werden untergeordnete Elemente der VersionOverrides>, die keine Elemente des< Basismanifests außer Kraft setzen, wirksam. Beispielsweise wird ein <WebApplicationInfo-Element> oder ein <EquivalentAddins> wirksam. Alle untergeordneten Elemente der <VersionOverrides> , die ein Basismanifestelement überschreiben, wie z. B <. Hosts>, werden jedoch nicht wirksam. Stattdessen verwendet Office die Werte des Basismanifestmarkups, das andernfalls außer Kraft gesetzt worden wäre.

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.

Hinweise

Das <Element "Anforderungen"> hat in einem <VersionOverrides> keinen Zweck, wenn es keine zusätzlichen Anforderungen angibt, die nicht in einer <Anforderung> im Basismanifest angegeben sind. Wenn die Office-Version und die Office-Plattform die Anforderungen im Basismanifest nicht unterstützen, wird das Add-In nicht aktiviert, und das <VersionOverrides-Element> wird nicht analysiert. Aus diesem Grund sollten Sie ein <Anforderungselement> in einem <VersionOverrides> nur verwenden, wenn beide dieser Bedingungen erfüllt sind:

• Ihr Add-In verfügt über zusätzliche Features, die mit der Konfiguration in einer <VersionOverrides> implementiert werden (z. B. Add-In-Befehle) und die eine Methode oder einen Anforderungssatz erfordern, der nicht in einem <Requirements-Element> im Basismanifest angegeben ist.
• Ihr Add-In ist nützlich und sollte aktiviert werden (allerdings ohne die zusätzlichen Features), auch in einer Kombination aus Plattform und Office-Version, die die Anforderungen für die zusätzlichen Features nicht unterstützt.

Als untergeordnetes Element des Override-Elements

Ein <Requirements-Element> kann ein untergeordnetes Element eines Override-Elements im Kontext eines übergeordneten ExtendedOverrides-Elements sein. Ein <Override-Element> drückt eine Bedingung aus und kann als "Wenn ... dann ..." zu verwenden. Wenn das <Override-Element> vom Typ RequirementTokenOverride ist (d. h. das xsi:type übergeordnete Token-Element ist RequirementsToken), dann drückt das untergeordnete <Requirements-Element> die Bedingung aus, und das Value Attribut ist die Folge. Die erste <Außerkraftsetzung> im Folgenden lautet beispielsweise "Wenn die aktuelle Plattform FeatureOne Version 1.7 unterstützt, verwenden Sie die Zeichenfolge 'oldAddinVersion' anstelle des ${token.requirements} Tokens in der URL des übergeordneten <ExtendedOverrides> (anstelle der Standardzeichenfolge 'upgrade')." Weitere Informationen finden Sie unter ExtendedOverrides.

<ExtendedOverrides Url="http://contoso.com/addinmetadata/${token.requirements}/extended-manifest-overrides.json">
    <Tokens>
        <Token Name="requirements" DefaultValue="upgrade" xsi:type="RequirementsToken">
            <Override Value="oldAddinVersion">
                <Requirements>
                    <Sets>
                        <Set Name="FeatureOne" MinVersion="1.7" />
                    </Sets>
                </Requirements>
            </Override>
            <Override Value="currentAddinVersion">
                <Requirements>
                    <Sets>
                        <Set Name="FeatureOne" MinVersion="1.8" />
                    </Sets>
                    <Methods>
                        <Method Name="MethodThree" />
                    </Methods>
                </Requirements>
            </Override>
        </Token>
    </Tokens>
</ExtendedOverrides>

Add-In-Typ: Aufgabenbereich

Syntax

<Requirements>
   ...
</Requirements>

Enthalten in

• OfficeApp
• VersionOverrides
• Override

Kann enthalten

>Das< Anforderungselement kann je nach Add-In-Typ die folgenden untergeordneten Elemente enthalten.

Siehe auch

Weitere Informationen zu Anforderungssätzen finden Sie unter Office-Versionen und Anforderungssätze.