Grundlegendes zu Office-Add-Ins

Abgeschlossen

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">.
• Kontextmenü-Element
  • Wichtigste Manifest-Einstellung: <ExtensionPoint xsi:type="ContextMenu">.

Ü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">.
• Eine Nachricht verfasst.
  • Wichtigste Manifest-Einstellung: <ExtensionPoint xsi:type="MessageComposeCommandSurface">.
• Als Organisator einen Termin oder eine Besprechung erstellt oder anzeigt.
  • Wichtigste Manifest-Einstellung: <ExtensionPoint xsi:type="AppointmentOrganizerCommandSurface">.
• Als Teilnehmer eine Besprechung anzeigt.
  • Wichtigste Manifest-Einstellung: <ExtensionPoint xsi:type="AppointmentAttendeeCommandSurface">.

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

Grundlegende Konzepte zu Office-Add-Ins

1.

Welche der folgenden Aussagen ist in Bezug auf Office-Add-Ins wahr?

Add-Ins können nur in Office unter Windows, Mac und iPad/iOS ausgeführt werden.

Microsoft 365 Administratoren können die zentrale Bereitstellung verwenden, um Add-Ins organisationsweit bereitzustellen.

Ein Entwickler veröffentlicht sein Add-In in AppSource, um es vor der Öffentlichkeit zu verbergen.

2.

Der Benutzer muss sich anmelden, um in einer Office-Anwendung auf die Add-In-Funktionen zugreifen zu können. Welches Feature der Office Add-In-Plattform sollte der Entwickler anzeigen, um den Anmeldevorgang zu vereinfachen?

Add-In-Befehl

Benutzerdefinierte Funktion

Dialogfeld

3.

Welche Datei definiert die Einstellungen und Funktionen eines Office Add-Ins?

Dialogdatei

Manifestdatei

Datei "Web.config"

Sie müssen alle Fragen beantworten, bevor Sie Ihre Arbeit überprüfen können.