Connecteur Microsoft Excel

:: : (info) () Pour télécharger l'application, visitez : Bibliothèque::: :

Connecteur Microsoft Excel

Intégration avec Microsoft O365 Worksheet V1.0 Api

Introduction

L'API Microsoft Excel Worksheets permet aux utilisateurs de créer, lire et éditer des feuilles Microsoft Excel avec les bons accès à leurs comptes Office365. L'objectif de ce connecteur est d'intégrer Tulip avec Microsoft en utilisant l'API Graphique de Microsoft (v1.0) en utilisant des connecteurs HTTP et de fournir à nos clients un connecteur prêt à l'emploi qui peut être importé dans leur instance.

Objectif

Ce document mettra en évidence les différentes fonctions du connecteur qui peuvent être construites en faisant des appels HTTP à l'API graphique de Microsoft (v1.0) pour interagir avec la feuille de calcul Excel M365 afin de présenter diverses actions de lecture et d'écriture sur la feuille de calcul qui pourraient être exploitées pour divers cas d'utilisation.

Doc API

Documentation de l'API Microsoft Graph

Pré-requis

1. Créer un compte sur Microsoft O365 et configurer les informations d'identification OAuth 2.0 dans Microsoft Entra ID.
2. Enregistrer l'API avec les champs d'application requis dans le portail Microsoft. Azure - Entra ID

Vidéo de configuration du connecteur :

Détails de la connexion Tulip

Les informations suivantes doivent être configurées sur Tulip's

Connecteurs.

1. Exécution : Cloud Connector Host
2. Hôte : graph.microsoft.com
3. Port : 443
4. TLS : Oui

OAuth 2 : Pour obtenir le jeton d'accès afin de communiquer avec l'API Graph de Microsoft.

Fonctions du connecteur

1) Obtenir les détails d'un lecteur

Objectif

Ce connecteur permet de récupérer tous les éléments d'un lecteur.

Point d'arrivée

HTTP POST appel au point de terminaison -https://graph.micrsoft.com:443/v1.0/me/drive/root/children

Données requises

Aucune entrée requise

Extracteur de sortie requis

1. SheetID : Identifiant unique du classeur qui sera utilisé pour effectuer les autres tâches.
2. CreatedAt : La date et l'heure de création du classeur.
3. LastModified : Date et heure de la dernière modification du classeur.
4. SheetName : Le nom du classeur.
5. SpreadSheetURL : L'URL du classeur.

2) Obtenir toutes les feuilles de calcul d'un classeur

Objectif

Ce connecteur permet de récupérer toutes les feuilles de calcul d'un classeur en transmettant l'identifiant du classeur.

Point d'arrivée

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

Données requises

Les paramètres URL à transmettre sont les suivants

1. ID du classeur

Sortie requise Extracteur

1. sheetId : Identifiant unique de la feuille de calcul qui sera utilisée pour effectuer les autres tâches.
2. sheetName : Nom d'affichage de la feuille de calcul.
3. sheetPosition : Position de la feuille de calcul dans le classeur.
4. sheetVisibility : La visibilité de la feuille de calcul. Les valeurs possibles sont Visible, Hidden, VeryHidden.

3) Obtenir les métadonnées de la feuille de calcul

Objectif

Ce connecteur récupère les données du WorkbookID et du Worksheet Name.

Point d'arrivée

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

Données requises

Les paramètres URL à transmettre sont les suivants

1. ID du classeur
2. Nom de la feuille de travail

Extracteur de sortie requis

1. sheetId : Identifiant unique de la feuille de calcul qui sera utilisée pour effectuer les autres tâches.
2. sheetName : Nom d'affichage de la feuille de calcul.
3. sheetPosition : Position zéro de la feuille de calcul dans le classeur.
4. sheetVisibility : La visibilité de la feuille de calcul. Les valeurs possibles sont les suivantes : Visible, Caché, TrèsCaché.

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

Objectif

1. Les utilisateurs peuvent passer un ID de classeur et un nom de feuille de calcul en entrée et Tulip créera une nouvelle feuille de calcul avec le nom de la feuille fourni. La réponse de l'API sera les métadonnées et les diverses propriétés de la feuille de travail. Celles-ci peuvent être utilisées pour récupérer et mettre à jour les données des feuilles de calcul.
2. Les informations extraites de l'API Microsoft Graph V1.0 peuvent ensuite être utilisées dans les applications Tulip, les tables Tulip ou les variables Tulip qui seront acheminées vers d'autres fonctions du connecteur.

Point d'arrivée

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

Données requises

Les paramètres suivants sont envoyés dans le corps de la requête

1. Workbook ID - L'identifiant du classeur
2. Worksheet Name - Titre de la feuille de travail

Extracteur de sortie requis

1. WorksheetId : Identifiant unique de la feuille de calcul qui sera utilisée pour effectuer les autres tâches.
2. spreadsheetURL : URL de la feuille de calcul nouvellement créée.
3. 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 passer un ID de classeur, le nom de l'ancienne feuille de calcul, la position de la feuille de calcul et le nom de la nouvelle feuille de calcul en entrée et Tulip mettra à jour la feuille de calcul avec le nom de la feuille fourni. La réponse de l'API sera constituée des métadonnées et des diverses propriétés de la feuille de calcul. Celles-ci peuvent être utilisées pour récupérer et mettre à jour les données des feuilles de calcul.

