Configurer les types d’onglets intégrés dans Microsoft Teams

  • Article

Pour créer ou configurer un onglet Microsoft Teams à l’aide de l’API Graph Microsoft, vous devez connaître le teamsAppId de l’application, et le entityId, contentUrl, removeUrlet websiteUrl pour fournir ce type d’application. Cet article explique comment obtenir ces valeurs pour les types d’onglets prédéfinis.

Onglets personnalisés

Pour utiliser Microsoft Graph afin de configurer un onglet associé à un fournisseur d’onglets que vous avez écrit, identifiez les entityId, contentUrl, removeUrl et websiteUrl que l’interface utilisateur de configuration de l’application fournit à Microsoft Teams, puis transmettez les mêmes valeurs de entityId, contentUrl, removeUrl et websiteUrl à Microsoft Graph.

Le teamsAppId est identique à l’id dans le schéma manifeste d’application pour Microsoft Teams.

Onglets Site web

Pour les onglets de site web, le teamsAppId est com.microsoft.teamspace.tab.web. La configuration et la suivante.

Propriété Type Description
entityId string valeur Null
contentUrl chaîne URL du site web
removeUrl chaîne valeur Null
websiteUrl chaîne URL du site web

Onglets de Word, Excel, PowerPoint et de PDF

Le tableau suivant répertorie le teamsAppId pour chaque application.

Application teamsAppId Type (extension)
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

La configuration est la suivante.

Propriété Type Description
entityId string ID sourceDoc du fichier. Vous pouvez le trouver en ouvrant le fichier dans SharePoint et en consultant la barre d’adresses : l’URL aura une clause sourcedoc=%7B{sourceDocId}%7D. Vous pouvez également le dériver de l’URL web de l’élément lecteur SharePoint pour le document. Pour plus d’informations, consultez l’article relatif à l’API GET /groups/{group-id}/drive/items/{item-id}.
contentUrl string L’URL du fichier au format {folder-webUrl}/{item-name}. {dossier webUrl} est l’URL web du dossier SharePoint contenant le fichier, accessible en ouvrant le fichier dans SharePoint et en consultant la barre d’adresses ou à l’aide de la propriété webUrl à partir de l’API GET /groups/{group-id}/drive/items/{folder-item-id}. {item-name} est le nom de fichier (par exemple, file.docx), c’est-à-dire la propriété name dans GET /groups/{group-id}/drive/items/{item-id}.
removeUrl chaîne valeur Null
websiteUrl string valeur Null

Exemple : créer un onglet Word configuré

L’exemple suivant crée un onglet Word configuré.

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
  }
}

Onglets de bibliothèque de documents

Pour les onglets de bibliothèque de documents, le teamsAppId est com.microsoft.teamspace.tab.files.sharepoint. La configuration est la suivante.

Propriété Type Description
entityId chaîne Chaîne vide («  »)
contentUrl string URL du dossier racine de la bibliothèque de documents. Vous pouvez trouver cette URL en ouvrant le dossier SharePoint dans votre navigateur, en copiant l’URL et en supprimant « /Forms/AllItems.aspx » et tout ce qui suit.
removeUrl chaîne valeur Null
websiteUrl string Null

Exemple : Créer un onglet de bibliothèque de documents configuré

L’exemple suivant crée un onglet de bibliothèque de documents configuré.

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
    }
}

Onglets de Wiki

Pour les onglets de Wiki, le teamsAppId est com.microsoft.teamspace.tab.wiki. Les onglets wiki ne prennent pas en charge la configuration via Microsoft Graph. Notez, toutefois, qu’il n’y a pas grand-chose à configurer : dans un onglet wiki non configuré, le premier utilisateur doit simplement sélectionner l’onglet Configurer pour le configurer.

Onglets Planificateur

Pour Planificateur onglets, est teamsAppIdcom.microsoft.teamspace.tab.planner. La configuration n’est pas prise en charge.

Onglets de Microsoft Stream

Pour les onglets de Microsoft Stream, le teamsAppId est com.microsoftstream.embed.skypeteamstab. La configuration n’est pas prise en charge.

Onglets de Microsoft Forms

Pour les onglets de Microsoft Forms, le teamsAppId est 81fef3a6-72aa-4648-a763-de824aeafb7d. La configuration n’est pas prise en charge.

Onglets de OneNote

Pour les onglets de OneNote, le teamsAppId est 0d820ecd-def2-4297-adad-78056cde7c78. La configuration n’est pas prise en charge.

Onglets de Power BI

Pour les onglets de Power BI, le teamsAppId est com.microsoft.teamspace.tab.powerbi. La configuration n’est pas prise en charge.

Onglets de page et de liste SharePoint

Pour les onglets de page et de liste SharePoint, le teamsAppId est 2a527703-1f6f-4559-a332-d8a7d288cd88. La configuration n’est pas prise en charge.

onglets basés sur SharePoint Framework

Les onglets personnalisés créés à l’aide de SharePoint Framework peuvent être créés à l’aide de Microsoft Graph, mais la configuration n’est pas prise en charge.

Contenu connexe