Connecteur Microsoft Excel

To download the app, visit: [connectors](https://tulip.co/library/<span translate=)/microsoft-excel-connector/">Library

Connecteur Microsoft Excel

Intégration avec l’API Microsoft O365 Worksheet V1.0

Introduction

L’API Microsoft Excel Worksheets permet aux utilisateurs de créer, lire et modifier des feuilles de calcul Microsoft Excel avec les droits d’accès appropriés à leurs comptes Office 365. L’objectif de ce connecteur est d’intégrer Tulip à Microsoft à l’aide de l’API Graph de Microsoft (v1.0) via des connecteurs HTTP, et de fournir à nos clients un connecteur prêt à l’emploi pouvant être importé dans leur instance.

Objectif

Ce document présente les différentes fonctionnalités du connecteur pouvant être mises en œuvre via des appels HTTP vers l’API Graph de Microsoft (v1.0) afin d’interagir avec les feuilles de calcul Excel de M365. Il illustre diverses actions de lecture et d’écriture sur ces feuilles de calcul, pouvant être exploitées dans divers cas d’utilisation.

Documentation de l’API

Documentation de l’API Graph de Microsoft

Prérequis

Créez un compte sur Microsoft O365 et configurez les informations d’identification OAuth 2.0 dans Microsoft Entra ID.
Enregistrez l’API avec les périmètres requis sur le portail Microsoft. Azure - Entra ID

Vidéo de configuration du connecteur :

Détails de connexion à Tulip

Les informations suivantes doivent être configurées dans la section

Exécution sur : Hôte du connecteur cloud
Hôte : graph.microsoft.com
Port : 443
TLS : Oui

OAuth 2 : pour obtenir le jeton d'accès permettant de communiquer avec l'API Graph de Microsoft

Fonctions du connecteur

1) Récupérer les détails d'un disque

Objectif

Ce connecteur récupère tous les éléments d'un Drive.

Point de terminaison

Appel HTTP GET vers le point de terminaison :https://graph.micrsoft.com:443/v1.0/me/drive/root/children

Données d'entrée requises

Aucune entrée requise

Extracteur de sortie requis

SheetID : identifiant unique du classeur qui sera utilisé pour effectuer les autres tâches.
CreatedAt : date et heure de création du classeur.
Dernière modification : date et heure de la dernière modification du classeur.
SheetName : nom du classeur.
URL de la feuille de calcul : l'URL du classeur.

2) Récupérer toutes les feuilles de calcul d'un classeur

Objectif

Ce connecteur récupère toutes les feuilles de calcul d’un classeur en lui transmettant l’identifiant du classeur (workbookID).

Point de terminaison

Requête HTTP GET vers le point de terminaison :https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets

Données d'entrée requises

Voici les paramètres d'URL à transmettre

ID du classeur

Extracteur de sortie obligatoire

sheetId : identifiant unique de la feuille de calcul qui sera utilisé pour effectuer les autres tâches.
sheetName : nom d'affichage de la feuille de calcul.
sheetPosition : position de la feuille de calcul dans le classeur, comptée à partir de zéro.
sheetVisibility : visibilité de la feuille de calcul. Les valeurs possibles sont « Visible », « Hidden » et « VeryHidden ».

3) Récupérer les métadonnées de la feuille de calcul

Objectif

Ce connecteur récupère les données à partir de l’identifiant du classeur (WorkbookID) et du nom de la feuille de calcul.

Point de terminaison

Appel HTTP GET vers le point de terminaison https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/

Données d'entrée requises

Voici les paramètres d’URL à transmettre

ID du classeur
Nom de la feuille de calcul

Extracteur de sortie requis

sheetId : identifiant unique de la feuille de calcul qui sera utilisé pour effectuer les autres tâches.
sheetName : nom d'affichage de la feuille de calcul.
sheetPosition : position de la feuille de calcul dans le classeur, comptée à partir de zéro.
sheetVisibility : visibilité de la feuille de calcul. Les valeurs possibles sont : Visible, Hidden, VeryHidden.

4) Création d'une nouvelle feuille de calcul

Objectif

