Registrieren Sie Ihren Connector beim Connector-Entwicklerdashboard in Office 365.Register your connector with the Office 365 Connectors developer dashboard

Die Erstellung eines Office 365-Connectors für Ihre Anwendung ist einfach. Sie müssen lediglich den Connector in unserem Entwicklerportal registrieren und eine integrierte Konfigurationserfahrung für Ihre Anwendung hinzufügen und den Connector implementieren. Benutzer können den Connector problemlos finden, wenn Sie ihn in unserem Katalog veröffentlichen.Building an Office 365 Connector for your application is easy. All you need to do is register your connector in our developer portal, add a Connect to Office 365 button to your application and implement your connector. Once you add a Connect button to your application, your users are able to use it to authorize their Office 365 Groups or Inbox to receive your actionable message cards. You can make it easy for your users to discover the connector by publishing to our catalog.

Erstellen Ihres eigenen ConnectorsBuild your own Connector

Registrieren des ConnectorsRegistering your Connector

Besuchen Sie das Connector-Entwicklerportal, und melden Sie sich mit Ihren Office 365-Anmeldeinformationen an.Visit the Connector Developer Portal and login with your Office 365 credentials. Wenn Sie nicht über ein Office 365-Abonnement verfügen, können Sie ein KOSTENLOSES Office 365-Abonnement für ein Jahr unter dem Office 365-Entwicklerprogramm abschließen.You'll need an Office 365 subscription to proceed. If you do not have an Office 365 subscription you can get a one year FREE Office 365 Subscription under the Office 365 Developer Program. Alternately, if you have an existing MSDN subscription, you can activate your free Office 365 benefit.

Wählen Sie Neuer Connector aus, und füllen Sie das Formular aus.Choose New Connector and fill out the form. Nachdem Sie Speichern ausgewählt haben, werden neue Optionen auf der Seite angezeigt.Once you choose Save, new options appear on the page.

  • Über die Schaltfläche Querladen in Outlook wird der Connector vorübergehend auf der Outlook-Benutzeroberfläche des angemeldeten Benutzers hinzugefügt.The Sideload to Outlook button will temporarily add your connector into the logged on user's Outlook experience. Dieser Benutzer kann den Connector entweder im Posteingang oder in einer Gruppe konfigurieren, bei der er Mitglied ist.That user will be able to configure the connector either in their inbox or on any group that user is a member of.
  • Ü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.The Publish to Store button will start the publish process, including review by Microsoft for listing in the store.

Hinzufügen einer integrierten KonfigurationserfahrungAdding an integrated configuration experience

Mit einer integrierten Konfigurationsbenutzeroberfläche können Benutzer den Connector konfigurieren, ohne Outlook verlassen zu müssen.An integrated configuration experience allows the user to configure your connector without leaving Outlook. Ihre Anwendung stellt die Konfiguration als Webseite bereit, die die Microsoft Teams-JavaScript-Bibliothek für die Kommunikation des Konfigurationsstatus an Outlook nutzt.Your application exposes the configuration as a web page that utilizes the Microsoft Teams JavaScript library to communicate configuration status back to Outlook.

Einzelheiten hierzu finden Sie unter Integrieren der Konfigurationsbenutzeroberfläche.For details, see Integrating the configuration experience.

Hinweis

Das Dokument Integrieren der Konfigurationsbenutzeroberfläche gilt spezifisch für Microsoft Teams, die Methoden in dem Dokument gelten jedoch auch für Outlook.The Integrating the configuration experience document is Microsoft Teams-specific, but the documented methods work the same way in Outlook.

Outlook-spezifische KonfigurationsanforderungenOutlook-specific configuration requirements

Wenn Ihre Konfigurationsbenutzeroberfläche eine Authentifizierung erfordert, gibt es weitere Anforderungen zum Aktivieren des Authentifizierungsflusses in Outlook unter Windows.If your configuration experience requires authentication, there are additional requirements to enable the authentication flow in Outlook on Windows.

Outlook unter Windows übergibt einen zusätzlichen Abfrageparameter an die Authentifizierungsstartseite für Connectors.Outlook on Windows passes an additional query parameter to your connectors authentication start page.

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.Your app must preserve this value and pass it as an additional parameter to the microsoftTeams.authentication.notifySuccess or microsoftTeams.authentication.notifyFailure methods once authentication is complete.

