Konektor kalendarza Microsoft

Integracja z interfejsem Graph API firmy Microsoft dla aplikacji Kalendarz

Wprowadzenie

Interfejs API kalendarza Microsoft umożliwia użytkownikom tworzenie, odczytywanie i edytowanie wydarzeń kalendarza Microsoft z odpowiednim dostępem do ich kont M365. Celem tego konektora jest integracja Tulip z Microsoft przy użyciu Graph API Microsoftu (v1.0) za pomocą konektorów HTTP i zapewnienie naszym klientom gotowego konektora, który można zaimportować do ich instancji.

Cel

Zamierzamy wyróżnić różne funkcje konektorów, które można zbudować, wykonując wywołania HTTP do Graph Api firmy Microsoft (v1.0) w celu interakcji z wydarzeniami kalendarza Microsoft, aby zaprezentować różne akcje odczytu i zapisu w kalendarzu, 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 na platformie Microsoft 365 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ę konektora dla programu Excel:

Możesz wykonać te same kroki, aby skonfigurować łącznik kalendarza.

Szczegóły połączenia Tulip

Następujące informacje muszą zostać skonfigurowane w Tulip's

Konektory.

1. Uruchomione na: Host konektora w chmurze
2. Host: graph.microsoft.com
3. Port:443
4. TLS: Tak

OAuth 2: Uwierzytelnianie zostanie przeniesione do wszystkich funkcji konektora.

Funkcje konektora

1) Pobierz wszystkie zdarzenia kalendarza

Cel

Ten konektor pobiera wszystkie wydarzenia z kalendarza M365.

Punkt końcowy

Wywołanie HTTP GET do punktu końcowego: https://graph.micrsoft.com:443/v1.0/me/events

Wymagane dane wejściowe

Dane wejściowe nie są wymagane

Ekstraktor danych wyjściowych

1. eventID: Unikalny identyfikator zdarzenia, który zostanie wykorzystany do wykonania innych zadań.
2. eventSubject: Temat zdarzenia.
3. eventContent: Treść zdarzenia.
4. eventStartDate: Data i godzina rozpoczęcia zdarzenia.
5. eventEndDate: Data i godzina zakończenia zdarzenia.
6. eventLocation: Lokalizacja wydarzenia.
7. eventAttendees: Uczestnicy wydarzenia.
8. eventOrganizer: Organizator wydarzenia.
9. Dodatkowe parametry zwracane wraz z odpowiedzią są częścią parametrów wyjściowych.

2) Get User Meeting Schedule

Cel

Ten konektor pobiera informacje o dostępności wolnych / zajętych dla kolekcji użytkowników, list dystrybucyjnych lub zasobów (pomieszczeń lub sprzętu) w określonym przedziale czasu.

Punkt końcowy

Wywołanie HTTP GET do punktu końcowego -https://graph.microsoft.com:443/v1.0/me/calendar/getSchedule

Wymagane dane wejściowe

Następujące parametry należy przekazać w treści żądania

1. Adres e-mail: Zbiór adresów SMTP użytkowników, list dystrybucyjnych lub zasobów, dla których mają zostać pobrane informacje o dostępności.
2. Schedule Start Date Time: Data, godzina i strefa czasowa rozpoczęcia okresu.
3. Schedule End Date Time: Data, godzina i strefa czasowa zakończenia okresu.
4. Strefa czasowa: Strefa czasowa zdarzenia.

Ekstraktor danych wyjściowych

1. scheduleUserId: Adres e-mail użytkownika harmonogramu.
2. startTime: data, godzina i strefa czasowa rozpoczęcia okresu.
3. endTime: data, godzina i strefa czasowa zakończenia okresu.
4. timeZone: Strefa czasowa.
5. scheduleStatus: Status odpowiedzi harmonogramów użytkownika.
6. scheduleSubject: Temat zaplanowanego zdarzenia.
7. scheduleLocation: Lokalizacja zaplanowanego zdarzenia.
8. scheduleStartDateTime: Godzina rozpoczęcia zaplanowanego zdarzenia.
9. scheduleEndDateTime: Zaplanowana data zakończenia zdarzenia.

3) Utwórz zdarzenie

Cel

1. Użytkownicy mogą przekazać temat wydarzenia, treść, datę rozpoczęcia, godzinę zakończenia i inne parametry jako dane wejściowe, a Tulip utworzy nowe wydarzenie kalendarza z dostarczonymi danymi wejściowymi. Odpowiedzią interfejsu API będą metadane i różne właściwości wydarzenia kalendarza. Można to dalej wykorzystać do pobierania i aktualizacji zdarzeń.
2. Ten konektor może utworzyć wydarzenie w domyślnym kalendarzu użytkownika lub określonym kalendarzu dla określonego użytkownika lub grupy użytkowników lub wielu użytkowników.
3. Informacje pobierane z interfejsu API Microsoft Graph V1.0 mogą być następnie dalej wykorzystywane w aplikacjach Tulip, tabelach Tulip lub zmiennych Tulip, które będą przekazywane do innych funkcji konektora.

Punkt końcowy

Wywołanie HTTP POST do punktu końcowego: https://graph.microsoft.com:443/v1.0/me/events

Wymagane dane wejściowe

W treści żądania należy przekazać następujące parametry

1. Event Subject: Temat zdarzenia
2. Treść zdarzenia: Treść zdarzenia
3. Event Start Date Time: Data i godzina rozpoczęcia zdarzenia
4. Strefa czasowa zdarzenia: Strefa czasowa zdarzenia
5. Data zakończenia zdarzenia: Godzina zakończenia zdarzenia
6. Lokalizacja zdarzenia: Lokalizacja wydarzenia
7. Adres e-mail uczestnika: Adres e-mail uczestnika

Ekstraktor danych wyjściowych

1. eventId: Identyfikator utworzonego wydarzenia
2. eventTimezone: Strefa czasowa zdarzenia
3. eventSubject: Temat zdarzenia
4. eventBody: Treść zdarzenia
5. eventStartDateTime: Godzina rozpoczęcia zdarzenia
6. eventEndDateTime: Godzina zakończenia zdarzenia
7. eventLocation: Lokalizacja zdarzenia
8. Dodatkowe parametry zwracane wraz z odpowiedzią są dołączane jako część parametrów wyjściowych.

4) Tworzenie zdarzeń cyklicznych

Cel

1. Użytkownicy mogą przekazać temat wydarzenia, treść, datę rozpoczęcia, godzinę zakończenia i inne parametry jako dane wejściowe, a Tulip utworzy nowe cykliczne wydarzenie kalendarza z dostarczonymi danymi wejściowymi. Odpowiedzią interfejsu API będą metadane i różne właściwości wydarzenia kalendarza. Można to dalej wykorzystać do pobierania i aktualizowania zdarzeń.
2. Ten konektor utworzy powtarzające się wydarzenie w domyślnym kalendarzu użytkownika i określonym kalendarzu dla użytkownika lub grupy użytkowników.
3. Informacje pobierane z interfejsu API Microsoft Graph V1.0 mogą być następnie dalej 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/events

Wymagane dane wejściowe

W treści żądania należy przekazać następujące parametry

1. Event Subject: Temat zdarzenia
2. Treść zdarzenia: Treść zdarzenia
3. Event Start Date Time: Data i godzina rozpoczęcia zdarzenia
4. Strefa czasowa zdarzenia: Strefa czasowa zdarzenia
5. Data zakończenia zdarzenia: Godzina zakończenia zdarzenia
6. Lokalizacja zdarzenia: Lokalizacja wydarzenia
7. Adres e-mail uczestnika: Adres e-mail uczestnika
8. Typ zdarzenia cyklicznego: Typ wydarzenia powtarzającego się
9. Powtarzające się dni tygodnia: Dzień wydarzenia nawrotu
10. Data rozpoczęcia nawrotu: Data rozpoczęcia zdarzenia nawrotu
11. Data zakończenia nawrotu: Data zakończenia zdarzenia nawrotu

Ekstraktor danych wyjściowych

1. eventId: Identyfikator utworzonego zdarzenia
2. eventTimezone: Strefa czasowa zdarzenia
3. eventSubject: Temat zdarzenia
4. eventBody: Treść zdarzenia
5. eventStartDateTime: Data rozpoczęcia i godzina zdarzenia
6. eventEndDateTime: Data końcowa i godzina zdarzenia
7. eventLocation: Lokalizacja zdarzenia
8. eventRecurrenceRangeStartDate: Data rozpoczęcia zdarzenia cyklicznego.
9. eventRecurrenceRangeEndDate: Data zakończenia wydarzenia cyklicznego.
10. eventAttendees: Uczestnicy wydarzenia.
11. eventOrganizer: Organizator wydarzenia.
12. Dodatkowe parametry zwracane wraz z odpowiedzią są częścią parametrów wyjściowych.

5) Aktualizacja wydarzenia

Cel

1. Użytkownicy mogą przekazać identyfikator wydarzenia, temat, treść i inne parametry jako dane wejściowe, a Tulip zaktualizuje wydarzenia w kalendarzu. Odpowiedzią API będą metadane i różne właściwości wydarzeń kalendarza.
2. Informacje pobierane z interfejsu API Microsoft Graph V1.0 mogą być następnie dalej 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 PATCH do punktu końcowego https://graph.microsoft.com:443/v1.0/me/events/{eventID}

Wymagane dane wejściowe

Następujące parametry są wysyłane jako treść żądania

1. Event Subject: Temat zdarzenia
2. Treść zdarzenia: Treść zdarzenia
3. Event Start Date Time: Godzina rozpoczęcia zdarzenia
4. Event TimeZone: Strefa czasowa zdarzenia
5. Data zakończenia zdarzenia: Godzina zakończenia zdarzenia
6. Lokalizacja zdarzenia: Lokalizacja wydarzenia
7. Adres e-mail uczestnika: Adres e-mail uczestnika

Ekstraktor danych wyjściowych

1. eventId: Identyfikator utworzonego wydarzenia
2. eventTimezone: Strefa czasowa zdarzenia
3. eventSubject: Temat zdarzenia
4. eventBody: Treść zdarzenia
5. eventStartDateTime: Godzina rozpoczęcia zdarzenia
6. eventEndDateTime: Godzina zakończenia zdarzenia
7. eventLocation: Lokalizacja zdarzenia
8. Dodatkowe parametry zwracane wraz z odpowiedzią są dołączane jako część parametrów wyjściowych.

6) Usuń zdarzenie

Cel

1. Użytkownicy mogą przekazać identyfikator wydarzenia jako dane wejściowe, a Tulip usunie wydarzenie z kalendarza.

Punkt końcowy

Wywołanie HTTP DELETE do punktu końcowego - https://graph.microsoft.com:443/v1.0/me/events/{eventID}

Wymagane dane wejściowe

Następujące parametry są wysyłane jako treść żądania

1. Event ID - identyfikator wydarzenia

Więcej informacji

Więcej informacji na temat konektorów Microsoft

• Konektor Microsoft Outlook
• Konektor Microsoft Teams
• Konektor Microsoft Excel