Làm việc với các cuộc hẹn
Tải và Lưu một cuộc hẹn ở định dạng ICS
Cái Appointment class trong Aspose.Email cho Java có thể được sử dụng để tải một cuộc hẹn ở định dạng ICS cũng như để tạo một cuộc hẹn mới và lưu nó vào đĩa ở định dạng ICS. Trong bài viết này, chúng tôi sẽ tạo một cuộc hẹn và lưu nó vào đĩa ở định dạng ICS, sau đó tải nó.
Tải một cuộc hẹn ở định dạng ICS
Để tải một cuộc hẹn ở định dạng ICS, cần thực hiện các bước sau:
- Tạo một đối tượng của Appointment lớp.
- Gọi Load() phương thức bằng cách cung cấp đường dẫn của tệp ICS.
- Đọc bất kỳ thuộc tính nào để lấy thông tin từ cuộc hẹn (tệp ICS).
Các đoạn mã dưới đây cho thấy cách tải một cuộc hẹn ở định dạng ICS.
Tạo một cuộc hẹn và lưu vào đĩa ở định dạng ICS
Cần thực hiện các bước sau để tạo một cuộc hẹn và lưu nó ở định dạng ICS.
- Tạo một đối tượng của Appointment class và khởi tạo nó với hàm khởi tạo này.
- Truyền các đối số sau vào hàm khởi tạo ở trên
- Người tham dự
- Mô tả
- Ngày kết thúc
- Địa điểm
- Người tổ chức
- Ngày bắt đầu
- Tóm tắt
- Ngày tạo
- Ngày sửa đổi cuối cùng
- Gọi Save() phương thức và chỉ định tên tệp và định dạng trong các đối số.
Cuộc hẹn có thể được mở trong Microsoft Outlook hoặc bất kỳ chương trình nào có thể tải tệp ICS. Nếu tệp được mở trong Microsoft Outlook, nó sẽ tự động thêm cuộc hẹn vào lịch Outlook.
Các đoạn mã sau cho thấy cách tạo và lưu một cuộc hẹn vào đĩa ở định dạng ICS.
Lưu các cuộc hẹn sang định dạng MSG
Aspose.Email cho phép lưu các cuộc hẹn trực tiếp vào tệp .msg. Các lớp công khai sau đây có sẵn để tùy chỉnh quá trình lưu các cuộc hẹn:
- AppointmentMsgSaveOptions class với các tùy chọn bổ sung để lưu các cuộc hẹn ở định dạng msg.
- AppointmentIcsSaveOptions class với các tùy chọn bổ sung để lưu cuộc hẹn ở định dạng ics. Nó được thêm vào để thay thế IcsSaveOptions cũ.
Đoạn mã mẫu dưới đây cho thấy cách tải một cuộc hẹn từ tệp, và sau đó lưu nó ở hai định dạng khác nhau: .ics và .msg.
Appointment appointment = Appointment.load("fileName");
appointment.save("fileName.ics", new AppointmentIcsSaveOptions());
appointment.save("fileName.msg", new AppointmentMsgSaveOptions());
Tạo một cuộc hẹn với nội dung HTML
Thực hành phổ biến là sử dụng tiêu đề X-ALT-DESC trong định dạng iCalendar (RFC 5545). Đây là một thuộc tính mở rộng cung cấp mô tả thay thế có thể đọc được cho một mục lịch hoặc sự kiện. Tiêu đề này thường được dùng để bao gồm một phiên bản văn bản thuần hoặc HTML của mô tả sự kiện, điều này có thể hữu ích cho khả năng tương thích với phần mềm lịch cũ hoặc để cung cấp một phiên bản mô tả đơn giản hơn. Trong các trường hợp, khi mô tả chính không được hỗ trợ hoặc hiển thị đúng bởi ứng dụng lịch của người nhận, tiêu đề X-ALT-DESC được dùng để cung cấp một mô tả thay thế cho sự kiện. Nó cho phép người gửi bao gồm các biểu diễn khác nhau của mô tả sự kiện để đảm bảo khả năng tương thích và tiếp cận tốt hơn trên các phần mềm và nền tảng lịch khác nhau. Để tạo một cuộc hẹn với nội dung HTML, hãy đặt HtmlDescription thuộc tính thành ’true’. Hãy thử đoạn mã mẫu sau, nó minh họa cách tạo và định nghĩa một đối tượng cuộc hẹn với các chi tiết và cài đặt cụ thể, bao gồm ngày, giờ, địa điểm, người tổ chức, người tham dự và mô tả được định dạng:
Date startDate = new Date();
Appointment appointment = new Appointment("Bygget 83",
startDate, // start date
addHours(startDate, 1), // end date
new MailAddress("TintinStrom@from.com", "Tintin Strom"), // organizer
MailAddressCollection.to_MailAddressCollection(
new MailAddress("AinaMartensson@to.com", "Aina Martensson"))); // attendee
appointment.setHtmlDescription("<html>\n"
+ " <style type=\"\"text/css\"\">\n"
+ " .text {\n"
+ " font-family:'Comic Sans MS';\n"
+ " font-size:16px;\n"
+ " }\n"
+ " </style>\n"
+ " <body>\n"
+ " <p class=\"\"text\"\">Hi, I'm happy to invite you to our party.</p>\n"
+ " </body>\n"
+ " </html>");
Tạo yêu cầu cuộc hẹn bản nháp
Để lưu một cuộc hẹn ở chế độ bản nháp, Method thuộc tính của Appointment class nên được đặt thành Publish. Đoạn mã mẫu sau minh họa việc sử dụng thuộc tính này như một ví dụ.
Tạo cuộc hẹn bản nháp từ văn bản
Thêm và Xóa tệp đính kèm từ các mục lịch
Aspose.Email cung cấp một bộ sưu tập tệp đính kèm có thể được dùng để thêm và lấy các tệp đính kèm liên quan tới mục lịch. Bài viết này cho thấy cách:
- Tạo và thêm tệp đính kèm vào một Appointment đối tượng class.
- Lấy thông tin các tệp đính kèm từ một cuộc hẹn.
- Trích xuất tệp đính kèm từ một cuộc hẹn.
Định dạng các cuộc hẹn
Các mẫu lập trình dưới đây minh họa cách sử dụng AppointmentFormattingOptions class để định dạng văn bản và HTML.
Mẫu lập trình - Định dạng văn bản
Mẫu lập trình - Định dạng HTML
Đọc nhiều sự kiện từ tệp ICS
Ghi nhiều sự kiện vào tệp ICS
Đặt trạng thái người tham dự của cuộc hẹn
API Aspose.Email cho .NET cho phép bạn đặt trạng thái của người tham dự cuộc hẹn khi soạn tin trả lời. Điều này sẽ thêm thuộc tính PARTSTAT vào tệp ICS.
Tùy chỉnh định danh sản phẩm cho ICalendar
API Aspose.Email cho Java cho phép lấy hoặc đặt định danh sản phẩm đã tạo đối tượng iCalendar.
Cách khắc phục lỗi xác thực địa chỉ khi cố gắng tải các cuộc hẹn
API Aspose.Email cho Java cho phép vượt qua lỗi xác thực email bằng cách đặt IgnoreSmtpAddressCheck tùy chọn trên AppointmentLoadOptions đối tượng và truyền nó vào lời gọi load.
AppointmentLoadOptions lo = new AppointmentLoadOptions();
lo.setIgnoreSmtpAddressCheck(true);
Appointment appointment = Appointment.load("app.ics", lo);