Import and export of favorites

Use the command line program runppmconfig to import private and shared favorites into PPM.

Import of favorites

The import of favorites via the command line supports the options Replace (parameter -replace) and Overwrite (parameter -overwrite). If no parameters are specified, the import is additive by default. Only new favorites and folders are created. Existing favorites and folders remain unchanged.

Prerequisite

You have the Favorites administration function privilege.

Import and export of shared favorites

If you specify the option sharedfavorites of the parameter –favoriteuser, only the shared favorites tree is imported or exported. If you do not specify the parameter –favoriteuser, the shared favorites tree is exported like a private favorites tree with the login name together with the private trees.

During the export of shared favorites, the access privileges for the shared favorites folders are exported, as well. Inherited or implicit access privileges are not exported.

You do not need special privileges for exporting favorites.

Import and export of template favorites

Importing and exporting template favorites is similar. However, you can import or export template favorites and favorites individually (parameter -favoritetemplates) or together (parameter -favoritesall).

runppmconfig -user <user name> -password <password>

-mode {import|export}

-favorites <file name>

[-client <client name>]

[–favoriteuser <ppm user>]

[-language <ISO code>]

[-overwrite]

[-replace]

[protocoloptions]

[-version]

[-favoritetemplates]

[-favoritesall]

List of specific parameters of favorites import and export

Parameter

Description

-favorites <file name>

File name with path to the XML file to which favorites are exported or from which favorites are imported.

Specification: Mandatory

[–favoriteuser <ppm user>]

Specifies the PPM user that the favorites are imported or exported for. If you do not specify this option, import or export will be executed for all PPM users.

Specification: Optional

[-overwrite]

Adds new favorites and folders, and changes existing favorites and folders, i.e., content of the favorites and access privileges of the shared favorites folders.

Specification: Optional

[-replace]

Deletes all folders and favorites and then imports the new favorites and folders including access privileges of the shared favorites folders.

Specification: Optional

[-favoritetemplates]

Exports or imports only template favorites of all users.

Specification: Optional

[-favoritesall]

Exports or imports favorites and template favorites of all users.

Specification: Optional

Examples