Override-Element

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

• Ein vom Standard LocaleTokenabweichendes Office-Gebietsschema namens LocaleTokenOverride.
• Ein Muster für die Unterstützung von Anforderungssätzen, das sich vom Standardmuster RequirementToken unterscheidet, genannt RequirementTokenOverride.
• Die Quelle unterscheidet sich von der Standardquelle Runtimeund heißt RuntimeOverride.

Ein <Override-Element> , das sich innerhalb eines <Runtime-Elements> befindet, muss vom Typ RuntimeOverride sein.

Es gibt kein overrideType Attribut für das <Override-Element> . Der Unterschied wird durch das übergeordnete Element und den Typ des übergeordneten Elements bestimmt. Ein <Override-Element> , das sich innerhalb eines <Token-Elements> befindet, dessen xsi:type is 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.

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

Override-Element für LocaleToken

Ein <Override-Element> drückt eine Bedingung aus und kann als "Wenn ... dann ..." zu verwenden. Wenn das <Override-Element> vom Typ LocaleTokenOverride ist, dann ist das Locale Attribut die Bedingung und das Value Attribut die Folge. Folgendes lautet beispielsweise "Wenn die Office-Gebietsschemaeinstellung fr-fr ist, dann 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 "Wenn ... dann ..." zu verwenden. Wenn das <Override-Element> vom Typ RequirementTokenOverride ist, drückt das untergeordnete <Requirements-Element> die Bedingung aus, und das Value Attribut ist die Folge. Die erste <Außerkraftsetzung> im Folgenden lautet beispielsweise "Wenn die aktuelle Plattform FeatureOne Version 1.7 unterstützt, verwenden Sie die Zeichenfolge 'oldAddinVersion' anstelle des ${token.requirements} Tokens in der URL des übergeordneten <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 je nach 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
• Geben Sie an, welche Office-Versionen und Plattformen das Add-In hosten können
• Tastenkombinationen

Override-Element für Runtime

Ein <Override-Element> drückt eine Bedingung aus und kann als "Wenn ... dann ..." zu verwenden. Wenn das <Override-Element vom Typ RuntimeOverride ist, dann ist das Attribut> die Bedingung und das resid Attribut die Folge.type Folgendes lautet beispielsweise "Wenn der Typ 'javascript' ist, dann ist 'residJSRuntime.Url'." Excel, PowerPoint und Word unter Windows sowie das klassische Outlook unter Windows erfordern dieses Element für die Pointhandler LaunchEvent-Erweiterungspunkt und ReportPhishingCommandSurface-Erweiterungspunkt.

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

Add-In-Typ: Dokument, E-Mail, Präsentation, Arbeitsmappe

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
• Aktivieren von Add-Ins mit Ereignissen