Bewährte Methoden für die Entwicklung von Office-Add-Ins

Artikel
07/19/2024

Effektive Add-Ins bieten eine einzigartige und überzeugende Funktionalität, die Office-Anwendungen auf visuell ansprechende Weise erweitert. Stellen Sie eine ansprechende Benutzeroberfläche für die Benutzer zum Erstellen eines großartigen Add-Ins bereit, entwerfen Sie eine erstklassigen Benutzeroberfläche und optimieren Sie die Add-In-Leistung. Wenden Sie die in diesem Artikel beschriebenen bewährten Methoden zum Erstellen von Add-Ins an, mit denen die Benutzer ihre Aufgaben schnell und effizient durchführen können.

Hinweis

Wenn Sie beabsichtigen, das Add-In in AppSource zu veröffentlichen und in der Office-Benutzeroberfläche zur Verfügung zu stellen, stellen Sie sicher, dass die Zertifizierungsrichtlinien für den kommerziellen Marketplace erfüllt sind. Damit das Add-In die Validierung besteht, muss es beispielsweise auf allen Plattformen funktionieren, die die Methoden unterstützen, die Sie definieren (weitere Informationen finden Sie im Abschnitt 1120.3 und auf der Seite zur Verfügbarkeit von Office-Add-Ins auf Anwendungen und Plattformen).

Angeben eines klaren Nutzens

Erstellen Sie Add-Ins, mit denen Benutzer Aufgaben schnell und effizient erledigen können. Konzentrieren Sie sich auf Szenarios, die für Office-Anwendungen sinnvoll sind. Beispiel:
- Erledigen Sie wichtige Aufhaben schneller und einfacher und mit weniger Unterbrechungen.
- Ermöglichen Sie neue Szenarios in Office.
- Betten Sie ergänzende Dienste in Office-Anwendungen ein.
- Verbessern Sie die Office-Benutzeroberfläche, um die Produktivität zu erhöhen.
Stellen Sie sicher, dass der Wert Ihres Add-Ins für Benutzer sofort klar ist, indem Sie eine ansprechende Erstausführungserfahrung schaffen.
Erfahren Sie, wie Sie einen effektiven AppSource-Eintrag erstellen, um Ihr Add-In zu bewerben.
- Machen Sie die Vorteile Ihres Add-in im Titel und in der Beschreibung deutlich. Verlassen Sie sich nicht darauf, dass Ihre Marke kommuniziert, wie Ihr Add-In funktioniert.
- Ihr Add-In muss einen ausreichenden Wert bieten, um die Investition der Benutzer zu rechtfertigen. Ihr Add-In sollte kein einfaches Hilfsprogramm oder von eingeschränktem Umfang sein.
- Wenn Ihr Add-In auf größere Organisationen und Unternehmen ausgerichtet ist, unterscheiden sich mehrere AppSource-Anforderungen von denen eines add-ins für den allgemeinen kommerziellen Marketplace. Weitere Informationen finden Sie in den häufig gestellten Fragen zur Übermittlung.

Erstellen Sie einer ansprechenden Benutzeroberfläche

Locken Sie neue Benutzer mit einer einfach zu verwendenden und intuitiven Benutzeroberfläche. Beachten Sie, dass Benutzer noch beim Herunterladen des Add-Ins entscheiden, ob Sie es überhaupt verwenden sollen.
Kommunizieren Sie deutlich die Schritte, die die Benutzer ausführen müssen, um Ihr Add-In zu verwenden. Verwenden Sie Videos, Unterlagen, Seitenbereiche und andere Ressourcen, um Benutzer anzulocken.
Verstärken Sie das Werteversprechen des Add-Ins beim Start anstatt die Benutzer lediglich zum Anmelden aufzufordern.
Stellen Sie für Benutzer eine anpassbare Benutzeroberfläche bereit.
Wenn das Inhalts-Add-in an Daten im Dokument des Benutzers gebunden ist, fügen Sie Beispieldaten oder eine Vorlage ein, damit Benutzer das zu verwendende Datenformat sehen können.
Bieten Sie kostenlose Testversionen an. Wenn für Ihr Add-In ein Abonnement erforderlich ist, stellen Sie einige Funktionen ohne Abonnement zur Verfügung.
Vereinfachen Sie die Registrierung. Füllen Sie Vorabinformationen aus, z. B. E-Mail und Anzeigename, und überspringen Sie E-Mail-Überprüfungen.
Vermeiden Sie Popupfenster. Wenn Sie sie verwenden müssen, führen Sie den Benutzer an, ihr Popupfenster zu aktivieren.

