Zawartość x
    Microsoft Excel Connector
    • 06 Mar 2024
    • 6 Minuty do przeczytania
    • Współtwórcy
    • Wydrukować
    Zawartość

    Microsoft Excel Connector

    • Zaktualizowano 06 Mar 2024
    • 6 Minuty do przeczytania
    • Współtwórcy
    • Wydrukować
    Article Summary

    ::: (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

    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