Élément Requirements

La signification de cet élément varie selon qu’il est utilisé dans le manifeste de base, comme enfant d’un <élément VersionOverrides> ou comme enfant de l’élément Override.

Dans le manifeste de base

Lorsqu’il est utilisé dans le manifeste de base (c’est-à-dire en tant qu’enfant direct d’OfficeApp), l’élément <Requirements> spécifie l’ensemble minimal des exigences de l’API JavaScript Office (ensembles de conditions requises et/ou méthodes) que votre complément Office doit activer par Office. Le complément n’est pas activé sur une combinaison de version et de plateforme Office (par exemple, Windows, Mac, web et iOS ou iPad) qui ne prend pas en charge les méthodes et les ensembles de conditions requises spécifiés.

Type de complément : Volet Office, Courrier

En tant qu’enfant d’un élément VersionOverrides

Lorsqu’il est utilisé en tant qu’enfant de VersionOverrides, spécifie l’ensemble minimal des exigences de l’API JavaScript Office (ensembles de conditions requises et/ou méthodes) qui doit être pris en charge par la version et la plateforme Office (par exemple, Windows, Mac, web et iOS ou iPad) pour que les paramètres de l’élément <VersionOverrides>qui remplacent les paramètres du manifeste de base prennent effet.

Prenons l’exemple d’un complément qui spécifie l’exigence A dans le manifeste de base et la condition B à l’intérieur de <VersionOverrides>.

• Si la plateforme et la version d’Office ne prennent pas en charge A, le complément n’est pas activé et Office n’analyse pas la <section VersionOverrides> du manifeste.
• Si A et B sont pris en charge, le complément est activé et tout le balisage dans <VersionOverrides> prend effet.
• Si A est pris en charge, mais que B ne l’est pas, le complément est activé et une partie du balisage dans VersionOverrides<> prend effet. Plus précisément, les éléments enfants de VersionOverrides<> qui ne remplacent pas les éléments de manifeste de base prennent effet. Par exemple, un <élément WebApplicationInfo> ou equivalentAddins<> prend effet. Toutefois, tous les éléments enfants de <VersionOverrides> qui remplacent un élément de manifeste de base, tel que <Hosts>, ne prennent pas effet. Au lieu de cela, Office utilise les valeurs du balisage de manifeste de base qui auraient autrement été remplacées.

Type de complément : Volet Office, Courrier

Valide uniquement dans les schémas VersionOverrides suivants :

• Volet De tâches 1.0
• Mail 1.0
• Courrier 1.1

Pour plus d’informations, consultez Remplacements de version dans le manifeste du complément uniquement.

Associé à ces ensembles de conditions requises :

• AddinCommands 1.1 lorsque le parent <VersionOverrides> est de type Taskpane 1.0.
• Boîte aux lettres 1.3 lorsque le parent <VersionOverrides> est de type Courrier 1.0.
• Boîte aux lettres 1.5 lorsque le parent <VersionOverrides> est de type Mail 1.1.

Remarques

L’élément <Requirements> ne sert à rien dans versionOverrides<> s’il ne spécifie aucune exigence supplémentaire qui n’est pas spécifiée dans une <configuration Requise> dans le manifeste de base. Si la version et la plateforme Office ne prennent pas en charge les exigences du manifeste de base, le complément n’est pas activé et l’élément <VersionOverrides> n’est pas analysé. Pour cette raison, vous devez utiliser un <élément Requirements> dans versionOverrides<> uniquement lorsque les deux conditions suivantes sont remplies :

• Votre complément possède des fonctionnalités supplémentaires implémentées avec la configuration dans versionOverrides<> (telles que les commandes de complément) et qui nécessitent une méthode ou un ensemble de conditions requises qui n’est pas spécifié dans un <élément Requirements> dans le manifeste de base.
• Votre complément est utile et doit être activé (mais sans les fonctionnalités supplémentaires), même dans une combinaison de plateforme et de version d’Office qui ne prend pas en charge les exigences requises pour les fonctionnalités supplémentaires.

En tant qu’enfant de l’élément Override

Un <élément Requirements> peut être un enfant d’un élément Override dans le contexte d’un élément ExtendedOverrides ancêtre. Un <élément Override> exprime une condition et peut être lu en tant que « Si ... alors... déclaration. Si l’élément <Override> est de type RequirementsTokenOverride (ce qui signifie que le xsi:type de son élément Token parent est RequirementsToken), l’élément Requirements> enfant< exprime la condition et l’attribut Value est le résultat. Par exemple, le premier <remplacement> de l’article suivant est « Si la plateforme actuelle prend en charge FeatureOne version 1.7, utilisez la chaîne « oldAddinVersion » à la ${token.requirements} place du jeton dans l’URL du grand-parent< ExtendedOverrides> (au lieu de la chaîne par défaut « upgrade ») ». Pour plus d’informations, consultez 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>

Type de complément : volet Office

Syntaxe

<Requirements>
   ...
</Requirements>

Contenu dans

• OfficeApp
• VersionOverrides
• Override

Peut contenir

L’élément <Requirements> peut contenir les éléments enfants suivants en fonction du type de complément.

Voir aussi

Pour plus d’informations concernant les ensembles de conditions requises, voir Versions d’Office et ensembles de conditions requises.