Registrieren Sie Ihren Connector beim Connector-Entwicklerdashboard in Office.

  • Artikel

Das Erstellen eines Office-Connectors für Ihre Anwendung ist ganz einfach. Alles, was Sie tun müssen, ist, Ihren Connector in unserem Entwicklerportal zu registrieren, Ihrer Anwendung eine integrierte Konfigurationsoberfläche hinzuzufügen und Ihren Connector zu implementieren. Durch eine Veröffentlichung in unserem Katalog können Sie es Ihren Benutzern einfacher machen, den Connector zu finden.

Erstellen Ihres eigenen Connectors

Registrieren des Connectors

Besuchen Sie das Connector Developer Portal , und melden Sie sich mit Ihren Microsoft 365-Anmeldeinformationen an. Wenn Sie nicht über einen Microsoft 365-Mandanten verfügen, können Sie sich über das Microsoft 365-Entwicklerprogramm für einen mandantenfähigen Mandanten qualifizieren. Weitere Informationen finden Sie in den häufig gestellten Fragen. Alternativ können Sie sich für eine kostenlose 1-monatige Testversion registrieren oder einen Microsoft 365-Plan erwerben.

Wählen Sie Neuer Connector aus, und füllen Sie das Formular aus. Nachdem Sie Speichern ausgewählt haben, werden neue Optionen auf der Seite angezeigt.

  • Über die Schaltfläche Querladen in Outlook wird der Connector vorübergehend auf der Outlook-Benutzeroberfläche des angemeldeten Benutzers hinzugefügt. Dieser Benutzer kann den Connector entweder im Posteingang oder in einer Gruppe konfigurieren, bei der er Mitglied ist.
  • Über die Schaltfläche Im Store veröffentlichen wird der Veröffentlichungsvorgang gestartet, darunter die Überprüfung von Microsoft für die Listung im Store.

Hinzufügen einer integrierten Konfigurationserfahrung

Mit einer integrierten Konfigurationsbenutzeroberfläche können Benutzer den Connector konfigurieren, ohne Outlook verlassen zu müssen. Ihre Anwendung stellt die Konfiguration als Webseite bereit, die die Microsoft Teams-JavaScript-Bibliothek für die Kommunikation des Konfigurationsstatus an Outlook nutzt.

Einzelheiten hierzu finden Sie unter Integrieren der Konfigurationsbenutzeroberfläche.

Hinweis

Das Dokument Integrieren der Konfigurationsbenutzeroberfläche gilt spezifisch für Microsoft Teams, die Methoden in dem Dokument gelten jedoch auch für Outlook.

Outlook-spezifische Konfigurationsanforderungen

Wenn Ihre Konfigurationsbenutzeroberfläche eine Authentifizierung erfordert, gibt es weitere Anforderungen zum Aktivieren des Authentifizierungsflusses in Outlook unter Windows.

Outlook unter Windows übergibt einen zusätzlichen Abfrageparameter an die Authentifizierungsstartseite für Connectors.

callbackUrl=<connectors url>

Ihre App muss diesen Wert beibehalten und als zusätzlichen Parameter an die microsoftTeams.authentication.notifySuccess- oder microsoftTeams.authentication.notifyFailure-Methoden übergeben, sobald die Authentifizierung abgeschlossen ist.

microsoftTeams.authentication.notifySuccess(result, callbackUrl);

Veröffentlichen Ihres Connectors im Store

Nachdem Sie Ihren Connector gründlich getestet haben und bereit ist, im Office-Connectorkatalog aufgeführt zu werden, können Sie die Schaltfläche Im Store veröffentlichen verwenden, um ihn zur Überprüfung zu übermitteln. Nach Überprüfung und Genehmigung wird der Connector dem Connectorkatalog hinzugefügt.

Übermittlungscheckliste für den Connector

  • Stellen Sie sicher, dass der Connector voll funktionsfähig ist und sorgfältig getestet wurde, bevor Sie ihn an den Store übermitteln.
  • Testen Sie Ihre Connectorkarten in verschiedenen Clients, auf denen die Benutzer sie verwenden würden: Outlook im Web, Outlook 2016 oder höher und Mobile Outlook Groups-Apps.
  • Stellen Sie sicher, dass Sie zur Textdekoration ausschließlich Markdown verwenden und keine HTML in der Nutzlast der Connectorkarte senden.
  • Behalten Sie ein Gleichgewicht zwischen Mehrwert und zu viel Rauschen bei. Stellen Sie sicher, dass der Benutzer nicht durch zu viele Benachrichtigungen blockiert wird.
  • Identifizieren Sie die richtigen Ereignisse, für die Sie Connectorkarten senden. Stellen Sie sicher, dass die Informationen, die Sie an die Gruppe senden, für die Mitglieder der Gruppe hilfreich sind.
  • Verwenden Sie beim Senden von Berichten oder Zusammenfassungen ein Digestformat, und ermöglichen Sie dem Benutzer, die Uhrzeit und die Häufigkeit der Berichte auszuwählen.
  • Setzen Sie beim Senden von Connectorkarten Markdown richtig ein, um wichtige Teile der Karte hervorzuheben.
  • Sorgen Sie dafür, dass Ihre Connectorkarten umsetzbar sind, indem Sie, wann immer möglich, relevante Aktionen bereitstellen.
  • Aufgerufene Aktionen sollten eine wirklich niedrige Fehlerrate und eine schnelle Antwort durch Ihren Endpunkt aufweisen.
  • Stellen Sie sicher, dass der Benutzer die Konfiguration anhalten oder entfernen kann.
  • Sorgen Sie dafür, dass Sie eine klare, an den Benutzer gerichtete Dokumentation zu den Funktionen, die der Connector bietet, bereitstellen.
  • Beim Registrieren des Connectors:
    • Stellen Sie sicher, dass der Name und das Logo des Connectors keinen Verstoß gegen ein Markenzeichen oder ein Urheberrecht eines anderen Produkts oder Diensts darstellen.
    • Stellen Sie ein qualitativ hochwertiges Logo vom Typ „jpg“, „jpeg“, „png“ oder „gif“ bereit, das nicht größer als 60 KB ist.
    • Geben Sie eine kurze Beschreibung der Anwendung ein (z. B. „Contoso-Helpdesk vereint Firmen und Kunden“).
    • Stellen Sie eine ausführliche Beschreibung des Connectors bereit (z. B. „Der Connector des Contoso-Helpdesks benachrichtigt Ihre Office 365-Gruppe bei Aktivitäten bei den Tickets Ihrer Kunden“).
  • Beim Veröffentlichen des Connectors im Store:
    • Füllen Sie die schrittweisen Anweisungen aus, und teilen Sie uns die Testkontoinformationen mit, damit wir Ihren Connector testen können.

Nächste Schritte

  • Wenn Sie Fragen haben, Hilfe benötigen oder ein Problem mit Ihrem Code auftritt, wenden Sie sich an die Entwicklercommunity auf Microsoft Q&A.
  • Sie können Ihre Fragen oder Probleme auch auf Stack Overflowposten. Markieren Sie Ihre Fragen gemäß der relevanten Technologie:
  • Wenn Sie eine Funktion vorschlagen möchten, posten Sie Ihre Idee in unserem Microsoft 365 Developer Platform Ideas Forum, und stimmen Sie dort für Vorschläge ab.