Microsoft Excel Connector

::: (info) () Aby pobrać aplikację, odwiedź: Biblioteka:::

Microsoft Excel Connector

Integracja z Microsoft O365 Worksheet V1.0 Api

Wprowadzenie

Microsoft Excel Worksheets API pozwala użytkownikom tworzyć, czytać i edytować arkusze Microsoft Excel z odpowiednim dostępem do ich kont Office365. Celem tego konektora jest integracja Tulip z Microsoft za pomocą interfejsu Graph API (v1.0) firmy Microsoft przy użyciu konektorów HTTP i zapewnienie naszym klientom gotowego konektora, który można zaimportować do ich instancji.

Cel

W tym dokumencie zostaną przedstawione różne funkcje konektorów, które można zbudować, wykonując wywołania HTTP do interfejsu Graph API (v1.0) firmy Microsoft w celu interakcji z arkuszem M365 Excel, aby zaprezentować różne akcje 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

1. Utwórz konto w Microsoft O365 i skonfiguruj poświadczenia OAuth 2.0 w Microsoft Entra ID.
2. Zarejestrowanie interfejsu API z wymaganymi zakresami w portalu Microsoft. Azure - Entra ID

Film przedstawiający konfigurację łącznika:

Szczegóły połączenia Tulip

Następujące informacje muszą zostać skonfigurowane w Tulip's

Konektory.

1. Uruchomione na: Cloud Connector Host
2. Host: graph.microsoft.com
3. Port:443
4. TLS: Tak

OAuth 2: Aby uzyskać token dostępu do komunikacji z interfejsem Graph API firmy Microsoft.

Funkcje konektora

1) Pobierz szczegóły jednego dysku

Cel

Ten konektor pobierze wszystkie elementy z jednego dysku.

Punkt końcowy

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

Wymagane dane wejściowe

Dane wejściowe nie są wymagane

Wymagane dane wyjściowe Extractor

1. SheetID: Unikalny identyfikator skoroszytu, który będzie używany do wykonywania innych zadań.
2. CreatedAt: Data i godzina utworzenia skoroszytu.
3. LastModified: Data i godzina ostatniej modyfikacji skoroszytu.
4. SheetName: Nazwa skoroszytu.
5. SpreadSheetURL: Adres URL skoroszytu.

2) Pobierz wszystkie arkusze w skoroszycie

Cel

Ten łącznik pobierze wszystkie arkusze ze skoroszytu, przekazując identyfikator skoroszytu.

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ć

1. Identyfikator skoroszytu

Wymagane dane wyjściowe Extractor

1. sheetId: Unikalny identyfikator arkusza SpreadSheet, który będzie używany do wykonywania innych zadań.
2. sheetName: Wyświetlana nazwa arkusza roboczego.
3. sheetPosition: Położenie arkusza w skoroszycie w oparciu o zero.
4. sheetVisibility: Widoczność arkusza. Możliwe wartości to Visible, Hidden, VeryHidden.

3) Pobierz metadane arkusza

Cel

Ten łącznik pobierze dane z WorkbookID i Worksheet Name.

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ć

1. Identyfikator skoroszytu
2. Nazwa arkusza roboczego

Wymagane dane wyjściowe Extractor

1. sheetId: Unikalny identyfikator arkusza SpreadSheet, który będzie używany do wykonywania innych zadań.
2. sheetName: wyświetlana nazwa arkusza.
3. sheetPosition: Położenie arkusza w skoroszycie w oparciu o zero.
4. sheetVisibility: Widoczność arkusza. Możliwe wartości to: Visible, Hidden, VeryHidden.

4) Tworzenie nowego arkusza

Cel

1. Użytkownicy mogą przekazać identyfikator skoroszytu i nazwę arkusza jako dane wejściowe, a Tulip utworzy nowy arkusz roboczy z podaną nazwą arkusza. Odpowiedzią API będą metadane i różne właściwości arkusza. Można to dalej wykorzystać do pobierania i aktualizowania danych z arkuszy.
2. Informacje pobierane z interfejsu API Microsoft Graph V1.0 mogą być następnie wykorzystywane w aplikacjach Tulip, tabelach Tulip lub zmiennych Tulip, które mogą być przesyłane do innych funkcji konektora.

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

Jako treść żądania wysyłane są następujące parametry

1. Identyfikator skoroszytu - identyfikator skoroszytu
2. Nazwa arkusza - tytuł arkusza

Wymagany ekstraktor danych wyjściowych

1. WorksheetId: Unikalny identyfikator arkusza kalkulacyjnego, który będzie używany do wykonywania innych zadań.
2. spreadsheetURL: Adres URL nowo utworzonego arkusza kalkulacyjnego.
3. Dodatkowe parametry zwracane wraz z odpowiedzią mogą zostać dołączone jako część parametrów wyjściowych.

5) Zaktualizuj właściwości arkusza

Cel

