CSM Client Command-Line Options
Use the CSM Client command-line to automatically execute instructions or commands. CSM Client command-line options can launch programs more quickly and uses fewer system resources.
To use the CSM Client command-line options, execute the CSM Desktop Client with arguments.
When launching the CSM Desktop Client application, the actual application to run is called Trebuchet.App.exe (Trebuchet is the internal library name for the CSM application). This is usually found in the directory C:\Program Files\Cherwell Service Management.
General Settings
Option | Description |
---|---|
/? | This is the help option and it provides a display of the supported CSM Client command-line options. |
/c | This is the connection to use. To use a common connection (a connection that is available to all Users of the machine), prefix the connection with [Common]. To use a connection that is associated with the current User, prefix the connection with [User]. When using the interactive dialog, [Common] connections are on the All Users tab, while [User] connections are on the tab named for the current User. |
/u | This is the User ID to use. This only works when CSM authentication is enabled (instead of Windows or LDAP). |
/p | This is the password to use. This only works when
CSM
authentication is enabled (instead of Windows or LDAP).
Putting a password into a shortcut is a
potential security issue, since other Users are able to edit the properties of
the shortcut and read the password.
|
/l or /r | This is the culture override. Example language culture pairs are: de-DE (German), fr-FR (French), and pt-BR (Portuguese). Use /l to set the culture for content strings; use /r to set the culture for platform strings. For more information, see String Types. |
The format for connection is:
Trebuchet.App.exe /c "[Common]connection name"
The format for User ID and password is:
Trebuchet.App.exe /u User ID/p password
The format for culture is:
Trebuchet.App.exe /l language-culture pair /r language-culture
pair
Logging Authentication Information
Option | Description |
---|---|
/la logfile | This option specifies the path and file name where authentication information should be logged (must also be enabled in Security Settings). |
Command Execution
Option | Description |
---|---|
/n | This option specifies to use a new window (default). |
/g [name] [id] | This is the Goto record: Name = name of Business Object; ID = ID of record. This command takes the system to a particular record, identified by its internal Record ID. This is a special value used to uniquely identify records (Example: 939cd1f313b3b6866ef7d043faa258398c765d444a). Obtain this value by running a One-Step Action that populates or writes to a field or a file, the value in the RecID field. An exception to this is the Incident Business Object. For historical reasons, (although there is a RecID field in Incident) Incident actually uses its IncidentID as a RecID. Other custom objects might also use different fields for the record ID. If using a tool to launch CSM and bring up a record, sometimes the RecID comes from a query or other mechanism. |
/gp [name] [public id] | This is the Goto record by public ID: Name = name of the Business Object; Public ID = Public ID of record. The Public ID of a Business Object is the ID by which it is normally identified by Users. For an Incident, this would be the Incident ID; for a Change, it would be the Change ID (Example: Change 12345). The Public ID does not need to be a number. For example, the Public ID for a Customer is the Customer's full name. |
/gs [name] [Saved Search] | This is the Goto Saved Search: Name = name of the Business
Object; Saved Search = Name of Saved Search. This option launches a named
global search and displays the results. Use the following format for the Saved
Search to launch non-global searches: Scope;Scope-Owner;SavedSearch. The scope
can be any supported scope – Global, Team, Persona (the internal name for
Role), User, etc. The scope-owner must be the internal ID of the owner.
This is a 42-character ID that identifies the Team, the
User, or the Role. For this reason, this functionality is designed to be used
in very specialized circumstances.
|
/s [name] [search text] | This executes a text search: Name = name of the Business
Object; Search text = text to find. This option allows searching for arbitrary
text in the specified type of record. This is the equivalent of typing search
text into the quick search box in the main application.
The Business Object must have Full-Text
Searching enabled, and the text needs to be URL encoded.
|
/NP | This executes a new process. Normally, when launching the
CSM
Desktop Client (with or without any additional command-line arguments) the
system looks to see if it is already running. If it is, a new window of the
existing process is launched. This means the program launches more quickly and
uses less system resources. If the application is already running, arguments
related to connection, User ID, and password are ignored. By using /NP, the
application does not try to find an existing instance and always launches a new
one.
If the
CSM
Desktop Client is run from two different directories, it always creates a new
instance.
|
The format for Goto record is:
Trebuchet.App.exe /g [name] [id]
The format for Goto record by public ID is:
Trebuchet.App.exe /gp [name] [public id]
The format for Goto Saved Search is:
Trebuchet.App.exe /gs [name] [Saved Search]
The format for search for text is:
Trebuchet.App.exe /s [name] [search text]