Microsoft Calendar Connector

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

Integration mit Microsofts Graph API für Kalender

Einführung

Microsoft Calendar API ermöglicht es den Benutzern, Microsoft-Kalenderereignisse zu erstellen, zu lesen und zu bearbeiten, wenn sie den richtigen Zugang zu ihren M365-Konten haben. Das Ziel dieses Konnektors ist die Integration von Tulip mit Microsoft unter Verwendung von Microsofts Graph API (v1.0) mit Hilfe von HTTP-Konnektoren und die Bereitstellung eines sofort einsatzbereiten Konnektors für unsere Kunden, der in ihre Instanz importiert werden kann.

Zweck

Wir werden verschiedene Konnektor-Funktionen hervorheben, die durch HTTP-Aufrufe an Microsofts Graph Api (v1.0) erstellt werden können, um mit den Microsoft Kalender-Ereignissen zu interagieren und verschiedene Lese- und Schreibaktionen auf dem Kalender zu zeigen, die für verschiedene Anwendungsfälle genutzt werden können.

API-Dokumentation

Microsoft Graph API-Dokumentation

Vorraussetzungen

1. Erstellen Sie ein Konto bei Microsoft 365 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 zum Einrichten des Konnektors für Excel:

Sie können die gleichen Schritte befolgen, um auch den Kalender-Connector einzurichten.

Details zur Tulip-Verbindung

Die folgenden Informationen müssen bei Tulip konfiguriert werden

Konnektoren.

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

OAuth 2: Die Authentifizierung wird an alle Connector-Funktionen weitergegeben

Connector-Funktionen

1) Alle Kalenderereignisse abrufen

Zweck

Dieser Konnektor ruft alle Kalenderereignisse aus dem M365-Kalender ab.

Endpunkt

HTTP GET-Aufruf an den Endpunkt: https://graph.micrsoft.com:443/v1.0/me/events

Erforderliche Eingabe

Keine Eingaben erforderlich

Ausgabe Extraktor

1. eventID: Eindeutiger Bezeichner des Ereignisses, der für die Ausführung der anderen Aufgaben verwendet wird.
2. eventSubject: Betreff des Ereignisses.
3. eventContent: Inhalt des Ereignisses.
4. eventStartDate: Startdatum und Uhrzeit des Ereignisses.
5. eventEndDate: Enddatum und -uhrzeit des Ereignisses.
6. eventLocation: Ort der Veranstaltung.
7. eventAttendees: Teilnehmer der Veranstaltung.
8. eventOrganizer: Organisator der Veranstaltung.
9. Zusätzliche Parameter, die mit der Antwort zurückgegeben werden, sind in den Ausgabeparametern enthalten.

2) Terminplan für Benutzerbesprechung abrufen

Zweck

Dieser Konnektor ruft die Frei/Gebucht-Verfügbarkeitsinformationen für eine Sammlung von Benutzern, Verteilerlisten oder Ressourcen (Räume oder Geräte) für einen bestimmten Zeitraum ab.

Endpunkt

HTTP GET-Aufruf an den Endpunkt -https://graph.microsoft.com:443/v1.0/me/calendar/getSchedule

Erforderliche Eingabe

Die folgenden Parameter sind im Request Body zu übergeben

1. E-Mail Adresse: Eine Sammlung von SMTP-Adressen von Benutzern, Verteilerlisten oder Ressourcen, für die Verfügbarkeitsinformationen abgerufen werden sollen.
2. Schedule Start Date Time: Das Datum, die Uhrzeit und die Zeitzone, in der der Zeitraum beginnt.
3. Enddatum des Zeitplans Uhrzeit: Datum, Uhrzeit und Zeitzone, zu der der Zeitraum endet.
4. Zeitzone: Zeitzone des Ereignisses.

Ausgabe-Extraktor

