Microsoft Excel-csatlakozó

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

Microsoft Excel-csatlakozó

Integráció a Microsoft O365 Worksheet V1.0 API-val

Bevezetés

A Microsoft Excel Worksheets API lehetővé teszi a felhasználók számára, hogy a megfelelő hozzáférési jogosultságokkal rendelkezve hozzanak létre, olvassanak és szerkesszenek Microsoft Excel-munkalapokat az Office 365-fiókjukon keresztül. Ennek a csatlakozónak a célja, hogy a Tulip-ot a Microsoft Graph API (v1.0) segítségével, HTTP-csatlakozók használatával integrálja a Microsoft rendszerébe, és ügyfeleink számára egy azonnal használható csatlakozót biztosítson, amelyet importálhatnak a saját példányukba.

Cél

Ez a dokumentum bemutatja a különböző csatlakozó funkciókat, amelyek a Microsoft Graph API (v1.0) felé irányuló HTTP-hívások segítségével hozhatók létre az M365 Excel-munkalapokkal való interakcióhoz, és bemutatja a munkalapokon végrehajtható különböző olvasási és írási műveleteket, amelyek számos felhasználási esethez felhasználhatók.

API-dokumentáció

Microsoft Graph API dokumentáció

Előfeltételek

Hozzon létre fiókot a Microsoft O365-en, és konfigurálja az OAuth 2.0 hitelesítő adatait a Microsoft Entra ID-ben.
Regisztrálja az API-t a szükséges hatókörökkel a Microsoft portálon. Azure – Entra ID

Videó a csatlakozó beállításáról:

Tulip csatlakozási adatok

A következő információkat kell beállítani a Tulip

csatlakozókon.

Futtatási környezet: Cloud Connector-gazdagép
Gazdagép: graph.microsoft.com
Port: 443
TLS: Igen

OAuth 2: A Microsoft Graph API-val való kommunikációhoz szükséges hozzáférési token megszerzéséhez

Csatlakozó funkciói

1) Egy meghajtó adatainak lekérése

Cél

Ez a csatlakozó az összes elemet lekérdezi egy meghajtóról.

Végpont

HTTP GET hívás a végponthoz –https://graph.micrsoft.com:443/v1.0/me/drive/root/children

Szükséges bemeneti adatok

Nincs szükség bemeneti adatokra

Szükséges kimeneti kivonó

SheetID: A munkafüzet egyedi azonosítója, amelyet a többi feladat végrehajtásához használnak.
CreatedAt: A munkafüzet létrehozásának dátuma és időpontja.
LastModified: A munkafüzet utolsó módosításának dátuma és időpontja.
SheetName: A munkafüzet neve.
SpreadSheetURL: A munkafüzet URL-címe.

2) Az összes munkalap lekérése egy munkafüzetből

Cél

Ez a csatlakozó a munkafüzet azonosítójának (workbookID) megadásával letölti a munkafüzet összes munkalapját.

Végpont

HTTP GET a végponthoz –https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets

Szükséges bemeneti adatok

Az alábbi URL-paramétereket kell megadni

Munkakönyv-azonosító

Szükséges kimenet-kivonó

sheetId: A táblázat egyedi azonosítója, amelyet a többi feladat végrehajtásához használunk.
sheetName: A munkalap megjelenítési neve.
sheetPosition: A munkalap nullától számított pozíciója a munkafüzeten belül.
sheetVisibility: A munkalap láthatósága. A lehetséges értékek: Visible, Hidden, VeryHidden.

3) A munkalap metaadatainak lekérése

Cél

Ez a csatlakozó a WorkbookID és a munkalap neve alapján tölti be az adatokat.

Végpont

HTTP GET hívás a https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/ végponthoz

Szükséges bemeneti adatok

Az alábbi URL-paramétereket kell átadni

Munkafüzet-azonosító
Munkalap neve

Szükséges kimenet-kivonó

sheetId: A táblázat egyedi azonosítója, amelyet a többi feladat végrehajtásához használunk.
sheetName: A munkalap megjelenítési neve.
sheetPosition: A munkalap nullától számított pozíciója a munkafüzeten belül.
sheetVisibility: A munkalap láthatósága. A lehetséges értékek: Visible, Hidden, VeryHidden.

4) Új munkalap létrehozása

Cél

A felhasználók megadhatnak egy munkafüzet-azonosítót és egy munkalapnevet bemeneti adatként, és a Tulip létrehoz egy új munkalapot a megadott munkalapnévvel. Az API válasza a munkalap metaadatai és különböző tulajdonságai lesznek. Ez tovább felhasználható a munkalapokból származó adatok lekérésére és frissítésére.
Az információkat a Microsoft Graph V1.0 API-ból nyerik ki, majd azokat tovább lehet használni akár a Tulip-alkalmazásokban, a Tulip-táblázatokban, akár a Tulip-változókban, amelyeket más csatlakozófüggvényekbe lehet továbbítani.

Végpont

HTTP POST-hívás a https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/add végponthoz

Szükséges bemeneti adatok

Az alábbi paramétereket küldjük el a kérés törzseként

Munkakönyv-azonosító – A munkakönyv azonosítója
Munkalap neve – A munkalap címe

Szükséges kimeneti kivonó

WorksheetId: A táblázat egyedi azonosítója, amelyet a többi feladat végrehajtásához használunk.
spreadsheetURL: Az újonnan létrehozott táblázat URL-je.
A válaszban visszaküldött további paraméterek is felvehetők a kimeneti paraméterek közé.

5) A munkalap tulajdonságainak frissítése

Cél

A felhasználók megadhatják a munkafüzet azonosítóját, a régi munkalap nevét, a munkalap pozícióját és az új munkalap nevét bemeneti adatként, és a Tulip frissíti a munkalapot a megadott névvel. Az API válasza a munkalap metaadatai és különböző tulajdonságai lesznek. Ez tovább felhasználható a táblázatokból származó adatok lekérésére és frissítésére.

Végpont

HTTP PATCH-hívás a végponthoz –https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}

Szükséges bemeneti adatok

Az alábbi paramétereket kell a kérés törzsében elküldeni

Munkakönyv-azonosító – A munkakönyv azonosítója
Munkalap neve – A munkalap címe
Munkalap pozíciója – A munkalap nullától számított pozíciója a munkafüzeten belül
Új munkalap neve – Az új munkalap címe

Szükséges kimeneti kivonó

sheetID: A munkafüzet egyedi azonosítója, amelyet a többi feladat végrehajtásához használnak
sheetName: A munkalap megjelenítési neve.
sheetPosition: A munkalap nullától számított pozíciója a munkafüzeten belül.

6) Egy adott cella adatainak lekérése

Cél

Ez a csatlakozó a megadott munkafüzet-azonosító (WorkbookID), munkalapnév, sorindex és oszlopindex alapján lekérdezi az adatokat a munkafüzet munkalapjaiból. Az API válasza a megadott cella értéke lesz.

Végpont

HTTP GET hívás a végponthoz –https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/cell(row={sorindex},column={oszlopindex})

Szükséges bemeneti adatok

Az alábbi URL-paramétereket kell átadni

Munkalap-azonosító – a munkalap azonosítója
Munkalap neve – Munkalap címe
Sorindex – A lekérdezendő cella sorának száma
Oszlopindex – A lekérdezendő cella oszlopszáma

Szükséges kimeneti kivonó

Ez a csatlakozó a megadott sor- és oszlopindexhez tartozó cellaértéket adja vissza.

7) Munkalap-tartomány adatainak lekérése

Cél

Ez a csatlakozó a megadott munkafüzet-azonosító (WorkbookID), munkalapnév, kezdő tartomány és végtartomány alapján lekérdezi a munkafüzet munkalapjainak adatait. Az API válasza a megadott tartomány adatai lesznek.

Végpont

HTTP GET-hívás a végponthoz:https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/range(address=’{start range}:{end range}’)

Szükséges bemeneti adatok

Az alábbi URL-paramétereket kell átadni

Munkafüzet-azonosító – A munkafüzet azonosítója
Munkalap neve – Munkalap címe
Kezdő tartomány – Kezdő tartomány
Végtartomány – Végtartomány

Szükséges kimeneti kivonó

