Override-Element

  • Artikel

Bietet eine Möglichkeit, den Wert einer Manifesteinstellung abhängig von einer angegebenen Bedingung zu überschreiben. Es gibt drei Arten von Bedingungen:

  • Ein Office-Gebietsschema, das sich vom Standardgebietsschema LocaleTokenmit dem Namen LocaleTokenOverride unterscheidet.
  • Ein Muster der Anforderungssatzunterstützung, das sich vom Standardmuster RequirementToken mit dem Namen RequirementTokenOverride unterscheidet.
  • Die Quelle unterscheidet sich von der Standardinstanz Runtime, die als RuntimeOverride bezeichnet wird.

Ein <Override-Element> , das sich in einem <Runtime-Element> befindet, muss vom Typ RuntimeOverride sein.

Es gibt kein overrideType Attribut für das <Override-Element> . Die Differenz wird durch das übergeordnete Element und den Typ des übergeordneten Elements bestimmt. Ein <Override-Element> , das sich in einem <Token-Element> befindet, dessen xsi:type ist RequirementToken, muss vom Typ RequirementTokenOverride sein. Ein <Override-Element> innerhalb eines anderen übergeordneten Elements oder innerhalb eines <Override-Elements> vom Typ LocaleTokenmuss vom Typ LocaleTokenOverride sein. Weitere Informationen zur Verwendung dieses Elements, wenn es ein untergeordnetes Element eines <Token-Elements> ist, finden Sie unter Arbeiten mit erweiterten Außerkraftsetzungen des Manifests.

Jeder Typ wird in separaten Abschnitten weiter unten in diesem Artikel beschrieben.

Override-Element für LocaleToken

Ein <Override-Element> drückt eine Bedingung aus und kann als "If ... dann ..." Anweisung. Wenn das <Override-Element> vom Typ LocaleTokenOverride ist, ist das Locale Attribut die Bedingung, und das Value Attribut ist das daraus resultierende Attribut. Beispielsweise lautet der folgende Text: "Wenn die Einstellung für das Office-Gebietsschema fr-fr lautet, lautet der Anzeigename 'Lecteur vidéo'" (Wenn die Einstellung für das Office-Gebietsschema fr-fr lautet, lautet der Anzeigename 'Lecteur vidéo').

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

Add-In-Typ: Inhalt, Aufgabenbereich, E-Mail

Syntax

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

Enthalten in

Element
CitationText
Beschreibung
DictionaryName
DictionaryHomePage
DisplayName
HighResolutionIconUrl
IconUrl
Image
QueryUri
SourceLocation
String
SupportUrl
Token
Url

Attribute

Attribut Typ Erforderlich Beschreibung
Locale string Ja Gibt den Kulturnamen des Gebietsschemas für diese Außerkraftsetzung im BCP 47-Sprachtagformat an, z "en-US". B. .
Wert string Ja Gibt den Wert der für das angegebene Gebietsschema ausgedrückten Einstellung an.

Beispiele

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

Siehe auch

Override-Element für RequirementToken

Ein <Override-Element> drückt eine Bedingung aus und kann als "If ... dann ..." Anweisung. Wenn das <Override-Element> vom Typ RequirementTokenOverride ist, gibt das untergeordnete <Requirements-Element> die Bedingung aus, und das Value Attribut ist das daraus resultierende Element. Die erste <Außerkraftsetzung> im Folgenden lautet z. B. "Wenn die aktuelle Plattform FeatureOne Version 1.7 unterstützt, verwenden Sie die Zeichenfolge "oldAddinVersion" anstelle des ${token.requirements} Tokens in der URL der großelternlternen <ExtendedOverrides> (anstelle der Standardzeichenfolge "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>

Add-In-Typ: Aufgabenbereich

Syntax

<Override Value="string" />

Enthalten in

Element
Token

Muss enthalten

Das <Override-Element> für RequirementToken muss abhängig vom Add-In-Typ die folgenden untergeordneten Elemente enthalten.

Element Inhalt E-Mail TaskPane
Anforderungen Nein Nein Ja

Attribute

Attribut Typ Erforderlich Beschreibung
Wert string Ja Wert des Großelterntokens, wenn die Bedingung erfüllt ist.

Beispiel

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

Siehe auch

Override-Element für Runtime

Wichtig

Unterstützung für dieses Element wurde im Postfachanforderungssatz 1.10 mit der ereignisbasierten Aktivierungsfunktion eingeführt. Siehe Clients und Plattformen, die diese Anforderungsgruppe unterstützen.

Ein <Override-Element> drückt eine Bedingung aus und kann als "If ... dann ..." Anweisung. Wenn das <Override-Element> vom Typ RuntimeOverride ist, ist das type -Attribut die Bedingung, und das resid -Attribut ist das daraus folgende Attribut. Im Folgenden wird z. B. "Wenn der Typ "javascript" ist, lautet "residJSRuntime.Url". Outlook unter Windows erfordert dieses Element für launchEvent-Erweiterungspunkt- und ReportPhishingCommandSurface-Erweiterungspunkthandler (Vorschau).

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

Add-In-Typ: Mail

Syntax

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

Enthalten in

Attribute

Attribut Typ Erforderlich Beschreibung
type string Ja Gibt die Sprache für diese Außerkraftsetzung an. Derzeit "javascript" ist die einzige unterstützte Option.
resid string Ja Gibt den URL-Speicherort der JavaScript-Datei an, die den URL-Speicherort des im übergeordneten residRuntime-Element definierten HTML-Standards überschreiben soll. der resid darf nicht mehr als 32 Zeichen lang sein und muss mit einem id Attribut eines Url Elements im Resources -Element übereinstimmen.

Beispiele

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

Siehe auch