Compartir a través de

Elemento VersionOverrides 1.0 en el archivo de manifiesto de un complemento de correo

  • Artículo

Este elemento contiene información para las características que no se admiten en el manifiesto base.

Nota:

En este artículo se supone que está familiarizado con la información general del elemento VersionOverrides, que contiene información importante sobre los atributos y las variaciones del elemento.

Tipo de complemento: correo

Solo es válido en estos esquemas VersionOverrides:

  • Correo 1.0

Para obtener más información, vea Invalidaciones de versión en el manifiesto de solo complemento.

Asociado a estos conjuntos de requisitos:

  • Mailbox 1.3
  • Algunos elementos secundarios pueden estar asociados a conjuntos de requisitos adicionales.

Elementos secundarios

La tabla siguiente solo se aplica a la versión 1.0 de <los elementos VersionOverrides> y solo a los complementos de correo.

Nota:

En iOS, solo <se admite WebApplicationInfo> . Se omiten todos los demás elementos secundarios de< VersionOverrides>.

Elemento Obligatorio Descripción
Descripción No Describe el complemento.
Requisitos No Especifica los conjuntos de requisitos mínimos que se deben admitir para que el marcado en el elemento primario< VersionOverrides> surta efecto. Esto siempre debe ser más restrictivo que el <elemento Requirements> de la parte base del manifiesto.
Hosts Yes Especifica una colección de aplicaciones de Office. El elemento Hosts> secundario< invalida el <elemento Hosts> en la parte primaria del manifiesto.
Recursos Sí Define una colección de recursos (cadenas, direcciones URL e imágenes) a las que hacen referencia otros elementos del manifiesto.
<VersionOverrides> No Define comandos de complemento en una versión más reciente del esquema. Consulte Implementar varias versiones para obtener detalles.
WebApplicationInfo No Especifica detalles sobre el registro del complemento con emisores de tokens seguros, como Azure Active Directory V2.0.

Descripción

Describe al complemento. Esto invalida el <elemento Description> en cualquier parte primaria del manifiesto. El texto de la descripción está contenido en un elemento secundario del elemento LongString, contenido en el elemento Resources. El resid atributo del <elemento Description> no puede tener más de 32 caracteres y debe coincidir con el valor del id atributo de un elemento secundario del <elemento ShortString> contenido en el elemento Resources .

Tipo de complemento: Panel de tareas, Correo

Solo es válido en estos esquemas VersionOverrides:

  • Panel de tareas 1.0
  • Correo 1.0
  • Correo 1.1

Para obtener más información, vea Invalidaciones de versión en el manifiesto de solo complemento.

Asociado a estos conjuntos de requisitos:

  • AddinCommands 1.1 cuando el elemento primario< VersionOverrides> es de tipo Panel de tareas 1.0.
  • Buzón 1.3 cuando el elemento primario< VersionOverrides> es de tipo Mail 1.0.
  • Buzón 1.5 cuando el elemento primario< VersionOverrides> es de tipo Mail 1.1.

Ejemplo

A continuación puede ver un ejemplo simple. Para obtener ejemplos más complejos, vea los manifiestos de los complementos de ejemplo en ejemplos de código de complementos de 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>

Implementar varias versiones

Un manifiesto puede implementar varias versiones del <elemento VersionOverrides> que admiten diferentes versiones del esquema VersionOverrides. Esto se puede hacer para admitir opcionalmente nuevas características en un esquema más reciente, a la vez que se admiten clientes anteriores que no admiten las nuevas características.

Para implementar varias versiones, el <elemento VersionOverrides> para la versión más reciente debe ser un elemento secundario del VersionOverrides elemento para la versión anterior. El elemento VersionOverrides> secundario< no hereda ningún valor del elemento primario.

Para implementar el esquema VersionOverrides v1.0 y v1.1, el manifiesto sería similar al siguiente ejemplo.

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