Elemento Override

  • Artigo

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

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

Um <elemento De substituição> que está dentro de um <elemento Runtime> deve ser do tipo RuntimeOverride.

Não há atributo overrideType para o elemento Substituição<>. 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 de substituição<> do tipo LocaleToken, deve ser do tipo LocaleTokenOverride. Para obter mais informações sobre o uso desse elemento quando ele é filho de um <elemento Token> , consulte Trabalhar com substituições estendidas do manifesto.

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

Elemento de substituição para LocaleToken

Um <elemento Override> expressa um condicional e pode ser lido como um "Se ... então ..." Declaração. Se o <elemento Override> for do tipo LocaleTokenOverride, o Locale atributo será a condição e o Value atributo será o conseqüente. Por exemplo, o seguinte é lido "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

Elemento de substituição para RequirementToken

Um <elemento Override> expressa um condicional e pode ser lido como um "Se ... então ..." Declaração. Se o <elemento Override> for do tipo RequirementTokenOverride, o elemento Requisitos> filho< expressará a condição e o Value atributo será o conseqüente. Por exemplo, a primeira <Substituição> no seguinte é lida "Se a plataforma atual dá suporte ao 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 Substituição> para RequirementToken deve conter os seguintes elementos filho, 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 de avô quando a condição é atendida.

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

Elemento de substituição para Runtime

Importante

O suporte para esse elemento foi introduzido no conjunto de requisitos da caixa de correio 1.10 com o recurso de ativação baseado em evento. Confira, clientes e plataformas que oferecem suporte a esse conjunto de requisitos.

Um <elemento Override> expressa um condicional e pode ser lido como um "Se ... então ..." Declaração. Se o <elemento Override> for do tipo RuntimeOverride, o type atributo será a condição e o resid atributo será o conseqüente. Por exemplo, o seguinte é lido "Se o tipo for 'javascript', o resid será 'JSRuntime.Url'." O Outlook no Windows requer esse elemento para manipuladores do ponto de extensão LaunchEvent e do ponto de extensão ReportPhishingCommandSurface (versão prévia ).

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

Tipo de suplemento: Email

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. Atualmente, "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 residRuntime pai . O resid não 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 (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>

Confira também