This site has been retired. For up to date information, see handbook.gnome.org or gitlab.gnome.org.


[Home] [TitleIndex] [WordIndex

Tasque

1. Backends

Information on how to write a task system backend for Tasque

1.1. Introduction

A Tasque Backend is an implementation of the Tasque.Backends.IBackend interface. A backend is essentially where Tasque reads and stores tasks.

The following backends currently exist:

1.2. Constructors

Each backend should implement a public constructor that takes no arguments. When Tasque starts up, it will search its assembly (tasque.exe) for implementations of Tasque.Backends.IBackend. It loads each one it finds and queries its name so it can be displayed in the Preferences Dialog. If you do too much in the constructor, you may consume more memory than is needed and also cause Tasque to be too slow at startup.

Instead of doing work in the constructor, you should do the work in the IBackend.Initialize () method. This will only be called if your backend has been selected as the one to use.

1.3. Backend entity IDs

Backend entity IDs are identification tokens (usually a number, id string or GUID) that identify an entity in Tasque. An entity in Tasque is one of Task, Task List and Note. When it comes to assigning IDs in Tasque, care must be taken to use a sufficiently scoped ID. Therefore we distinguish between 3 levels of uniqueness scopes of IDs:

Tasque requires the use of 2nd level scope uniqueness, that is entity-type-scope IDs.


2024-10-23 10:59