Microsoft Excel-Konnektor

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

Microsoft Excel-Konnektor

Integration mit der Microsoft O365 Worksheet V1.0 API

Einführung

Die Microsoft Excel Worksheets API ermöglicht es Benutzern, Microsoft Excel-Tabellen zu erstellen, zu lesen und zu bearbeiten, sofern sie über die entsprechenden Zugriffsrechte für ihre Office 365-Konten verfügen. Das Ziel dieses Connectors ist es, Tulip mithilfe der Microsoft Graph API (v1.0) über HTTP-Connectors in Microsoft zu integrieren und unseren Kunden einen sofort einsatzbereiten Connector zur Verfügung zu stellen, der in ihre Instanz importiert werden kann.

Zweck

Dieses Dokument beleuchtet verschiedene Konnektorfunktionen, die durch HTTP-Aufrufe an die Microsoft Graph-API (v1.0) erstellt werden können, um mit der M365-Excel-Tabelle zu interagieren und verschiedene Lese- und Schreibaktionen in der Tabelle zu demonstrieren, die für verschiedene Anwendungsfälle genutzt werden können.

API-Dokumentation

Dokumentation zur Microsoft Graph-API

Voraussetzungen

Erstellen Sie ein Konto bei Microsoft O365 und konfigurieren Sie die OAuth 2.0-Anmeldeinformationen in Microsoft Entra ID.
Registrieren Sie die API mit den erforderlichen Bereichen im Microsoft-Portal. Azure – Entra ID

Video zur Einrichtung des Konnektors:

Tulip-Verbindungsdetails

Die folgenden Informationen müssen in den

Konfigurieren.

Ausgeführt auf: Cloud-Connector-Host
Host: graph.microsoft.com
Port: 443
TLS: Ja

OAuth 2: Zum Abrufen des Zugriffstokens für die Kommunikation mit der Microsoft Graph-API

Funktionen des Connectors

1) Details zu einem Laufwerk abrufen

Zweck

Dieser Konnektor ruft alle Elemente aus einem Laufwerk ab.

Endpunkt

HTTP-GET-Aufruf an den Endpunkt –https://graph.micrsoft.com:443/v1.0/me/drive/root/children

Erforderliche Eingaben

Keine Eingaben erforderlich

Erforderlicher Ausgabekoppler

SheetID: Eindeutige Kennung der Arbeitsmappe, die zur Ausführung der weiteren Aufgaben verwendet wird.
CreatedAt: Erstellungsdatum und -uhrzeit der Arbeitsmappe.
LastModified: Datum und Uhrzeit der letzten Änderung der Arbeitsmappe.
Blattname: Der Name der Arbeitsmappe.
SpreadSheetURL: Die URL der Arbeitsmappe.

2) Alle Arbeitsblätter einer Arbeitsmappe abrufen

Zweck

Dieser Konnektor ruft alle Arbeitsblätter einer Arbeitsmappe ab, indem die Arbeitsmappen-ID übergeben wird.

Endpunkt

HTTP-GET an den Endpunkt –https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets

Erforderliche Eingabe

Die folgenden URL-Parameter müssen übergeben werden

Arbeitsmappen-ID

Erforderlicher Extraktor

sheetId: Eindeutige Kennung der Tabelle, die zur Ausführung der weiteren Aufgaben verwendet wird.
sheetName: Der Anzeigename des Arbeitsblatts.
sheetPosition: Die Position des Arbeitsblatts innerhalb der Arbeitsmappe, beginnend bei 0.
sheetVisibility: Die Sichtbarkeit des Arbeitsblatts. Mögliche Werte sind „Visible“, „Hidden“ und „VeryHidden“.

3) Metadaten des Arbeitsblatts abrufen

Zweck

Dieser Konnektor ruft die Daten anhand der Arbeitsmappen-ID und des Arbeitsblattnamens ab.

Endpunkt

HTTP-GET-Aufruf an den Endpunkt https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/

Erforderliche Eingaben

Die folgenden URL-Parameter müssen übergeben werden

Arbeitsmappen-ID
Arbeitsblattname

Erforderlicher Extraktor

sheetId: Eindeutige Kennung der Tabelle, die zur Ausführung der weiteren Aufgaben verwendet wird.
sheetName: Der Anzeigename des Arbeitsblatts.
sheetPosition: Die Position des Arbeitsblatts innerhalb der Arbeitsmappe, beginnend bei 0.
sheetVisibility: Die Sichtbarkeit des Arbeitsblatts. Mögliche Werte sind: „Visible“, „Hidden“, „VeryHidden“.

4) Erstellen eines neuen Arbeitsblatts

Zweck

