Grundlegendes zum Anpassen von Office-Add-Ins
Auf der Office-Add-Ins-Plattform können Sie Ihr Add-In anpassen. In diesem Modul erfahren Sie, wie Sie Ihr Add-In anpassen, indem Sie den Status beibehalten, und die Fluent-Benutzeroberfläche und Microsoft Graph verwenden. Am Ende dieses Moduls sollten Sie wissen, wie Sie Office-Add-Ins mit beibehaltenem Status, die Fluent-Benutzeroberfläche und Microsoft Graph anpassen können.
Grundlegendes zu den Optionen für das Beibehalten von Status und Einstellungen
Die Office-Add-Ins-Plattform bietet Ihrem Add-In mehrere Möglichkeiten, den Status und die Einstellungen beizubehalten. Ihre Optionen sind von den Office-Anwendungen abhängig, die unterstützt werden sollen, und vom Typ des Add-Ins, das Sie entwickeln möchten.
Optionen zum Beibehalten von Status und Einstellungen
Die Office JavaScript-API bietet Objekte für Ihr Add-In, um den Status über Benutzersitzungen hinweg beizubehalten. In der folgenden Tabelle sind die Optionen sowie die unterstützten Add-In-Typen und Office-Hostanwendungen aufgeführt.
Office API-Objekt | Unterstützte Add-In-Typen | Unterstützte Office-Hosts | Speicherinformationen |
---|---|---|---|
CustomProperties | MailApp | Outlook | Elementdaten werden in der Nachricht oder dem Termin gespeichert, die/der vom Add-In bearbeitet wird.* |
CustomXmlParts | TaskPaneApp | Excel (hostspezifische Excel-JavaScript-API), Word (allgemeine Office-JavaScript-API) |
Die Daten werden in einem eigenen XML-Teil des Dokuments oder der Arbeitsmappe gespeichert. |
RoamingSettings | MailApp | Outlook | Die Daten werden im Exchange-Postfach des Benutzers gespeichert und dem jeweiligen Add-In zugeordnet.* |
Einstellungen | ContentApp, TaskPaneApp | Excel, PowerPoint, Word | Die Daten werden in dem Dokument, der Arbeitsmappe oder der Präsentation gespeichert, das/die von dem Add-In bearbeitet wird.* |
* Daten, die in einem Eigenschaftenbehälter in Name/Wert-Paaren gespeichert sind
Sie können auch HTML5-Webspeicher sowie andere Methoden verwenden, die über das zugrunde liegende Browsersteuerelement des Add-Ins verfügbar sind.
Wichtig
Speichern Sie keine Kennwörter und personenbezogene Informationen (PII) auf dem Gerät des Benutzers.
Grundlegendes zur Fluent-Benutzeroberfläche in Office-Add-Ins
Beim Erstellen des Add-Ins sind bei der Benutzeroberflächengestaltung viele Faktoren zu berücksichtigen. Die Fluent-Benutzeroberfläche enthält Elemente, die dem Office-Branding entsprechen, sodass Ihr Add-In wie eine natürliche Erweiterung von Office aussieht.
Hinweis
Die Verwendung von UI Fabric ist optional, wird jedoch empfohlen.
Informationen zur Fluent-Benutzeroberfläche
Die Fluent-Benutzeroberfläche hat zwei (2) Hauptbereiche:
- Fabric Core: umfasst grundlegende Elemente, z. B. Schriftart, Symbole und Farben.
- Fabric React-Komponenten: umfasst neben Fabric Core-Elementen unter anderem Eingabe-, Navigations- und Benachrichtigungskomponenten.
Fabric Core
Fabric Core umfasst grundlegende Designelemente, die dem Office-Branding entsprechen oder damit synchronisiert werden.
Um mit der Verwendung von Fabric Core zu beginnen, verweisen Sie darauf im CSS auf Ihrer HTML-Seite, wie im folgenden Code dargestellt:
<link rel="stylesheet" href="https://static2.sharepointonline.com/files/fabric/office-ui-fabric-core/9.6.1/css/fabric.min.css">
Sie können dann Fabric-Symbole, -Schriftarten und -Farben verwenden. Das folgende Beispiel zeigt, wie Sie ein extra großes Tabellensymbol in der primären Designfarbe der Office-Anwendung einschließen können.
<i class="ms-Icon ms-font-xl ms-Icon--Table ms-fontColor-themePrimary"></i>
Fabric-Komponenten
Fabric React bietet UX-Komponenten für Eingabe, Navigation, Benachrichtigung und andere Kategorien. Es basiert auf und umfasst Fabric Core.
Dies sind die Komponenten, deren Verwendung in Ihrem Add-In empfohlen wird:
- Breadcrumb
- Schaltfläche
- Kontrollkästchen
- ChoiceGroup
- Dropdown
- Label
- List
- Pivot
- TextField
- Umschaltfläche
Tipp
Sie können den Yeoman-Generator für Office-Add-Ins verwenden, um ein Projekt zu erstellen, das auf Fabric React verweist. Ein verfügbarer Projekttyp ist das Office Add-In-Aufgabenbereich-Projekt unter Verwendung des React-Frameworks.
Verstehen, wann und wie Microsoft Graph in Office-Add-Ins verwendet wird
Das Add-In kann eine Verbindung mit Microsoft Graph herstellen und auf die Daten des Benutzers zugreifen, damit sich nützlichere und produktivere Szenarios ergeben. Mögliche Aufgaben sind z. B.:
- Auslesen von Dateien von OneDrive
- Abrufen von E-Mail-Anlagen
- Abrufen des Benutzerprofils
Was spricht für die Verwendung der Microsoft Graph?
Die REST-APIs für Microsoft Graph ermöglichen es Ihrem Add-In, auf die Daten eines Benutzers in Diensten wie den folgenden zuzugreifen:
- Microsoft Entra-ID
- Microsoft 365-Dienste
- Enterprise Mobility and Security-Dienste
- Windows 10-Dienste
- Dynamics 365
Autorisierungen für Microsoft Graph erteilen
Zum Herstellen einer Verbindung mit Microsoft Graph muss das Add-In Folgendes ausführen bzw. dazu berechtigt sein:
- Den Benutzer authentifizieren
- Berechtigt sein, im Namen des Benutzers zu handeln
Authentifizierung
Das Add-In kann ein Zugriffstoken von microsoft Entra ID abrufen, wenn sich der Benutzer angemeldet hat. Microsoft Entra ID lässt das Öffnen der Anmeldeseite in einem iframe nicht zu, und der Add-In-Aufgabenbereich ist ein iframe, wenn das Add-In in Office im Web gestartet wird. Verwenden Sie daher die Office JavaScript-Dialog-API, um das Microsoft Entra-Anmeldeformular anzuzeigen. Wenn das Add-In benutzerdefinierte Funktionen enthält, für die eine Autorisierung von Microsoft Graph erforderlich ist, verwenden Sie zum Anzeigen des Anmeldefensters die Dialog-API für benutzerdefinierte Funktionen.
Autorisierung
Nachdem sich der Benutzer angemeldet hat, erhält Ihr Add-In ein Zugriffstoken, das in späteren API-Aufrufen an Microsoft Graph verwendet werden kann. Das Zugriffstoken kann dem Add-In niemals mehr oder umfangreichere Berechtigungen erteilen, als der Benutzer hat. Benutzer verfügen in der Regel nur über Berechtigungen für Daten über sie selbst, für ihre eigenen Dateien und E-Mails sowie für Objekte, die für sie freigegeben wurden. Wenn das Add-In Microsoft Graph-Daten zu mehreren Benutzer abruft, ist dessen Verwendung nur Benutzern mit Berechtigungen auf Administratorebene möglich.
Empfohlene Bibliotheken
Je nach Ihren Entwicklungsentscheidungen können Sie bei Bedarf eine der folgenden Bibliotheken zur Authentifizierung und Autorisierung verwenden.
- Wenn sich Ihre Serverseite in einem .NET-basierten Framework (z. B. .NET Core oder ASP.NET) befindet: Verwenden Sie MSAL.NET.
- Ihre Serverseite ist node.js-basiert: Verwenden Sie Passport Microsoft Entra ID.
- Wenn Ihr Add-in den impliziten Fluss verwendet: Verwenden Sie msal.js.
Zusammenfassung
Auf der Office-Add-Ins-Plattform können Sie Ihr Add-In anpassen. In diesem Modul haben Sie erfahren, wie Sie das Add-In anpassen können, indem Sie den Status beibehalten und die Fluent-Benutzeroberfläche und Microsoft Graph verwenden. Am Ende dieses Moduls sollten Sie wissen, wie Sie Office-Add-Ins mit beibehaltenem Status, die Fluent-Benutzeroberfläche und Microsoft Graph anpassen können.