1. scheduleUserId: E-Mail-Adresse des Zeitplanbenutzers.
2. startTime: Das Datum, die Uhrzeit und die Zeitzone, in der der Zeitraum beginnt.
3. endTime: Das Datum, die Uhrzeit und die Zeitzone, in der der Zeitraum endet.
4. timeZone: Zeitzone.
5. scheduleStatus: Antwortstatus der Benutzerzeitpläne.
6. scheduleSubject: Betreff des geplanten Ereignisses.
7. scheduleLocation: Geplanter Ort des Ereignisses.
8. scheduleStartDateTime: Geplantes Ereignis Startdatum Uhrzeit.
9. scheduleEndDateTime: Geplante Veranstaltung Enddatum Zeit.

3) Ein Ereignis erstellen

Zweck

1. Der Benutzer kann ein Ereignis mit Betreff, Inhalt, Startdatum, Enddatum und anderen Parametern eingeben und Tulip wird ein neues Kalenderereignis mit den angegebenen Eingaben erstellen. Die Antwort der API besteht aus den Metadaten und verschiedenen Eigenschaften des Kalenderereignisses. Dies kann zum Abrufen und Aktualisieren von Ereignissen weiter verwendet werden.
2. Dieser Konnektor kann ein Ereignis im Standardkalender des Benutzers oder in einem bestimmten Kalender für einen bestimmten Benutzer oder eine Benutzergruppe oder mehrere Benutzer erstellen.
3. Die Informationen, die aus der Microsoft Graph V1.0 API gezogen werden, können dann entweder in Tulip-Anwendungen, Tulip-Tabellen oder Tulip-Variablen weiterverwendet werden, die dann in andere Konnektorfunktionen geleitet werden.

Endpunkt

HTTP POST-Aufruf an den Endpunkt: https://graph.microsoft.com:443/v1.0/me/events

Erforderliche Eingabe

Die folgenden Parameter sind im Request Body zu übergeben

1. Betreff des Ereignisses: Betreff des Ereignisses
2. Inhalt des Ereignisses: Inhalt des Ereignisses
3. Event Start Date Time: Startdatum und -zeit des Ereignisses
4. Zeitzone des Ereignisses: Zeitzone des Ereignisses
5. Enddatum des Ereignisses: Zeit des Enddatums und der Endzeit des Ereignisses
6. Ort des Ereignisses: Ort der Veranstaltung
7. E-Mail Adresse des Teilnehmers: E-Mail-Adresse des Teilnehmers

Ausgabe-Extraktor

1. EreignisId: Erstellte Ereignis-ID
2. eventTimezone: Zeitzone der Veranstaltung
3. eventSubject: Betreff des Ereignisses
4. eventBody: Inhalt des Ereignisses
5. eventStartDateTime: Uhrzeit des Startdatums des Ereignisses
6. eventEndDateTime: Uhrzeit des Enddatums des Ereignisses
7. eventLocation: Ort des Ereignisses
8. Zusätzliche Parameter, die mit der Antwort zurückgegeben werden, sind in den Ausgabeparametern enthalten.

4) Wiederkehrende Ereignisse erstellen

Zweck

1. Benutzer können ein Ereignis-Thema, einen Inhalt, ein Startdatum, ein Enddatum und andere Parameter als Eingabe übergeben & Tulip wird ein neues wiederkehrendes Kalenderereignis mit den angegebenen Eingaben erstellen. Die Antwort der API besteht aus den Metadaten und verschiedenen Eigenschaften des Kalenderereignisses. Diese können weiter zum Abrufen und Aktualisieren von Ereignissen verwendet werden.
2. Dieser Konnektor erstellt ein wiederkehrendes Ereignis im Standardkalender des Benutzers und im angegebenen Kalender für einen Benutzer oder eine Gruppe von Benutzern.
3. Die Informationen, die aus der Microsoft Graph V1.0 API gezogen werden, können dann entweder in Tulip-Anwendungen, Tulip-Tabellen oder Tulip-Variablen weiterverwendet werden, die in andere Funktionen des Connectors geleitet werden.

Endpunkt

HTTP POST Aufruf an den Endpunkt https://graph.microsoft.com:443/v1.0/me/events

Erforderliche Eingabe

Die folgenden Parameter sind im Request Body zu übergeben