microsoftTeams.authentication.notifySuccess(result, callbackUrl);

Veröffentlichen Ihres Connectors im StorePublish your Connector to the Store

Nachdem Sie Ihren Connector sorgfältig getestet haben und er im Office 365- Connectorkatalog aufgeführt werden kann, 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.Once you have thoroughly tested your connector and it is ready to be listed in the Office 365 connector catalog, you can use the Publish to Store button to submit it for review. Once reviewed and approved your connector would be added to the connector catalog.

Übermittlungscheckliste für den ConnectorConnector submission checklist

  • Stellen Sie sicher, dass der Connector voll funktionsfähig ist und sorgfältig getestet wurde, bevor Sie ihn an den Store übermitteln.Ensure that your connector is fully functional & thoroughly tested before submitting it to the Store.
  • Testen Sie Ihre Connectorkarten in verschiedenen Clients, auf denen die Benutzer sie verwenden würden: Outlook im Web-, Outlook 2016- und Mobile Outlook Groups-Apps.Test your connector cards in various clients where your users would use it: Outlook on the Web, Outlook 2016 & Outlook Groups mobile apps.
  • Stellen Sie sicher, dass Sie zur Textdekoration ausschließlich Markdown verwenden und keine HTML in der Nutzlast der Connectorkarte senden.Ensure that you strictly use Markdown for text decoration and not send HTML in your connector card payload.
  • Behalten Sie ein Gleichgewicht zwischen Mehrwert und zu viel Rauschen bei. Stellen Sie sicher, dass der Benutzer nicht durch zu viele Benachrichtigungen blockiert wird.Maintain a balance between adding value and generating too much noise. Ensure that the user is not bogged down with too many notifications.
  • 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.Identify the right events to send connector cards for. Ensure that the information you send to the group is valuable to the members of the group.
  • 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.When sending reports or summaries, use a digest format and allow the user to choose the time and frequency of the reports.
  • Setzen Sie beim Senden von Connectorkarten Markdown richtig ein, um wichtige Teile der Karte hervorzuheben.When sending connector cards make the best use of Markdown to highlight important parts of the card.
  • Sorgen Sie dafür, dass Ihre Connectorkarten umsetzbar sind, indem Sie, wann immer möglich, relevante Aktionen bereitstellen.Make your connector cards actionable by providing relevant actions whenever possible.
  • Aufgerufene Aktionen sollten eine wirklich niedrige Fehlerrate und eine schnelle Antwort durch Ihren Endpunkt aufweisen.Actions invoked should be really low in failure rate and should have fast response by your endpoint.
  • Stellen Sie sicher, dass der Benutzer die Konfiguration anhalten oder entfernen kann.Ensure that you have provisions for the user to pause or remove the configuration.
  • Sorgen Sie dafür, dass Sie eine klare, an den Benutzer gerichtete Dokumentation zu den Funktionen, die der Connector bietet, bereitstellen.Have clear user-facing documentation on the capabilities your connector offers.
  • Beim Registrieren des Connectors:When registering your connector:
    • 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.Ensure that the name and logo of your connector does not infringe upon a trademark or copyright of any other product or service.
    • Stellen Sie ein qualitativ hochwertiges Logo vom Typ „jpg“, „jpeg“, „png“ oder „gif“ bereit, das nicht größer als 60 KB ist.Provide a high quality logo of type jpg, jpeg, png or gif that is under 60KB in size.
    • Geben Sie eine kurze Beschreibung der Anwendung ein (z. B. „Contoso-Helpdesk vereint Firmen und Kunden“).Provide a short description of your application (e.g. 'Contoso Helpdesk brings companies & customers together').
    • 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“).Provide a detailed description of your connector (e.g. 'The Contoso Helpdesk connector notifies your Office 365 group about activity on your customer's tickets').
  • Beim Veröffentlichen des Connectors im Store:When publishing your connector to Store:
    • Füllen Sie die schrittweisen Anweisungen aus, und teilen Sie uns die Testkontoinformationen mit, damit wir Ihren Connector testen können.Make sure to fill out step by step instructions and share test account information to let us test your connector.

Nächste SchritteNext steps

Feedback können Sie auf UserVoice abgeben. Veröffentlichen Sie Ihre Fragen auf Stack Overflow, und markieren Sie sie mit Office365Connectors.If you have any feedback share it on UserVoice. Post your questions on Stack Overflow and tag them with Office365Connectors.