Łącznik z programem Microsoft Excel

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

Łącznik z programem Microsoft Excel

Integracja z interfejsem API Microsoft O365 Worksheet V1.0

Wprowadzenie

Interfejs API arkuszy kalkulacyjnych Microsoft Excel umożliwia użytkownikom tworzenie, odczytywanie i edytowanie arkuszy programu Microsoft Excel przy odpowiednim uprawnieniu dostępu do ich kont Office 365. Celem tego łącznika jest integracja Tulip z platformą Microsoft za pomocą interfejsu API Microsoft Graph (wersja 1.0) przy użyciu łączników HTTP oraz zapewnienie naszym klientom gotowego do użycia łącznika, który można zaimportować do ich instancji.

Cel

W niniejszym dokumencie omówiono różne funkcje łącznika, które można zrealizować poprzez wywołania HTTP do interfejsu API Microsoft Graph (wersja 1.0) w celu interakcji z arkuszem kalkulacyjnym programu Excel w ramach platformy M365, aby zaprezentować różne operacje odczytu i zapisu w arkuszu, które można wykorzystać w różnych przypadkach użycia.

Dokumentacja API

Dokumentacja interfejsu API Microsoft Graph

Wymagania wstępne

Utwórz konto w usłudze Microsoft O365 i skonfiguruj poświadczenia OAuth 2.0 w usłudze Microsoft Entra ID.
Zarejestruj interfejs API z wymaganymi zakresami w portalu Microsoft. Azure — Entra ID

Film przedstawiający konfigurację łącznika:

Szczegóły połączenia z Tulip

Następujące informacje należy skonfigurować w sekcji

Działa na: Hostie Cloud Connector
Host: graph.microsoft.com
Port: 443
TLS: Tak

OAuth 2: W celu uzyskania tokenu dostępu do komunikacji z interfejsem API Microsoft Graph

Funkcje łącznika

1) Pobierz szczegóły jednego dysku

Cel

Ten łącznik pobierze wszystkie elementy z jednego dysku.

Punkt końcowy

Wywołanie HTTP GET do punktu końcowego —https://graph.micrsoft.com:443/v1.0/me/drive/root/children

Wymagane dane wejściowe

Nie są wymagane żadne dane wejściowe

Wymagany ekstraktor wyników

SheetID: Unikalny identyfikator skoroszytu, który zostanie wykorzystany do wykonania pozostałych zadań.
CreatedAt: Data i godzina utworzenia skoroszytu.
LastModified: Data i godzina ostatniej modyfikacji skoroszytu.
SheetName: Nazwa skoroszytu.
SpreadSheetURL: Adres URL skoroszytu.

2) Pobierz wszystkie arkusze z skoroszytu

Cel

Ten łącznik pobierze wszystkie arkusze z skoroszytu po przekazaniu identyfikatora workbookID.

Punkt końcowy

HTTP GET do punktu końcowego —https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets

Wymagane dane wejściowe

Poniżej przedstawiono parametry adresu URL, które należy przekazać

Identyfikator skoroszytu

Wymagany ekstraktor wyników

sheetId: Unikalny identyfikator arkusza kalkulacyjnego, który zostanie wykorzystany do wykonania pozostałych zadań.
sheetName: Nazwa wyświetlana arkusza.
sheetPosition: Pozycja arkusza w skoroszycie, liczona od zera.
sheetVisibility: Widoczność arkusza. Możliwe wartości to Visible, Hidden, VeryHidden.

3) Pobierz metadane arkusza

Cel

Ten łącznik pobierze dane na podstawie identyfikatora skoroszytu (WorkbookID) i nazwy arkusza.

Punkt końcowy

Wywołanie HTTP GET do punktu końcowego https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/

Wymagane dane wejściowe

Poniżej przedstawiono parametry adresu URL, które należy przekazać

Identyfikator skoroszytu
Nazwa arkusza

Wymagany ekstraktor wyników

sheetId: Unikalny identyfikator arkusza kalkulacyjnego, który zostanie wykorzystany do wykonania pozostałych zadań.
sheetName: Nazwa wyświetlana arkusza.
sheetPosition: Pozycja arkusza w skoroszycie, liczona od zera.
sheetVisibility: Widoczność arkusza. Możliwe wartości to: Visible, Hidden, VeryHidden.