Point final

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

Données requises

Les paramètres suivants sont envoyés dans le corps de la requête

1. ID du classeur - L'ID du classeur
2. Worksheet Name - Titre de la feuille de travail
3. Position de la feuille de travail - Position zéro de la feuille de travail dans le classeur
4. Nom de la nouvelle feuille de travail - Titre de la nouvelle feuille de travail

Extracteur de sortie requis

1. sheetID : Identifiant unique du classeur qui sera utilisé pour effectuer les autres tâches
2. sheetName : Le nom d'affichage de la feuille de travail.
3. sheetPosition : Position de la feuille de calcul dans le classeur.

6) Obtenir 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 de l'ID du classeur, du nom de la feuille de calcul, de l'indice de ligne et de l'indice de colonne fournis en tant qu'entrée. La réponse de l'API sera la valeur de la cellule fournie.

Point final

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

Données requises

Les paramètres URL à transmettre sont les suivants

1. ID du classeur - ID du classeur
2. Nom de la feuille de travail - Titre de la feuille de travail
3. Index de la ligne - Numéro de la ligne de la cellule à extraire
4. Indice de colonne - Numéro de colonne de la cellule à extraire

Extracteur de sortie requise

Ce connecteur renvoie la valeur de la cellule correspondant à l'index de ligne et de colonne fourni.

7) Obtenir 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 de l'ID du classeur, du nom de la feuille de calcul, de la plage de début et de la plage de fin fournis en entrée. La réponse de l'API sera les données de la plage fournie.

Point final

Appel HTTP GET au 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 requises

Les paramètres URL à transmettre sont les suivants

1. ID du classeur - ID du classeur
2. Nom de la feuille de travail - Titre de la feuille de travail
3. Début de la plage - Début de la plage
4. Plage de fin - Plage de fin

Extracteur de sortie requis

Ce connecteur renvoie toutes les valeurs des cellules dans la plage fournie.

8) Mise à jour des valeurs par plage

Objectif

Les utilisateurs peuvent passer un ID de classeur, un nom de feuille de calcul, une plage de départ, une plage de fin et les valeurs à mettre à jour comme entrée et Tulip mettra à jour les valeurs de la plage avec la plage fournie. La réponse de l'API sera les valeurs de l'intervalle mis à jour.

Point d'arrivée

HTTP PATCH call to the endpoint -https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/range(address='{start range}:{end range}')

Données requises

Les paramètres URL à transmettre sont les suivants

1. ID du classeur - ID du classeur
2. Nom de la feuille de travail - Titre de la feuille de travail
3. Début de la plage - Début de la plage
4. Plage de fin - Plage de fin
5. Valeurs de chaque cellule dans la plage fournie

Extracteur de sortie requis

Nous n'avons pas besoin d'extracteur de sortie.

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

Objectif

1. Les utilisateurs peuvent passer l'ID du classeur, le nom de la feuille de calcul, l'adresse de la feuille de calcul et les en-têtes comme données d'entrée et Tulip créera un nouveau tableau avec le nom du tableau. La réponse de l'API contiendra les métadonnées et les diverses propriétés de la table.
2. Celles-ci peuvent être utilisées pour récupérer et mettre à jour les données des feuilles de calcul.
3. Les informations extraites de l'API Microsoft Graph V1.0 peuvent ensuite être utilisées soit dans les applications Tulip, soit dans les tables Tulip, soit dans les variables Tulip qui seront acheminées vers d'autres fonctions du connecteur.

Point d'arrivée

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

Données requises

Les paramètres suivants sont envoyés dans le corps de la requête

1. Workbook ID - L'identifiant du classeur
2. Worksheet Name - Titre de la feuille de travail
3. 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 active est utilisée.
4. hasHeaders - Valeur booléenne indiquant si les données importées comportent des étiquettes de colonne. 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 qui décale les données d'une ligne.

Extracteur de sortie requise

Il renvoie les valeurs des métadonnées du tableau nouvellement créé.

10) Ajouter une nouvelle ligne dans un tableau

Objectif

Les utilisateurs peuvent passer un ID de classeur, un nom de tableau et des valeurs de ligne en entrée et Tulip créera une nouvelle ligne avec les valeurs de ligne fournies. La réponse de l'API sera les valeurs de la ligne créée dans la table.

Point d'arrivée

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

Données requises

Les paramètres suivants sont envoyés dans le corps de la requête

1. ID du classeur - L'ID du classeur
2. Worksheet Name - Titre de la feuille de travail
3. Row Values

Sortie requise Extracteur

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 passer un ID de classeur, un nom de feuille de calcul, une plage de début et une plage de fin comme entrée et Tulip effacera les valeurs des cellules basées sur la plage donnée.

Point d'arrivée

HTTP POST appel au point de terminaison https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheet/{worksheetName}/range(address='{start range}:{end range}')/clear

Données requises

Les paramètres suivants sont envoyés dans le corps de la requête

1. ID du classeur - L'ID du classeur
2. Worksheet Name - Titre de la feuille de travail
3. Plage de début
4. Plage de fin

Pour en savoir plus

Plus d'informations sur les connecteurs Microsoft

• Connecteur Microsoft Calendar
• Connecteur Microsoft Outlook
• Connecteur Microsoft Teams