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

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 part du principe que vous connaissez la vue d’ensemble de l’élément VersionOverrides, qui contient des informations importantes sur les attributs et les variantes de l’élément.

Type de complément : messagerie

Valide uniquement dans les schémas VersionOverrides suivants :

  • 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 messagerie.

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 de conditions requises minimales qui doivent être pris en charge pour que le balisage dans le parent< VersionOverrides> prenne effet. Cela doit toujours être plus restrictif que l’élément <Requirements> dans la partie de base du manifeste.
Hôtes Oui Spécifie une collection d’applications Office. L’élément Hosts enfant remplace l’élément Hosts dans la partie parente du manifeste.
Resources Oui 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) qui sont équivalents au complément web. Le complément web n’est pas activé si un complément natif équivalent est installé.
<VersionOverrides> Non Actuellement non utilisable dans VersionOverrides 1.1 pour les compléments de messagerie.
WebApplicationInfo Non Spécifie des détails sur l’inscription du complément auprès des é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 parente 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 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 :

Exemple

Voici un exemple simple. Pour obtenir des exemples plus complexes, consultez les manifestes des exemples de compléments dans les 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 obligatoires, 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 les schémas 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>