Override-Element

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

Attribute

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

• Lokalisierung für Office-Add-Ins
• Tastenkombinationen

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

Muss enthalten

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

Attribute

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

• Office-Versionen und Anforderungssätze
• Angeben, welche Office-Versionen und Plattformen Ihr Add-In hosten können
• Tastenkombinationen

Override-Element für Runtime

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

• Laufzeit

Attribute

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

• Laufzeit
• Konfigurieren Ihres Outlook-Add-Ins für die ereignisbasierte Aktivierung