1. Betreff des Ereignisses: Betreff des Ereignisses
2. Inhalt des Ereignisses: Inhalt des Ereignisses
3. Event Start Date Time: Startdatum und -zeit des Ereignisses
4. Zeitzone des Ereignisses: Zeitzone des Ereignisses
5. Enddatum des Ereignisses: Zeit des Enddatums und der Endzeit des Ereignisses
6. Ort des Ereignisses: Ort der Veranstaltung
7. E-Mail Adresse des Teilnehmers: E-Mail-Adresse des Teilnehmers
8. Wiederholungsereignis Typ: Wiederholungsveranstaltung Typ
9. Wiederholung Wochentage: Tag der Wiederholungsveranstaltung
10. Wiederholung Startdatum: Wiederholungsereignis Startdatum
11. Wiederholung Enddatum: Wiederholungsereignis Enddatum

Ausgabe-Extraktor

1. EreignisId: Erstellte Ereignis-ID
2. eventTimezone: Event TimeZone
3. eventSubject: Betreff des Ereignisses
4. eventBody: Inhalt des Ereignisses
5. eventStartDateTime: Startdatum Uhrzeit des Ereignisses
6. eventEndDateTime: Enddatum Uhrzeit des Ereignisses
7. eventLocation: Ort des Ereignisses
8. eventRecurrenceRangeStartDate: Startdatum des Wiederholungsereignisses.
9. eventRecurrenceRangeEndDate: Enddatum der wiederkehrenden Veranstaltung.
10. eventAttendees: Teilnehmer der Veranstaltung.
11. eventOrganizer: Organisator des Ereignisses.
12. Zusätzliche Parameter, die mit der Antwort zurückgegeben werden, sind in den Ausgabeparametern enthalten.

5) Aktualisieren einer Veranstaltung

Zweck

1. Benutzer können eine Veranstaltungs-ID, einen Betreff, einen Inhalt und andere Parameter als Eingabe übergeben und Tulip aktualisiert die Veranstaltungen im Kalender. Die Antwort der API besteht aus den Metadaten und verschiedenen Eigenschaften der Kalenderereignisse.
2. Die Informationen werden von der Microsoft Graph V1.0 API abgezogen und können dann entweder in Tulip-Anwendungen, Tulip-Tabellen oder Tulip-Variablen weiterverwendet werden, die dann in andere Connector-Funktionen geleitet werden.

Endpunkt

HTTP PATCH Aufruf an den Endpunkt https://graph.microsoft.com:443/v1.0/me/events/{eventID}

Erforderliche Eingabe

Die folgenden Parameter werden als Request Body gesendet

1. Betreff des Ereignisses: Betreff des Ereignisses
2. Inhalt des Ereignisses: Inhalt des Ereignisses
3. Event Start Date Time: Uhrzeit des Startdatums des Ereignisses
4. Ereignis ZeitZone: Zeitzone des Ereignisses
5. Event End Date Time: Uhrzeit des Enddatums des Ereignisses
6. Ort des Ereignisses: Ort der Veranstaltung
7. E-Mail Adresse des Teilnehmers: E-Mail-Adresse des Teilnehmers

Ausgabe-Extraktor

1. EreignisId: Erstellte Ereignis-ID
2. eventTimezone: Zeitzone der Veranstaltung
3. eventSubject: Betreff des Ereignisses
4. eventBody: Inhalt des Ereignisses
5. eventStartDateTime: Uhrzeit des Startdatums des Ereignisses
6. eventEndDateTime: Uhrzeit des Enddatums des Ereignisses
7. eventLocation: Ort des Ereignisses
8. Zusätzliche Parameter, die mit der Antwort zurückgegeben werden, sind in den Ausgabeparametern enthalten.

6) Löschen eines Ereignisses

Zweck

1. Benutzer können eine Ereignis-ID als Eingabe übergeben & Tulip wird das Ereignis im Kalender löschen.

Endpunkt

HTTP DELETE Aufruf an den Endpunkt - https://graph.microsoft.com:443/v1.0/me/events/{eventID}

Erforderliche Eingabe

Die folgenden Parameter werden als Request Body gesendet

1. Ereignis-ID - Die Ereignis-ID

Weitere Informationen

Hier finden Sie weitere Informationen zu Microsoft Connectors

• Microsoft Outlook-Konnektor
• Microsoft Teams-Verbinder
• Microsoft Excel-Verbinder