Microsoft Excel-Verbindung

::: (info) () Um die App herunterzuladen, besuchen Sie: Bibliothek:::

Microsoft Excel-Konnektor

Integration mit Microsoft O365 Arbeitsblatt V1.0 Api

Einführung

Microsoft Excel Worksheets API ermöglicht es den Benutzern, Microsoft Excel-Arbeitsblätter zu erstellen, zu lesen und zu bearbeiten, wenn sie den richtigen Zugang zu ihren Office365-Konten haben. Das Ziel dieses Konnektors ist es, Tulip mit Microsofts Graph API (v1.0) unter Verwendung von HTTP-Konnektoren zu integrieren und unseren Kunden einen fertigen Konnektor zu bieten, der in ihre Instanz importiert werden kann.

Zweck

In diesem Dokument werden verschiedene Konnektor-Funktionen hervorgehoben, die durch HTTP-Aufrufe an Microsofts Graph API (v1.0) erstellt werden können, um mit dem M365 Excel-Arbeitsblatt zu interagieren und verschiedene Lese- und Schreibaktionen auf dem Arbeitsblatt zu zeigen, die für verschiedene Anwendungsfälle genutzt werden können.

API-Dokument

Microsoft Graph API-Dokumentation

Vorraussetzungen

1. Erstellen Sie ein Konto bei Microsoft O365 und konfigurieren Sie die OAuth 2.0-Anmeldeinformationen in Microsoft Entra ID.
2. 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 auf Tulip's

Konnektoren.

1. Läuft auf: Cloud Connector Host
2. Rechner: graph.microsoft.com
3. Anschluss:443
4. TLS: Ja

OAuth 2: Um das Zugriffstoken für die Kommunikation mit Microsofts Graph API zu erhalten

Connector-Funktionen

1) Abrufen von Details zu einem Laufwerk

Zweck

Dieser Connector ruft alle Elemente von einem Laufwerk ab.

Endpunkt

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

Erforderliche Eingabe

Keine Eingaben erforderlich

Erforderlicher Output Extractor

1. SheetID: Eindeutiger Bezeichner der Arbeitsmappe, die für die Ausführung der anderen Aufgaben verwendet wird.
2. ErstelltAt: Das Erstellungsdatum und die Uhrzeit der Arbeitsmappe.
3. LastModified: Das Datum und die Uhrzeit der letzten Änderung der Arbeitsmappe.
4. Blattname: Der Name der Arbeitsmappe.
5. SpreadSheetURL: Die URL der Arbeitsmappe.

2) Alle Arbeitsblätter in einer Arbeitsmappe abrufen

Zweck

Dieser Konnektor ruft alle Arbeitsblätter einer Arbeitsmappe ab, indem er die workbookID übergibt.

Endpunkt

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

Erforderliche Eingabe

Die folgenden URL-Parameter sind zu übergeben

1. Arbeitsmappen-ID

Erforderlicher Output-Extraktor

1. sheetId: Eindeutiger Bezeichner des Arbeitsblatts, das für die Ausführung der anderen Aufgaben verwendet wird.
2. sheetName:Der Anzeigename des Arbeitsblatts.
3. sheetPosition:Die nullbasierte Position des Arbeitsblatts innerhalb der Arbeitsmappe.
4. sheetVisibility: Die Sichtbarkeit des Arbeitsblatts. Die möglichen Werte sind Visible, Hidden, VeryHidden.

3) Arbeitsblatt-Metadaten abrufen

Zweck

Dieser Konnektor ruft die Daten aus WorkbookID und Worksheet Name ab.

Endpunkt

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

Erforderliche Eingabe

Die folgenden URL-Parameter sind zu übergeben

1. Arbeitsmappen-ID
2. Arbeitsblatt-Name

Erforderlicher Output Extraktor

1. sheetId: Eindeutiger Bezeichner des Arbeitsblatts, das für die Ausführung der anderen Aufgaben verwendet wird.
2. sheetName:Der Anzeigename des Arbeitsblatts.
3. sheetPosition:Die nullbasierte Position des Arbeitsblatts innerhalb der Arbeitsmappe.
4. sheetVisibility: Die Sichtbarkeit des Arbeitsblatts. Die möglichen Werte sind: Sichtbar, Versteckt, SehrVersteckt.

