Microsoft Excel csatlakozó

::: (info) () Az alkalmazás letöltéséhez látogasson el a következő weboldalra: Könyvtár:::

Microsoft Excel Connector

Integráció a Microsoft O365 Worksheet V1.0 Api-vel

Bevezetés

A Microsoft Excel Worksheets API lehetővé teszi a felhasználók számára, hogy létrehozzák, olvassák és szerkesszék a Microsoft Excel táblákat az Office365 fiókjukhoz beállított megfelelő hozzáféréssel. Ennek a csatlakozónak a célja a Tulip és a Microsoft integrálása a Microsoft Graph API(v1.0) segítségével a HTTP csatlakozók segítségével, és ügyfeleinknek egy olyan out of box csatlakozót biztosít, amelyet be lehet importálni a példányukba.

Cél

Ez a dokumentum kiemeli a különböző csatlakozófunkciókat, amelyek a Microsoft Graph API(v1.0) HTTP-hívásaival építhetők ki az M365 Excel munkalapjával való interakcióhoz, hogy bemutassa a munkalapon végzett különböző olvasási és írási műveleteket, amelyeket különböző felhasználási esetekben lehet kihasználni.

API-dokumentum

Microsoft Graph API dokumentáció

Előfeltételek

1. Hozzon létre egy fiókot a Microsoft O365-ön és konfigurálja az OAuth 2.0 hitelesítő adatokat a Microsoft Entra ID-ban.
2. 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 Connection Details

A következő információkat kellene konfigurálni a Tulipban

Csatlakozók.

1. Futtatás: Felhőcsatlakozó gazdája
2. Host: graph.microsoft.com
3. Port:443
4. TLS: Igen

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

A csatlakozó funkciói

1) Egy meghajtó adatainak lekérése

Cél

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

Végpont:

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

Szükséges bemenet

Nincs szükség bemenetre

Kötelező kimenet Extractor

1. SheetID: A munkafüzet egyedi azonosítója, amelyet a többi feladat elvégzéséhez használnak.
2. CreatedAt: A munkafüzet létrehozásának dátuma és időpontja.
3. LastModified: A munkafüzet utolsó módosításának dátuma és időpontja.
4. SheetName: A munkafüzet neve.
5. SpreadSheetURL: A munkafüzet URL címe.

2) A munkafüzet összes munkalapjának lekérdezése

Cél

Ez a csatlakozó egy munkafüzet összes munkalapját lekérdezi a workbookID átadásával.

Végpont:

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

Kötelező bemenet

A következő URL paramétereket kell átadni

1. Munkafüzet azonosítója

Kötelező kimenet Extractor

1. sheetId: A többi feladat elvégzéséhez használt SpreadSheet egyedi azonosítója.
2. sheetName: A munkalap megjelenített neve.
3. sheetPosition: A munkalap nullára alapozott pozíciója a munkafüzetben.
4. sheetVisibility: A munkalap láthatósága. A lehetséges értékek: Visible, Hidden, VeryHidden.

3) A munkalap metaadatainak lekérdezése

Cél

Ez a csatlakozó a WorkbookID és a Worksheet Name adataiból fogja lekérni 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égpontra.

Kötelező bemenet

A következő URL paramétereket kell átadni

1. Munkafüzet azonosítója
2. Munkalap neve

Kötelező kimenet Extractor

1. sheetId: A többi feladat elvégzéséhez használt SpreadSheet egyedi azonosítója.
2. sheetName: A munkalap megjelenített neve.
3. sheetPosition: A munkalap nullás alapú pozíciója a munkafüzetben.
4. sheetVisibility: A munkalap láthatósága. A lehetséges értékek a következők: Visible, Hidden, VeryHidden.

4) Új munkalap létrehozása

Cél

1. A felhasználók megadhatják a Munkafüzet azonosítóját és a Munkalap nevét bemenetként, és a Tulip létrehoz egy új Munkalapot a megadott lapnévvel. Az API válasza a munkalap metaadatai és különböző tulajdonságai lesznek. Ez a továbbiakban felhasználható a munkalapok adatainak lekérdezésére és frissítésére.
2. A Microsoft Graph V1.0 API-ból származó információk ezután tovább használhatók a Tulip alkalmazásokban, a Tulip táblázatokban vagy a Tulip változókban, amelyeket más csatlakozó funkciókba vezetnek.

Végpont

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

Kötelező bemenet

A következő paraméterek a kérés testeként elküldött paraméterek

1. Workbook ID - A munkafüzet azonosítója
2. Munkalap neve - A munkalap címe

Kötelező kimeneti kivonat

1. WorksheetId: A SpreadSheet egyedi azonosítója, amelyet a többi feladat elvégzéséhez használnak .
2. spreadsheetURL: Az újonnan létrehozott Táblázat URL címe.
3. A válasszal együtt visszaküldött további paraméterek a kimeneti paraméterek részeként szerepelhetnek.

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

Cél

A felhasználók bemenetként átadhatjá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, és a Tulip frissíti a Munkalapot a megadott lapnévvel. Az API válasza a munkalap metaadatai és különböző tulajdonságai lesznek. Ez a továbbiakban felhasználható a táblázatok adatainak lekérdezésére és frissítésére.

Végpont

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

Kötelező bemenet

