Élément Override

  • Article

Fournit un moyen de remplacer la valeur d’un paramètre de manifeste en fonction d’une condition spécifiée. Il existe trois types de conditions :

  • Paramètres régionaux Office qui sont différents de la valeur par défaut LocaleToken, appelée LocaleTokenOverride.
  • Modèle de prise en charge des ensembles de conditions requises qui est différent du modèle par défaut RequirementToken , appelé RequirementTokenOverride.
  • La source est différente de la valeur par défaut Runtime, appelée RuntimeOverride.

Un <élément Override> qui se trouve à l’intérieur d’un <élément Runtime> doit être de type RuntimeOverride.

Il n’existe aucun overrideType attribut pour l’élément <Override> . La différence est déterminée par l’élément parent et le type de l’élément parent. Élément <Override> qui se trouve à l’intérieur d’un <élément Token> dont xsi:type la valeur est RequirementToken, doit être de type RequirementTokenOverride. Un <élément Override> à l’intérieur d’un autre élément parent, ou à l’intérieur d’un <élément Override> de type LocaleToken, doit être de type LocaleTokenOverride. Pour plus d’informations sur l’utilisation de cet élément lorsqu’il s’agit d’un enfant d’un <élément Token> , consultez Utiliser des remplacements étendus du manifeste.

Chaque type est décrit dans des sections distinctes plus loin dans cet article.

Élément Override pour LocaleToken

Un <élément Override> exprime une condition et peut être lu en tant que « Si ... alors... Déclaration. Si l’élément <Override> est de type LocaleTokenOverride, l’attribut Locale est la condition et l’attribut Value est la conséquence. Par exemple, le texte suivant est « Si le paramètre de paramètres régionaux Office est fr-fr, le nom d’affichage est ' Lecteur vidéo' ».

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

Type de complément : application de contenu, de volet Office, de messagerie

Syntaxe

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

Contenu dans

Élément
CitationText
Description
DictionaryName
DictionaryHomePage
DisplayName
HighResolutionIconUrl
IconUrl
Image
QueryUri
SourceLocation
String
SupportUrl
Jeton
Url

Attributs

Attribut Type Requis Description
Locale string Oui Spécifie le nom de culture des paramètres régionaux pour ce remplacement dans le format de balise de langue BCP 47, par "en-US"exemple .
Valeur string Oui Spécifie la valeur du paramètre exprimée pour les paramètres régionaux spécifiés.

Exemples

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

Voir aussi

Élément Override pour RequirementToken

Un <élément Override> exprime une condition et peut être lu en tant que « Si ... alors... Déclaration. Si l’élément <Override> est de type RequirementsTokenOverride, l’élément Enfant< Requirements> exprime la condition et l’attribut Value est l’attribut résultant. Par exemple, le premier <remplacement> de l’article suivant est « Si la plateforme actuelle prend en charge FeatureOne version 1.7, utilisez la chaîne « oldAddinVersion » à la ${token.requirements} place du jeton dans l’URL du grand-parent< ExtendedOverrides> (au lieu de la chaîne par défaut « 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>

Type de complément : volet Office

Syntaxe

<Override Value="string" />

Contenu dans

Élément
Jeton

Doit contenir

L’élément <Override> de RequirementToken doit contenir les éléments enfants suivants en fonction du type de complément.

Élément Contenu Courrier TaskPane
Conditions requises Non Non Oui

Attributs

Attribut Type Requis Description
Valeur string Oui Valeur du jeton grand-parent lorsque la condition est remplie.

Exemple

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

Voir aussi

Élément Override pour Runtime

Importante

La prise en charge de cet élément a été introduite dans l’ensemble de conditions requises de boîte aux lettres 1.10 avec la fonctionnalité d’activation basée sur les événements. Voir les clients et les plateformes qui prennent en charge cet ensemble de conditions requises.

Un <élément Override> exprime une condition et peut être lu en tant que « Si ... alors... Déclaration. Si l’élément <Override> est de type RuntimeOverride, l’attribut type est la condition et l’attribut resid est le résultat. Par exemple, ce qui suit est lu « Si le type est 'javascript', le resid est 'JSRuntime.Url'. » . Outlook sur Windows nécessite cet élément pour les gestionnaires de point d’extension LaunchEvent et de point d’extension ReportPhishingCommandSurface (préversion).

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

Type de complément : messagerie

Syntaxe

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

Contenu dans

Attributs

Attribut Type Requis Description
type string Oui Spécifie la langue de ce remplacement. Actuellement, "javascript" est la seule option prise en charge.
resid string Oui Spécifie l’emplacement de l’URL du fichier JavaScript qui doit remplacer l’emplacement de l’URL du code HTML par défaut défini dans le de l’élément residRuntime parent. Ne resid peut pas comporter plus de 32 caractères et doit correspondre à un id attribut d’un Url élément dans l’élément Resources .

Exemples

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

Voir aussi