Aufgeklappte Registerkartenverknüpfung und Phasenansicht

Die Phasenansicht ist eine neue Benutzeroberflächenkomponente, mit der Sie den Inhalt rendern können, der im Vollbildmodus in Teams geöffnet und als Registerkarte angeheftet wird.

Phasenansicht

Die Phasenansicht ist eine Vollbild-UI-Komponente, die Sie aufrufen können, um Ihre Webinhalte anzuzeigen. Der vorhandene Link-Verbreitungsdienst wird so aktualisiert, dass er verwendet wird, um URLs mithilfe einer adaptiven Karte und Chatdiensten in eine Registerkarte umzuwandeln. Wenn ein Benutzer eine URL in einem Chat oder Kanal sendet, wird die URL auf eine adaptive Karte entrollt. Der Benutzer kann auf der Karte "Anzeigen" auswählen und den Inhalt direkt in der Phasenansicht als Registerkarte anheften.

Vorteile der Phasenansicht

Die Phasenansicht bietet eine nahtlosere Erfahrung beim Anzeigen von Inhalten in Teams. Benutzer können die von Ihrer App bereitgestellten Inhalte öffnen und anzeigen, ohne den Kontext zu verlassen, und sie können die Inhalte an den Chat oder Kanal anheften, um später schnell auf Ihre App zugreifen zu können, was zu einer größeren Benutzerbindung führt.

Phasenansicht im Vergleich zum Aufgabenmodul

Phasenansicht Aufgabenmodul
Die Phasenansicht ist hilfreich, wenn Sie benutzern umfangreiche Inhalte anzeigen können, z. B. eine Seite, ein Dashboard, eine Datei usw. Es bietet umfangreiche Features, mit denen Sie Ihre Inhalte im Vollbildbereich rendern können. Das Aufgabenmodul ist besonders nützlich, um Nachrichten anzuzeigen, die Die Aufmerksamkeit des Benutzers erfordern, oder um Informationen zu sammeln, die zum Nächsten Schritt erforderlich sind.

Aufrufen der Phasenansicht

Sie können die Phasenansicht auf folgende Weise aufrufen:

Aufrufen der Phasenansicht von einer adaptiven Karte

Wenn der Benutzer eine URL auf dem Teams Desktopclient eingibt, wird der Bot aufgerufen und gibt eine adaptive Karte mit der Option zum Öffnen der URL in einer Phase zurück. Nachdem eine Phase gestartet und tabInfo bereitgestellt wurde, können Sie die Phase als Registerkarte anheften.

Die folgenden Bilder zeigen eine Phase, die von einer adaptiven Karte geöffnet wurde:

Öffnen einer Phase über eine adaptive Karte

Öffnen einer Phase

Beispiel

Es folgt der Code zum Öffnen einer Phase von einer adaptiven Karte aus:

{
    type: "Action.Submit",
    name: "View",
    data: {
          msteams: {
            type: "invoke",
            value: {
                type: "tab/tabInfoAction",
                tabInfo: {
                    contentUrl: contentUrl,
                    websiteUrl: websiteUrl,
                    name: "Tasks",
                    entityId: "entityId"
                 }
                }
            }
        }
} 

Der invoke Anforderungstyp muss composeExtension/queryLink .

Hinweis

  • invoke workflow is similar to the current appLinking workflow.
  • Um die Konsistenz zu gewährleisten, wird empfohlen, den Namen Action.Submit View ".
  • websiteUrl ist eine erforderliche Eigenschaft, die im Objekt übergeben werden TabInfo muss.

Nachfolgend sehen Sie den Prozess zum Aufrufen der Phasenansicht:

  • Wenn der Benutzer "Anzeigen" auswählt, erhält der Bot eine invoke Anforderung. Der Anforderungstyp lautet composeExtension/queryLink .
  • invoke antwort von Bot enthält eine adaptive Karte mit Typ tab/tabInfoAction darin.
  • Der Bot antwortet mit einem 200 Code.

Hinweis

Auf Teams mobilen Clients öffnet das Aufrufen der Phasenansicht für Apps, die über den Teams Store verteilt werden und keine mobliesoptimierte Oberfläche haben, den Standardwebbrowser des Geräts. Der Browser öffnet die im Parameter des Objekts angegebene websiteUrl TabInfo URL.

