élément VersionOverrides 1.1 dans le fichier manifeste d’un complément de courrier

Cet élément contient des informations sur les fonctionnalités qui ne sont pas prises en charge dans le manifeste de base.

Remarque

Cet article suppose que vous connaissez la vue d’ensemble de l’élément VersionOverrolls, qui contient des informations importantes sur les attributs et les variantes de l’élément.

Type de complément : messagerie

Valide uniquement dans ces schémas VersionOverrides :

  • Courrier 1.1

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

Associé à ces ensembles de conditions requises :

  • Mailbox 1.5
  • Certains éléments enfants peuvent être associés à des ensembles de conditions requises supplémentaires.

Éléments enfants

Le tableau suivant s’applique uniquement à la version 1.1 des éléments VersionOverrides<> et uniquement aux compléments de courrier.

Remarque

Dans iOS, seul <WebApplicationInfo> est pris en charge. Tous les autres éléments enfants de <VersionOverrides> sont ignorés.

Élément Obligatoire Description
Description Non Décrit le complément.
Configuration requise Non Spécifie les ensembles d’exigences minimales qui doivent être pris en charge pour que le balisage dans les VersionOverrides> parents< prenne effet. Cela doit toujours être plus restrictif que l’élément <Exigences> dans la partie de base du manifeste.
Hôtes Non Spécifie un regroupement d’applications Office. L’élément Hosts enfant remplace l’élément Hosts dans la partie parent du manifeste.
Resources Non Définit une collection de ressources (chaînes, URL et images) qui sont référencées par d’autres éléments de manifeste.
EquivalentAddins Non Spécifie les compléments natifs (COM/XLL) équivalents au complément Web. Le complément web n’est pas activé si un complément natif équivalent est installé.
<VersionOverrides> Non Non utilisable actuellement dans VersionOverrides 1.1 pour les compléments de courrier.
WebApplicationInfo Non Spécifie les détails de l’inscription du complément auprès d’émetteurs de jetons sécurisés, tels qu’Azure Active Directory V2.0.
ExtendedPermissions Non Spécifie une collection d’autorisations étendues.

Description

Décrit le complément. Cela remplace l’élément <Description> dans n’importe quelle partie parent du manifeste. Le texte de la description est contenu dans un élément enfant de l’élément LongString contenu dans l’élément Resources. L’attribut resid de l’élément <Description> ne peut pas comporter plus de 32 caractères et doit correspondre à la valeur de l’attribut id d’un élément enfant de l’élément <ShortString> contenu dans l’élément Resources .

Type de complément : Volet Office, Courrier

Valide uniquement dans ces schémas VersionOverrides :

  • 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 :

Exemple

Voici un exemple simple. Pour obtenir des exemples plus complexes, consultez les manifestes des exemples de compléments dans la rubrique Exemples de code de complément Office.

Voici un exemple d’élément VersionOverrides> classique<, y compris certains éléments enfants qui ne sont pas requis mais qui sont généralement utilisés.

<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>

Mise en œuvre de plusieurs versions

Un manifeste peut implémenter plusieurs versions de l’élément VersionOverrides qui prennent en charge différentes versions du schéma VersionOverrides. Cette opération permet éventuellement la prise en charge de nouvelles fonctionnalités dans un schéma plus récent tout en prenant en charge des clients plus anciens qui ne prennent pas en charge les nouvelles fonctionnalités.

Pour mettre en œuvre plusieurs versions, l’élément VersionOverrides de la nouvelle version doit être un enfant de l’élément VersionOverrides de l’ancienne version. L’élément enfant VersionOverrides n’hérite pas des valeurs du parent.

Pour implémenter à la fois le schéma VersionOverrides v1.0 et v1.1, le manifeste ressemble à l’exemple suivant.

<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