Elemento Override

Fornece uma forma de substituir o valor de uma definição de manifesto consoante uma condição especificada. Existem três tipos de condições:

• Uma região do Office diferente da predefinição LocaleToken, denominada LocaleTokenOverride.
• Um padrão de suporte de conjunto de requisitos diferente do padrão predefinido RequirementToken , denominado RequirementTokenOverride.
• A origem é diferente da predefinição Runtime, denominada RuntimeOverride.

Um <elemento De substituição> que esteja dentro de um <elemento Runtime> tem de ser do tipo RuntimeOverride.

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

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

Substituir elemento para LocaleToken

Um <elemento Substituir> expressa uma condição e pode ser lido como um "Se... e, em seguida, ..." instrução. Se o <elemento Substituir> for do tipo LocaleTokenOverride, o Locale atributo é a condição e o Value atributo é o consequente. Por exemplo, o seguinte é "Se a definição de região do Office for fr-fr, o nome a apresentar é "Vidéo do Vidéo Do 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 de cultura da região para esta substituição no formato de etiqueta 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

• Localização para suplementos do Office
• Atalhos de teclado para o SharePoint

Substituir elemento para RequirementToken

Um <elemento Substituir> expressa uma condição e pode ser lido como um "Se... e, em seguida, ..." instrução. Se o <elemento Substituição> for do tipo RequirementTokenOverride, o elemento Requisitos> subordinados< expressa a condição e o Value atributo é o consequente. Por exemplo, a primeira <Substituição> no seguinte é lida "Se a plataforma atual suportar a versão 1.7 da FeatureOne, utilize a cadeia "oldAddinVersion" em vez do ${token.requirements} token no URL das Extensões> Do avô< (em vez da cadeia predefinida '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 Substituir> para RequirementToken tem de conter os seguintes elementos subordinados consoante o 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 do 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

• Versões do Office e conjuntos de requisitos
• Especifique as versões e plataformas do Office que podem alojar o seu suplemento
• Atalhos de teclado para o SharePoint

Substituir elemento para Runtime

Importante

O suporte para este elemento foi introduzido no conjunto de requisitos da Caixa de Correio 1.10 com a funcionalidade de ativação baseada em eventos. Confira, clientes e plataformas que oferecem suporte a esse conjunto de requisitos.

Um <elemento Substituir> expressa uma condição e pode ser lido como um "Se... e, em seguida, ..." instrução. Se o <elemento Substituição> for do tipo RuntimeOverride, o type atributo é a condição e o resid atributo é o consequente. Por exemplo, o seguinte é lido "Se o tipo for "javascript", significa resid que é "JSRuntime.Url". O Outlook no Windows requer este elemento para processadores de ponto de extensão LaunchEvent e ReportPhishingCommandSurface (pré-visualização).

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

Tipo de suplemento: Email

Sintaxe

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

Contido em

• Tempo de execução

Atributos

Atributo	Tipo	Obrigatório	Descrição
type	string	Sim	Especifica o idioma para esta substituição. Atualmente, "javascript" é a única opção suportada.
resid	string	Sim	Especifica a localização do URL do ficheiro JavaScript que deve substituir a localização do URL do HTML predefinido definido no elemento residruntime principal . O resid não pode ter mais de 32 carateres e tem de 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

• Tempo de execução
• Configurar o suplemento do Outlook para ativação baseada em eventos