Muster, die Sie beim Entwickeln Ihrer Umgebung für das erste Ausführen anwenden können, finden Sie unter UX-Entwurfsmuster für Office-Add-Ins.

Verwenden von Add-In-Befehlen

Geben Sie relevante Einstiegspunkte der Benutzeroberfläche für das Add-in Add-In-Befehle mit. Details, einschließlich der bewährte Methoden, finden Sie unter Add-In-Befehle.

Anwenden von UX-Entwurfsprinzipien

Stellen Sie sicher, dass das Design und die Funktionalität des Add-Ins die Office-Benutzeroberfläche ergänzt. Weitere Informationen finden Sie unter Entwerfen der Benutzeroberfläche von Office-Add-Ins.
Ziehen Sie Inhalt Chrom vor. Vermeiden Sie überflüssige Benutzeroberflächenelemente, die keinen Nutzen für die Benutzeroberfläche mit sich bringen.
Überlassen Sie Benutzern das Steuern. Stellen Sie sicher, dass Benutzer wichtige Entscheidungen verstehen und Aktionen auf einfache Weise rückgängig machen können, die das Add-In ausführt.
Verwenden Sie Branding, um die Vertrauenswürdigkeit zu fördern und damit sich Benutzer besser orientieren können. Verwenden Sie branding nicht, um Benutzer zu überlasten oder zu werben.
Vermeiden Sie das Scrollen. Optimieren Sie das Design für die Auflösung von 1366x768.
Schließen Sie keine nicht lizenzierten Bilder ein.
Verwenden Sie eine klare und einfache Sprache im Add-In.
Eingabehilfen – Ermöglichen Sie allen Benutzern eine einfache Interaktion mit Ihrem Add-In, und integrieren Sie Eingabehilfstechnologien wie die Sprachausgabe.
Entwerfen Sie für alle Plattformen und Eingabemethoden, einschließlich Tastatur, Maus und Toucheingabe. Stellen Sie sicher, dass Ihre Benutzeroberfläche auf verschiedenen Formfaktoren reagiert.

Optimierung für Toucheingabe

Verwenden Sie die Context.touchEnabled-Eigenschaft , um zu ermitteln, ob die Office-Anwendung, auf der Ihr Add-In ausgeführt wird, touchfähig ist.

Hinweis

Diese Eigenschaft wird in Outlook nicht unterstützt.
Stellen Sie sicher, dass alle Steuerelemente für die Toucheingabe entsprechend angepasst sind. Schaltflächen haben beispielsweise ausreichende Touchziele, und Eingabefelder sind groß genug.
Verlassen Sie sich nicht auf Eingabemethoden ohne Toucheingabe, z. B. darauf zeigen oder mit der rechten Maustaste klicken.
Stellen Sie sicher, dass das Add-In im Hoch- und Querformat funktioniert. Beachten Sie, dass auf Touchgeräten ein Teil des Add-Ins aufgrund der Bildschirmtastatur möglicherweise ausgeblendet ist.
Testen Sie das Add-In auf einem echten Gerät mit Querladen.

Hinweis

Wenn Sie Fluent UI React für Ihre Designelemente verwenden, sind viele dieser Elemente in das Designsystem integriert.

Optimieren und Überwachen der Add-In-Leistung

Schnelle Benutzeroberflächenantworten. Das Add-In sollte in 500 ms oder weniger geladen werden.
Stellen Sie sicher, dass innerhalb von weniger als einer Sekunde eine Reaktion auf alle Benutzerinteraktionen folgt.
Stellen Sie Ladeanzeigen bei lang andauernden Vorgängen bereit.
Verwenden Sie ein Content Delivery Network (CDN), um Images, Ressourcen und allgemeine Bibliotheken zu hosten. Laden Sie so viel wie möglich von einem zentralen Ort.
Befolgen Sie die standardmäßigen Webmethoden zur Optimierung Ihrer Webseite. Verwenden Sie in der Produktion nur kleinere Versionen der Bibliotheken. Laden Sie nur Ressourcen, die Sie benötigen, und optimieren Sie die Ladevorgänge dieser Ressourcen.

