Freigeben über

Fehlerbehebung für Ihre Microsoft Teams-Anwendung

  • Artikel

So behandeln Sie Registerkarten

Zugreifen auf DevTools

Sie können DevTools im Teams-Client öffnen, um eine ähnliche Erfahrung wie das Drücken von F12 (unter Windows) oder Command-Option-I (unter MacOS) in einem Browser zu erhalten.

Leerer Registerkartenbildschirm

Wenn Ihre Inhalte in der Registerkartenansicht nicht angezeigt werden, kann dies wie folgt sein:

  • Ihre Inhalte können nicht in einem <iframe>angezeigt werden.
  • die Inhaltsdomäne ist nicht in der Liste validDomains im Manifest enthalten.

Hinweis

Eine leere Registerkarte wird angezeigt, wenn die angegebene Registerkarten-URL zum Anmeldebildschirm umgeleitet wird. Anmeldeseiten werden in iFrames nicht als Schutz vor Clickjacking gerendert. Ihre Authentifizierungslogik muss eine andere Methode als die Umleitung verwenden.

Änderungen an meiner Web-App werden nicht auf der Registerkarte "Teams" angezeigt.

Wenn bei Ihnen konsistente oder zeitweilige Zwischenspeicherungsprobleme auftreten, bei denen Keine Updates für Ihre Web-App angezeigt werden, wenn sie auf einer Teams-Registerkarte gehostet wird, überprüfen Sie ihre Servercacheeinstellungen, und verwenden Sie Cache-Control Header, um das gewünschte Verhalten der Clientzwischenspeicherung sicherzustellen.

Die Schaltfläche Speichern ist im Einstellungsdialogfeld nicht aktiviert.

Stellen Sie sicher, dass Sie aufrufen, microsoftTeams.settings.setValidityState(true) nachdem der Benutzer auf der Einstellungsseite eingaben oder alle erforderlichen Daten ausgewählt hat, um die Schaltfläche "Speichern" zu aktivieren.

Die Registerkarteneinstellungen können beim Auswählen von Speichern nicht gespeichert werden.

Wenn Sie beim Hinzufügen einer Registerkarte Speichern auswählen, aber eine Fehlermeldung mit dem Hinweis erhalten, dass die Einstellungen nicht gespeichert werden können, kann das Problem eine von zwei Klassen von Problemen sein:

  • Die Meldung zum Speichern des Erfolgs wurde nie empfangen: Wenn ein Speicherhandler mit microsoftTeams.settings.registerOnSaveHandler(handler)registriert wurde, muss der Rückruf aufrufen saveEvent.notifySuccess().

    • Wenn der Rückruf nicht innerhalb von 30 Sekunden oder saveEvent.notifySuccess() stattdessen aufruft saveEvent.notifyFailure(reason) , wird dieser Fehler angezeigt.
    • Wenn kein Speicherhandler registriert wurde, erfolgt der saveEvent.notifySuccess() Aufruf automatisch, wenn der Benutzer Speichern auswählt.

  • Die angegebenen Einstellungen waren ungültig: Der andere Grund, warum die Einstellungen möglicherweise nicht gespeichert werden, ist, wenn der Aufruf von microsoftTeams.setSettings(settings) ein ungültiges Einstellungsobjekt bereitgestellt hat oder der Aufruf überhaupt nicht erfolgt ist. Weitere Informationen finden Sie im nächsten Abschnitt: Allgemeine Probleme mit dem Einstellungsobjekt.

Häufige Probleme mit dem Einstellungsobjekt

  • settings.entityId fehlt. Dieses Feld ist obligatorisch.
  • settings.contentUrl fehlt. Dieses Feld ist obligatorisch.
  • settings.contentUrl oder die optionalen settings.removeUrl, oder settings.websiteUrl sind angegeben, aber ungültig. Die URLs müssen HTTPS verwenden und entweder dieselbe Domäne wie die Einstellungsseite aufweisen oder in der Liste des Manifests validDomains angegeben sein.

Der Benutzer kann nicht authentifiziert oder Der Authentifizierungsanbieter kann nicht auf der Registerkarte angezeigt werden.

Sofern Sie keine automatische Authentifizierung durchführen, müssen Sie den Authentifizierungsprozess befolgen, der von der Microsoft Teams JavaScript-Clientbibliothek bereitgestellt wird.

