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.
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
<Override Locale="string" Value="string"></Override>
Elemento |
---|
CitationText |
Descripción |
DictionaryName |
DictionaryHomePage |
DisplayName |
HighResolutionIconUrl |
IconUrl |
Image |
QueryUri |
SourceLocation |
Cadena |
SupportUrl |
Token |
Url |
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. |
<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>
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
<Override Value="string" />
Elemento |
---|
Token |
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í |
Atributo | Tipo | Obligatorio | Descripción |
---|---|---|---|
Valor | string | Sí | Valor del token de abuelo cuando se cumple la condición. |
<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>
- Versiones de Office y conjuntos de requisitos
- Especificar qué versiones y plataformas de Office pueden hospedar el complemento
- Métodos abreviados de teclado
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
<Override type="javascript" resid="JSRuntime.Url"/>
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 resid ejecució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 . |
<!-- 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>
Comentarios de Office Add-ins
Office Add-ins es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios: