Microsoft Calendar Connector

A Microsoft Graph API for Calendar integrálása

Bevezetés

A Microsoft Calendar API lehetővé teszi a felhasználók számára, hogy létrehozzák, olvassák és szerkesszék a Microsoft naptár eseményeit az M365 fiókjukhoz beállított megfelelő hozzáféréssel. Ennek a csatlakozónak a célja a Tulip és a Microsoft Graph API(v1.0) integrálása a Microsoft Graph API(v1.0) segítségével HTTP csatlakozók segítségével, és ügyfeleink számára egy olyan out-of-box csatlakozót biztosít, amelyet be lehet importálni a példányukba.

Cél

Különböző csatlakozó funkciókat fogunk kiemelni, amelyek a Microsoft Graph Api(v1.0) HTTP-hívásaival építhetők a Microsoft Calendar eseményeivel való interakcióhoz, hogy bemutassuk a naptár különböző olvasási és írási műveleteit, amelyeket különböző felhasználási esetekben lehet kihasználni.

API-dokumentum

Microsoft Graph API dokumentáció

Előfeltételek

1. Hozzon létre egy fiókot a Microsoft 365 rendszerben, és konfigurálja az OAuth 2.0 hitelesítő adatokat a Microsoft Entra ID-ban.
2. Regisztrálja az API-t a szükséges hatókörökkel a Microsoft portálon. Azure - Entra ID

Videó a csatlakozó beállításáról az excel számára:

Ugyanezeket a lépéseket követheti a naptárkonnektor beállításához is.

Tulip kapcsolat részletei

A következő információkat kellene beállítani a Tulip

Csatlakozók.

1. Futtatás: Cloud Connector Host
2. Host: graph.microsoft.com
3. Port:443
4. TLS: Igen

OAuth 2: A hitelesítés az összes csatlakozófunkcióra továbbításra kerül.

Csatlakozófunkciók

1) Az összes naptáresemény lekérése

Cél

Ez a csatlakozó lekérdezi az összes naptári eseményt az M365 Naptárból.

Végpont

HTTP GET hívás a következő végponthoz: https://graph.micrsoft.com:443/v1.0/me/events

Kötelező bemenet

Nincs szükség bemenetre

Kimenet Extractor

1. eventID: Az esemény egyedi azonosítója, amely a többi feladat végrehajtásához használatos.
2. eventSubject: Az esemény tárgya.
3. eventContent: Az esemény tartalma.
4. eventStartDate: Az esemény kezdeti dátuma és időpontja.
5. eventEndDate: Az esemény befejezési dátuma és időpontja.
6. eventLocation: Az esemény helye.
7. eventAttendees: Az esemény résztvevői.
8. eventOrganizer: Az esemény szervezője.
9. A válasszal együtt visszaküldött további paraméterek a kimeneti paraméterek részeként szerepelnek.

2) Felhasználói találkozók ütemtervének lekérdezése

Cél

Ez a csatlakozó lekérdezi a felhasználók, elosztólisták vagy erőforrások (termek vagy berendezések) egy adott időszakra vonatkozó szabad/foglaltsági elérhetőségi adatait.

Végpont

HTTP GET hívás a -https://graph.microsoft.com:443/v1.0/me/calendar/getSchedule végponthoz.

Kötelező bemenet

A következő paramétereket kell átadni a kérés testében

1. E-mail cím: A felhasználók, terjesztési listák vagy erőforrások SMTP-címeinek gyűjteménye, amelyek elérhetőségi adatait le kell kérni.
2. Schedule Start Date Time: Az időszak kezdetének dátuma, időpontja és időzónája.
3. Schedule End Date Time (Ütemezés végdátum) Time (Időpont): Az időszak végének dátuma, ideje és időzónája.
4. Időzóna: Esemény időzóna.

Kimeneti kivonat

1. scheduleUserId: Az ütemező felhasználó e-mail címe.
2. startTime: Az időszak kezdetének dátuma, időpontja és időzónája.
3. endTime: Az a dátum, időpont és időzóna, amikor az időszak véget ér.
4. timeZone: Időzóna.
5. scheduleStatus: A felhasználó ütemezésének válaszállapota.
6. scheduleSubject: Az ütemezett esemény tárgya.
7. scheduleLocation: Scheduled event Location.
8. scheduleStartDateTime: Ütemezett esemény kezdő időpontja.
9. scheduleEndDateTime: Ütemezett esemény végdátumának időpontja.

3) Esemény létrehozása

Cél

1. A felhasználók átadhatnak egy Esemény tárgyát, tartalmát, kezdő dátum-időpontját, befejező dátum-időpontját és egyéb paramétereket bemenetként, és a Tulip létrehoz egy új naptári eseményt a megadott bemenetekkel. Az API válasza a naptáresemény metaadatai és különböző tulajdonságai lesznek. Ez a továbbiakban felhasználható az események lekérdezésére és frissítésére.
2. Ez a csatlakozó létrehozhat egy eseményt a felhasználó alapértelmezett naptárában vagy egy adott felhasználó, csoportos felhasználó vagy több felhasználó megadott naptárában.
3. A Microsoft Graph V1.0 API-ból származó információk a továbbiakban felhasználhatók a Tulip alkalmazásokban, a Tulip táblázatokban vagy a Tulip változókban, amelyeket más csatlakozófunkciókba vezetnek.

Végpont

HTTP POST hívás a végponthoz: https://graph.microsoft.com:443/v1.0/me/events

Szükséges bemenet

A következő paramétereket kell átadni a kérés testében