4) Tworzenie nowego arkusza

Cel

Użytkownicy mogą przekazać identyfikator skoroszytu i nazwę arkusza jako dane wejściowe, a Tulip utworzy nowy arkusz o podanej nazwie. Odpowiedź API będzie zawierała metadane oraz różne właściwości arkusza. Można to następnie wykorzystać do pobierania i aktualizowania danych z arkuszy.
Informacje pobierane z interfejsu API Microsoft Graph V1.0 można następnie wykorzystać w aplikacjach Tulip, tabelach Tulip lub zmiennych Tulip, które będą przekazywane do innych funkcji łącznika.

Punkt końcowy

Wywołanie HTTP POST do punktu końcowego https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/add

Wymagane dane wejściowe

Poniżej przedstawiono parametry wysyłane w treści żądania

ID skoroszytu — identyfikator skoroszytu
Nazwa arkusza — tytuł arkusza

Wymagany moduł ekstrakcji danych wyjściowych

WorksheetId: Unikalny identyfikator arkusza kalkulacyjnego, który zostanie wykorzystany do wykonania pozostałych zadań.
spreadsheetURL: adres URL nowo utworzonego arkusza kalkulacyjnego.
Dodatkowe parametry zwracane wraz z odpowiedzią mogą zostać uwzględnione jako część parametrów wyjściowych.

5) Aktualizacja właściwości arkusza

Cel

Użytkownicy mogą przekazać identyfikator skoroszytu, starą nazwę arkusza, pozycję arkusza oraz nową nazwę arkusza jako dane wejściowe, a Tulip zaktualizuje arkusz zgodnie z podaną nazwą. Odpowiedź API będzie zawierała metadane oraz różne właściwości arkusza. Można to następnie wykorzystać do pobierania i aktualizowania danych z arkuszy kalkulacyjnych.

Punkt końcowy

Wywołanie HTTP PATCH do punktu końcowego —https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}

Wymagane dane wejściowe

Poniżej przedstawiono parametry wysyłane w treści żądania

Identyfikator skoroszytu — identyfikator skoroszytu
Nazwa arkusza — tytuł arkusza
Pozycja arkusza — pozycja arkusza w skoroszycie, liczona od zera
Nazwa nowego arkusza — tytuł nowego arkusza

Wymagany ekstraktor wyników

sheetID: Unikalny identyfikator skoroszytu, który zostanie użyty do wykonania pozostałych zadań
sheetName: Nazwa wyświetlana arkusza.
sheetPosition: Pozycja arkusza w skoroszycie, liczona od zera.

6) Pobierz dane z określonej komórki

Cel

Ten łącznik pobierze dane z arkuszy skoroszytu na podstawie podanego identyfikatora WorkbookID, nazwy arkusza, indeksu wiersza i indeksu kolumny jako danych wejściowych. Odpowiedzią API będą dane dotyczące wartości podanej komórki.

Punkt końcowy

Wywołanie HTTP GET do punktu końcowego—https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/cell(row={indeks wiersza},column={indeks kolumny})

Wymagane dane wejściowe

Poniżej przedstawiono parametry adresu URL, które należy przekazać

Identyfikator skoroszytu — identyfikator skoroszytu
Nazwa arkusza — tytuł arkusza
Indeks wiersza – numer wiersza komórki, która ma zostać pobrana
Indeks kolumny — numer kolumny komórki, którą należy pobrać

Wymagany ekstraktor wyników

Ten łącznik zwraca wartość komórki o podanych indeksach wiersza i kolumny.

7) Pobierz dane z zakresu arkusza

Cel

Ten łącznik pobierze dane z arkuszy roboczych skoroszytu na podstawie podanego identyfikatora WorkbookID, nazwy arkusza, zakresu początkowego i zakresu końcowego jako danych wejściowych. Odpowiedzią API będą dane z podanego zakresu.

Punkt końcowy

Wywołanie HTTP GET do punktu końcowego—https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/range(address=’{start range}:{end range}’)

Wymagane dane wejściowe

Poniżej przedstawiono parametry adresu URL, które należy przekazać

Identyfikator skoroszytu — identyfikator skoroszytu
Nazwa arkusza — tytuł arkusza
Zakres początkowy — zakres początkowy
Zakres końcowy — zakres końcowy

