iCalendar

On-Call Optimizer can import availability from any calendar product that publishes a web-accessible iCalendar feed.

Connection process

To add a calendar feed (ICS) to your On-Call Optimizer account follow the connection instructions:

1. In the Select calendar provider dialog, choose Calendar feed and click Add URL.
2. On the Create a calendar feed connection page, enter a Calendar nickname and paste the URL provided by your calendar product into the Calendar URL field.
3. Click Create.

On-Call Optimizer fetches the feed and opens the Edit connection page, where you choose how its events are imported and click Save.

Disconnecting

To remove a calendar feed:

1. Click your avatar at the top right of the application and choose Calendars.
2. Click the Disconnect icon (a circled cross) at the top right of the calendar feed connection card.
3. Click Disconnect in the Disconnect calendar dialog to confirm.

Disconnecting also removes all availability imported from the connection’s calendars.

Supported products

On-Call Optimizer’s ICS support is compliant with the RFC 5545 specification and should work with any calendar product producing a valid iCalendar feed in this format. On-Call Optimizer has been specifically tested with ICS feeds generated by the following products:

• Google Calendar
• Microsoft Outlook

Recurring events

On-Call Optimizer supports expansion of recurring events defined using the RRULE attribute in ICS feeds.

• Recurring events are automatically expanded and processed as individual event occurrences in later availability and assignment processes.
• Occurrences are expanded within the same availability window used for all calendar imports. Occurrences beyond this window are not processed.
• A maximum of 100 occurrences per recurring event are processed. Events with very high-frequency recurrence rules (e.g. every minute) will be capped.
• If a recurring event cannot be expanded (e.g. due to a malformed RRULE), the original event instance is used as a fallback.
• Full day events are imported as the full day in the timezone of the schedule as specified in the feed itself.

Required permissions and data

The URL provided to On-Call Optimizer must not require authentication.

Data accessed

On-Call Optimizer filters events from the provided feed to minimize the amount of information processed and retained.