Użytkownicy mogą przekazać identyfikator skoroszytu, nazwę starego arkusza roboczego, pozycję arkusza roboczego i nazwę nowego arkusza roboczego jako dane wejściowe, a Tulip zaktualizuje arkusz roboczy o podaną nazwę arkusza. Odpowiedzią interfejsu API będą metadane i różne właściwości arkusza. Można to dalej 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

Następujące parametry są wysyłane jako treść żądania

1. Identyfikator skoroszytu - identyfikator skoroszytu
2. Nazwa arkusza - tytuł arkusza
3. Pozycja arkusza - zerowa pozycja arkusza w skoroszycie
4. Nowa nazwa arkusza - nowy tytuł arkusza

Wymagany ekstraktor danych wyjściowych

1. sheetID: Unikalny identyfikator skoroszytu, który będzie używany do wykonywania innych zadań
2. sheetName: Wyświetlana nazwa arkusza.
3. sheetPosition: Pozycja arkusza w skoroszycie oparta na zerze.

6) Pobierz dane określonej komórki

Cel

Ten konektor pobiera dane z arkuszy skoroszytu na podstawie podanego identyfikatora skoroszytu, nazwy arkusza, indeksu wiersza i indeksu kolumny jako danych wejściowych. Odpowiedzią API będą dane podanej wartości 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ć

1. Identyfikator skoroszytu - identyfikator skoroszytu
2. Nazwa arkusza - tytuł arkusza
3. Indeks wiersza- Numer wiersza komórki do pobrania
4. Column Index- Numer kolumny komórki, która ma zostać pobrana

Wymagany ekstraktor danych wyjściowych

To złącze zwraca wartość komórki podanego indeksu wiersza i kolumny.

7) Pobierz dane zakresu arkusza

Cel

Ten łącznik pobiera dane z arkuszy skoroszytu na podstawie podanego identyfikatora skoroszytu, 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ć

1. Identyfikator skoroszytu - identyfikator skoroszytu
2. Nazwa arkusza - tytuł arkusza
3. Zakres początkowy- Zakres początkowy
4. Zakres końcowy- Zakres końcowy

Wymagany ekstraktor danych wyjściowych

Ten konektor zwraca wszystkie wartości komórek w podanym zakresie.

8) Aktualizuj wartości według zakresu

Cel

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

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ć

1. Identyfikator skoroszytu - identyfikator skoroszytu
2. Nazwa arkusza - tytuł arkusza
3. Zakres początkowy- Zakres początkowy
4. Zakres końcowy- Zakres końcowy
5. Wartości każdej komórki w podanym zakresie

Wymagany ekstraktor danych wyjściowych

Nie wymagamy żadnego ekstraktora danych wyjściowych.

9) Utwórz tabelę w arkuszu

Cel

1. Użytkownicy mogą przekazać identyfikator skoroszytu, nazwę arkusza, adres arkusza i nagłówki jako dane wejściowe, a Tulip utworzy nową tabelę z nazwą tabeli. Odpowiedzią interfejsu API będą metadane i różne właściwości tabeli.
2. Można to dalej wykorzystać do pobierania i aktualizowania danych z arkuszy kalkulacyjnych.
3. Informacje pobierane z interfejsu API Microsoft Graph V1.0 mogą być następnie wykorzystywane w aplikacjach Tulip, tabelach Tulip lub zmiennych Tulip, które będą przesyłane do innych funkcji konektora.

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

Jako treść żądania wysyłane są następujące parametry

1. Identyfikator skoroszytu - identyfikator skoroszytu
2. Nazwa arkusza - tytuł arkusza
3. Address - adres lub nazwa obiektu zakresu reprezentującego źródło danych. Jeśli adres nie zawiera nazwy arkusza, używany jest aktualnie aktywny arkusz.
4. 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ść jest ustawiona na false), Excel automatycznie wygeneruje nagłówek przesuwający dane w dół o jeden wiersz

Wymagany ekstraktor danych wyjściowych

Zwraca wartości metadanych nowo utworzonej tabeli.

10) Dodanie nowego wiersza w 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 wiersza. Odpowiedzią interfejsu API będą utworzone wartości wierszy 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

Następujące parametry są wysyłane jako treść żądania

1. Identyfikator skoroszytu - identyfikator skoroszytu
2. Nazwa arkusza - tytuł arkusza
3. Wartości wierszy

Wymagane wyjście Extractor

Zwraca wartości wiersza nowo utworzonego wiersza.

11) Wyczyść dane arkusza

Cel

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

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 jako treść żądania

1. Identyfikator skoroszytu - identyfikator skoroszytu
2. Nazwa arkusza - tytuł arkusza
3. Zakres początkowy
4. Zakres końcowy

Więcej informacji

Więcej informacji na temat konektorów Microsoft

• Konektor kalendarza Microsoft
• Konektor Microsoft Outlook
• Konektor Microsoft Teams