Grundlegendes zu Office-Add-Ins
Die Office-Add-Ins-Plattform ermöglicht Ihnen, die Funktionen von Office-Anwendungen zu erweitern. In dieser Lerneinheit befassen Sie sich mit verschiedenen Möglichkeiten, wie Sie mithilfe von Add-Ins Office-Anwendungen erweitern und mit diesen interagieren können. Außerdem erfahren Sie, wie Sie Ihr Add-In mithilfe seiner Manifestdatei konfigurieren können.
Grundlegendes zu Aufgabenbereich- und Inhalts-Add-Ins
Office-Add-Ins bieten mehrere Optionen für die Interaktion Ihrer Lösung mit einer Office-Anwendung. In dieser Lerneinheit befassen wir uns mit zwei dieser Optionen:
- Aufgabenbereich
- Inhalt
Aufgabenbereich-Add-Ins
Aufgabenbereich-Add-Ins ermöglichen Benutzerinteraktionen über einen Bereich, der innerhalb einer Office-Anwendung angezeigt wird. Über die Benutzeroberfläche des Aufgabenbereichs können Sie dem Benutzer das Ändern von Dokumenten oder E-Mails, das Anzeigen von Daten aus einer Datenquelle und vieles mehr ermöglichen. In der folgenden Abbildung ist der Aufgabenbereich der Bereich, der rechts neben dem Dokument angezeigt wird.
Aufgabenbereich-Add-In, das innerhalb einer Office-Anwendung angezeigt wird
In neueren Word-, Excel- und PowerPoint-Versionen können Sie den Aufgabenbereich so konfigurieren, dass er automatisch angezeigt wird, wenn ein Benutzer eine Datei öffnet. Der Benutzer muss zuerst das Add-In installiert haben, damit dieses Verhalten aktiviert werden kann.
Definieren des Typs des Aufgabenbereich-Add-Ins
Wie zuvor beschrieben, sind in der Manifestdatei eines Office-Add-Ins dessen Einstellungen und Funktionen angegeben.
Wenn Sie ein Add-In als Aufgabenbereich-Add-In für eine beliebige Office-Anwendung außer Outlook konfigurieren möchten, legen Sie innerhalb des OfficeApp-Elements der Manifestdatei das Attribut xsi:type auf TaskPaneApp fest, wie im folgenden Beispiel gezeigt.
<OfficeApp
...
xsi:type="TaskPaneApp">
...
</OfficeApp>
Wenn Sie ein Add-In für Outlook konfigurieren möchten, legen Sie im OfficeApp-Element der Manifestdatei das Attribut xsi:type auf MailApp fest, wie im folgenden Beispiel gezeigt.
<OfficeApp
...
xsi:type="MailApp">
...
</OfficeApp>
Inhalts-Add-Ins
Inhalts-Add-Ins können verwendet werden, um ein Objekt in eine Excel-Kalkulationstabelle oder eine PowerPoint-Präsentation einzufügen. Bei diesem Objekt kann es sich um eine webbasierte Datenvisualisierung, Medien oder andere externe Inhalte handeln. In der folgenden Abbildung wird das Inhalts-Add-In ungefähr in der Mitte des Dokuments angezeigt.
Inhalts-Add-In, das in einer Office-Anwendung geladen wurde
Definieren des Inhalts-Add-In-Typs
Wie zuvor beschrieben, sind in der Manifestdatei eines Office-Add-Ins dessen Einstellungen und Funktionen angegeben. Wenn Sie ein Add-In als Inhalts-Add-In konfigurieren möchten, legen Sie im OfficeApp-Element der Manifestdatei das Attribut xsi:type auf ContentApp fest, wie im folgenden Beispiel gezeigt.
<OfficeApp
...
xsi:type="ContentApp">
...
</OfficeApp>
Grundlegendes zu Office-Add-Ins-Dialogfeldern
Mit der Office-Add-Ins-Plattform können Sie ein Dialogfeld für Ihre Benutzer anzeigen, um ihnen Folgendes zu ermöglichen:
- Die Anmeldung bei einem integrierten Dienst, z. B. bei einem Microsoft-Konto, Google oder Facebook.
- Die Bestätigung einer Benutzeraktion.
- Die Ausführung eines Vorgangs, für den der Aufgabenbereich eventuell zu beschränkt ist (beispielsweise ein Video anzeigen).
Das Dialogfeldfenster ist nicht modal, d. h., der Benutzer kann weiterhin mit der Office-Anwendung und dem Add-In interagieren, während das Dialogfeld angezeigt wird. In der folgenden Abbildung ist ein in einer Office-Anwendung angezeigtes Dialogfeld dargestellt.
In einer Office-Anwendung angezeigtes Dialogfeld
Grundlegendes zu benutzerdefinierten Funktionen von Office-Add-Ins
Mit Office-Add-Ins können Sie benutzerdefinierte JavaScript- oder TypeScript-Funktionen erstellen, auf die wie auf integrierte Excel-Funktionen wie SUM() zugegriffen werden kann.
In der folgenden Abbildung ist eine benutzerdefinierte Funktion namens SPHEREVOLUME zu sehen, die in Excel eingegeben wird.
In Excel eingegebene benutzerdefinierte Funktion
Das folgende Codebeispiel enthält den JavaScript-Code für die zuvor dargestellte SPHEREVOLUME()-Funktion.
/**
* Returns the volume of a sphere.
* @customfunction
* @param {number} radius
*/
function sphereVolume(radius) {
return (Math.pow(radius, 3) * 4 * Math.PI) / 3;
}
Wo können benutzerdefinierte Funktionen verwendet werden?
Benutzerdefinierte Funktionen sind in Excel auf den folgenden Plattformen verfügbar:
- Windows (in Verbindung mit einem Microsoft 365-Abonnement)
- macOS (in Verbindung mit einem Microsoft 365-Abonnement)
- Webbrowser
Definieren des Add-in-Typs für eine benutzerdefinierte Funktion
Wenn Sie ein Add-In so konfigurieren möchten, dass es die benutzerdefinierte Funktion enthält, sind die wichtigsten Einstellungen im Manifest für Excel-Add-Ins wie folgt:
<OfficeApp
...
xsi:type="TaskPaneApp">
...
<Hosts>
<Host Name="Workbook"/>
</Hosts>
...
<VersionOverrides xmlns="http://schemas.microsoft.com/office/taskpaneappversionoverrides" xsi:type="VersionOverridesV1_0">
<Hosts>
<Host xsi:type="Workbook">
<AllFormFactors>
<ExtensionPoint xsi:type="CustomFunctions">
...
</ExtensionPoint>
</AllFormFactors>
</Host>
</Hosts>
...
</VersionOverrides>
</OfficeApp>
Grundlegendes zu Add-In-Befehlen
Add-In-Befehle sind Elemente der Benutzeroberfläche, die die Office-Benutzeroberfläche erweitern und Aktionen in Ihrem Add-In starten. Sie können Add-In-Befehle verwenden, um eine Schaltfläche zum Menüband oder ein Element zu einem Kontextmenü hinzuzufügen. Wenn Benutzer einen Add-In-Befehl auswählen, starten sie Aktionen wie z. B. die Ausführung von JavaScript-Code oder die Anzeige einer Seite des Add-Ins in einem Aufgabenbereich. Add-In-Befehle helfen Benutzer dabei, Ihr Add-In zu finden und zu verwenden; dies kann die Annahme und Wiederverwendung Ihres Add-Ins verbessern und die Kundenbindung stärken.
Add-In-Befehle in Excel, Word, PowerPoint und OneNote
Sie können ein Add-In so konfigurieren, dass es von einem Benutzer ausgeführt werden kann, indem er Folgendes auswählt:
- Schaltfläche im Menüband oder im Befehls-Überlaufmenü der Office-Anwendung
- Wichtigste Manifest-Einstellung:
<ExtensionPoint xsi:type="PrimaryCommandSurface">.
- Wichtigste Manifest-Einstellung:
- Kontextmenü-Element
- Wichtigste Manifest-Einstellung:
<ExtensionPoint xsi:type="ContextMenu">.
- Wichtigste Manifest-Einstellung:
Über einen Add-In-Befehl kann auch ein Untermenü mit weiteren Befehlen geöffnet werden.
Hinweis
Add-In-Befehle werden von Inhalts-Add-Ins derzeit nicht unterstützt.
In der folgenden Abbildung sind drei Add-In-Befehle (benutzerdefinierte Schaltflächen) zu sehen, die zur Registerkarte Daten des Excel-Menübands hinzugefügt wurden.
Add-in-Befehle in Excel unter Windows
Add-In-Befehle in Outlook
Sie können ein Add-In so konfigurieren, dass es von einem Benutzer ausgeführt werden kann, indem er eine Schaltfläche im Office-Menüband oder im Befehls-Überlaufmenü auswählt, während er:
- Eine Nachricht im Lesebereich oder in einem Popupfenster liest.
- Wichtigste Manifest-Einstellung:
<ExtensionPoint xsi:type="MessageReadCommandSurface">.
- Wichtigste Manifest-Einstellung:
- Eine Nachricht verfasst.
- Wichtigste Manifest-Einstellung:
<ExtensionPoint xsi:type="MessageComposeCommandSurface">.
- Wichtigste Manifest-Einstellung:
- Als Organisator einen Termin oder eine Besprechung erstellt oder anzeigt.
- Wichtigste Manifest-Einstellung:
<ExtensionPoint xsi:type="AppointmentOrganizerCommandSurface">.
- Wichtigste Manifest-Einstellung:
- Als Teilnehmer eine Besprechung anzeigt.
- Wichtigste Manifest-Einstellung:
<ExtensionPoint xsi:type="AppointmentAttendeeCommandSurface">.
- Wichtigste Manifest-Einstellung:
Über einen Add-In-Befehl kann auch ein Untermenü mit weiteren Befehlen geöffnet werden.
In den folgenden Bildern sind drei Add-In-Befehle (benutzerdefinierte Schaltflächen) zu sehen, die dem Menüband in Outlook hinzugefügt wurden. Im ersten Bild wurden die Schaltflächen in einem normalen Status gerendert. Im zweiten Bild wurden die Schaltflächen in einem reduzierten Zustand gerendert.
Add-In-Befehle in Outlook unter Windows
Wo können Add-In-Befehle verwendet werden?
Add-In-Befehle stehen in Excel, Outlook, OneNote, PowerPoint und Word zur Verfügung, wie in der folgenden Tabelle dargestellt.
| Plattform | Office-Hauptversion | Abonnement oder einmaliger Kauf? | Notizen |
|---|---|---|---|
| Windows | Nicht zutreffend | in Verbindung mit dem Microsoft 365-Abonnement | In OneNote nicht verfügbar |
| 2021 | als Einmalkauf | In OneNote nicht verfügbar | |
| 2019 | als Einmalkauf | In OneNote nicht verfügbar | |
| 2016 | als Einmalkauf | Nur verfügbar in Outlook in Exchange 2016 (nach der Veröffentlichung erforderlich) oder höher. In anderen Anwendungen von Office nicht verfügbar. | |
| 2013 | als Einmalkauf | Nur in Outlook in Exchange 2016 oder höher verfügbar. Erfordert Updates nach der Veröffentlichung für Outlook und Exchange 2016. In anderen Office-Anwendungen nicht verfügbar. | |
| MacOS | Nicht zutreffend | in Verbindung mit dem Microsoft 365-Abonnement | In OneNote nicht verfügbar |
| 2021 | als Einmalkauf | In OneNote nicht verfügbar | |
| 2019 | als Einmalkauf | In OneNote nicht verfügbar | |
| 2016 | als Einmalkauf | In OneNote nicht verfügbar | |
| iOS | Nicht zutreffend | in Verbindung mit dem Microsoft 365-Abonnement | Nur in Outlook verfügbar |
| Android | Nicht zutreffend | in Verbindung mit dem Microsoft 365-Abonnement | Nur in Outlook verfügbar |
| Webbrowser | Nicht zutreffend | Nicht zutreffend | Verfügbar in allen unterstützten Office-Anwendungen |
Grundlegendes zum Zweck des Add-In-Manifests
In der XML-Manifestdatei eines Office-Add-Ins sind dessen Einstellungen und Funktionen angegeben. Sie können diese konfigurieren, um zu steuern, wie das Add-In gerendert wird und wie es sich in den ausgewählten Office-Anwendungen verhält.
Was im Manifest angegeben ist
Im Manifest werden wichtige Informationen zum Add-In festgelegt, einschließlich:
- Add-In-Metadaten (z. B. ID, Version, Beschreibung, Anzeigename, Standardgebietsschema).
- Informationen dazu, wie das Add-In in Office integriert wird (z. B. Zielanwendungen, benutzerdefinierte Funktionen, Add-In-Befehle)
- Die Speicherorte der Bilder, die das Add-In für das Branding und Befehlssymbole verwenden soll.
- Berechtigungen, die das Add-In benötigt.
- Maße des Add-Ins (z. B. Standardmaße für Inhalts-Add-Ins und erforderliche Höhe für Outlook-Add-Ins).
- Regeln, die angeben, wann das Add-in in einer Nachricht oder einem Termin aktiviert werden soll (nur Outlook).
Verwendung des Manifests
Ein Add-In-Manifest wird auf folgende Weise verwendet:
- Die Office-Anwendungen, in denen das Add-In ausgeführt wird, verwenden Informationen aus dem Manifest, um die Add-In-Benutzeroberfläche wiederzugeben und benutzerdefinierte Schaltflächen oder Menüeinträge zu verbinden.
- Wenn Sie das Add-In auf AppSource veröffentlichen:
- Informationen aus dem Manifest (Name, Beschreibung, Autor, Logo usw.) werden verwendet, um den App-Eintrag zu erstellen, der potenziellen Kunden in AppSource angezeigt wird.
- Der AppSource-Überprüfungsprozess liest Informationen aus dem Manifest aus und überprüft, ob das Add-In auf den erwarteten Plattformen ausgeführt wird.
Zusammenfassung
Die Office-Add-Ins-Plattform ermöglicht Ihnen, die Funktionen von Office-Anwendungen zu erweitern. In diesem Modul haben Sie sich mit verschiedenen Möglichkeiten befasst, wie Sie mithilfe von Add-Ins Office-Anwendungen erweitern und mit diesen interagieren können. Außerdem haben Sie erfahren, wie Sie Ihr Add-In mithilfe seiner Manifestdatei konfigurieren können.