Správa kalendářů a událostí je pro mnoho aplikací klíčová, zejména při integraci s populárními službami, jako je Kalendář Google a Microsoft 365. Od verze 4D 20 R9 můžete snadno načítat kalendáře a události z těchto platforem a přistupovat k nim pomocí nových příkazů 4D NetKit. Tyto příkazy umožňují bezproblémovou integraci se službami Google a Microsoft 365, ať už synchronizujete plány, vytváříte funkce založené na kalendáři, nebo jen načítáte podrobnosti o událostech.
V následujících příkladech získáme seznam všech kalendářů v účtu Google Calendar nebo Microsoft 365 a všechny události spojené s prvním kalendářem v seznamu.
Připojení k účtu
Jako obvykle před použitím rozhraní Google nebo Microsoft API vytvoříme objekt připojení OAuth 2.0:
Pro rozhraní Google API:
var $oAuth2 : cs.NetKit.OAuth2Provider
var $google : cs.NetKit.Google
$oAuth2:=cs.NetKit.OAuth2Provider.new($googleCredentials)
$google:=cs.NetKit.Google.new($oAuth2)For Microsoft API:
var $oAuth2: cs.NetKit.OAuth2Provider
var $office365 : cs.NetKit.Office365
$oAuth2:=cs.NetKit.OAuth2Provider.new($microsoftCredentials)
$office365:=cs.NetKit.Office365.new($oAuth2)Získat seznam kalendářů
Před získáním událostí konkrétního kalendáře je třeba získat ID kalendáře. K jeho získání můžete použít funkci .calendar.getCalendars(), která zobrazí seznam všech kalendářů propojených s vaším účtem. Obě rozhraní API poskytují metodu pro výpis kalendářů, ale parametry a vrácený objekt se mohou u společností Google a Microsoft lišit.
V případě rozhraní Google API
// Gets all the calendars
var $calendars:=$google.calendar.getCalendars()
// For the rest of the example, we'll use the first calendar in the list
var $myCaldendar:=$calendars.calendars[0]pro Microsoft API
// Gets all the calendars
var $calendars:=$office365.calendar.getCalendars()
// For the rest of the example, we'll use the first calendar in the list
var $myCaldendar:=$calendars.calendars[0]
get eventS list
Nyní můžeme získat události spojené s konkrétním kalendářem pomocí funkce calendar.getEvents(). Obě rozhraní API poskytují metodu pro výpis událostí, ale parametry a vrácený objekt se mohou u společností Google a Microsoft lišit.
pro Google API
// Calculates the date range to be used
var $startDate:={date:Current date(); time:?00:00:00?}
var $endDate:={date:Current date()+7); time:?23:59:59?}
// Gets all the event of the selected calendars
var $events:=$google.calendar.getEvents({calendarId: $myCalendar.id; top: 100; singleEvents: True; startDateTime: $startDate; endDateTime: $endDate})
pro Microsoft API
// Calculates the date range to be used
var $startDate:={date:Current date(); time:?00:00:00?}
var $endDate:={date:Current date()+7); time:?23:59:59?}
// Gets all the event of the selected calendars
var $events:=$office365.calendar.getEvents({calendarId: $myCalendar.id; top: 100; startDateTime: $startDate; endDateTime: $endDate})
Závěr
Správa kalendářů a událostí pomocí nových příkazů 4D NetKit v aplikaci 4D 20 R9 je snadná. Ať už pracujete s Kalendářem Google nebo Microsoft 365, můžete rychle načítat kalendáře a události a zároveň zohlednit rozdíly ve fungování obou platforem. Pro více podrobností se nezapomeňte podívat do dokumentace 4D NetKit!
A to je teprve začátek, brzy se objeví další příkazy a funkce, díky kterým bude integrace kalendáře ještě výkonnější.