Um die Phasenansicht über den Deep-Link von Ihrer Registerkarte aus aufzurufen, müssen Sie die DEEP-Link-URL in der microsoftTeams.executeDeeplink(url) API umschließen. Der Deep-Link kann auch über eine Aktion auf der Karte übergeben OpenURL werden.

In der folgenden Abbildung wird eine Phasenansicht angezeigt, die über einen Deep-Link aufgerufen wird:

Invoke a Stage View through a deep link

Syntax

Es folgt die Deeplinksyntax:

https://teams.microsoft.com/l/stage/{appId}/0?context={\"contentUrl " : " "[contentUrl]" " , " websiteUrl " : " "[websiteUrl]" " , name : Contoso " " " " }

Beispiele

Wenn ein Benutzer eine URL eingibt, wird diese in eine adaptive Karte entrollt.

Nachfolgend sind die Deep-Linkbeispiele zum Aufrufen der Phasenansicht aufgeführt:

Beispiel 1

https://teams.microsoft.com/l/stage/2a527703-1f6f-4559-a332-d8a7d288cd88/0?context={"contentUrl":"https%3A%2F%2Fmicrosoft.sharepoint.com%2Fteams%2FLokisSandbox%2FSitePages%2FSandbox-Page.aspx","websiteUrl":"https%3A%2F%2Fmicrosoft.sharepoint.com%2Fteams%2FLokisSandbox%2FSitePages%2FSandbox-Page.aspx","name":"Contoso"}

Beispiel 2

https://teams.microsoft.com/l/Meeting_Stage/2a527703-1f6f-4559-a332-d8a7d288cd88/0?context={"contentUrl":"https%3A%2F%2Fmicrosoft.sharepoint.com%2Fteams%2FLokisSandbox%2FSitePages%2FSandbox-Page.aspx","websiteUrl":"https%3A%2F%2Fmicrosoft.sharepoint.com%2Fteams%2FLokisSandbox%2FSitePages%2FSandbox-Page.aspx","name":"Contoso"}

Hinweis

  • Dies name ist optional im Deep-Link. Wenn er nicht enthalten ist, wird er durch den App-Namen ersetzt.
  • Der Deep-Link kann auch über eine Aktion übergeben OpenURL werden.
  • Wenn Sie eine Phase aus einem bestimmten Kontext starten, stellen Sie sicher, dass Ihre App in diesem Kontext funktioniert. Wenn Ihre Phasenansicht beispielsweise über eine persönliche App gestartet wird, müssen Sie sicherstellen, dass Ihre App einen persönlichen Bereich aufweist.

Tabinformationseigenschaft

Eigenschaftenname Typ Anzahl der Zeichen Beschreibung
entityId Zeichenfolge 64 Diese Eigenschaft ist ein eindeutiger Bezeichner für die Entität, die auf der Registerkarte angezeigt wird. Dies ist ein Pflichtfeld.
name Zeichenfolge 128 Diese Eigenschaft ist der Anzeigename der Registerkarte in der Kanalschnittstelle. Dieses Feld ist optional.
contentUrl Zeichenfolge 2048 Diese Eigenschaft ist die https://-URL, die auf die Entitätsbenutzeroberfläche verweist, die im Teams Canvas angezeigt werden soll. Dies ist ein Pflichtfeld.
websiteUrl? Zeichenfolge 2048 Diese Eigenschaft ist die https:// URL, auf die sie zeigen soll, wenn ein Benutzer die Anzeige in einem Browser auswählt. Dies ist ein Pflichtfeld.
removeUrl? Zeichenfolge 2048 Diese Eigenschaft ist die https://-URL, die auf die Benutzeroberfläche verweist, die angezeigt werden soll, wenn der Benutzer die Registerkarte löscht. Dies ist ein optionales Feld.

Codebeispiel

Beispielname Beschreibung C# Node.js
Registerkarte in der Phasenansicht Microsoft Teams Registerkartenbeispiel-App zum Demonstrieren der Registerkarte in der Phasenansicht. View View

Nächster Schritt

Weitere Informationen