A következő paraméterek a kérés testeként elküldendő paraméterek

1. Workbook ID - A munkafüzet azonosítója
2. Munkalap neve - A munkalap címe
3. Worksheet Position - A munkalap nulla alapú pozíciója a munkafüzetben.
4. Új munkalap neve - A munkalap új címe

Kötelező kimeneti kivonat

1. sheetID: A munkafüzet egyedi azonosítója, amelyet a többi feladat elvégzéséhez használunk.
2. sheetName: A munkalap megjelenített neve.
3. sheetPosition: A munkalap nulla alapú pozíciója a munkafüzetben.

6) Egy adott cella adatainak kinyerése

Cél

Ez a csatlakozó a megadott WorkbookID, munkalap neve, sorindex és oszlopindex mint bemenet alapján lekérdezi az adatokat egy munkafüzet munkalapjairól. Az API válasza a megadott cellaérték adatai lesznek.

Végpont

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

Kötelező bemenet

A következő URL paramétereket kell átadni

1. Workbook Id- Munkafüzet azonosító
2. Munkalap neve-munkalap címe
3. Row Index- A lekérdezendő cella sorszáma
4. Column Index- A lekérdezendő cella oszlopszáma

Szükséges kimeneti kivonat

Ez a csatlakozó a megadott sor- és oszlopindex cellájának értékét adja vissza.

7) A munkalap tartomány adatainak lekérése

Cél

Ez a csatlakozó egy munkafüzet munkalapjainak adatait a megadott WorkbookID, munkalap neve, Start Range és End Range (Kezdő tartomány) mint bemeneti adat alapján hívja le. Az API válasza a megadott tartomány adatai lesznek.

Végpont

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

Kötelező bemenet

A következő URL-paramétereket kell átadni

1. Workbook Id- Munkafüzet azonosító
2. Munkalap neve-Munkalap címe
3. Start range- Kezdő tartomány
4. Végtartomány- Végtartomány

Kötelező kimeneti kivonat

Ez a csatlakozó visszaadja a megadott tartományon belüli összes cellaértéket.

8) Értékfrissítés tartományonként

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 bemenetként, és a Tulip frissíti a tartomány értékeit a megadott tartományban. Az API válasza a frissített tartományértékek lesznek.

Végpont

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

Kötelező bemenet

A következő URL paramétereket kell átadni

1. Workbook Id- Munkafüzet azonosító
2. Munkalap neve-Munkalap címe
3. Start range- Kezdő tartomány
4. Végtartomány- Végtartomány
5. A megadott tartományon belüli egyes cellák értékei

Szükséges kimeneti kivonat

Nincs szükségünk semmilyen kimeneti kivonatolóra.

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

Cél

1. A felhasználók átadhatják a munkafüzet azonosítóját , a munkalap nevét, a munkalap címét és a fejléceket bemenetként, és a Tulip létrehoz egy új táblázatot a táblázat nevével. Az API válasza a táblázat metaadatai és különböző tulajdonságai lesznek.
2. Ez a továbbiakban felhasználható a táblázatokból történő adatlekérdezéshez és -frissítéshez.
3. A Microsoft Graph V1.0 API-ból származó információk a továbbiakban felhasználhatók a Tulip alkalmazásokban, a Tulip táblázatokban vagy a Tulip változókban, amelyeket más csatlakozó funkciókba vezetnek.

Végpont

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

Kötelező bemenet

A következő paraméterek a kérés testeként elküldött paraméterek

1. Workbook ID - A munkafüzet azonosítója
2. Munkalap neve - A munkalap címe
3. Address - Az adatforrást képviselő tartományobjektum címe vagy neve. Ha a cím nem tartalmaz lapnevet, akkor az aktuálisan aktív lapot használja a rendszer.
4. hasHeaders-Boolean érték, amely jelzi, hogy az importálandó adatok rendelkeznek-e oszlopcímkékkel. Ha a forrás nem tartalmaz fejléceket (azaz ha ez a tulajdonság hamis értékre van állítva), az Excel automatikusan létrehoz egy fejlécet, amely egy sorral lejjebb tolja az adatokat.

Szükséges kimeneti kivonatoló

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

10) Új sor hozzáadása egy táblázathoz

Cél

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

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égpontra.

Kötelező bemenet

A következő paraméterek a kérés testeként elküldendő paraméterek

1. Workbook ID - A munkafüzet azonosítója
2. Munkalap neve - A munkalap címe
3. Sorértékek

Kötelező kimenet Extractor

Az újonnan létrehozott sor sorértékeit adja vissza.

11) A munkalap adatainak törlése

Cél

A felhasználók átadhatják a Munkafüzet azonosítóját , a Munkalap nevét, a kezdő és a végtartományt bemenetként, és a Tulip törli a cellák értékeit a megadott tartomány alapján.

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égpontra.

Kötelező bemenet

A következő paraméterek a kérés testeként elküldött paraméterek

1. Workbook ID - A munkafüzet azonosítója
2. Munkalap neve - A munkalap címe
3. Kezdő tartomány
4. End Range (végtartomány)

További olvasmányok

További információk a Microsoft Connectors-ról

• Microsoft Calendar Connector
• Microsoft Outlook-csatlakozó
• Microsoft Teams csatlakozó