Organise()

Description:

The Organise method adds landmarks to a landmark category (association) or removes landmarks from a landmark category (disassociation). The same landmark can belong to multiple categories or to no category.

This is a synchronous method.

Syntax:

Organise(parameters:Object):Object

Arguments:

• parameters:

  This is an object that specifies which landmarks to associate or disassociate and with which landmark category. For more information about the object properties and how to define them, see section Parameters for organizing landmarks in a landmark category.

Return value:

The Organise method returns an object that contains an error code and an error message.

Remarks:

• If no landmark database is specified, Organise is performed on the default database. If the default database does not exist, it is created and set active. The default database is file://c:eposlm.ldb.

• For more information about landmarks, landmark categories, and landmark databases, see the Landmarks Service overview page.

Example code:

The following sample code illustrates how to organize landmarks:

import com.nokia.lib.Service;
var landmark = new Service("Service.Landmarks", "IDataSource");
var idList = ["id1","id2"...."idn"];
var inputData = {id:catId, IdList:idList}; // must pass a valid CategoryId which is a String
var inParams = {Type:"Landmark", Data:inputData, OperationType:"Associate"};
var outParams = landmark.Organise(inParams);
var errorId = outParams.ErrorCode;