Wymagany moduł ekstrakcji wyników

Ten łącznik zwraca wszystkie wartości komórek w podanym zakresie.

8) Aktualizacja wartości według zakresu

Cel

Użytkownicy mogą przekazać jako dane wejściowe identyfikator skoroszytu, nazwę arkusza, zakres początkowy, zakres końcowy oraz wartości do aktualizacji, a Tulip zaktualizuje wartości w podanym zakresie. Odpowiedzią API będą zaktualizowane wartości w zakresie.

Punkt końcowy

Wywołanie HTTP PATCH do punktu końcowego—https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/range(address=’{start range}:{end range}’)

Wymagane dane wejściowe

Poniżej przedstawiono parametry adresu URL, które należy przekazać

Identyfikator skoroszytu — identyfikator skoroszytu
Nazwa arkusza — tytuł arkusza
Zakres początkowy — zakres początkowy
Zakres końcowy — zakres końcowy
Wartości poszczególnych komórek w podanym zakresie

Wymagany ekstraktor wyników

Nie wymagamy żadnego ekstraktora wyników.

9) Utwórz tabelę w arkuszu

Cel

Użytkownicy mogą przekazać identyfikator skoroszytu, nazwę arkusza, adres arkusza oraz informację „Czy zawiera nagłówki” jako dane wejściowe, a Tulip utworzy nową tabelę o podanej nazwie. Odpowiedzią API będą metadane oraz różne właściwości tabeli.
Można to następnie wykorzystać do pobierania i aktualizowania danych z arkuszy kalkulacyjnych.
Informacje pobierane z interfejsu API Microsoft Graph V1.0 można następnie wykorzystać w aplikacjach Tulip, tabelach Tulip lub zmiennych Tulip, które będą przekazywane do innych funkcji łączników.

Punkt końcowy

Wywołanie HTTP POST do punktu końcowego https://graph.microsoft.com:443/v1.0/me/drive/items/{itemID}/workbook/worksheets/add

Wymagane dane wejściowe

Poniżej przedstawiono parametry wysyłane w treści żądania

ID skoroszytu — identyfikator skoroszytu
Nazwa arkusza — tytuł arkusza
Adres — adres lub nazwa obiektu zakresu reprezentującego źródło danych. Jeśli adres nie zawiera nazwy arkusza, używany jest aktualnie aktywny arkusz.
hasHeaders – wartość logiczna wskazująca, czy importowane dane zawierają etykiety kolumn. Jeśli źródło nie zawiera nagłówków (tj. gdy ta właściwość ma wartość „false”), program Excel automatycznie wygeneruje nagłówek, przesuwając dane o jeden wiersz w dół

Wymagany ekstraktor danych wyjściowych

Zwraca wartości metadanych nowo utworzonej tabeli.

10) Dodaj nowy wiersz do tabeli

Cel

Użytkownicy mogą przekazać identyfikator skoroszytu, nazwę tabeli i wartości wiersza jako dane wejściowe, a Tulip utworzy nowy wiersz z podanymi wartościami. Odpowiedzią API będą wartości utworzonego wiersza w tabeli.

Punkt końcowy

Wywołanie HTTP POST do punktu końcowego https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/tables/{tablename}/rows/add

Wymagane dane wejściowe

Poniżej przedstawiono parametry wysyłane w treści żądania

Identyfikator skoroszytu — identyfikator skoroszytu
Nazwa arkusza — tytuł arkusza
Wartości wierszy

Wymagany ekstraktor wyników

Zwraca wartości wiersza nowo utworzonego wiersza.

11) Wyczyść dane arkusza

Cel

Użytkownicy mogą przekazać identyfikator skoroszytu, nazwę arkusza, zakres początkowy i końcowy jako dane wejściowe, a Tulip wyczyści wartości komórek w oparciu o podany zakres.

Punkt końcowy

Wywołanie HTTP POST do punktu końcowego https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheet/{worksheetName}/range(address=’{start range}:{end range}’)/clear

Wymagane dane wejściowe

Poniżej przedstawiono parametry wysyłane w treści żądania

Identyfikator skoroszytu — identyfikator skoroszytu
Nazwa arkusza — tytuł arkusza
Zakres początkowy
Zakres końcowy

Więcej informacji

Zobacz więcej informacji na temat łączników Microsoft