Wenn Vorgänge länger andauern, kommunizieren Sie dies dem Benutzer. Beachten Sie die in der folgenden Tabelle aufgeführten Schwellenwerte. Weitere Informationen finden Sie unter Ressourcengrenzen und Leistungsoptimierung für Office Add-Ins

Interaktionsklasse	Ziel	Obergrenze	Menschlichen Wahrnehmung
Direkt	<=50 ms	100 ms	Ohne spürbaren Verzögerung.
Schnell	50-100 ms	200 ms	Minimal spürbare Verzögerung. Kein Feedback erforderlich.
Typisch	100-300 ms	500 ms	Schnell, aber zu langsam, um als schnell beschrieben zu werden. Kein Feedback erforderlich.
Reaktionsfähig	300-500 ms	1 Sekunde	Nicht schnell, aber dennoch reaktionsfähig. Kein Feedback erforderlich.
Fortlaufend.	>500 ms	5 Sekunden	Mittlere Wartezeit, ist nicht mehr reaktionsfähig. Möglicherweise Feedback erforderlich.
Erfassung	>500 ms	10 Sekunden	Lange, aber nicht lange genug, um etwas anderes zu tun. Möglicherweise Feedback erforderlich.
Erweitert	>500 ms	>10 Sekunden	Lange genug, um beim Warten etwas anderes zu tun. Möglicherweise Feedback erforderlich.
Lange ausgeführt	>5 Sekunden	>1 Minute	Benutzer tun in der Zwischenzeit mit Sicherheit etwas anderes tun.

Überwachen Sie den Dienststatus, und verwenden Sie Telemetrie, um erfolgreiche Benutzerausführungen zu überwachen.
Minimieren Sie den Datenaustausch zwischen dem Add-In und dem Office-Dokument. Weitere Informationen finden Sie unter Vermeiden der Verwendung der context.sync-Methode in Schleifen.

Veröffentlichen und Vermarkten Ihres Add-Ins

Erstellen Sie ein effektives AppSource-Angebot.
- Verwenden Sie kurze und prägnante beschreibende Add-In-Titel. Verwenden Sie nicht mehr als 128 Zeichen.
- Schreiben Sie kurze, überzeugende und genaue Beschreibungen Ihres Add-Ins. Verlassen Sie sich nicht auf die Marke.
- Vermitteln Sie das Wertversprechen des Add-Ins im Titel und der Beschreibung. Verlassen Sie sich nicht auf die Marke.
Erstellen Sie eine Website, damit die Benutzer das Add-In leichter finden und verwenden können.
Veröffentlichen Sie Ihr Add-In in AppSource. Befolgen Sie unbedingt die Prüfliste und den Übermittlungsleitfaden für die AppSource-Vorabveröffentlichung.
- Stellen Sie sicher, dass Ihr Add-In auf allen Betriebssystemen, Browsern und Geräten fehlerfrei funktioniert, die von der mindestanzahl von APIs unterstützt werden, die in Ihrem Add-In-Manifest deklariert werden.
- Stellen Sie detaillierte Testanweisungen und Ressourcen für Zertifizierungsprüfer bereit, um die Funktionalität Ihres Add-Ins zu überprüfen.
Bewerben Sie Ihr Add-In von Ihrer Website aus.

Wichtig

Wenn Ihr Add-In auf größere Organisationen und Unternehmen ausgerichtet ist, unterscheiden sich mehrere AppSource-Anforderungen von denen eines add-ins für den allgemeinen kommerziellen Marketplace. Weitere Informationen finden Sie in den häufig gestellten Fragen zur Übermittlung.

Unterstützung älterer Microsoft-Webviews und Office-Versionen (empfohlen, aber nicht erforderlich)

Weitere Informationen finden Sie unter Unterstützen älterer Microsoft-Webviews und Office-Versionen.

Freigeben über