MENU
      Zawartość x
      Microsoft Excel Connector
      • 13 Jan 2025
      • 6 Minuty do przeczytania
      • Współtwórcy
      • Wydrukować
      Zawartość

      Microsoft Excel Connector

      • Zaktualizowano 13 Jan 2025
      • 6 Minuty do przeczytania
      • Współtwórcy
      • Wydrukować
      Streszczenie artykułu

      To download the app, visit: Library

      Microsoft Excel Connector

      Integracja z Microsoft O365 Worksheet V1.0 Api

      Wprowadzenie

      Microsoft Excel Worksheets API pozwala użytkownikom tworzyć, odczytywać 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ę konektora:

      Szczegóły połączenia Tulip

      Następujące informacje będą musiały zostać skonfigurowane w Tulip's

      Konektory.

      1. Uruchamiane 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ą 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: Położenie arkusza w skoroszycie w oparciu o zero.

      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ć dalej 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

      Czy ten artykuł był pomocny?
      What's Next
      Platforma
      Biblioteka
      Produkty
      Zasoby
      Dotychczasowi użytkownicy
      Połącz się z nami
      Kontakt Sprzedaż
      • +1 833 468 8547
      • sales@tulip.co
      Copyright © Tulip Interfaces. Wszystkie prawa zastrzeżone