Praca z elementami kalendarza Outlook

Praca z MapiCalendar

Aspose.Email MapiCalendar klasa udostępnia metody i atrybuty do ustawiania różnych właściwości elementu kalendarza. Ten artykuł zawiera przykłady kodu dla:

• Praca z MapiCalendar
  • Tworzenie i zapisywanie elementów kalendarza
  • Zapisywanie elementu kalendarza jako MSG
  • Dodawanie przypomnienia wyświetlanego do kalendarza
  • Dodawanie przypomnienia audio do kalendarza
  • Dodaj/Pobierz załączniki z plików kalendarza
  • Status odbiorców z żądania spotkania
  • Utwórz MapiCalendarTimeZone ze standardowej strefy czasowej
• Ustawianie przypomnienia przy utworzonym spotkaniu
  • Ustawianie przypomnienia przez dodanie tagów
• Konwertuj spotkanie EML do MSG z treścią HTML

Tworzenie i zapisywanie elementów kalendarza

Poniższy fragment kodu pokazuje, jak utworzyć i zapisać element kalendarza w formacie ICS.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

Calendar cal = Calendar.getInstance();
cal.set(2012, Calendar.OCTOBER, 2, 13, 0, 0);
Date startDate = cal.getTime();
cal.set(2012, Calendar.OCTOBER, 2, 14, 0, 0);
Date endDate = cal.getTime();

MapiCalendar calendar = new MapiCalendar("LAKE ARGYLE WA 6743", 
                                         "Appointment", 
                                         "This is a very important meeting :)", 
                                         startDate, 
                                         endDate);

calendar.save(dataDir + "CalendarItem_out.ics", AppointmentSaveFormat.Ics);

Zapisywanie elementu kalendarza jako MSG

Poniższy fragment kodu pokazuje, jak zapisać element kalendarza jako MSG.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
calendar.save(dataDir + "CalendarItemAsMSG_out.Msg", AppointmentSaveFormat.Msg);

Ustawianie identyfikatora produktu przy zapisywaniu elementu kalendarza do ICS

Ten ProductIdentifier właściwość MapiCalendarIcsSaveOptions klasa jest używana do zapisania elementu kalendarza MAPI do pliku iCalendar (ICS), zachowując oryginalne informacje o dacie i czasie oraz niestandardowy identyfikator produktu. Właściwość określa identyfikator produktu, który utworzył obiekt iCalendar.

Poniższy przykład kodu pokazuje, jak pracować z danymi iCalendar (ICS) w obiekcie kalendarza MAPI:

MapiCalendarIcsSaveOptions icsSaveOptions = new MapiCalendarIcsSaveOptions();
icsSaveOptions.setKeepOriginalDateTimeStamp(true);
icsSaveOptions.setProductIdentifier("Foo Ltd");

mapiCalendar.save("my.ics", icsSaveOptions);

Dodawanie przypomnienia wyświetlanego do kalendarza

Poniższy fragment kodu pokazuje, jak dodać przypomnienie wyświetlane do kalendarza.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";
Calendar jCalendar = Calendar.getInstance();
jCalendar.add(Calendar.HOUR, 1);
Date startDate = jCalendar.getTime();
Date endDate = jCalendar.getTime();

MailAddressCollection attendees = new MailAddressCollection();
attendees.addItem(new MailAddress("[e-mail]", "Attendee"));
// Create Appointment
Appointment app = new Appointment("Home", 
                                  startDate, 
                                  endDate, 
                                  new MailAddress("[e-mail]", "Organizer"), 
                                  attendees);
MailMessage msg = new MailMessage();
msg.addAlternateView(app.requestApointment());
MapiMessage mapi = MapiMessage.fromMailMessage(msg);
MapiCalendar calendar = (MapiCalendar) mapi.toMapiMessageItem();

// Set calendar Properties
calendar.setReminderSet(true);
calendar.setReminderDelta(5); // 45 min before start of event

String savedFile = (dataDir + "calendarWithDisplayReminder.ics");
calendar.save(savedFile, AppointmentSaveFormat.Ics);

Dodawanie przypomnienia audio do kalendarza

Poniższy fragment kodu pokazuje, jak dodać przypomnienie audio do kalendarza.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";
Calendar jCalendar = Calendar.getInstance();
jCalendar.add(Calendar.HOUR, 1);
Date startDate = jCalendar.getTime();
Date endDate = jCalendar.getTime();

MailAddressCollection attendees = new MailAddressCollection();
attendees.addItem(new MailAddress("[e-mail]", "Attendee"));

Appointment app = new Appointment("Home", 
                                  startDate, 
                                  endDate, 
                                  new MailAddress("[e-mail]", "Organizer"), 
                                  attendees);

MailMessage msg = new MailMessage();
msg.addAlternateView(app.requestApointment());
MapiMessage mapi = MapiMessage.fromMailMessage(msg);
MapiCalendar cal = (MapiCalendar) mapi.toMapiMessageItem();

cal.setReminderSet(true);
cal.setReminderDelta(58); // 58 min before start of event
cal.setReminderFileParameter(dataDir + "Alarm01.wav");