Les utilisateurs peuvent fournir un identifiant de classeur et un nom de feuille de calcul en tant que paramètres d’entrée ; Tulip créera alors une nouvelle feuille de calcul portant le nom indiqué. La réponse de l’API comprendra les métadonnées et diverses propriétés de la feuille de calcul. Ces informations peuvent ensuite être utilisées pour récupérer et mettre à jour des données issues des feuilles de calcul.
Les informations extraites de l’API Microsoft Graph V1.0 peuvent ensuite être utilisées soit dans des applications Tulip, soit dans des tableaux Tulip, soit dans des variables Tulip qui seront transmises à d’autres fonctions du connecteur.

Point de terminaison

Appel HTTP POST vers le point de terminaison https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/add

Données requises

Voici les paramètres envoyés dans le corps de la requête

ID du classeur - L'ID du classeur
Nom de la feuille de calcul : titre de la feuille de calcul

Extracteur de sortie requis

WorksheetId : identifiant unique de la feuille de calcul qui sera utilisé pour effectuer les autres tâches.
spreadsheetURL : l'URL de la feuille de calcul nouvellement créée.
Les paramètres supplémentaires renvoyés avec la réponse peuvent être inclus dans les paramètres de sortie.

5) Mise à jour des propriétés de la feuille de calcul

Objectif

Les utilisateurs peuvent transmettre un identifiant de classeur, l'ancien nom de la feuille de calcul, sa position et son nouveau nom en tant que paramètres d'entrée ; Tulip mettra alors à jour la feuille de calcul avec le nom fourni. La réponse de l'API comprendra les métadonnées et diverses propriétés de la feuille de calcul. Ces informations peuvent ensuite être utilisées pour récupérer et mettre à jour des données issues des feuilles de calcul.

Point de terminaison

Appel HTTP PATCH vers le point de terminaison :https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}

Données requises

Voici les paramètres envoyés dans le corps de la requête

ID du classeur : l’ID du classeur
Nom de la feuille de calcul : le titre de la feuille de calcul
Position de la feuille de calcul : la position de la feuille de calcul dans le classeur, comptée à partir de zéro
Nom de la nouvelle feuille de calcul : titre de la nouvelle feuille de calcul

Extracteur de sortie requis

sheetID : identifiant unique du classeur qui sera utilisé pour effectuer les autres tâches
sheetName : nom d'affichage de la feuille de calcul.
sheetPosition : position (à partir de zéro) de la feuille de calcul dans le classeur.

6) Récupérer les données d’une cellule spécifique

Objectif

Ce connecteur récupère les données des feuilles de calcul d’un classeur en fonction des paramètres fournis : WorkbookID, nom de la feuille de calcul, index de ligne et index de colonne. La réponse de l’API correspondra à la valeur de la cellule indiquée.

Point de terminaison

Appel HTTP GET vers le point de terminaison :https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/cell(row={index de ligne},column={index de colonne})

Données d'entrée requises

Voici les paramètres d’URL à transmettre

ID du classeur : ID du classeur
Nom de la feuille de calcul : titre de la feuille de calcul
Indice de ligne : numéro de ligne de la cellule à récupérer
Indice de colonne : numéro de colonne de la cellule à récupérer

Extracteur de sortie requis

Ce connecteur renvoie la valeur de la cellule correspondant aux indices de ligne et de colonne fournis.

7) Récupérer les données d’une plage de la feuille de calcul

Objectif

Ce connecteur récupère les données des feuilles de calcul d’un classeur en fonction des paramètres fournis : ID du classeur, nom de la feuille de calcul, plage de départ et plage de fin. La réponse de l’API correspondra aux données de la plage indiquée.

Point de terminaison

Appel HTTP GET vers le point de terminaison :https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/range(address=’{start range}:{end range}’)

Données d’entrée obligatoires

Voici les paramètres d’URL à transmettre

ID du classeur : ID du classeur
Nom de la feuille de calcul : titre de la feuille de calcul
Plage de départ : plage de départ
Plage de fin : Plage de fin

Extracteur de résultats requis

Ce connecteur renvoie toutes les valeurs des cellules comprises dans la plage indiquée.

