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
LocaleToken
mit 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 LocaleToken
muss 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 | 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
- Office-Versionen und Anforderungssätze
- Angeben, welche Office-Versionen und Plattformen Ihr Add-In hosten können
- Tastenkombinationen
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 "resid
JSRuntime.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 resid Runtime-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. -->
<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
Office Add-ins