4) Erstellen eines neuen Arbeitsblatts

Zweck

1. Der Benutzer kann eine Arbeitsbuch-ID und den Namen des Arbeitsblatts als Eingabe übergeben und Tulip wird ein neues Arbeitsblatt mit dem angegebenen Blattnamen erstellen. Die Antwort der API besteht aus den Metadaten und verschiedenen Eigenschaften des Arbeitsblatts. Diese können weiter verwendet werden, um Daten aus den Arbeitsblättern zu holen und zu aktualisieren.
2. Die Informationen, die aus der Microsoft Graph V1.0 API gezogen werden, können dann entweder innerhalb von Tulip-Anwendungen, Tulip-Tabellen oder Tulip-Variablen weiterverwendet werden, die dann in 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 Eingabe

Im Folgenden sind die Parameter aufgeführt, die als Request Body gesendet werden

1. Arbeitsbuch-ID - Die Arbeitsbuch-ID
2. Arbeitsblatt-Name - Arbeitsblatt-Titel

Erforderlicher Output-Extraktor

1. WorksheetId: Eindeutiger Bezeichner des SpreadSheet, die verwendet werden, um die anderen Aufgaben auszuführen.
2. spreadsheetURL: Die URL des neu erstellten Arbeitsblatts.
3. Zusätzliche Parameter, die mit der Antwort zurückgegeben werden, können als Teil der Ausgabeparameter aufgenommen werden.

5) Arbeitsblatteigenschaften aktualisieren

Zweck

Der Benutzer kann eine Arbeitsmappen-ID, den Namen des alten Arbeitsblatts, die Position des Arbeitsblatts und den Namen des neuen Arbeitsblatts als Eingabe übergeben und Tulip aktualisiert das Arbeitsblatt mit dem angegebenen Blattnamen. Die Antwort der API besteht aus den Metadaten und verschiedenen Eigenschaften des Arbeitsblatts. Diese können weiter verwendet werden, um Daten aus den Arbeitsblättern zu holen und zu aktualisieren.

Endpunkt

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

Erforderliche Eingaben

Im Folgenden sind die Parameter aufgeführt, die als Request Body gesendet werden

1. Arbeitsbuch-ID - Die Arbeitsbuch-ID
2. Arbeitsblatt-Name - Arbeitsblatt-Titel
3. Arbeitsblattposition - Die nullbasierte Position des Arbeitsblatts innerhalb der Arbeitsmappe
4. Neuer Arbeitsblattname - Neuer Arbeitsblatttitel

Erforderlicher Output-Extraktor

1. sheetID: Eindeutiger Bezeichner der Arbeitsmappe, die für die Ausführung der anderen Aufgaben verwendet wird
2. BlattName: Der Anzeigename des Arbeitsblatts.
3. sheetPosition: Die nullbasierte Position des Arbeitsblatts innerhalb der Arbeitsmappe.

6) Abrufen von Daten einer bestimmten Zelle

Zweck

Dieser Konnektor ruft die Daten aus den Arbeitsblättern einer Arbeitsmappe ab, basierend auf der angegebenen WorkbookID, dem Arbeitsblattnamen, dem Zeilenindex und dem Spaltenindex als Eingabe. Die Antwort der API sind die Daten des angegebenen Zellwerts.

Endpunkt

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

Erforderliche Eingabe

Die folgenden URL-Parameter sind zu übergeben

1. Arbeitsmappen-ID - Arbeitsmappen-ID
2. Arbeitsblatt-Name - Arbeitsblatt-Titel
3. Zeilenindex - Zeilennummer der abzurufenden Zelle
4. Spaltenindex - Spaltennummer der Zelle, die abgerufen werden soll

Erforderlicher Ausgabeextraktor

Dieser Connector gibt den Zellwert der angegebenen Zeile und Spaltenindex zurück.

7) Arbeitsblattbereichsdaten abrufen

Zweck

Dieser Konnektor ruft die Daten von Arbeitsblättern einer Arbeitsmappe ab, die auf der angegebenen WorkbookID, dem Arbeitsblattnamen, dem Startbereich und dem Endbereich als Eingabe basieren. Die Antwort der API sind 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 Eingabe

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

