NotesCalendar (Java)

Represents a Domino® calendar.

Properties

AutoSendNotices (NotesCalendar - Java) through getAutoSendNotices and setAutoSendNotices

EntriesProcessed (NotesCalendar - Java) through getEntriesProcessed

ReadRangeMask1 (NotesCalendar - Java) through getReadRangeMask1 and setReadRangeMask1

ReadRangeMask2 (NotesCalendar - Java) through getReadRangeMask2 and setReadRangeMask2

ReadXLotusPropsOutputLevel (NotesCalendar - Java) through getReadXLotusPropsOutputLevel and setReadXLotusPropsOutputLevel

UntilTime (NotesCalendar - Java) through getUntilTime

Methods

createEntry (NotesCalendar - Java)

getEntries (NotesCalendar - Java)

getEntry (NotesCalendar - Java)

getEntryByNoteID (NotesCalendar - Java)

getEntryByUNID (NotesCalendar - Java)

getNewInvitations (NotesCalendar - Java)

getNoticeByUNID (NotesCalendar - Java)

getRecurrenceID (NotesCalendar Java)

readRange (NotesCalendar - Java)

Usage

This object provides access to calendar and scheduling services in a Domino® mail application in standard iCalendar format. See

Internet Calendaring and Scheduling Core Object
Specification (iCalendar)

at http://tools.ietf.org/html/rfc5545 for the format.

To create a NotesCalendar object, call getCalendar in Session.

You can access calendar entries as Document objects, but this interface should be used sparingly. In a standard Domino® mail application, calendar documents can be accessed through the ($Calendar) view. For sample code, see getEntryByNoteID or getEntryByUNID. You can access calendar documents directly with getAsDocument in NotesCalendarEntry and getAsDocument in NotesCalendarNotice.

Examples

This agent gets calendar and scheduling information for the current user for today and tomorrow.

import lotus.domino.*;

public class JavaAgent extends AgentBase {

    public void NotesMain() {

      try {
          Session session = getSession();
          AgentContext agentContext = session.getAgentContext();

          // (Your code goes here)
          // Get calendar for current user
          DbDirectory dbdir = session.getDbDirectory("");
          Database maildb = dbdir.openMailDatabase();
          NotesCalendar cal = session.getCalendar(maildb);
          DateTime dt1 = session.createDateTime("Today 08");
          DateTime dt2 = session.createDateTime("Tomorrow 17");
          // Create document to post results
          Database db = agentContext.getCurrentDatabase();
          Document doc = db.createDocument();
          doc.appendItemValue("Form", "main");
          doc.appendItemValue("subject", "Today 08");
          RichTextItem body = doc.createRichTextItem("body");
          // Read range and put in body of document
          body.appendText(cal.readRange(dt1, dt2));
          doc.save(true, true);
          NotesCalendarNotice caln = cal.getNoticeByUNID("");

      } catch(Exception e) {
          e.printStackTrace();
       }
   }
}

This is sample output.

BEGIN:VCALENDAR
X-LOTUS-CHARSET:UTF-8
VERSION:2.0
BEGIN:VEVENT
DTSTART:20120403T183000Z
DTEND:20120403T190000Z
TRANSP:OPAQUE
RECURRENCE-ID:20120403T183000Z
DTSTAMP:20120403T141313Z
SEQUENCE:3
X-LOTUS-ORGANIZER:CN=Robert F Harwood/OU=Westford/O=IBM
CLASS:PUBLIC
SUMMARY:Domino Designer ID Team meeting
UID:F0A3694E4E7E20938525790F004D370A-Lotus_Notes_Generated
X-LOTUS-SUMMARYDATAONLY:TRUE
X-LOTUS-NOTICETYPE:A
X-LOTUS-APPTTYPE:3
END:VEVENT
BEGIN:VEVENT
DTSTART:20120403T190000Z
DTEND:20120403T200000Z
TRANSP:OPAQUE
DTSTAMP:20120403T141313Z
SEQUENCE:0
X-LOTUS-ORGANIZER:CN=Craig Lordan/OU=Westford/O=IBM
X-LOTUS-ROOM:B2-B2104/LKG2/550 King St/MA-Littleton@IBMUS
CLASS:PUBLIC
SUMMARY:Translation packaging enablement session by Bruce Webster
LOCATION:USA: 888-555-5555 | passcode: 5555555
UID:C4FC689987507AC2852579CF00720024-Lotus_Notes_Generated
X-LOTUS-SUMMARYDATAONLY:TRUE
X-LOTUS-NOTICETYPE:A
X-LOTUS-APPTTYPE:3
X-LOTUS-ONLINEMEETING-URL:http://www.webdialogs.com/
X-LOTUS-ONLINEMEETING-CONFID:w555
END:VEVENT
BEGIN:VEVENT
DTSTART:20120404T124500Z
DTEND:20120404T131500Z
TRANSP:OPAQUE
RECURRENCE-ID:20120404T124500Z
DTSTAMP:20120403T141313Z
SEQUENCE:0
X-LOTUS-ORGANIZER:CN=Maire Kehoe/OU=Ireland/O=IBM
X-LOTUS-ROOM:G07 - Meeting Room/Campus Building 6@IBMIE
CLASS:PUBLIC
SUMMARY:XPages scrum
LOCATION:Location: \nIRELAND Toll-Free
 :  1-800-555-555\nIRELAND Caller Paid
 :  0-1-5555555\nUSA Caller Paid 555-555-5555\nUSA Toll-Free 888-555-55
 55\nUnited Kingdom Caller Paid 0-55-55555555\nUnited Kingdom Toll-Free
  0800-555-5555\nParticipant Code:  5555555\nFor other Countries
 : \nhttps
 ://www.teleconference.att.com/servlet/glbAccess?process=1&accessCode=5
 555555&accessNumber=015555555
UID:26CBC9B27E8660C1802579B3003DF9C0-Lotus_Notes_Generated
X-LOTUS-SUMMARYDATAONLY:TRUE
X-LOTUS-NOTICETYPE:A
X-LOTUS-APPTTYPE:3
END:VEVENT
END:VCALENDAR