2.1.3.1.1.20.62 Component: VALARM

  • Article

RFC Reference: [RFC2445] section 4.6.6

Number of Instances Allowed: 0, 1

Brief Description: Specifies a reminder for an appointment.

Importing to Calendar objects

If there is a VALARM component with a TRIGGER property specified as a Duration ([RFC2445] section 4.3.6) or a Date-Time ([RFC2445] section 4.3.5), then it MUST be parsed according to the following table.

Named Property

Value

PidLidReminderDelta

If TRIGGER is specified as a Duration, PidLidReminderDelta MUST be set to the absolute value of the number of minutes specified by the TRIGGER property. If TRIGGER is specified as a Date-Time, PidLidReminderDelta SHOULD<262> be set to the difference in minutes between DTSTART and the value of TRIGGER. If no such TRIGGER property could be parsed, PidLidReminderDelta SHOULD<263> be set to 0x0000000F for non-all day appointments and 0x00000438 for all day appointments.

PidLidReminderTime ([MS-OXPROPS] section 2.224)

MUST be set to the next instance of the appointment, in UTC. If all instances of the appointment are in the past, then this property SHOULD NOT be set.

PidLidReminderSignalTime ([MS-OXPROPS] section 2.223)

If TRIGGER is specified as a Duration, PidLidReminderSignalTime SHOULD<264> be set to PidLidReminderDelta minutes earlier than PidLidReminderTime. If TRIGGER is specified as a Date-Time, PidLidReminderSignalTime SHOULD<265> be set to the value of TRIGGER in UTC. If PidLidReminderTime is not set, then this property SHOULD NOT be set.

PidLidReminderSet ([MS-OXPROPS] section 2.222)

MUST be set to TRUE if and only if PidLidReminderDelta was successfully parsed from a TRIGGER property and PidLidReminderTime was set.

Exporting from Calendar objects

If PidLidReminderSet is TRUE, then a VALARM component MUST be exported with the properties specified in the following table.

VALARM Property

Value

TRIGGER

MUST be set to a Duration ([RFC2445] section 4.3.6) representing the number of minutes specified by PidLidReminderDelta. If PidLidReminderDelta is set to 0x5AE980E1, TRIGGER MUST be exported as 15 minutes.

ACTION

MUST be set to 'DISPLAY'

DESCRIPTION

MUST be set to 'Reminder'