Projects/Nepomuk/BulkChanges: Difference between revisions

    From KDE TechBase
    (Initial commit)
     
    Line 3: Line 3:
    = DataManagement =
    = DataManagement =


    With KDE 4.9 the Nepomuk Datamanagement libraries finally became public and allow clients to make large bulk changes to Nepomuk. In fact they are now the defacto method of modifying data. All other client libraries are now built on top of the Data Management library.
    With KDE 4.9 the [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/group__nepomuk__datamanagement.html Nepomuk Datamanagement libraries] finally became public and allow clients to make large bulk changes to Nepomuk. In fact they are now the defacto method of modifying data. All other client libraries are now built on top of the Data Management library.


    == Includes and Libraries ==
    == Includes and Libraries ==
    Since the datamanagement libraries are so prevalent, they come bundled together with the NepomukCore library.
    Since the datamanagement libraries are so prevalent, they come bundled together with the NepomukCore library.


    The appropriate functions are included in the <code>Nepomuk/DataManagement</code> include file.
    The appropriate functions are included in the [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/group__nepomuk__datamanagement.html <code>Nepomuk/DataManagement</code>] include file.


    ==Jobs==
    ==Jobs==

    Revision as of 10:08, 24 August 2012

    Quite often one needs to apply some changes to a large number of resources. Instead of using the Resource class which is synchronous. They are easier ways, which are asynchronous.

    DataManagement

    With KDE 4.9 the Nepomuk Datamanagement libraries finally became public and allow clients to make large bulk changes to Nepomuk. In fact they are now the defacto method of modifying data. All other client libraries are now built on top of the Data Management library.

    Includes and Libraries

    Since the datamanagement libraries are so prevalent, they come bundled together with the NepomukCore library.

    The appropriate functions are included in the Nepomuk/DataManagement include file.

    Jobs

    Each Datamanagement function returns a KJob which performs the jobs and returns a signal on completion. These jobs are automatically started, and like all other KJobs they are automatically deleted on completion.

    Errors

    While these jobs are quite easy to use, they have inbuilt error checking that verifies the domain, range and cardinality of the properties that are being changed. Therefore it is important to check the error code of the job when it returns. A better error message can be received via KJob::errorString