Adding a Custom Reporting Search from the Command Line

CentraSite Documentation : Working with the CentraSite Business UI : Administering the Business UI : Managing the Catalog : Saving and Re-Executing Saved Searches : Adding a Custom Reporting Search from the Command Line

You can add a custom XQuery reporting search by executing the following command in the command line interface CentraSiteCommand.cmd (Windows) or CentraSiteCommand.sh (UNIX) of Command Central. The tool is located in <CentraSiteInstallDir>/utilities.

If you start this command line tool with no parameters, you receive a help text summarizing the required input parameters.

The parameters of the command are case-sensitive, so for example the parameter -url must be specified as shown and not as -URL.

If you omit the passwords from the command, you will be prompted to provide them.

The syntax of the command is as follows:

CentraSiteCommand add Search [-url <CENTRASITE-URL>] -user <USER-ID>
-password<PASSWORD> -savedSearch <SAVED-SEARCH> [-module <XQUERY-MODULE>]
[-overwrite<CONFIRM-OVERWRITE>] [-scope <SCOPE>]

The following table describes the complete set of input parameters that you can use with the add Search utility:

Parameter	Description
-url	The fully qualified URL (http://localhost:53307/CentraSite/CentraSite) for the CentraSite registry/repository.
-user	The user ID of a user who has the CentraSite Administrator role.
-password	The password of the user identified by the parameter -user.
-savedSearch	Name of the saved search XML file.
-module	The fully qualified namespace of the XQuery module.
-overwrite	Specifies whether to overwrite an existing XQuery module. Possible values: true - overwrite existing XQuery module; false - do not overwrite existing XQuery module.
-scope	Specifies the folder to store the newly added search. Possible values: global - stores the search information in Default Organization folder; org - stores the search information in the user's organization folder; user (default value) - stores the search information in the user folder.

For example:

CentraSiteCommand add Search -url http://localhost:53307/CentraSite/CentraSite
-user Administrator -password manage -savedSearch MySearch.xml
-module MySearchQuery.xquery -overwrite true -scope org

Important:

CentraSite relies on file extensions to determine a file's type. When you upload a saved search XML file or an XQuery module from your local machine using the command line, be sure you specify the name of the file along with its extension (.xml or .xquery) so that CentraSite can determine the file's type and mark it correctly in the repository.

Contact Support | Community | Feedback