Home · All Classes · Grouped Classes · Annotated · Functions

Content: Document Management
Functional Description

The Qtopia document system integrates with Digital Rights Management (DRM) and the Safe Execution Environment providing an enabling layer to enhance file-handling across all applications. Files are displayed by category rather than as a hierarchy which provides application-specific file displays. For example, if the user selects Mediaplayer, only the files able to be used by the Mediaplayer are displayed for selection.

The Document Management architecture of Qtopia provides a system-wide approach to management of user-visible documents such as images and music files. This allows efficient navigation of documents, removable storage media, and complex document types such as Digital Rights Management (DRM) files. The Document Server also relies on the Document Management system to control access to documents.



The document API framework provides the basis for the Qtopia Document System and enables the browsing and launching of regular and Digital Rights Management (DRM) files. An SQL database backs the framework allowing for flexible document management services.

The framework includes a scanning algorithm designed to run in the background and allow the user interface to continue to operate during document discovery. Qtopia applications in the launcher are also managed via the API.

Loading, saving and other file operations are performed by Qtopia applications through the Document System. This allows management of DRM content for example, which must not be saved to external storage devices in plain-text format.

See the Document System Documentation for further details.

Document Selectors (QTOPIA-460)

The QDocumentSelector and QImageDocumentSelector widgets provide applications with a view through which users can choose documents indexed by the document system. Both widgets are backed by a QContentSetModel with it's full range of filtering options.

In addition to selecting documents the widgets allow users to apply additional category and type filtering criteria, view document properties, and move and delete documents.

The QDocumentSelector widget provides a list view of documents, with an optional selection to create a new document. The QImageDocumentSelector provides a thumbnail view of images with an option to preview images before completing a selection.

Document Server (QTOPIA-461)

The Document Server exposes the functionality of the Document System using a Unix Domain Socket based server. Untrusted applications may connect to the server and utilize a select sub-set of the document system features without requiring direct access to the documents database.

The functionality of the Document System available to an application is determined by its SXE profiles. In this way an application may be allowed to view document meta-data but not open or edit documents.

The Document Server also provides a Document Selector Service which displays an open/save document dialog on behalf of an untrusted application. A selected document is opened by the Document Server process and passed to the untrusted application over the Unix Domain Socket using Ancilliary Data. Because the dialog is displayed by the server it allows the user unfettered access to their documents, but strictly limits the application's access to documents explicity selected by the user.

The Document Server thus allows downloaded untrusted applications to handle user documents. This enables downloadable Photo Editors, and so on.

Incremental Document Search (QTOPIA-479)

Typing characters in the Documents launcher menu launches an incremental search dialog. The documents displayed in the menu are filtered by the text in the dialog as the user types, clearing the text will restore the full list.

This works in conjunction with scrolling through the list with up and down arrows, or selecting by type/category.

Launcher Menus. (QTOPIA-458)

The Applications, Documents, Settings, Games, and other menus of the Qtopia launcher utilize a Model/View framework backed by QContentSetModel. The "just-in-time" fetching of content data and the change notification architecture ensures the menus are populated quickly and efficiently and remain up to date.

Additional filter expressions may be applied to the Documents menu to filter its contents by type or category. The Documents menu also provides a visual notification of when Qtopia is scanning for documents.

Media Management (QTOPIA-459)

Content plug-ins (QContentPlugin) are used to extract meta-data embedded in content scanned by the Document System. Qtopia includes plug-ins for MP3 ID3 tags and EXIF tags in JPEG and TIFF images.

This meta-data as well as other information made available by the Document System (name, location, type, categories, etc) may be used to search for and sort documents.

The QContentFilterModel and QContentFilterSelector classes provide a framework for querying and navigating searchable content information. These may be used to produce flat selection lists, or hierarchical (drill down) menus.

MIME Type Associations (QTOPIA-468)

MIME type associations allow Qtopia to identify the correct application to use to open a document based on the documents type. They are also used to determine the icon to decorate a document with, and what DRM permission, if any, are to be validated before opening the document.

Applications can associate themselves with a MIME type through their .desktop file, or at run-time using QMimeType. For more information see Document Oriented Applications.

Copyright © 2008 Nokia Trademarks
Qtopia 4.3.3