KDE 4.7 PyKDE API Reference

- KDE's Python API

# CollectionDeleteJob Class Reference

`from PyKDE4.akonadi import *`

Inherits: Akonadi.Job → KCompositeJob → KJob → QObject
Namespace: Akonadi

## Detailed Description

Job that deletes a collection in the Akonadi storage.

This job deletes a collection and all its sub-collections as well as all associated content.

     Akonadi.Collection collection = ...

     Akonadi.CollectionDeleteJob *job = new Akonadi.CollectionDeleteJob( collection );
     connect( job, SIGNAL( result( KJob* ) ), this, SLOT( deletionResult( KJob* ) ) );

Note:
  This job deletes the data from the backend storage. To delete the collection from the Akonadi storage only, leaving the backend storage unchanged, delete the Agent instead, as follows. (Note that if it's a sub-collection, deleting the agent will also delete its parent collection; in this case the only option is to delete the sub-collection data in both Akonadi and backend storage.)

     const Akonadi.AgentInstance instance =
                       Akonadi.AgentManager.self()->instance( collection.resource() );
     if ( instance.isValid() ) {
       Akonadi.AgentManager.self()->removeInstance( instance );
     }

Author:
  Volker Krause <vkrause@kde.org>

## Methods

| __init__ (self, Akonadi.Collection collection, QObject parent=0)
| doStart (self)

## Method Documentation

__init__ | ( | self, |
|  | Akonadi.Collection | collection,
|  | QObject | parent=0
| ) |  |  |

Creates a new collection delete job. The collection needs to either have a unique identifier or a remote identifier set. Note that using a remote identifier only works in a resource context (that is from within ResourceBase), as remote identifiers are not guaranteed to be globally unique.

Parameters:

  | collection | The collection to delete.
  | parent | The parent object.

doStart | ( |  | self ) |