Elemento VersionOverrides 1.1 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.1

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.5
  • Algunos elementos secundarios pueden estar asociados a conjuntos de requisitos adicionales.

Elementos secundarios

La tabla siguiente solo se aplica a la versión 1.1 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.
EquivalentAddins No Especifica los complementos nativos (COM/XLL) que son equivalentes al complemento web. El complemento web no se activa si se instala un complemento nativo equivalente.
<VersionOverrides> No No se puede usar actualmente en VersionOverrides 1.1 para complementos de correo.
WebApplicationInfo No Especifica detalles sobre el registro del complemento con emisores de tokens seguros, como Azure Active Directory V2.0.
ExtendedPermissions No Especifica una colección de permisos extendidos.

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.

A continuación se muestra un ejemplo de un elemento VersionOverrides típico<, incluidos algunos elementos secundarios> que no son necesarios pero que se usan normalmente.

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

Implementar varias versiones

Un manifiesto puede implementar varias versiones del elemento VersionOverrides que admiten diferentes versiones del esquema de VersionOverrides. Esta acción puede realizarse para tener la opción de admitir nuevas características en un esquema más reciente, pero, a la vez, admitir clientes anteriores que no sean compatibles con las nuevas características.

Para poder implementar varias versiones, el elemento VersionOverrides de la versión más reciente deberá ser un elemento secundario del elemento VersionOverrides de 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>