String savedFile = dataDir + "calendarWithAudioReminder_out.ics";
cal.save(savedFile, AppointmentSaveFormat.Ics);

Dodaj/Pobierz załączniki z plików kalendarza

Poniższy fragment kodu pokazuje, jak dodać/pobrać załączniki z plików kalendarza.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";
Calendar jCalendar = Calendar.getInstance();
jCalendar.add(Calendar.HOUR, 1);
Date startDate = jCalendar.getTime();
Date endDate = jCalendar.getTime();

String[] files = new String[3];
files[0] = "attachment_1.doc";
files[1] = "download.png";
files[2] = "Desert.jpg";

MailAddressCollection attendees = new MailAddressCollection();
attendees.addItem(new MailAddress("[e-mail]", "Attendee"));

Appointment app1 = new Appointment("Home", 
                                   startDate, 
                                   endDate, 
                                   new MailAddress("[e-mail]", "Organizer"), 
                                   attendees);
for (String file : files) {
    app1.getAttachments().addItem(new Attachment(dataDir + file));
}

app1.save(dataDir + "appWithAttachments_out.ics", AppointmentSaveFormat.Ics);

Appointment app2 = Appointment.load(dataDir + "appWithAttachments_out.ics");
System.out.println(app2.getAttachments().size());
for (Attachment att : app2.getAttachments())
    System.out.println(att.getName());

Status odbiorców z żądania spotkania

Poniższy fragment kodu pokazuje, jak uzyskać status odbiorców z żądania spotkania.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
String fileName = "outlook/test.msg";

MapiMessage message = MapiMessage.fromFile(fileName);
for (MapiRecipient recipient : message.getRecipients()) {
    System.out.println(recipient.getRecipientTrackStatus());
}

Ustaw stan spotkania kalendarza jawnie

Aspose.Email umożliwia ustawienie stanu MapiCalendar obiekt jawnie, nadpisując domyślne zachowanie. setStateForced metoda zapewnia lepszą kontrolę nad stanami zdarzeń kalendarza, szczególnie przy obsłudze otrzymanych żądań spotkań. Domyślnie, gdy spotkanie jest tworzone, jego stan to MapiCalendarState.Meeting. Po otrzymaniu w skrzynce odbiorczej odbiorcy, automatycznie zmienia się na MapiCalendarState.Received, a jego klasa wiadomości jest aktualizowana do IPM.Schedule.Meeting.Request. Używając SetStateForced pozwala ręcznie ustawić stan na Otrzymane, co może być przydatne do zachowania informacji o organizatorze przy zapisywaniu kalendarza jako plik MSG. Jednak może to uniemożliwić prawidłowe przekazywanie lub ponowne wysyłanie spotkania.

Poniższy przykład kodu pomoże Ci zaimplementować tę funkcję:

Calendar c = Calendar.getInstance();
c.set(2024, Calendar.MAY, 10, 12, 30, 0);
Date startDate = c.getTime();
c.set(2024, Calendar.MAY, 10, 13, 30, 0);
Date endDate = c.getTime();
MapiCalendar appointment = new MapiCalendar(
        "LAKE ARGYLE WA 6743",
        "Appointment",
        "This is a very important meeting :)",
        startDate,
        endDate);

MapiElectronicAddress organizer = new MapiElectronicAddress();
organizer.setEmailAddress("[e-mail]");
organizer.setDisplayName("test display Name");
appointment.setOrganizer(organizer);

appointment.setStateForced(MapiCalendarState.Meeting | MapiCalendarState.Received);

appointment.save("appointment.msg", AppointmentSaveFormat.Msg);

Utwórz MapiCalendarTimeZone ze standardowej strefy czasowej

Poniższy fragment kodu pokazuje, jak stworzyć MapiCalendarTimeZone z standardowej strefy czasowej.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
MapiCalendarTimeZone timeZone = new MapiCalendarTimeZone("Eastern Standard Time");

Ustawianie przypomnienia przy utworzonym spotkaniu

Przypomnienie można dodać podczas tworzenia spotkania. Te alarmy mogą być wyzwalane na podstawie różnych kryteriów, takich jak n minut przed rozpoczęciem planu, powtarzanie n razy w odstępach n. Różne tagi mogą być użyte do stworzenia tych wyzwalaczy w skrypcie umieszczonym pomiędzy BEGIN:VALARM i END:VALARM w obrębie spotkania. Istnieje wiele wariantów ustawiania przypomnienia w spotkaniu.

Ustawianie przypomnienia przez dodanie tagów

Poniższy fragment kodu pokazuje, jak ustawić przypomnienie poprzez dodanie tagów.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = RunExamples.getDataDir_Outlook();
long MIN_MS = 60 * 1000;
long HR_MS = 60 * MIN_MS;
long DAY_MS = 24 * HR_MS;

