Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

Events.Calendars

Returns calendars that support a given entity type.

Component Version macOS Windows Linux Server iOS SDK
Events 6.2 ✅ Yes ❌ No ❌ No ❌ No ✅ Yes
MBS( "Events.Calendars"; Type { ; AsJSON } )   More

Parameters

Parameter Description Example Flags
Type Which entity type you like to check: Event or Reminder.
Default is Event.
"Event"
AsJSON Available in MBS FileMaker Plugin 13.4 or newer.
Pass 1 to return result as JSON.
Optional

Result

Returns list of calendar identifiers or error.

Description

Returns calendars that support a given entity type.
Type can be Event or Reminder.
If you have limited access to calendars, you may only see one virtual calendar.

Examples

Get list of all calendars for events:

MBS( "Events.calendars" ; "Events")

Get list of all calendars for reminders:

MBS( "Events.calendars" ; "Reminder")

Query list of all calendar names:

While(
[
    names = "";
    // query list of Calendar IDs
    list = MBS( "Events.Calendars"; "Event" );
    count = ValueCount(list);
    index = 1
] ;
    index ≤ count ;
[
    id = GetValue(list; index);
    // query name for each ID
    name = MBS( "Events.Calendar.GetTitle"; id);
    names = names & name & ¶;
    index = index + 1
] ;
// return all the names
names )

Example result:
Family
Work
Birthdays

Query as JSON:

MBS( "Events.Calendars"; "Reminder"; 1)

Example result:
[ { "subscribed" : false, "source" : { "sourceTypeText" : "CalDAV", "title" : "Mac.com", "sourceIdentifier" : "780DE199-35C3-4720-9FF0-D5CB37A4B7E6", "isDelegate" : false, "sourceType" : 2 }, "title" : "Reminders", "allowedEntityTypes" : 2, "supportedEventAvailabilities" : 0, "allowsContentModifications" : true, "type" : 1, "immutable" : false, "calendarIdentifier" : "F01661A4-E434-4F9D-79CD-C7395B34D69C", "typeText" : "CalDAV" }, { "subscribed" : false, "source" : { "sourceTypeText" : "CalDAV", "title" : "Mac.com", "sourceIdentifier" : "780DE199-35C3-4720-9FF0-D5CB37A4B7E6", "isDelegate" : false, "sourceType" : 2 }, "title" : "Family", "allowedEntityTypes" : 2, "supportedEventAvailabilities" : 0, "allowsContentModifications" : true, "type" : 1, "immutable" : false, "calendarIdentifier" : "8A134D40-6DE4-4F69-A4D4-06CB897EB173", "typeText" : "CalDAV" } ]

Test with limited permissions in macOS Sonoma:

MBS( "Events.Calendars"; "event"; 1)

Example result:
[ { "subscribed" : false, "source" : { "sourceTypeText" : "CalDAV", "title" : "Account", "sourceIdentifier" : "VIRTUAL_APP_SOURCE_UUID", "isDelegate" : false, "sourceType" : 2 }, "title" : "Calendar", "allowedEntityTypes" : 1, "supportedEventAvailabilities" : 0, "allowsContentModifications" : true, "type" : 1, "immutable" : true, "calendarIdentifier" : "VIRTUAL_APP_CALENDAR_UUID", "typeText" : "CalDAV" } ]

See also

Release notes

Example Databases

Blog Entries

This function checks for a license.

Created 10th March 2016, last changed 12nd October 2023


Events.CalendarItemsWithExternalIdentifier - Events.ClearNotification