1. Esemény tárgya: Az esemény tárgya
2. Esemény tartalma: Az esemény tartalma
3. Event Start Date Time: Az esemény kezdő időpontja.
4. Esemény időzóna: Az esemény időzónája
5. Esemény végdátum időpontja: Az esemény végének időpontja.
6. Esemény helye: Az esemény helye
7. Résztvevő e-mail címe: A résztvevők e-mail címe

Kimeneti kivonat

1. eventId: Létrehozott esemény azonosítója
2. eventTimezone: Esemény időzóna
3. eventSubject: Az esemény tárgya
4. eventBody: Az esemény tartalma
5. eventStartDateTime: Az esemény kezdő időpontja.
6. eventEndDateTime: Az esemény befejezésének időpontja.
7. eventLocation: Az esemény helye
8. A válasszal együtt visszaküldött további paraméterek a kimeneti paraméterek részeként szerepelnek.

4) Ismétlődő események létrehozása

Cél

1. A felhasználók megadhatják az esemény tárgyát, tartalmát, kezdő dátum-időpontját, befejező dátum-időpontját és egyéb paramétereket bemenetként, és a Tulip új ismétlődő naptári eseményt hoz létre a megadott bemenetekkel. Az API válasza a naptári esemény metaadatai és különböző tulajdonságai lesznek. Ez a továbbiakban felhasználható az események lekérdezésére és frissítésére.
2. Ez a csatlakozó létrehoz egy ismétlődő eseményt a felhasználó alapértelmezett naptárában és a megadott naptárban egy felhasználó vagy egy felhasználói csoport számára.
3. A Microsoft Graph V1.0 API-ból származó információk a továbbiakban felhasználhatók a Tulip alkalmazásokban, a Tulip táblázatokban vagy a Tulip változókban, amelyeket más csatlakozófunkciókba vezetnek.

Végpont

HTTP POST hívás a https://graph.microsoft.com:443/v1.0/me/events végpontra.

Szükséges bemenet

A következő paramétereket kell átadni a kérés testében

1. Esemény tárgya: Az esemény tárgya
2. Esemény tartalma: Az esemény tartalma
3. Event Start Date Time: Az esemény kezdő időpontja.
4. Esemény időzóna: Az esemény időzónája
5. Esemény végdátum időpontja: Az esemény végének időpontja.
6. Esemény helye: Az esemény helye
7. Résztvevő e-mail címe: A résztvevők e-mail címe
8. Ismétlődés Esemény típusa: Ismétlődő esemény típusa
9. Ismétlődés Heti napok: Ismétlődő esemény napja
10. Ismétlődés kezdeti dátuma: Ismétlődési esemény kezdőnapja
11. Ismétlődés vége: Ismétlődés esemény vége

Kimeneti kivonat

1. eventId: Létrehozott esemény azonosítója
2. eventTimezone: Esemény TimeZone
3. eventSubject: Az esemény tárgya
4. eventBody: Az esemény tartalma
5. eventStartDateTime: Az esemény kezdeti időpontja.
6. eventEndDateTime: Az esemény befejezési dátuma és időpontja.
7. eventLocation: Az esemény helye
8. eventRecurrenceRangeStartDate: Recurrence event Start date.
9. eventRecurrenceRangeEndDate: Recurrence event End date.
10. eventAttendees: Az esemény résztvevői.
11. eventOrganizer: Az esemény szervezője.
12. A válasszal együtt visszaküldött további paraméterek a kimeneti paraméterek részeként szerepelnek.

5) Esemény frissítése

Cél

1. A felhasználók bemenetként átadhatnak egy eseményazonosítót, tárgyat, tartalmat és egyéb paramétereket, és a Tulip frissíti az eseményeket a naptárban. Az API válasza a naptáresemények metaadatai és különböző tulajdonságai lesznek.
2. A Microsoft Graph V1.0 API-ból származó információk a továbbiakban felhasználhatók a Tulip alkalmazásokban, a Tulip táblázatokban vagy a Tulip változókban, amelyeket más csatlakozófunkciókba továbbítanak.

Végpont

HTTP PATCH hívás a https://graph.microsoft.com:443/v1.0/me/events/{eventID} végpontra.

Kötelező bemenet

A következő paraméterek a kérés testeként elküldendő paraméterek

1. Esemény tárgya: Az esemény tárgya
2. Esemény tartalma: Az esemény tartalma
3. Esemény kezdeti időpontja: Az esemény kezdeti időpontja.
4. Esemény TimeZone: Az esemény időzónája.
5. Esemény végdátum időpontja: Az esemény végdátumának időpontja.
6. Esemény helye: Az esemény helye
7. Résztvevő e-mail címe: Résztvevő e-mail címe

Kimeneti kivonat

1. eventId: Létrehozott esemény azonosítója
2. eventTimezone: Esemény időzóna
3. eventSubject: Az esemény tárgya
4. eventBody: Az esemény tartalma
5. eventStartDateTime: Az esemény kezdő időpontja.
6. eventEndDateTime: Az esemény befejezésének időpontja.
7. eventLocation: Az esemény helye
8. A válasszal együtt visszaküldött további paraméterek a kimeneti paraméterek részeként szerepelnek.

6) Esemény törlése

Cél

1. A felhasználók bemenetként megadhatnak egy eseményazonosítót, és a Tulip törli az eseményt a naptárból.

Végpont

HTTP DELETE hívás a végponthoz - https://graph.microsoft.com:443/v1.0/me/events/{eventID}

Kötelező bemenet

A következő paraméterek a kérés testeként elküldendő paraméterek

1. Esemény ID - Az esemény azonosítója

További olvasmányok

További információk a Microsoft Connectors-ról

• Microsoft Outlook-csatlakozó
• Microsoft Teams Connector
• Microsoft Excel-csatlakozó