MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

Organizer QML Plugin

Overview

The identifying string for this component is "QtMobility.organizer". Use this in the QML import statement.

The Organizer API enables a client to request calendar, schedule and personal data from local or remote backends. The QML Organizer Plugin delivers these capabilities in an easy to use form.

Organizer Items

The OrganizerItem element provides a generic interface for accessing events, todos, journals and notes. To actually access specific fields of an item, convenience sub elements of OrganizerItem are offered. These are Event, Todo, Journal and Note. Additionally, EventOccurrence and TodoOccurrence can be used for manipulating occurrences of event or todos.

Recurring Items

A recurring item is an item that occurs more than once; for example, a meeting that occurs every week for the next 10 weeks. A recurring item is created by creating an Event or Todo and setting a RecurrenceRule on it to specify the rules for when it should recur. See Recurrence and RecurrenceRule for detail references.

Collections

Every item stored in a organizer store belongs to exactly one collection. A collection can have properties such as a name, a "color", a specified icon, a description, and so on. Collections may be added or removed if the backend store supports those operations, or modified. There will always be at least one collection in an organizer, and the organizer manager will always have a default collection into which items are saved if no other collection is specified.

Organizer Item Details

Several sub elements of ItemDetail are provided as part of the QtMobility Organizer API. They are general in design but are intended to fulfill specific use-cases. Please note that certain backends may choose not to support one or more of these elements as they appear here; they may offer their own which provide similar functionality.

Organizer Filters

The Organizer QML plugin supplies filters to search for organizer items with particular values for various properties in the organizer item details.

Times in Organizer

All time type properties in QML Organizer such as OrganizerItem.itemEndTime etc are returned in local time. But when assign new values to these properties, the time specs remain the same while saving these values into backend organizer engines.

Organizer Elements

QML AudibleReminder Element

The AudibleReminder element contains information about an audible reminder of an item.

QML ChangeLogFilter Element

The ChangeLogFilter element provides a filter based around a organizer item timestamp criterion.

QML Collection Element

The Collection element represents a collection of items in an organizer manager.

QML CollectionFilter Element

The CollectionFilter element provides a filter based around a list of organizer item ids.

QML Comment Element

The Comment element contains the comment text of an organizer item.

QML Description Element

The Description element contains the description text of an organizer item.

QML Detail Element

The Detail element represents a single, complete detail about a organizer item.

QML DetailFilter Element

The DetailFilter element provides a filter based around a detail value criterion.

QML DetailRangeFilter Element

The DetailRangeFilter element provides a filter based around a detail value range criterion.

QML DisplayLabel Element

The DisplayLabel element contains the display label of an organizer item.

QML EmailReminder Element

The EmailReminder element contains information about an email reminder of an item.

QML Event Element

The Event element provides an event in time which may reoccur.

QML EventOccurrence Element

The EventOccurrence element provides an occurrence of an event.

QML EventTime Element

The EventTime element contains the start and end dates and times of a recurring event series, or occurrence of an event.

QML FetchHint Element

The FetchHint element provides hints to the manager about which organizer item information needs to be retrieved in an asynchronous fetch request or a synchronous function call.

QML Filter Element

The Filter element is used as a property of OrganizerModel, to allow selection of organizer items which have certain details or properties.

QML Guid Element

The Guid element contains the GUID string of an organizer item.

QML IdFilter Element

The IdFilter element provides a filter based around a list of organizer item ids.

QML IntersectionFilter Element

The IntersectionFilter element provides a filter which intersects the results of other filters.

QML InvalidFilter Element

the InvalidFilter element provides a filter which will never match any organizer items.

QML Journal Element

The Journal element provides a journal which is associated with a particular point in time.

QML JournalTime Element

The JournalTime element contains the entry date and time of a journal item.

QML Location Element

The Location element contains information about a location which is related to the organizer item in some manner.

QML Note Element

The Note element provides a note which is not associated with any particular point in time.

QML OrganizerItem Element

The OrganizerItem element represents the in-memory version of a calendar organizer item, and has no tie to a specific backend calendar store.

QML OrganizerModel Element

The OrganizerModel element provides access to organizer items from the organizer store.

QML Parent Element

The Parent element contains information about the event or todo that generated this item.

QML Priority Element

The Priority element contains the priority of the organizer item, which may be used to resolve scheduling conflicts.

QML Recurrence Element

The Recurrence element contains a list of rules and dates on which the recurrent item occurs, and a list of rules and dates on which exceptions occur.

QML RecurrenceRule Element

The RecurrenceRule element represents a rule by which a organizer item repeats.

QML Reminder Element

The Reminder element contains information about when and how the user wants to reminded of the item.

QML SortOrder Element

The SortOrder element defines how a list of organizer item should be ordered according to some criteria.

QML Tag Element

The Tag element contains the tag string of an organizer item.

QML Timestamp Element

The Timestamp element contains the created and last modified timestamp of an organizer item's creating date and time.

QML Todo Element

The Todo element provides a task which should be completed.

QML TodoOccurrence Element

The TodoOccurrence element provides an occurrence of an event.

QML TodoProgress Element

The TodoProgress element contains information about the progress of a todo item.

QML TodoTime Element

The TodoTime element contains the start and due dates and times of a recurring todo series, or occurrence of an todo item.

QML Type Element

The Type element contains the type string of an organizer item.

QML UnionFilter Element

The UnionFilter element provides a filter which unions the results of other filters.

QML VisualReminder Element

The VisualReminder element contains information about a visual reminder of an item.

See also OrganizerItem::isFloatingTime and ..