Inhalt x
    Microsoft Calendar Connector
    • 06 Mar 2024
    • 5 Minuten zu lesen
    • Mitwirkende
    • Drucken
    Inhalt

    Microsoft Calendar Connector

    • Aktualisiert am 06 Mar 2024
    • 5 Minuten zu lesen
    • Mitwirkende
    • Drucken
    Article Summary

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

    War dieser Artikel hilfreich?
    What's Next
    Plattform
    Bibliothek
    Produkte
    Ressourcen
    Bestehende Benutzer
    Mit uns verbinden
    Kontakt Vertrieb
    • +1 833 468 8547
    • sales@tulip.co
    Urheberrecht © Tulip Interfaces. Alle Rechte vorbehalten