8) Mettre à jour les valeurs par plage

Objectif

Les utilisateurs peuvent fournir en entrée un identifiant de classeur, un nom de feuille de calcul, une plage de départ, une plage de fin et les valeurs à mettre à jour ; Tulip mettra alors à jour les valeurs de la plage en fonction des informations fournies. La réponse de l’API correspondra aux valeurs mises à jour de la plage.

Point de terminaison

Appel HTTP PATCH vers le point de terminaison :https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/range(address=’{start range}:{end range}’)

Données d’entrée requises

Voici les paramètres d’URL à transmettre

ID du classeur : ID du classeur
Nom de la feuille de calcul : titre de la feuille de calcul
Plage de départ : plage de départ
Plage de fin : plage de fin
Valeurs de chaque cellule dans la plage fournie

Extracteur de résultats requis

Nous n'avons pas besoin d'extracteur de résultats.

9) Créer un tableau dans la feuille de calcul

Objectif

Les utilisateurs peuvent fournir en entrée un identifiant de classeur, un nom de feuille de calcul, une adresse de feuille de calcul et l'indicateur « Contient des en-têtes » ; Tulip créera alors un nouveau tableau portant le nom indiqué. La réponse de l'API contiendra les métadonnées et diverses propriétés du tableau.
Ces informations peuvent ensuite être utilisées pour récupérer et mettre à jour des données à partir des feuilles de calcul.
Les informations extraites de l’API Microsoft Graph V1.0 peuvent ensuite être utilisées soit dans des applications Tulip, soit dans des tableaux Tulip, soit dans des variables Tulip qui seront transmises à d’autres fonctions de connecteur.

Point de terminaison

Appel HTTP POST vers le point de terminaison https://graph.microsoft.com:443/v1.0/me/drive/items/{itemID}/workbook/worksheets/add

Données requises

Voici les paramètres envoyés dans le corps de la requête

ID du classeur : l’ID du classeur
Nom de la feuille de calcul : titre de la feuille de calcul
Adresse : adresse ou nom de l’objet de plage représentant la source de données. Si l’adresse ne contient pas de nom de feuille, la feuille actuellement active est utilisée.
hasHeaders : valeur booléenne indiquant si les données importées comportent des étiquettes de colonnes. Si la source ne contient pas d’en-têtes (c’est-à-dire lorsque cette propriété est définie sur « false »), Excel génère automatiquement un en-tête en décalant les données d’une ligne vers le bas

Extracteur de sortie obligatoire

Cette fonction renvoie les valeurs des métadonnées de la table nouvellement créée.

10) Ajouter une nouvelle ligne dans un tableau

Objectif

Les utilisateurs peuvent fournir en entrée un identifiant de classeur, un nom de tableau et des valeurs de ligne ; Tulip créera alors une nouvelle ligne avec les valeurs fournies. La réponse de l’API correspondra aux valeurs de la ligne créée dans le tableau.

Point de terminaison

Appel HTTP POST vers le point de terminaison https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/tables/{tablename}/rows/add

Données requises

Voici les paramètres envoyés dans le corps de la requête

ID du classeur : l’ID du classeur
Nom de la feuille de calcul : titre de la feuille de calcul
Valeurs des lignes

Extracteur de sortie obligatoire

Cette fonction renvoie les valeurs de la ligne nouvellement créée.

11) Effacer les données de la feuille de calcul

Objectif

Les utilisateurs peuvent fournir un identifiant de classeur, un nom de feuille de calcul, une plage de début et une plage de fin en tant que paramètres d’entrée ; Tulip effacera alors les valeurs des cellules en fonction de la plage indiquée.

Point de terminaison

Appel HTTP POST vers le point de terminaison https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheet/{worksheetName}/range(address=’{plage de début}:{plage de fin}’)/clear

Données requises

Voici les paramètres envoyés dans le corps de la requête

ID du classeur - L’ID du classeur
Nom de la feuille de calcul : titre de la feuille de calcul
Plage de départ
Plage de fin

Pour en savoir plus

Découvrez plus d'informations sur les connecteurs Microsoft