HRM-10/HRM.UI/BackgroundJobs/Calendar/CalendarIcsBuilder.cs
Mohaimen Hasan 838b8d4480 first commit
2026-11-03 13:06:00 +06:00

145 lines
6.7 KiB
C#

using HRM.BO;
using Ical.Net.CalendarComponents;
using Ical.Net.DataTypes;
using Ical.Net.Serialization;
using System;
using System.Globalization;
using IcalCalendar = Ical.Net.Calendar;
namespace HRM.UI.BackgroundJobs.Calendar
{
/// <summary>
/// Builds the iCalendar (.ics) meeting invitation that makes a calendar item appear in Outlook (and Gmail, etc.).
/// One invitation per person: the same UID for everybody, so Outlook matches later updates (higher SEQUENCE) and
/// cancellations (METHOD:CANCEL) to the entry it already has.
/// </summary>
public static class CalendarIcsBuilder
{
private const string ProductId = "-//CEL//HRM Calendar//EN";
/// <summary>The stable unique id of an item in every invitation it ever gets.</summary>
public static string Uid(int calendarItemID, string domain)
{
return "hrm-calendar-" + calendarItemID + "@" + domain;
}
/// <param name="item">The item, as stored (attendees not needed).</param>
/// <param name="recipient">The one person this invitation is for.</param>
/// <param name="cancel">True for a cancellation (item cancelled, or this person removed).</param>
/// <param name="timeZoneId">IANA time zone of the stored times, or null to write "floating" local times.</param>
/// <param name="uidDomain">Domain for the UID.</param>
/// <param name="organizerEmail">The mailbox the invitation is sent from (shown as organizer, with the real organizer's name).</param>
public static string Build(CalendarItem item, CalendarItemAttendee recipient, bool cancel,
string timeZoneId, string uidDomain, string organizerEmail)
{
IcalCalendar calendar = new IcalCalendar
{
Method = cancel ? "CANCEL" : "REQUEST",
ProductId = ProductId
};
bool useTimeZone = !item.IsAllDay && !string.IsNullOrWhiteSpace(timeZoneId);
if (useTimeZone)
calendar.AddTimeZone(VTimeZone.FromDateTimeZone(timeZoneId));
// A one-off task can have the person's own title and dates; a repeating item always uses the series.
bool recurring = !string.IsNullOrWhiteSpace(item.RecurrenceRule);
DateTime start = !recurring && recipient.FromOverride.HasValue ? recipient.FromOverride.Value : item.StartDateTime;
DateTime end = !recurring && recipient.ToOverride.HasValue ? recipient.ToOverride.Value : item.EndDateTime;
if (end < start)
end = start;
string title = string.IsNullOrWhiteSpace(recipient.TitleOverride) ? item.Title : recipient.TitleOverride;
CalendarEvent calendarEvent = new CalendarEvent
{
Uid = Uid(item.ID, uidDomain),
Sequence = item.OutlookSequence,
Summary = title,
Description = BuildDescription(item),
Location = item.Location,
// all-day ends are stored inclusive; iCalendar wants the exclusive next day
DtStart = ToCalDateTime(start, item.IsAllDay, useTimeZone ? timeZoneId : null),
DtEnd = item.IsAllDay
? new CalDateTime(DateOnly.FromDateTime(end).AddDays(1))
: ToCalDateTime(end, false, useTimeZone ? timeZoneId : null),
Status = cancel ? "CANCELLED" : "CONFIRMED",
Transparency = "OPAQUE",
Priority = ToIcalPriority(item.Priority)
};
if (!string.IsNullOrWhiteSpace(organizerEmail))
{
Organizer organizer = new Organizer("mailto:" + organizerEmail.Trim());
if (!string.IsNullOrWhiteSpace(item.OrganizerName))
organizer.CommonName = item.OrganizerName;
calendarEvent.Organizer = organizer;
}
if (recurring)
{
calendarEvent.RecurrenceRule = new RecurrencePattern(item.RecurrenceRule);
foreach (DateTime skippedDay in ParseExceptionDates(item.ExceptionDates))
{
calendarEvent.ExceptionDates.Add(item.IsAllDay
? new CalDateTime(DateOnly.FromDateTime(skippedDay))
: ToCalDateTime(skippedDay.Date + item.StartDateTime.TimeOfDay, false, useTimeZone ? timeZoneId : null));
}
}
Attendee attendee = new Attendee("mailto:" + recipient.Email.Trim())
{
Role = recipient.Role == EnumAttendeeRole.Optional ? "OPT-PARTICIPANT" : "REQ-PARTICIPANT",
ParticipationStatus = "NEEDS-ACTION",
// answers are given in HRM; an Outlook reply would only reach the sending mailbox
Rsvp = false
};
if (!string.IsNullOrWhiteSpace(recipient.Name))
attendee.CommonName = recipient.Name;
calendarEvent.Attendees.Add(attendee);
calendar.Events.Add(calendarEvent);
return new CalendarSerializer().SerializeToString(calendar);
}
#region Helpers
private static CalDateTime ToCalDateTime(DateTime value, bool allDay, string timeZoneId)
{
if (allDay)
return new CalDateTime(DateOnly.FromDateTime(value));
return timeZoneId == null ? new CalDateTime(value, true) : new CalDateTime(value, timeZoneId, true);
}
/// <summary>iCalendar priority: 1 = high, 5 = normal, 9 = low, 0 = not set.</summary>
private static int ToIcalPriority(EnumCalendarPriority? priority)
{
switch (priority)
{
case EnumCalendarPriority.High: return 1;
case EnumCalendarPriority.Normal: return 5;
case EnumCalendarPriority.Low: return 9;
default: return 0;
}
}
private static string BuildDescription(CalendarItem item)
{
string note = "Created in HRM. Please give your answer or update in HRM (My Calendar).";
return string.IsNullOrWhiteSpace(item.Description) ? note : item.Description.Trim() + "\n\n" + note;
}
private static System.Collections.Generic.IEnumerable<DateTime> ParseExceptionDates(string exceptionDates)
{
if (string.IsNullOrWhiteSpace(exceptionDates))
yield break;
foreach (string part in exceptionDates.Split(',', StringSplitOptions.RemoveEmptyEntries))
{
if (DateTime.TryParseExact(part.Trim(), "yyyy-MM-dd", CultureInfo.InvariantCulture, DateTimeStyles.None, out DateTime day))
yield return day;
}
}
#endregion
}
}