Elemento Override

Proporciona una manera de invalidar el valor de una configuración de manifiesto en función de una condición especificada. Hay tres tipos de condiciones:

• Una configuración regional de Office diferente de la predeterminada LocaleToken, denominada LocaleTokenOverride.
• Un patrón de compatibilidad con conjuntos de requisitos diferente del patrón predeterminado RequirementToken , denominado RequirementTokenOverride.
• El origen es diferente del predeterminado Runtime, llamado RuntimeOverride.

Un <elemento Override> que se encuentra dentro de un <elemento en tiempo> de ejecución debe ser de tipo RuntimeOverride.

No hay ningún overrideType atributo para el <elemento Override> . La diferencia viene determinada por el elemento principal y el tipo del elemento principal. Un <elemento Override> que se encuentra dentro de un <elemento Token> cuyo xsi:type es RequirementToken, debe ser de tipo RequirementTokenOverride. Un <elemento Override> dentro de cualquier otro elemento primario, o dentro de un <elemento Override> de tipo LocaleToken, debe ser de tipo LocaleTokenOverride.

Cada tipo se describe en secciones independientes más adelante en este artículo.

Reemplazar elemento para LocaleToken

Un <elemento Override> expresa una condición y se puede leer como un error "Si ... entonces ..." declaración. Si el <elemento Override> es de tipo LocaleTokenOverride, el Locale atributo es la condición y el Value atributo es el consecuente. Por ejemplo, se lee lo siguiente: "Si la configuración regional de Office es fr-fr, el nombre para mostrar es 'Lecteur vidéo'".

<DisplayName DefaultValue="Video player">
    <Override Locale="fr-fr" Value="Lecteur vidéo" />
</DisplayName>

Tipo de complemento: Contenido, Panel de tareas, Correo

Sintaxis

<Override Locale="string" Value="string"></Override>

Forma parte de

Atributos

Ejemplos

<DisplayName DefaultValue="Video player">
    <Override Locale="fr-fr" Value="Lecteur vidéo" />
</DisplayName>

<bt:Image id="icon1_16x16" DefaultValue="https://www.contoso.com/icon_default.png">
    <bt:Override Locale="ja-jp" Value="https://www.contoso.com/ja-jp16-icon_default.png" />
</bt:Image>

  <ExtendedOverrides Url="http://contoso.com/addinmetadata/${token.locale}/extended-manifest-overrides.json">
    <Tokens>
      <Token Name="locale" DefaultValue="en-us" xsi:type="LocaleToken">
        <Override Locale="es-*" Value="es-es" />
        <Override Locale="es-mx" Value="es-mx" />
        <Override Locale="fr-*" Value="fr-fr" />
        <Override Locale="ja-jp" Value="ja-jp" />
      </Token>
    <Tokens>
  </ExtendedOverrides>

Recursos adicionales

• Localización de complementos para Office
• Métodos abreviados de teclado

Reemplazar elemento para RequirementToken

Un <elemento Override> expresa una condición y se puede leer como un error "Si ... entonces ..." declaración. Si el <elemento Override> es de tipo RequirementTokenOverride, el <elemento secundario Requirements> expresa la condición y el Value atributo es el consecuente. Por ejemplo, la primera <Invalidación> en el siguiente se lee "Si la plataforma actual admite la versión 1.7 de FeatureOne, use la ${token.requirements} cadena 'oldAddinVersion' en lugar del token en la dirección URL del abuelo <ExtendedOverrides> (en lugar de la cadena predeterminada 'actualización')".

<ExtendedOverrides Url="http://contoso.com/addinmetadata/${token.requirements}/extended-manifest-overrides.json">
    <Tokens>
        <Token Name="requirements" DefaultValue="upgrade" xsi:type="RequirementsToken">
            <Override Value="oldAddinVersion">
                <Requirements>
                    <Sets>
                        <Set Name="FeatureOne" MinVersion="1.7" />
                    </Sets>
                </Requirements>
            </Override>
            <Override Value="currentAddinVersion">
                <Requirements>
                    <Sets>
                        <Set Name="FeatureOne" MinVersion="1.8" />
                    </Sets>
                    <Methods>
                        <Method Name="MethodThree" />
                    </Methods>
                </Requirements>
            </Override>
        </Token>
    </Tokens>
</ExtendedOverrides>

Tipo de complemento: Panel de tareas

Sintaxis

<Override Value="string" />

Forma parte de

Debe contener

El <elemento Override> para RequirementToken debe contener los siguientes elementos secundarios según el tipo de complemento.

Atributos

Ejemplo

<ExtendedOverrides Url="http://contoso.com/addinmetadata/${token.requirements}/extended-manifest-overrides.json">
    <Token Name="requirements" DefaultValue="upgrade" xsi:type="RequirementsToken">
        <Override Value="very-old">
            <Requirements>
                <Sets>
                    <Set Name="FeatureOne" MinVersion="1.5" />
                    <Set Name="FeatureTwo" MinVersion="1.1" />
                </Sets>
            </Requirements>
        </Override>
        <Override Value="old">
            <Requirements>
                <Sets>
                    <Set Name="FeatureOne" MinVersion="1.7" />
                    <Set Name="FeatureTwo" MinVersion="1.2" />
                </Sets>
            </Requirements>
        </Override>
        <Override Value="current">
            <Requirements>
                <Sets>
                    <Set Name="FeatureOne" MinVersion="1.8" />
                    <Set Name="FeatureTwo" MinVersion="1.3" />
                </Sets>
                <Methods>
                    <Method Name="MethodThree" />
                </Methods>
            </Requirements>
        </Override>
    </Token>
</ExtendedOverrides>

Vea también

• Versiones de Office y conjuntos de requisitos
• Especifique qué versiones y plataformas de Office pueden hospedar el complemento
• Métodos abreviados de teclado

Reemplazar elemento para Runtime

Un <elemento Override> expresa una condición y se puede leer como un error "Si ... entonces ..." declaración. Si el <elemento Override> es de tipo RuntimeOverride, el type atributo es la condición y el atributo es el resid consecuente. Por ejemplo, se lee lo siguiente: "Si el tipo es 'javascript', entonces resid es 'JSRuntime.Url'". Excel, PowerPoint y Word en Windows y Outlook clásico en Windows requieren este elemento para los controladores de punto de extensión LaunchEvent y ReportPhishingCommandSurface.

<Runtime resid="WebViewRuntime.Url">
  <Override type="javascript" resid="JSRuntime.Url"/>
</Runtime>

Tipo de complemento: Documento, correo, presentación y libro

Sintaxis

<Override type="javascript" resid="JSRuntime.Url"/>

Forma parte de

• Tiempo de ejecución

Atributos

Ejemplos

<!-- Event-based activation and integrated spam reporting happen in a lightweight runtime.-->
<Runtimes>
  <!-- HTML file including reference to or inline JavaScript event handlers.
  This is used by Outlook on the web, on the new Mac UI, and new Outlook on Windows. -->
  <Runtime resid="WebViewRuntime.Url">
    <!-- JavaScript file containing event handlers. This is used by Outlook on Windows. -->
    <Override type="javascript" resid="JSRuntime.Url"/>
  </Runtime>
</Runtimes>

Vea también

• Tiempo de ejecución
• Activar complementos con eventos