Konfigurieren der integrierten Registerkartentypen in Microsoft Teams
Um eine Microsoft Teams-Registerkarte mit dem Microsoft Graph-API zu erstellen oder zu konfigurieren, müssen Sie die teamsAppId
der App und die entityId
, contentUrl
removeUrl
, und websiteUrl
kennen, um für diese Art von App bereitzustellen. In diesem Artikel wird erläutert, wie Sie diese Werte für die integrierten Registerkartentypen abrufen.
Benutzerdefinierte Registerkarten
Um Microsoft Graph zum Konfigurieren einer Registerkarte zu verwenden, die einem von Ihnen geschriebenen Registerkartenanbieterzugeordnet ist, identifizieren Sie die entityId
, contentUrl
, removeUrl
und websiteUrl
, die die Konfigurations-Benutzeroberfläche für Microsoft Teams bereitstellt, und übergeben Sie eben diese Werte für entityId
, contentUrl
, removeUrl
und websiteUrl
an Microsoft Graph.
Die teamsAppId
ist die gleiche wie die id
im App-Manifestschema für Microsoft Teams.
Website-Registerkarten
Für Website-Registerkarten lautet die teamsAppId
com.microsoft.teamspace.tab.web
. Die folgende Tabelle zeigt die Konfiguration.
Eigenschaft | Typ | Beschreibung |
---|---|---|
entityId | string | Null |
contentUrl | string | URL der Website |
removeUrl | string | Null |
websiteUrl | string | URL der Website |
Word-, Excel-, PowerPoint- und PDF-Registerkarten
In der folgenden Tabelle ist die teamsAppId
für die einzelnen Apps aufgelistet.
App | teamsAppId | Typ (Erweiterung) |
---|---|---|
Word | com.microsoft.teamspace.tab.file.staticviewer.word |
docx |
Excel | com.microsoft.teamspace.tab.file.staticviewer.excel |
xlsx |
PowerPoint | com.microsoft.teamspace.tab.file.staticviewer.powerpoint |
pptx |
com.microsoft.teamspace.tab.file.staticviewer.pdf |
pdf |
Die folgende Tabelle zeigt die Konfiguration.
Eigenschaft | Typ | Beschreibung |
---|---|---|
entityId | Zeichenfolge | Die sourceDoc-ID der Datei. Sie finden diese, indem Sie die Datei in SharePoint öffnen und in die Adressleiste schauen – die URL weist eine sourcedoc=%7B{sourceDocId}%7D - Klausel auf. Sie können diese auch aus der webUrl des SharePoint-Laufwerkelements für das Dokument abrufen. Einzelheiten hierzu finden Sie unter GET /groups/{group-id}/drive/items/{item-id}. |
contentUrl | Zeichenfolge | Die URL der Datei im Format {folder-webUrl}/{item-name} . {folder-webUrl} ist die webUrl des SharePoint-Ordners, der die Datei enthält, die Sie finden, indem Sie die Datei in SharePoint öffnen und in die Adressleiste schauen, oder indem Sie die webUrl-Eigenschaft aus GET /groups/{group-id}/drive/items/{folder-item-id} verwenden. {item-name} ist der Dateiname (z. B. file.docx), der die name -Eigenschaft in GET /groups/{group-id}/drive/items/{item-id} darstellt. |
removeUrl | string | Null |
websiteUrl | string | Null |
Beispiel: Erstellen einer konfigurierten Word-Registerkarte
Im folgenden Beispiel wird eine konfigurierte Word-Registerkarte erstellt.
POST https://graph.microsoft.com/v1.0/teams/{team-id}/channels/{channel-id}/tabs
{
"displayName": "word",
"teamsApp@odata.bind" : "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/com.microsoft.teamspace.tab.file.staticviewer.word",
"configuration": {
"entityId": "115A90F4-AC9C-4F79-9837-36D1EFB3BE08",
"contentUrl": "https://m365x165177.sharepoint.com/sites/4NewCloneWithClonableParts/Shared%20Documents/General/Employee Handbook.docx",
"removeUrl": null,
"websiteUrl": null
}
}
Registerkarten der Dokumentbibliothek
Für Registerkarten der Dokumentbibliothek ist die teamsAppId
com.microsoft.teamspace.tab.files.sharepoint
.
Die folgende Tabelle zeigt die Konfiguration.
Eigenschaft | Typ | Beschreibung |
---|---|---|
entityId | string | Leere Zeichenfolge ("") |
contentUrl | string | Die URL des Stammordners der Dokumentbibliothek. Sie können diese URL finden, indem Sie den SharePoint-Ordner in Ihrem Browser öffnen, die URL kopieren und "/Forms/AllItems.aspx" und danach alles löschen. |
removeUrl | string | Null |
websiteUrl | string | Null |
Beispiel: Erstellen einer konfigurierten Dokumentbibliotheksregisterkarte
Im folgenden Beispiel wird eine konfigurierte Dokumentbibliotheksregisterkarte erstellt.
POST https://graph.microsoft.com/v1.0/teams/{team-id}/channels/{channel-id}/tabs
{
"displayName": "Document%20Library1",
"teamsApp@odata.bind": "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/com.microsoft.teamspace.tab.files.sharepoint",
"configuration": {
"entityId": "",
"contentUrl": "https://microsoft.sharepoint.com/teams/WWWtest/Shared%20Documents",
"removeUrl": null,
"websiteUrl": null
}
}
Wiki-Registerkarten
Für Wiki-Registerkarten ist die teamsAppId
com.microsoft.teamspace.tab.wiki
.
Wiki-Registerkarten unterstützen keine Konfiguration über Microsoft Graph.
Beachten Sie jedoch, dass es nicht viel zu konfigurieren gibt. Auf einer nicht konfigurierten Wiki-Registerkarte muss der erste Benutzer nur die Registerkarte Einrichten auswählen, um sie zu konfigurieren.
Planner-Registerkarten
Für Planner Registerkarten ist com.microsoft.teamspace.tab.planner
.teamsAppId
Konfiguration wird nicht unterstützt.
Microsoft Stream-Registerkarten
Für Microsoft Stream-Registerkarten ist die teamsAppId
com.microsoftstream.embed.skypeteamstab
.
Konfiguration wird nicht unterstützt.
Microsoft Forms-Registerkarten
Für Microsoft Forms-Registerkarten ist die teamsAppId
81fef3a6-72aa-4648-a763-de824aeafb7d
.
Konfiguration wird nicht unterstützt.
OneNote-Registerkarten
Für OneNote-Registerkarten ist die teamsAppId
0d820ecd-def2-4297-adad-78056cde7c78
.
Konfiguration wird nicht unterstützt.
Power BI-Registerkarten
Für Power BI-Registerkarten ist teamsAppId
com.microsoft.teamspace.tab.powerbi
.
Konfiguration wird nicht unterstützt.
Registerkarten von SharePoint-Seiten und -Listen
Für Registerkarten von SharePoint-Seiten und -Listen ist die teamsAppId
2a527703-1f6f-4559-a332-d8a7d288cd88
.
Konfiguration wird nicht unterstützt.
SharePoint-Framework-basierte Registerkarten
Benutzerdefinierte Registerkarten, die mit SharePoint-Framework erstellt wurden, können mit Microsoft Graph erstellt werden, die Konfiguration wird jedoch nicht unterstützt.