using HRM.BO; using System; using System.Net; using System.Text; namespace HRM.UI.BackgroundJobs.Calendar { /// A notification in its two forms: the short in-app (bell) text and the e-mail. public sealed class CalendarMessage { public string Header { get; set; } public string BellText { get; set; } public string MailSubject { get; set; } public string MailBody { get; set; } } /// /// Wording of every calendar notification. Text the users typed (title, location, remarks...) is HTML-encoded /// before it goes into an e-mail. Messages to one attendee show that person's own title and (one-off items) own /// dates, the same as their calendar and their Outlook invitation. /// public static class CalendarMessages { /// Start of the occurrence (already the person's own start for a one-off item). public static CalendarMessage Reminder(CalendarItem item, CalendarItemAttendee to, DateTime start, DateTime end, string calendarLink) { string kind = KindOf(item); string title = TitleFor(item, to); return Build(item, title, "Reminder: " + title, kind + " " + When(item, start, end), "Reminder: " + title + " - " + When(item, start, end), "This is a reminder for the " + kind.ToLowerInvariant() + " below.", start, end, calendarLink); } public static CalendarMessage Invited(CalendarItem item, CalendarItemAttendee to, string calendarLink) { bool isTask = item.ItemType == EnumCalendarItemType.Task; string title = TitleFor(item, to); (DateTime start, DateTime end) = DatesFor(item, to); string header = isTask ? "New task: " + title : "Invitation: " + title; string intro = isTask ? (item.OrganizerName ?? "Someone") + " assigned you a task." : (item.OrganizerName ?? "Someone") + " invited you to an event."; return Build(item, title, header, When(item, start, end), header, intro, start, end, calendarLink); } public static CalendarMessage Updated(CalendarItem item, CalendarItemAttendee to, string calendarLink) { string title = TitleFor(item, to); (DateTime start, DateTime end) = DatesFor(item, to); string header = KindOf(item) + " updated: " + title; return Build(item, title, header, "Please check the new details.", header, (item.OrganizerName ?? "The organizer") + " changed this " + KindOf(item).ToLowerInvariant() + ". Please check the details below.", start, end, calendarLink); } public static CalendarMessage Removed(CalendarItem item, CalendarItemAttendee to, string calendarLink) { string title = TitleFor(item, to); (DateTime start, DateTime end) = DatesFor(item, to); string header = "Removed from: " + title; return Build(item, title, header, "You are no longer part of this " + KindOf(item).ToLowerInvariant() + ".", header, (item.OrganizerName ?? "The organizer") + " removed you from this " + KindOf(item).ToLowerInvariant() + ".", start, end, calendarLink); } public static CalendarMessage Cancelled(CalendarItem item, CalendarItemAttendee to, string calendarLink) { string title = TitleFor(item, to); (DateTime start, DateTime end) = DatesFor(item, to); string header = KindOf(item) + " cancelled: " + title; return Build(item, title, header, "This " + KindOf(item).ToLowerInvariant() + " was cancelled.", header, (item.OrganizerName ?? "The organizer") + " cancelled this " + KindOf(item).ToLowerInvariant() + ".", start, end, calendarLink); } /// The organizer's own copy of the Outlook invitation (new or changed item). public static CalendarMessage OrganizerCopy(CalendarItem item, CalendarItemAttendee to, bool isUpdate, string calendarLink) { string kind = KindOf(item).ToLowerInvariant(); string title = TitleFor(item, to); (DateTime start, DateTime end) = DatesFor(item, to); string header = (isUpdate ? KindOf(item) + " updated: " : KindOf(item) + " added: ") + title; string intro = isUpdate ? "Your " + kind + " was updated in your Outlook calendar too." : "Your " + kind + " was added to your Outlook calendar too."; return Build(item, title, header, intro, header, intro, start, end, calendarLink); } public static CalendarMessage Responded(CalendarItem item, CalendarItemAttendee attendee, string calendarLink) { string answer = attendee.ResponseStatus switch { EnumResponseStatus.Accepted => "is going", EnumResponseStatus.Declined => "is not going", EnumResponseStatus.Tentative => "might go", _ => "has not answered yet" }; string text = attendee.Name + " " + answer + "."; return Build(item, item.Title, "Answer: " + item.Title, text, attendee.Name + " " + answer + ": " + item.Title, text, item.StartDateTime, item.EndDateTime, calendarLink); } public static CalendarMessage TaskUpdated(CalendarItem item, CalendarItemAttendee attendee, string calendarLink) { string status = attendee.TaskStatus switch { EnumCalendarTaskStatus.Done => "Done", EnumCalendarTaskStatus.InProgress => "In progress", _ => "Not started" }; string text = attendee.Name + " set the task to " + status + "." + (string.IsNullOrWhiteSpace(attendee.Remarks) ? string.Empty : " Remarks: " + attendee.Remarks); return Build(item, item.Title, "Task progress: " + item.Title, text, "Task " + status.ToLowerInvariant() + ": " + item.Title, text, item.StartDateTime, item.EndDateTime, calendarLink); } #region Helpers /// The person's own title when the organizer gave them one, else the item's. private static string TitleFor(CalendarItem item, CalendarItemAttendee to) { return string.IsNullOrWhiteSpace(to?.TitleOverride) ? item.Title : to.TitleOverride; } /// The person's own dates on a one-off item (a repeating item always uses the series' dates). private static (DateTime Start, DateTime End) DatesFor(CalendarItem item, CalendarItemAttendee to) { if (to == null || !string.IsNullOrWhiteSpace(item.RecurrenceRule)) return (item.StartDateTime, item.EndDateTime); DateTime start = to.FromOverride ?? item.StartDateTime; DateTime end = to.ToOverride ?? item.EndDateTime; return (start, end < start ? start : end); } private static string KindOf(CalendarItem item) { return item.ItemType == EnumCalendarItemType.Task ? "Task" : "Event"; } /// "Thu, 15 Oct 2026, 10:00 AM - 11:00 AM" or "Thu, 15 Oct 2026 (entire day)". public static string When(CalendarItem item, DateTime start, DateTime end) { if (item.IsAllDay) { string first = start.ToString("ddd, dd MMM yyyy"); return start.Date == end.Date ? first + " (entire day)" : first + " - " + end.ToString("ddd, dd MMM yyyy") + " (entire day)"; } return start.Date == end.Date ? start.ToString("ddd, dd MMM yyyy, h:mm tt") + " - " + end.ToString("h:mm tt") : start.ToString("ddd, dd MMM yyyy, h:mm tt") + " - " + end.ToString("ddd, dd MMM yyyy, h:mm tt"); } /// The title shown in the e-mail (the recipient's own title, where they have one). private static CalendarMessage Build(CalendarItem item, string title, string header, string bellText, string subject, string intro, DateTime start, DateTime end, string calendarLink) { StringBuilder body = new StringBuilder(); body.Append("

").Append(Encode(intro)).Append("

"); body.Append(""); Row(body, item.ItemType == EnumCalendarItemType.Task ? "Task" : "Event", title); Row(body, "When", When(item, start, end)); if (!string.IsNullOrWhiteSpace(item.Location)) Row(body, "Location", item.Location); if (!string.IsNullOrWhiteSpace(item.OrganizerName)) Row(body, "Organizer", item.OrganizerName); if (!string.IsNullOrWhiteSpace(item.Description)) Row(body, "Details", item.Description); body.Append("
"); if (!string.IsNullOrWhiteSpace(calendarLink)) body.Append("

Open my calendar

"); // EmployeeNotification's column sizes are not documented: keep the bell texts short to be safe. return new CalendarMessage { Header = Truncate(header, 100), BellText = Truncate(bellText, 250), MailSubject = Truncate(subject, 250), MailBody = body.ToString() }; } private static void Row(StringBuilder body, string label, string value) { body.Append("").Append(Encode(label)) .Append("").Append(Encode(value)).Append(""); } private static string Encode(string value) { return WebUtility.HtmlEncode(value ?? string.Empty); } private static string Truncate(string value, int max) { value ??= string.Empty; return value.Length <= max ? value : value.Substring(0, max - 1) + "…"; } #endregion } }