Elemento Override

Fornece uma maneira de substituir o valor de uma configuração de manifesto, dependendo de uma condição especificada. Existem três tipos de condições:

  • Uma localidade do Office diferente da padrão LocaleToken, chamada LocaleTokenOverride.
  • Um padrão de suporte ao conjunto de requisitos que é diferente do padrão padrão RequirementToken , chamado RequirementTokenOverride.
  • A origem é diferente do padrão Runtime, chamado RuntimeOverride.

Um <elemento Override> que está dentro de um <elemento Runtime> deve ser do tipo RuntimeOverride.

Não há nenhum overrideType atributo para o <elemento Override> . A diferença é determinada pelo elemento pai e pelo tipo do elemento pai. Um <elemento Override> que está dentro de um <elemento Token> cujo xsi:type é RequirementToken, deve ser do tipo RequirementTokenOverride. Um <elemento Override> dentro de qualquer outro elemento pai ou dentro de um <elemento Override> do tipo LocaleToken, deve ser do tipo LocaleTokenOverride.

Cada tipo é descrito em seções separadas mais adiante neste artigo.

Substituir elemento para LocaleToken

Um <elemento Override> expressa uma condicional e pode ser lido como um "Se ... então ..." da Microsoft Edge. Se o <elemento Override> for do tipo LocaleTokenOverride, o Locale atributo será a condição e o Value atributo será o consequente. Por exemplo, lê-se "Se a configuração de localidade do Office for fr-fr, o nome de exibição será 'Lecteur vidéo'".

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

Tipo de suplemento: Conteúdo, Painel de tarefas, Email

Sintaxe

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

Contido em

Elemento
CitationText
Descrição
DictionaryName
DictionaryHomePage
DisplayName
HighResolutionIconUrl
IconUrl
Imagem
QueryUri
SourceLocation
String
SupportUrl
Token
Url

Atributos

Atributo Tipo Obrigatório Descrição
Locale string Sim Especifica o nome da cultura da localidade para essa substituição no formato de marca de idioma BCP 47, como "en-US".
Valor string Sim Especifica o valor da configuração expressa para a localidade especificada.

Exemplos

<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>

Confira também

Substituir elemento para RequirementToken

Um <elemento Override> expressa uma condicional e pode ser lido como um "Se ... então ..." da Microsoft Edge. Se o <elemento Override> for do tipo RequirementTokenOverride, o <elemento filho Requirements> expressará a condição e o Value atributo será o consequente. Por exemplo, a primeira <substituição> a seguir é lida "Se a plataforma atual for compatível com o FeatureOne versão 1.7, use a cadeia de caracteres 'oldAddinVersion' no lugar do ${token.requirements} token na URL do avô <ExtendedOverrides> (em vez da cadeia de caracteres padrão '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 suplemento: Painel de tarefas

Sintaxe

<Override Value="string" />

Contido em

Elemento
Token

Deve conter

O <elemento Override> for RequirementToken deve conter os elementos filho a seguir, dependendo do tipo de suplemento.

Elemento Conteúdo Email TaskPane
Requisitos Não Não Sim

Atributos

Atributo Tipo Obrigatório Descrição
Valor string Sim Valor do token avô quando a condição é satisfeita.

Exemplo

<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>

Confira também

Substituir elemento para Runtime

Importante

O suporte para esse elemento foi introduzido com o recurso de ativação baseada em eventos. Consulte a lista de eventos com suporte para saber quando o suporte foi habilitado para cada evento em cada aplicativo do Office.

Um <elemento Override> expressa uma condicional e pode ser lido como um "Se ... então ..." da Microsoft Edge. Se o <elemento Override> for do tipo RuntimeOverride, o type atributo será a condição e o resid atributo será o consequente. Por exemplo, o seguinte é lido "Se o tipo for 'javascript', então é resid 'JSRuntime.Url'." O Excel, o PowerPoint e o Word no Windows e o Outlook clássico no Windows exigem esse elemento para o ponto de extensão LaunchEvent e os manipuladores de ponto de extensão ReportPhishingCommandSurface.

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

Tipo de suplemento: Documento, Email, Apresentação, Pasta de Trabalho

Sintaxe

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

Contido em

Atributos

Atributo Tipo Obrigatório Descrição
type string Sim Especifica o idioma para essa substituição. No momento, "javascript" é a única opção com suporte.
resid string Sim Especifica o local da URL do arquivo JavaScript que deve substituir o local da URL do HTML padrão definido no elemento residde Runtime pai . Não resid pode ter mais de 32 caracteres e deve corresponder a um id atributo de um Url elemento no Resources elemento.

Exemplos

<!-- 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>

Confira também

  • Last updated on