Fehlerbehebung für Ihre Microsoft Teams-Anwendung

Artikel
10/28/2024

So behandeln Sie Registerkarten

Zugriff auf Entwicklungstools

Sie können Dev Tools im Teams-Client öffnen, um eine ähnliche Benutzeroberfläche wie das Drücken von F12 (unter Windows) oder Befehlsoption-I (unter MacOS) in einem Browser zu ermöglichen.

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 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 manifest.json-Datei . Andere Codierungen, insbesondere mit der BoM, sind möglicherweise nicht lesbar.
Falsch formatiertes .zip-Paket. Die manifest.json Datei muss sich auf der obersten Ebene der .zip Datei befinden. Beachten Sie, dass die standardmäßige Mac-Dateikomprimierung die manifest.json in einem Unterverzeichnis platzieren kann, 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.

Fehler beim Hochladen der App in Teams

Wenn Beim Hochladen der App in Teams die Fehlermeldung Manifestanalyse hat fehlgeschlagen angezeigt wird, verwenden Sie das Teams-App-Validierungssteuerelement , um das App-Paket zu überprüfen, einschließlich des App-Manifests und der OpenAPI-Spezifikationsdatei. Überprüfen Sie das App-Manifest und die OAD-Anforderungen (OpenAPI Description), um Fehler oder Warnungen zu beheben, und versuchen Sie, Ihre App hochzuladen.
Wenn beim Ausführen Ihrer App in Teams Probleme auftreten, führen Sie die folgenden Schritte zur Problembehandlung aus, um Ihr Problem zu identifizieren und zu beheben:
- Netzwerk: Wählen Sie die Registerkarte Netzwerk in Entwicklungstools aus, um die Netzwerkaktivität zu überprüfen.
  1. Öffnen Sie den Teams-Webclient.
  2. Melden Sie sich mit Ihren Microsoft 365-Anmeldeinformationen an.
  3. Wechseln Sie zu einem Chat, und führen Sie Ihre Nachrichtenerweiterungs-App aus.
  4. Wählen Sie oben rechts Einstellungen und mehr (...) aus. Wechseln Sie zu Weitere Tools>Entwicklungstools.
  5. Wählen Sie Netzwerk aus. Wählen Sie die Filteroption aus, und geben Sie invoke in das Suchfeld ein.
  6. Wählen Sie einen Fehler aus der Liste aus.
  7. Wählen Sie im rechten Bereich die Registerkarte Antwort aus.
  8. Ein JSON-Objekt, das eine Fehlerantwort eines Diensts oder einer API darstellt, wird angezeigt. Es enthält ein standardizedError -Objekt mit errorCode, errorSubCodeund errorDescription, die weitere Details zum Fehler enthalten.
  Häufige HTTP-Fehlerantworten:
  - Ein Fehler vom Typ 400 Ungültige Anforderung kann auftreten, wenn ein Anforderungsparameter fehlt oder falsch formatiert ist.
  - Der Fehler 401 Unauthorized oder 403 Forbidden deutet auf Probleme mit dem API-Schlüssel hin, z. B. fehlender oder nicht autorisierter Schlüssel.
  - Ein interner Serverfehler 500 gibt an, dass der Dienst aufgrund eines serverseitigen Problems nicht weiß, wie er reagieren soll.
Problembehandlung mit Tools: Wenn die Informationen aus der Netzwerkablaufverfolgung nicht ausreichen, können Sie eine Anforderung nach dem OpenAPI-Beschreibungsdokument erstellen und Tools wie Swagger Editor oder Postman verwenden, um die Anforderung zu testen, einschließlich des Autorisierungsheaders für den API-Schlüssel, falls erforderlich.

Wenn Sie die Fehler nicht beheben können, empfehlen wir Ihnen, sich an den Microsoft Teams-Produktsupport zu wenden, um weitere Unterstützung zu erhalten.

Freigeben über