Compartir a través de

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.

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

Elemento
CitationText
Descripción
DictionaryName
DictionaryHomePage
DisplayName
HighResolutionIconUrl
IconUrl
Image
QueryUri
SourceLocation
String
SupportUrl
Token
Url

Atributos

Atributo Tipo Obligatorio Descripción
Locale string Sí Especifica el nombre de la referencia cultural de la configuración regional de esta invalidación en el formato de etiqueta de idioma BCP 47, como "en-US".
Valor string Sí Especifica el valor de la opción de configuración expresado para la configuración regional especificada.

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

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

Elemento
Token

Debe contener

El <elemento Override> de RequirementToken debe contener los siguientes elementos secundarios en función del tipo de complemento.

Elemento Contenido Correo TaskPane
Requisitos No No Sí

Atributos

Atributo Tipo Obligatorio Descripción
Valor string Sí Valor del token de abuelo cuando se cumple la condición.

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

Elemento Override para Runtime

Importante

La compatibilidad con este elemento se introdujo con la característica de activación basada en eventos. Consulte la lista de eventos admitidos para obtener información sobre cuándo se ha habilitado la compatibilidad con cada evento de cada aplicación de Office.

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'". 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 punto de extensión ReportPhishingCommandSurface.

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

Tipo de complemento: Document, Mail, Presentation, Workbook

Sintaxis

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

Forma parte de

Atributos

Atributo Tipo Obligatorio Descripción
type string Sí Especifica el idioma de esta invalidación. En la actualidad, "javascript" es la única opción admitida.
resid string Sí Especifica la ubicación de dirección URL del archivo JavaScript que debe invalidar la ubicación de dirección URL del HTML predeterminado definido en el elemento en tiempo de residejecución primario. resid no puede tener más de 32 caracteres y debe coincidir con un id atributo de un Url elemento del Resources elemento .

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

  • Last updated on