Benutzer können eine Arbeitsmappen-ID und einen Arbeitsblattnamen als Eingabe übergeben, woraufhin Tulip ein neues Arbeitsblatt mit dem angegebenen Namen erstellt. Die Antwort der API enthält die Metadaten und verschiedene Eigenschaften des Arbeitsblatts. Diese können anschließend zum Abrufen und Aktualisieren von Daten aus den Arbeitsblättern verwendet werden.
Die aus der Microsoft Graph V1.0-API abgerufenen Informationen können anschließend entweder in Tulip-Apps, Tulip-Tabellen oder Tulip-Variablen verwendet werden, die an andere Connector-Funktionen weitergeleitet werden.

Endpunkt

HTTP-POST-Aufruf an den Endpunkt https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/add

Erforderliche Eingaben

Die folgenden Parameter werden als Request-Body gesendet

Arbeitsmappen-ID – Die Arbeitsmappen-ID
Arbeitsblattname – Titel des Arbeitsblatts

Erforderlicher Ausgabextraktor

WorksheetId: Eindeutige Kennung der Tabelle, die zur Ausführung der weiteren Aufgaben verwendet wird.
spreadsheetURL: Die URL der neu erstellten Tabelle.
Zusätzliche Parameter, die mit der Antwort zurückgegeben werden, können als Teil der Ausgabeparameter einbezogen werden.

5) Eigenschaften des Arbeitsblatts aktualisieren

Zweck

Benutzer können eine Arbeitsmappen-ID, den alten Arbeitsblattnamen, die Position des Arbeitsblatts und den neuen Arbeitsblattnamen als Eingabe übergeben; Tulip aktualisiert das Arbeitsblatt dann mit dem angegebenen Namen. Die Antwort der API enthält die Metadaten und verschiedene Eigenschaften des Arbeitsblatts. Diese können anschließend zum Abrufen und Aktualisieren von Daten aus den Tabellenkalkulationen verwendet werden.

Endpunkt

HTTP-PATCH-Aufruf an den Endpunkt –https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}

Erforderliche Eingabe

Die folgenden Parameter werden als Request-Body gesendet

Arbeitsmappen-ID – Die Arbeitsmappen-ID
Arbeitsblattname – Titel des Arbeitsblatts
Position des Arbeitsblatts – Die Position des Arbeitsblatts innerhalb der Arbeitsmappe, beginnend bei 0
Name des neuen Arbeitsblatts – Titel des neuen Arbeitsblatts

Erforderlicher Ausgabextraktor

sheetID: Eindeutige Kennung der Arbeitsmappe, die zur Ausführung der anderen Aufgaben verwendet wird
sheetName: Der Anzeigename des Arbeitsblatts.
sheetPosition: Die Position des Arbeitsblatts innerhalb der Arbeitsmappe, beginnend bei 0.

6) Daten aus einer bestimmten Zelle abrufen

Zweck

Dieser Konnektor ruft die Daten aus Arbeitsblättern einer Arbeitsmappe ab, basierend auf den als Eingabe angegebenen Werten für „WorkbookID“, „Worksheet Name“, „Row index“ und „Column index“. Die Antwort der API enthält den Wert der angegebenen Zelle.

Endpunkt

HTTP-GET-Aufruf an den Endpunkt–https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/cell(row={Zeilenindex},column={Spaltenindex})

Erforderliche Eingaben

Die folgenden URL-Parameter müssen übergeben werden

Arbeitsmappen-ID – ID der Arbeitsmappe
Arbeitsblattname – Titel des Arbeitsblatts
Zeilenindex – Zeilennummer der abzurufenden Zelle
Spaltenindex – Spaltennummer der abzurufenden Zelle

Erforderlicher Ausgabekoppler

Dieser Konnektor gibt den Zellwert der angegebenen Zeilen- und Spaltenindexe zurück.

7) Daten aus einem Arbeitsblattbereich abrufen

Zweck

Dieser Konnektor ruft die Daten aus Arbeitsblättern einer Arbeitsmappe ab, basierend auf der angegebenen Arbeitsmappen-ID, dem Arbeitsblattnamen sowie dem Start- und Endbereich als Eingabe. Die Antwort der API enthält die Daten des angegebenen Bereichs.

Endpunkt

HTTP-GET-Aufruf an den Endpunkt–https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/range(address=’{start range}:{end range}’)

Erforderliche Eingaben

Die folgenden URL-Parameter müssen übergeben werden

Arbeitsmappen-ID – ID der Arbeitsmappe
Arbeitsblattname – Titel des Arbeitsblatts
Startbereich – Startbereich
Endbereich – Endbereich

Erforderlicher Ausgabe-Extractor