Ez a csatlakozó a megadott tartományon belüli összes cellatartalmat visszaadja.

8) Értékek frissítése tartomány szerint

Cél

A felhasználók megadhatják a munkafüzet azonosítóját, a munkalap nevét, a kezdő tartományt, a végtartományt és a frissítendő értékeket bemeneti adatokként, és a Tulip frissíti a tartomány értékeit a megadott tartomány szerint. Az API válasza a frissített tartományértékek lesznek.

Végpont

HTTP PATCH hívás a végponthoz –https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/range(address=’{start range}:{end range}’)

Szükséges bemeneti adatok

Az alábbi URL-paramétereket kell átadni

Munkalap-azonosító – A munkalap azonosítója
Munkalap neve – Munkalap címe
Kezdő tartomány – Kezdő tartomány
Végtartomány – Végtartomány
A megadott tartományon belüli egyes cellák értékei

Szükséges kimeneti kivonó

Nincs szükségünk kimeneti kivonóra.

9) Hozzon létre egy táblázatot a munkalapon

Cél

A felhasználók megadhatják a munkafüzet azonosítóját, a munkalap nevét, a munkalap címét és azt, hogy van-e fejléc, és a Tulip létrehoz egy új táblázatot a megadott névvel. Az API válasza a táblázat metaadatai és különböző tulajdonságai lesznek.
Ez tovább felhasználható a táblázatokból származó adatok lekérésére és frissítésére.
A Microsoft Graph V1.0 API-ból lekért információk ezután felhasználhatók akár a Tulip-alkalmazásokban, a Tulip-táblákban, akár a Tulip-változókban, amelyeket tovább lehet irányítani más csatlakozó funkciókba.

Végpont

HTTP POST-hívás a https://graph.microsoft.com:443/v1.0/me/drive/items/{itemID}/workbook/worksheets/add végponthoz

Szükséges bemeneti adatok

Az alábbi paraméterek kerülnek elküldésre a kérés törzseként

Munkakönyv-azonosító – A munkakönyv azonosítója
Munkalap neve – A munkalap címe
Cím – Az adatforrást képviselő tartományobjektum címe vagy neve. Ha a cím nem tartalmaz munkalapnevet, akkor a jelenleg aktív munkalap kerül felhasználásra.
hasHeaders – Boole-érték, amely jelzi, hogy az importált adatok tartalmaznak-e oszlopcímeket. Ha a forrás nem tartalmaz fejlécet (azaz ha ez a tulajdonság false értékre van állítva), az Excel automatikusan létrehoz egy fejlécet, és az adatokat egy sorral lejjebb tolja.

Szükséges kimeneti kivonó

Ez az újonnan létrehozott táblázat metaadat-értékeit adja vissza.

10) Új sor hozzáadása a táblához

Cél

A felhasználók megadhatják a munkafüzet azonosítóját, a táblázat nevét és a sorértékeket bemenetként, és a Tulip létrehoz egy új sort a megadott sorértékekkel. Az API válasza a táblázatban létrehozott sorértékek lesznek.

Végpont

HTTP POST hívás a https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/tables/{tablename}/rows/add végponthoz

Szükséges bemeneti adatok

Az alábbi paramétereket kell a kérés törzsében elküldeni

Munkakönyv-azonosító – A munkakönyv azonosítója
Munkalap neve – A munkalap címe
Sorértékek

Kötelező kimeneti kivonó

Ez az újonnan létrehozott sor sorértékeit adja vissza.

11) A munkalap adatainak törlése

Cél

A felhasználók megadhatják a munkafüzet azonosítóját, a munkalap nevét, a kezdő és végtartományt bemeneti adatként, és a Tulip a megadott tartomány alapján törli a cellák értékeit.

Végpont

HTTP POST-hívás a https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheet/{worksheetName}/range(address=’{start range}:{end range}’)/clear végponthoz

Szükséges bemeneti adatok

Az alábbi paramétereket kell a kérés törzsében elküldeni

Munkakönyv-azonosító – A munkakönyv azonosítója
Munkalap neve – A munkalap címe
Kezdő tartomány
Végtartomány

További információk

További információk a Microsoft-csatlakozókról