Beheren van Outlook-agenda-items

De MapiCalendar klasse in de Aspose.Email-bibliotheek biedt verschillende methoden en attributen om agenda-items te configureren en te manipuleren. Hiermee kunt u Outlook-agenda-items effectief beheren, waardoor productiviteit en organisatie worden verbeterd. Hieronder staan de secties die u door verschillende aspecten van het beheren van agenda-items zullen leiden.

Agenda‑items maken en opslaan

Agenda-items maken en opslaan

Het volgende codefragment laat zien hoe u een agenda-item maakt en opslaat in het ICS-formaat:

Definieer het pad waar uw agenda-bestand wordt opgeslagen.
Maak een afspraak door een nieuw te initialiseren MapiCalendar object met specifieke details zoals locatie, onderwerp, beschrijving, start- en eindtijden.
Sla de gemaakte afspraak op als een ICS-bestand in de opgegeven map.

import aspose.email as ae
from datetime import datetime

data_dir = "path/to/data/directory"

# Create the appointment
calendar = ae.mapi.MapiCalendar(
    "LAKE ARGYLE WA 6743",
    "Appointment",
    "This is a very important meeting :)",
    datetime(2012, 4, 1),
    datetime(2012, 5, 1))

calendar.save(data_dir + "CalendarItem_out.ics", ae.calendar.AppointmentSaveFormat.ICS)

Agenda-items opslaan als MSG

De volgende codefragment laat zien hoe u het agenda-item opslaat als MSG:

Product-ID instellen voor MapiCalendar‑naar‑ICS-conversie

De Aspose.Email-bibliotheek stelt u in staat een MapiCalendar (een agenda‑item) op te slaan in een ICS (iCalendar)-bestand met specifieke opties. Het volgende eigenschappen zal u in staat stellen de originele datum‑ en tijdstempels die aan het agenda‑item zijn gekoppeld te behouden en de productidentifier in het ICS‑bestand in te stellen, bijvoorbeeld op "Foo Ltd", respectievelijk:

ics_save_options.keep_original_date_time_stamp
ics_save_options.product_identifier

De productidentifier is een veld dat de software of dienst identificeert die het ICS‑bestand heeft gegenereerd.

Hier is een codevoorbeeld waarmee u een product-ID kunt instellen bij het opslaan van MapiCalendar naar ICS:

import aspose.email as ae
from datetime import datetime

mapi_calendar = ae.mapi.MapiCalendar(
    "LAKE ARGYLE WA 6743",
    "Appointment",
    "This is a very important meeting :)",
    datetime(2024, 4, 1),
    datetime(2024, 4, 2))

ics_save_options = ae.mapi.MapiCalendarIcsSaveOptions()
ics_save_options.keep_original_date_time_stamp = True
ics_save_options.product_identifier = "Foo Ltd"

mapi_calendar.save("my.ics", ics_save_options)

Totale agenda‑evenementen tellen

De CalendarReader klasse biedt functionaliteit om agenda-gegevens uit een aangewezen bestand te lezen en te analyseren. Door een CalendarReader-object te initialiseren, kunt u cruciale details ophalen, zoals het totale aantal gebeurtenissen, de agenda-versie, de gebruikte methode en of de agenda meerdere gebeurtenissen bevat. Hieronder staat een codefragment dat laat zien hoe u met agenda-gegevens kunt werken en afspraken kunt laden als een uitgebreide lijst van gebeurtenissen:

import aspose.email as ae

reader = ae.calendar.CalendarReader("calendar.ics")
print(f"Calendar contains {reader.count} events")
print(f"The Version of the calendar is {reader.version}")
print(f"The Method of the calendar is {reader.method}")
print(f"Is calendar contains contains multiple events? - {reader.is_multi_events}")
appointments = reader.load_as_multiple()

Weergaveherinneringen toevoegen aan agenda-items

Het volgende codefragment laat zien hoe u een weergave‑herinnering aan een agenda toevoegt.

Audiherinneringen toevoegen aan agenda-items

Het volgende codefragment laat zien hoe u een audiherinnering aan een agenda toevoegt.

De MapiCalendar‑status expliciet instellen

Aspose.Email biedt een methode om expliciet de status van een MapiCalendar-object te definiëren, waarmee het standaardgedrag wordt overschreven:

void MapiCalendar.set_state_forced(MapiCalendarState state) - biedt meer controle over de status van het agenda‑item, vooral bij het werken met ontvangen vergaderverzoeken.

Wanneer een MapiCalendar-object wordt gemaakt, krijgt het automatisch de status MapiCalendarState.MEETING. Wanneer het item door een ontvanger wordt ontvangen, verandert de status doorgaans in MapiCalendarState.RECEIVED, en wordt de berichtklasse bijgewerkt naar "IPM.Schedule.Meeting.Request".

Het volgende codevoorbeeld laat zien hoe u een vergaderafspraak maakt met Aspose.Email voor Python via .NET, de organisator en agenda‑status handmatig instelt, en de afspraak opslaat als een Outlook .msg‑bestand:

from aspose.email.mapi import MapiCalendar, MapiCalendarState, MapiElectronicAddress
from aspose.email.calendar import AppointmentSaveFormat
from datetime import datetime, timezone

