TABLE OF CONTENTS
Introduction
iCal is a computer file format for storing calendar information. It is short for iCalendar. It is designed to be an open standard to allow for easy interoperability with many different applications, ManagementStudio being one of those. The iCal feature is configurable within the Test Sign-Offs and Self-Scheduling components.
This guide will walk through the steps required to send a self-schedule booking appointment with the iCal information attached.
It is assumed a deployment unit, deployment schedule has been configured and Users have been added into the deployment unit.
Step 1 – Enable Meeting Request
- Switch to Administration -> User Migrations -> DeployUnit & Self-Schedule (1).
- Ensure the Deployment Units for UserMigrations is Enabled (2).
- Click on the Settings (3) tab.
- Scroll down to the Meeting Request panel (4). Use this panel to control & customize the meeting invitations sent out to the end users.
- Attach Meeting Request to Email: When this option is enabled, it will attach an iCal (Meeting Request) file to the 'Complete' email.
- Outlook Reminder (Min): Specify the number of minutes before the appointment. This will allow Outlook to popup a reminder.
- Appointment Subject: Specify a clear appointment subject line.
- Appointment Location: Provide a location of the appointment. Deployment Unit location keywords can be used. Here is a list of available keywords.
- Appointment Description: Provide a brief description of the appointment.
Please note, keywords can be used within the Appointment location & Description textboxes. The description textbox has a limit of 1000 length characters.
- Click Save Changes (5) to commit the changes.
Step 2 – Send User Booking Link
- When a User is sent the booking link to book their migration slot.
- Upon submitting their booking, they will receive a Complete Email with the iCal file enclosed.
- Clicking on the attached iCal file will automatically add the appointment to their diary in Outlook.
- The screenshot below shows an example of the iCal file.
Embedding Custom iCal Meeting Requests in emails
You can embed custom meeting invites directly within an email template by using a specific format. This feature enables you to define meeting details—such as start and end times—through keyword-based placeholders.
To include a meeting invite, insert the following block anywhere in the email body. The content must be enclosed within <#
and #>
tags:
<# #InviteIcs# Summary: My Meeting Subject StartDate: [UM-DeployUnitSlotStart-f{u}] EndDate: [UM-DeployUnitSlotEnd-f{u}] UseUtcOffSet: false UtcOffSet: 0 ReminderMin: 15 Location: My Location Description: Invite Description HtmlDescription: <b>Invite</b> <i>Description</i> #>
Dates
When using Date Keywords ( e.g. [UM-DeployUnitSlotStart-f{u}] ). It is required that you include the -f{u} option to format these dates in universal time.
Required Fields:
#InviteIcs#
Summary
StartDate
If any of these are missing, the invite will not be generated. All other fields are optional and may be omitted.
Further Support
If you require further support, please visit ManagementStudio's Service Desk to search the knowledge base or create a new support ticket.
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article