Konfigurieren der integrierten Registerkartentypen in Microsoft Teams

  • Artikel

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, contentUrlremoveUrl, 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 teamsAppIdcom.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
PDF 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 teamsAppIdcom.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 teamsAppIdcom.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 teamsAppIdcom.microsoftstream.embed.skypeteamstab. Konfiguration wird nicht unterstützt.

Microsoft Forms-Registerkarten

Für Microsoft Forms-Registerkarten ist die teamsAppId81fef3a6-72aa-4648-a763-de824aeafb7d. Konfiguration wird nicht unterstützt.

OneNote-Registerkarten

Für OneNote-Registerkarten ist die teamsAppId0d820ecd-def2-4297-adad-78056cde7c78. Konfiguration wird nicht unterstützt.

Power BI-Registerkarten

Für Power BI-Registerkarten ist teamsAppIdcom.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 teamsAppId2a527703-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.

Verwandte Inhalte