1. Arbeitsmappen-ID - Arbeitsmappen-ID
2. Arbeitsblattname - Arbeitsblatttitel
3. Startbereich - Startbereich
4. Endbereich- Endbereich

Erforderlicher Output-Extraktor

Dieser Connector 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 und Tulip aktualisiert die Werte mit dem angegebenen Bereich. Die Antwort der API sind 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 Eingabe

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

1. Arbeitsmappen-ID - Arbeitsmappen-ID
2. Arbeitsblattname - Arbeitsblatttitel
3. Startbereich - Startbereich
4. Endbereich- Endbereich
5. Werte der einzelnen Zellen innerhalb des angegebenen Bereichs

Erforderlicher Ausgabe-Extraktor

Wir benötigen keinen Ausgabe-Extraktor.

9) Erstellen Sie eine Tabelle im Arbeitsblatt

Zweck

1. Der Benutzer kann eine Arbeitsmappen-ID, einen Arbeitsblattnamen, eine Arbeitsblattadresse und eine Kopfzeile als Eingabe übergeben und Tulip wird eine neue Tabelle mit dem Tabellennamen erstellen. Die Antwort der API besteht aus den Metadaten und verschiedenen Eigenschaften der Tabelle.
2. Diese können weiter verwendet werden, um Daten aus den Tabellenblättern zu holen und zu aktualisieren.
3. Die Informationen, die aus der Microsoft Graph V1.0 API gezogen werden, können dann entweder innerhalb von Tulip-Anwendungen, Tulip-Tabellen oder Tulip-Variablen weiterverwendet werden, die dann in andere Connector-Funktionen geleitet werden.

Endpunkt

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

Erforderliche Eingabe

Im Folgenden sind die Parameter aufgeführt, die als Request Body gesendet werden

1. Arbeitsmappen-ID - Die Arbeitsmappen-ID
2. Arbeitsblattname - Arbeitsblatttitel
3. Adresse - Adresse oder Name des Bereichsobjekts, das die Datenquelle darstellt. Wenn die Adresse keinen Blattnamen enthält, wird das aktuell aktive Blatt verwendet.
4. hasHeaders - Boolescher Wert, der angibt, ob die importierten Daten Spaltenbeschriftungen enthalten. Wenn die Quelle keine Kopfzeilen enthält (d. h., wenn diese Eigenschaft auf false gesetzt ist), generiert Excel automatisch eine Kopfzeile, die die Daten um eine Zeile nach unten verschiebt.

Erforderlicher Output-Extraktor

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

10) Hinzufügen einer neuen Zeile in einer Tabelle

Zweck

Benutzer können eine Arbeitsmappen-ID, einen Tabellennamen und Zeilenwerte als Eingabe übergeben und Tulip wird eine neue Zeile mit den angegebenen Zeilenwerten erstellen. Die Antwort der API sind die erstellten Zeilenwerte 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 Eingabe

Im Folgenden sind die Parameter aufgeführt, die als Request Body gesendet werden

1. Arbeitsbuch-ID - Die Arbeitsbuch-ID
2. Arbeitsblatt Name - Arbeitsblatt Titel
3. Zeile Werte

Erforderlicher Output-Extraktor

Dies gibt die Zeilenwerte der neu erstellten Zeile zurück.

11) Löschen der Arbeitsblattdaten

Zweck

Benutzer können eine Arbeitsbuch-ID, einen Arbeitsblattnamen, einen Startbereich und einen Endbereich als Eingabe übergeben. Tulip löscht die Zellwerte basierend auf dem angegebenen Bereich.

Endpunkt

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

Erforderliche Eingabe

Im Folgenden sind die Parameter aufgeführt, die als Request Body gesendet werden

1. Arbeitsmappen-ID - Die Arbeitsmappen-ID
2. Arbeitsblattname - Arbeitsblatttitel
3. Startbereich
4. Endbereich

Weitere Informationen

Hier finden Sie weitere Informationen zu Microsoft Connectors

• Microsoft Kalender-Connector
• Microsoft Outlook-Verbinder
• Microsoft Teams Connector