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:

• Configuración regional de Office que es diferente de la predeterminada LocaleToken, denominada LocaleTokenOverride.
• Patrón de compatibilidad con conjuntos de requisitos que es diferente del patrón predeterminado RequirementToken , denominado RequirementTokenOverride.
• El origen es diferente del valor predeterminado Runtime, denominado RuntimeOverride.

Un <elemento Override> que se encuentra dentro de un <elemento Runtime> debe ser de tipo RuntimeOverride.

No hay ningún overrideType atributo para el <elemento Override> . La diferencia viene determinada por el elemento primario y el tipo del elemento primario. 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. Para obtener más información sobre el uso de este elemento cuando es un elemento secundario de un <elemento Token> , vea Trabajar con invalidaciones extendidas del manifiesto.

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

Elemento Override para LocaleToken

Un <elemento Override> expresa un condicional y se puede leer como "If ... a continuación, ..." Declaración. Si el <elemento Override> es de tipo LocaleTokenOverride, el Locale atributo es la condición y el Value atributo es el consiguiente. 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

Elemento Override para RequirementToken

Un <elemento Override> expresa un condicional y se puede leer como "If ... a continuación, ..." Declaración. Si el <elemento Override> es de tipo RequirementTokenOverride, el elemento Requirements> secundario< expresa la condición y el Value atributo es el consiguiente. Por ejemplo, la primera <invalidación> de lo siguiente se lee "Si la plataforma actual admite featureOne versión 1.7, use la cadena 'oldAddinVersion' en lugar del ${token.requirements} token en la dirección URL del elemento <primario ExtendedOverrides> (en lugar de la cadena predeterminada 'upgrade')."

<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> de RequirementToken debe contener los siguientes elementos secundarios en función del 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
• Especificar qué versiones y plataformas de Office pueden hospedar el complemento
• Métodos abreviados de teclado

Elemento Override para Runtime

Un <elemento Override> expresa un condicional y se puede leer como "If ... a continuación, ..." Declaración. Si el <elemento Override> es de tipo RuntimeOverride, el type atributo es la condición y el resid atributo es el consiguiente. Por ejemplo, lo siguiente se lee "Si el tipo es 'javascript', entonces es resid 'JSRuntime.Url'". Outlook en Windows requiere este elemento para los controladores de punto de extensión LaunchEvent y punto de extensión ReportPhishingCommandSurface (versión preliminar ).

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

Tipo de complemento: correo

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
• Configuración del complemento de Outlook para la activación basada en eventos