Hinweis

Wir erfordern, dass der gesamte Authentifizierungsfluss in Ihrer Domäne beginnt und endet, die im validDomains -Objekt in Ihrem Manifest aufgeführt sein muss.

Weitere Informationen zur Authentifizierung finden Sie unter Authentifizieren eines Benutzers.

Statische Registerkarten werden nicht angezeigt

Es gibt ein bekanntes Problem, bei dem beim Aktualisieren einer vorhandenen Bot-App mit einer neuen oder aktualisierten statischen Registerkarte diese Registerkartenänderung beim Zugriff auf die App aus einer persönlichen Chatunterhaltung nicht angezeigt wird. Um die Änderung anzuzeigen, sollten Sie einen Neuen Benutzer testen oder instance testen oder über das Apps-Flyout auf den Bot zugreifen.

So beheben Sie Probleme mit Bots

Mein Bot kann nicht hinzugefügt werden

Apps müssen vom Microsoft 365-Mandantenadministrator aktiviert werden, damit sie von Endbenutzern geladen werden können. In einigen Fällen sind dem Microsoft 365-Mandanten möglicherweise mehrere SKUs zugeordnet, und damit Bots in allen SKUs funktionieren können, müssen sie aktiviert sein. Weitere Informationen finden Sie unter Vorbereiten Ihres Microsoft 365-Mandanten.

Bot kann nicht als Mitglied eines Teams hinzugefügt werden

Bots müssen zuerst in einem Team hochgeladen werden, bevor sie in einem Kanal dieses Teams darauf zugreifen können. Weitere Informationen zu diesem Prozess finden Sie unter Hochladen Ihrer App in einem Team.

Mein Bot erhält meine Nachricht nicht in einem Kanal

Bots in Kanälen empfangen Nachrichten nur, wenn sie explizit @mentionedsind, auch wenn Sie auf eine vorherige Botnachricht antworten. Die einzige Ausnahme, bei der der Botname in einer Nachricht möglicherweise nicht angezeigt wird, ist, wenn der Bot eine imBack Aktion als Ergebnis einer CardAction empfängt, die er ursprünglich gesendet hat.

Mein Bot versteht meine Befehle nicht, wenn er sich in einem Kanal befindet.

Da Bots in Kanälen nur Nachrichten empfangen, wenn sie sind @mentioned, enthalten alle Nachrichten, die Ihr Bot in einem Kanal empfängt, diese @mention in das Textfeld. Es ist eine bewährte Methode, den Botnamen selbst aus allen eingehenden SMS-Nachrichten zu entfernen, bevor sie an Ihre Analyselogik übergeben werden. In den Erwähnungen finden Sie Tipps zum Umgang mit diesem Fall.

Probleme beim Packen und Hochladen

Fehler beim Lesen von manifest.json

Die meisten Manifestfehler geben einen Hinweis darauf, welches Feld fehlt oder ungültig ist. Wenn die JSON-Datei jedoch überhaupt nicht als JSON gelesen werden kann, wird diese generische Fehlermeldung verwendet.

Häufige Gründe für Manifestlesefehler:

  • Ungültiger JSON-Code. Verwenden Sie eine IDE wie Visual Studio Code oder Visual Studio , die die JSON-Syntax automatisch überprüft.
  • Codierungsprobleme. Verwenden Sie UTF-8 für die Datei manifest.json . Andere Codierungen, insbesondere mit der BoM, sind möglicherweise nicht lesbar.
  • Falsch formatiertes .zip-Paket. Die Datei manifest.json muss sich auf der obersten Ebene der .zip-Datei befinden. Beachten Sie, dass die Standardmäßige Mac-Dateikomprimierung manifest.json möglicherweise in einem Unterverzeichnis abgelegt wird, das in Microsoft Teams nicht ordnungsgemäß geladen wird.

Eine andere Erweiterung mit derselben ID ist vorhanden.

Wenn Sie versuchen, ein aktualisiertes Paket mit derselben ID erneut hochzuladen, wählen Sie das Symbol Ersetzen am Ende der Tabellenzeile der Registerkarte anstelle der Schaltfläche Hochladen aus.

Wenn Sie ein aktualisiertes Paket nicht erneut hochladen, stellen Sie sicher, dass die ID eindeutig ist.

Siehe auch