String location = "Meeting Location: Room 5";
Date startDate = getDate(1997, 3, 18, 18, 30, 00);
Date endDate = getDate(1997, 3, 18, 19, 30, 00);
MailAddress organizer = new MailAddress("[e-mail]", "Organizer");
MailAddressCollection attendees = new MailAddressCollection();
attendees.addItem(new MailAddress("[e-mail]", "First attendee"));

Appointment target = new Appointment(location, startDate, endDate, organizer, attendees);

// Audio alarm that will sound at a precise time and
// Repeat 4 more times at 15 minute intervals:
AppointmentReminder audioReminder = new AppointmentReminder();
audioReminder.setTrigger(new ReminderTrigger(getDate(1997, 3, 17, 13, 30, 0)));
audioReminder.setRepeat(4);
audioReminder.setDuration(new ReminderDuration(15 * MIN_MS));
audioReminder.setAction(ReminderAction.Audio);
ReminderAttachment attach = new ReminderAttachment(new URI("ftp://Host.com/pub/sounds/bell-01.aud"));
audioReminder.getAttachments().addItem(attach);
target.getReminders().addItem(audioReminder);


// Display alarm that will trigger 30 minutes before the
// Scheduled start of the event it is
// Associated with and will repeat 2 more times at 15 minute intervals:
AppointmentReminder displayReminder = new AppointmentReminder();
ReminderDuration dur = new ReminderDuration(-30 * MIN_MS);
displayReminder.setTrigger(new ReminderTrigger(dur, ReminderRelated.Start));
displayReminder.setRepeat(2);
displayReminder.setDuration(new ReminderDuration(15 * MIN_MS));
displayReminder.setAction(ReminderAction.Display);
displayReminder.setDescription("Breakfast meeting with executive team at 8:30 AM EST");
target.getReminders().addItem(displayReminder);

// Email alarm that will trigger 2 days before the
// Scheduled due date/time. It does not
// Repeat. The email has a subject, body and attachment link.
AppointmentReminder emailReminder = new AppointmentReminder();
ReminderDuration dur1 = new ReminderDuration(-2 * DAY_MS);
emailReminder.setTrigger(new ReminderTrigger(dur1, ReminderRelated.Start));
ReminderAttendee attendee = new ReminderAttendee("[e-mail]");
emailReminder.getAttendees().addItem(attendee);
emailReminder.setAction(ReminderAction.Email);
emailReminder.setSummary("REMINDER: SEND AGENDA FOR WEEKLY STAFF MEETING");
emailReminder.setDescription("A draft agenda needs to be sent out to the attendees to the weekly managers meeting (MGR-LIST). Attached is a pointer the document template for the agenda file.");
ReminderAttachment attach1 = new ReminderAttachment(new URI("http://Host.com/templates/agenda.doc"));
emailReminder.getAttachments().addItem(attach1);
target.getReminders().addItem(emailReminder);

// Procedural alarm that will trigger at a precise date/time
// And will repeat 23 more times at one hour intervals. The alarm will
// Invoke a procedure file.
AppointmentReminder procReminder = new AppointmentReminder();
procReminder.setTrigger(new ReminderTrigger(getDate(1998, 1, 1, 5, 0, 0)));
procReminder.setRepeat(23);
procReminder.setDuration(new ReminderDuration(1 * DAY_MS));
procReminder.setAction(ReminderAction.Procedure);
ReminderAttachment attach2 = new ReminderAttachment(new URI("ftp://Host.com/novo-procs/felizano.exe"));
procReminder.getAttachments().addItem(attach2);
target.getReminders().addItem(procReminder);
target.save(dataDir + "savedFile_out.ics");

Konwertuj spotkanie EML do MSG z treścią HTML

Od wersji 19.3, Aspose.Email umożliwia konwersję spotkania w formacie EML do MSG zachowując treść HTML spotkania. Aspose.Email zapewnia MapiConversionOptions.ForcedRtfBodyForAppointment właściwości, która ma domyślną wartość true. Gdy wartość MapiConversionOptions.ForcedRtfBodyForAppointment jest ustawiona na true, treść spotkania jest konwertowana do formatu RTF. Aby zachować format treści spotkania w HTML, ustaw wartość MapiConversionOptions.ForcedRtfBodyForAppointment na false.

Poniższy przykład demonstruje użycie MapiConversionOptions.ForcedRtfBodyForAppointment właściwość, aby zachować format treści spotkania w formacie HTML.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

MailMessage mailMessage = MailMessage.load(dataDir + "TestAppointment.eml");

MapiConversionOptions conversionOptions = new MapiConversionOptions();
conversionOptions.setFormat(OutlookMessageFormat.Unicode);

// default value for ForcedRtfBodyForAppointment is true
conversionOptions.setForcedRtfBodyForAppointment(false);

MapiMessage mapiMessage = MapiMessage.fromMailMessage(mailMessage, conversionOptions);

if (mapiMessage.getBodyType() == BodyContentType.Html) {
    System.out.println("Body Type: Html");
} else if (mapiMessage.getBodyType() == BodyContentType.Rtf) {
    System.out.println("Body Type: Rtf");
}

mapiMessage.save(dataDir + "TestAppointment_out.msg");