# Create a MapiCalendar appointment
appointment = MapiCalendar(
    "LAKE ARGYLE WA 6743",                     # Location
    "Appointment",                             # Subject
    "This is a very important meeting :)",     # Body
    datetime(2024, 5, 10, 12, 30, 0, tzinfo=timezone.utc),  # Start time (UTC)
    datetime(2024, 5, 10, 13, 30, 0, tzinfo=timezone.utc)   # End time (UTC)
)

# Set the organizer
appointment.organizer = MapiElectronicAddress()
appointment.organizer.email_address = "test@aaa.com"
appointment.organizer.display_name = "test display Name"

# Forcefully set the calendar state to Meeting | Received
appointment.set_state_forced(MapiCalendarState.MEETING | MapiCalendarState.RECEIVED)

# Save the appointment to a .msg file
appointment.save("appointment.msg", AppointmentSaveFormat.MSG)

Door de set_state_forced, u kunt handmatig de status van het agenda-item op een specifieke waarde instellen (bijv. MapiCalendarState.RECEIVED). Dit is vooral nuttig wanneer u wilt:

Simuleer een ontvangen vergaderverzoek.
Behoud organisator‑ en vergadermetadata bij het opslaan van de afspraak in een .MSG‑bestand.
Pas agenda‑workflows aan wanneer het standaardgedrag niet voldoende is.

Opmerking: Handmatig instellen van de status met set_state_forced kan het Outlook‑gedrag beïnvloeden, zoals de mogelijkheid om de vergadering door te sturen of opnieuw te verzenden. Daarom moet het met voorzichtigheid worden gebruikt en alleen wanneer het nodig is voor de logica van uw applicatie.

Beheer van agenda‑bestanden

Bijlagen toevoegen of ophalen uit agenda‑bestanden

De Aspose.Email Calendar ("ae.calendar")‑module biedt ook de functionaliteit om bijlage‑informatie toe te voegen en op te halen.

Om een bijlage aan de afspraak toe te voegen, volg de onderstaande stappen:

Maak een Attachment object dat het bestandspad levert.
Voeg deze bijlage toe aan de lijst met bijlagen van de afspraak.
Sla de afspraak op naar een specifiek bestandspad in iCalendar‑formaat met behulp van de opslaan methode en het juiste bestandsformaat.

Om bijlagen uit een afspraak op te halen, volg de volgende stappen:

Laad een afspraak uit het opgeslagen bestand met behulp van de laden methode.
Haal het aantal bijlagen in de afspraak op met de .attachments.length‑eigenschap.
Itereer door elke bijlage.
Print de naam van elke bijlage met behulp van de .name‑eigenschap binnen de lus.

Het onderstaande codefragment laat zien hoe u afspraken met bijlagen maakt, opslaat en bijlage‑informatie ophaalt met behulp van de "ae.calendar"‑module. Het benadrukt de functionaliteit en mogelijkheden van het werken met afspraken en bijlagen in een agenda‑applicatie.

import aspose.email as ae
import datetime as dt

# Add an attachment to an appointment
attendees = ae.MailAddressCollection()
attendees.append(ae.MailAddress("attendee@domain.com", "Recipient 1"))

appointment = ae.calendar.Appointment("Room 112", dt.datetime(2023, 5, 27), dt.date(2023, 5, 28),  ae.MailAddress("organizer@domain.com"), attendees)

attachment = ae.Attachment("D:\\Aspose\\Files\\Attachment.txt")
appointment.attachments.append(attachment)

appointment.save("D:\\Aspose\\Files\\appWithAttachments_out.ics", ae.calendar.AppointmentSaveFormat.ICS)

# Retrieve attachments from an appointment 
appointment2 = ae.calendar.Appointment.load("D:\\Aspose\\Files\\appWithAttachments_out.ics")
print(appointment2.attachments.length)
for att in appointment2.attachments:
    print(att.name)

Ontvangerstatus ophalen uit vergaderverzoeken

Aspose.Email stelt u in staat te werken met vergaderverzoeken, weergegeven als een MapiCalendar-object, en de ontvangerstatus (bijwonen‑tracking) van dergelijke vergaderverzoeken op te halen. Het volgende codefragment laat zien hoe u de status van de e‑mail voor elke ontvanger kunt identificeren:

EML‑afspraken naar MSG converteren met behoud van HTML‑body

Aspose.Email maakt het mogelijk om een EML‑afspraak naar MSG te converteren en de HTML‑body te behouden. De forced_rtf_body_for_appointment-eigenschap van de MapiConversionOptions klasse wordt gebruikt om het type van de afspraak‑body te manipuleren. Wanneer ingesteld op True, wordt de body standaard geconverteerd naar RTF‑formaat. Om de body in HTML‑formaat te behouden, moet deze worden ingesteld op False. Het volgende codevoorbeeld laat zien hoe u de HTML‑body van de afspraak behoudt bij het converteren van EML naar MSG:

import aspose.email as ae

eml = ae.MailMessage.load("appointment.eml")

conversionOptions = ae.mapi.MapiConversionOptions()
conversionOptions.format = ae.mapi.OutlookMessageFormat.UNICODE
# default value for ForcedRtfBodyForAppointment is true
conversionOptions.forced_rtf_body_for_appointment = False

msg = ae.mapi.MapiMessage.from_mail_message(eml, conversionOptions)

print(f"Body Type: {msg.body_type}")

msg.save("appointment.msg")

Outlook‑MSG‑bestand follow‑up- en vervaldatumbeheer in Python Outlook-contacten beheren in PST-bestanden