Elemento Override

  • Artículo

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

Elemento
CitationText
Descripción
DictionaryName
DictionaryHomePage
DisplayName
HighResolutionIconUrl
IconUrl
Image
QueryUri
SourceLocation
Cadena
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 en el conjunto de requisitos de buzón 1.10 con la característica de activación basada en eventos. Vea clientes y plataformas compatibles con este conjunto de requisitos.

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

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 (preview). -->
  <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