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

  • Article

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 :

  • Mail 1.0

Pour plus d’informations, consultez Remplacements de version dans le manifeste.

Associé à ces ensembles de conditions requises :

  • Mailbox 1.3
  • 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.0 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.
<VersionOverrides> Non Définit des commandes de complément sous une version plus récente du schéma. Voir Mise en œuvre de plusieurs versions pour plus d’informations.
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.

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.

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.

<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>
...
</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. Cela peut être fait pour éventuellement prendre en charge de nouvelles fonctionnalités dans un schéma plus récent tout en prenant en charge les clients plus anciens qui ne prennent pas en charge les nouvelles fonctionnalités.

Pour implémenter plusieurs versions, l’élément <VersionOverrides> de la version plus récente doit être un enfant de l’élément VersionOverrides pour la version antérieure. L’élément VersionOverrides> enfant< n’hérite pas de 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>