Arbeiten mit erweiterten Außerkraftsetzungen des Manifests

Einige Erweiterbarkeitsfeatures von Office-Add-Ins werden mit JSON-Dateien konfiguriert, die auf Ihrem Server gehostet werden, anstatt mit dem XML-Manifest des Add-Ins.

Hinweis

In diesem Artikel wird davon ausgegangen, dass Sie mit Office-Add-In-Manifesten und deren Rolle in Add-Ins vertraut sind. Lesen Sie das Office-Add-Ins-Manifest, falls dies noch nicht geschehen ist.

In der folgenden Tabelle sind die Erweiterbarkeitsfeatures angegeben, die eine erweiterte Außerkraftsetzung erfordern, sowie Links zur Dokumentation des Features.

Feature	Entwicklungsanweisungen
Tastenkombinationen	Hinzufügen von benutzerdefinierten Tastenkombinationen zu Ihren Office-Add-Ins

Das Schema, das das JSON-Format definiert, ist das Schema des erweiterten Manifests.

Tipp

Dieser Artikel ist etwas abstrakt. Erwägen Sie, einen der Artikel in der Tabelle zu lesen, um die Konzepte klarer zu machen.

Teilen Sie Office mit, wo die JSON-Datei zu finden ist.

Verwenden Sie das Manifest, um Office mitzuteilen, wo die JSON-Datei zu finden ist. Fügen Sie unmittelbar unterhalb (nicht innerhalb) des <VersionOverrides-Elements> im Manifest ein ExtendedOverrides-Element hinzu. Legen Sie das Url Attribut auf die vollständige URL einer JSON-Datei fest. Es folgt ein Beispiel für das einfachste mögliche <ExtendedOverrides-Element> .

    ...
    </VersionOverrides>  
    <ExtendedOverrides Url="https://contoso.com/addin/extended-overrides.json"></ExtendedOverrides>
</OfficeApp>

Es folgt ein Beispiel für eine sehr einfache JSON-Datei mit erweiterten Außerkraftsetzungen. Die Tastenkombination STRG+UMSCHALT+A wird einer (an anderer Stelle definierten) Funktion zugewiesen, die den Aufgabenbereich des Add-Ins öffnet.

{
    "actions": [
        {
            "id": "SHOWTASKPANE",
            "type": "ExecuteFunction",
            "name": "Show task pane for add-in"
        }
    ],
    "shortcuts": [
        {
            "action": "SHOWTASKPANE",
            "key": {
                "default": "CTRL+SHIFT+A"
            }
        }
    ]
}

Lokalisieren der erweiterten Außerkraftsetzungsdatei

Wenn Ihr Add-In mehrere Gebietsschemas unterstützt, können Sie das ResourceUrl -Attribut des <ExtendedOverrides-Elements> verwenden, um Office auf eine Datei lokalisierter Ressourcen zu verweisen. Es folgt ein Beispiel.

    ...
    </VersionOverrides>  
    <ExtendedOverrides Url="https://contoso.com/addin/extended-overrides.json" 
                       ResourceUrl="https://contoso.com/addin/my-resources.json">
    </ExtendedOverrides>
</OfficeApp>

Weitere Informationen zum Erstellen und Verwenden der Ressourcendatei, zum Verweisen auf die zugehörigen Ressourcen in der Datei mit erweiterten Außerkraftsetzungen und zu zusätzlichen Optionen, die hier nicht erläutert werden, finden Sie unter Lokalisieren erweiterter Außerkraftsetzungen.