Dieser Konnektor gibt alle Zellwerte innerhalb des angegebenen Bereichs zurück.

8) Werte nach Bereich aktualisieren

Zweck

Benutzer können eine Arbeitsmappen-ID, einen Arbeitsblattnamen, einen Startbereich, einen Endbereich und die zu aktualisierenden Werte als Eingabe übergeben; Tulip aktualisiert daraufhin die Werte im Bereich entsprechend dem angegebenen Bereich. Die Antwort der API enthält die aktualisierten Werte des Bereichs.

Endpunkt

HTTP-PATCH-Aufruf an den Endpunkt–https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/range(address=’{start range}:{end range}’)

Erforderliche Eingaben

Im Folgenden sind die URL-Parameter aufgeführt, die übergeben werden müssen

Arbeitsmappen-ID – ID der Arbeitsmappe
Arbeitsblattname – Titel des Arbeitsblatts
Startbereich – Startbereich
Endbereich – Endbereich
Werte der einzelnen Zellen innerhalb des angegebenen Bereichs

Erforderlicher Ausgabe-Extraktor

Wir benötigen keinen Ausgabextraktor.

9) Erstellen Sie eine Tabelle im Arbeitsblatt

Zweck

Benutzer können eine Arbeitsmappen-ID, einen Arbeitsblattnamen, eine Arbeitsblattadresse und die Angabe „Hat Kopfzeilen“ als Eingabe übergeben, woraufhin Tulip eine neue Tabelle mit dem angegebenen Tabellennamen erstellt. Die Antwort der API enthält die Metadaten und verschiedene Eigenschaften der Tabelle.
Diese können anschließend zum Abrufen und Aktualisieren von Daten aus den Tabellenkalkulationen verwendet werden.
Die aus der Microsoft Graph V1.0-API abgerufenen Informationen können anschließend entweder in Tulip-Apps, Tulip-Tabellen oder Tulip-Variablen verwendet werden, die an andere Konnektorfunktionen weitergeleitet werden.

Endpunkt

HTTP-POST-Aufruf an den Endpunkt https://graph.microsoft.com:443/v1.0/me/drive/items/{itemID}/workbook/worksheets/add

Erforderliche Eingaben

Die folgenden Parameter werden als Request-Body gesendet

Arbeitsmappen-ID – Die ID der Arbeitsmappe
Arbeitsblattname – Titel des Arbeitsblatts
Adresse – Adresse oder Name des Bereichsobjekts, das die Datenquelle darstellt. Wenn die Adresse keinen Blattnamen enthält, wird das aktuell aktive Blatt verwendet.
hasHeaders – Boolescher Wert, der angibt, ob die zu importierenden Daten Spaltenüberschriften enthalten. Wenn die Quelle keine Überschriften enthält (d. h. wenn diese Eigenschaft auf „false“ gesetzt ist), generiert Excel automatisch eine Überschrift und verschiebt die Daten um eine Zeile nach unten

Erforderlicher Ausgabe-Extractor

Dies gibt die Metadatenwerte der neu erstellten Tabelle zurück.

10) Eine neue Zeile in eine Tabelle einfügen

Zweck

Benutzer können eine Arbeitsmappen-ID, einen Tabellennamen und Zeilenwerte als Eingabe übergeben; Tulip erstellt daraufhin eine neue Zeile mit den angegebenen Zeilenwerten. Die Antwort der API enthält die Werte der erstellten Zeile in der Tabelle.

Endpunkt

HTTP-POST-Aufruf an den Endpunkt https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/tables/{tablename}/rows/add

Erforderliche Eingaben

Die folgenden Parameter werden als Request-Body gesendet

Arbeitsmappen-ID – Die Arbeitsmappen-ID
Arbeitsblattname – Titel des Arbeitsblatts
Zeilenwerte

Erforderlicher Ausgabextraktor

Gibt die Zeilenwerte der neu erstellten Zeile zurück.

11) Löschen der Arbeitsblattdaten

Zweck

Benutzer können eine Arbeitsmappen-ID, einen Arbeitsblattnamen sowie einen Start- und Endbereich als Eingabe übergeben; Tulip löscht daraufhin die Zellwerte innerhalb des angegebenen Bereichs.

Endpunkt

HTTP-POST-Aufruf an den Endpunkt https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheet/{worksheetName}/range(address=’{Startbereich}:{Endbereich}’)/clear

Erforderliche Eingaben

Die folgenden Parameter werden als Request-Body gesendet

Arbeitsmappen-ID – Die Arbeitsmappen-ID
Arbeitsblattname – Titel des Arbeitsblatts
Startbereich
Endbereich

Weiterführende Informationen

Weitere Informationen zu Microsoft-Konnektoren