Customize the bso.xml File

Installing and Configuring the Connector for CA Unicenter® Service Desk and CA Software Change Manager for Distributed with Harvest › Customize the bso.xml File

Customize the bso.xml File

The bso.xml file is the connector's configuration file. To customize this file for your environment, follow these steps on both the Harvest and Service Desk servers.

To customize the bso.xml file for your environment

Using a text editor, open the bso.xml file.
- On Windows, this file is typically located in the %SD_CL_CNCTR_HOME%\config folder.
- On UNIX, this file is typically located in the $SD_CL_CNCTR_HOME/bin directory.
Under the sti:general element, provide values for the following elements:
Note: If the path name contains a space, use ~ symbols. For example, if the path is C:\Program Files\CA\CMI, specify the path as follows:
```
“C:\PROGRA~1\CA\CMI”
```
sti:keyfile
Specify the complete path of the connector's key file.

Windows Example:
```
<sti:keyfile>
C:\PROGRA~1\CA\CMI\key\allfusion.key
</sti:keyfile>
```
UNIX Example:
```
<sti:keyfile>
/home/CMI/key/allfusion.key
</sti:keyfile>
```
sti:idmanagerpgm
Specify the complete path of the hidmgr.

On Windows, this file is typically located in the %SD_CL_CNCTR_HOME%\bin folder.

On UNIX, this file is typically located in the $SD_CL_CNCTR_HOME/bin directory.

Windows Example:
```
<sti:idmanagerpgm>
c:\PROGRA~1\CA\CMI\bin\hidmgr.exe
</sti:idmanagerpgm>
```
UNIX Example:
```
<sti:idmanagerpgm>
/home/CMI/bin/hidmgr
</sti:idmanagerpgm>
```
- sti:timezone—specify the time zone of the Service Desk server, relative to GMT.
  Example:
  
  If the time zone is GMT+5:30, specify the following:
```
<sti:timezone>GMT+5:30</sti:timezone>
```
sti:dateformat

Specify the date format; the default value is dd/MM/yyyy HH:mm:ss aaa.

The following table contains examples of other date and time formats:

Date and Time Pattern	Example
“yyyy.MM.dd G ‘at’ HH:mm:ss z”	2001.07.04 AD at 12:08:56 PDT
“EEE, MM dd, ‘ ’ yy”	Wed, Jul 4, ‘01
“h:mm a”	12:08 PM
“hh ‘o’ ‘clock’ a, zzzz”	12 o’clock PM, Pacific Daylight Time
“K:mm a, z”	0:08 PM, PDT
“yyyyy.MMMMM.dd GGG hh:mm aaa”	02001.July.04 AD 12:08 PM
“EEE, d MMM yyyy HH:mm:s Z”	Wed, 4 Jul 2001 1208:56 -0700
“yyMMddHHmmssZ”	010704120856-0700

Example:

<sti:dateformat>dd/MM/yyyy HH:mm:ss aaa</sti:dateformat>

Under the harvest element, provide values for the following elements:
sti:product
Specify the product name. The default is HARVEST. Specify the same product name used in the connector's key file for the Harvest broker.

Example:
```
<sti:product>HARVEST</sti:product>
```
sti:state
Specify the initial lifecycle state of the Harvest project.

Example:
```
<sti:state>Plan</sti:state>
```
sti:process
Specify the process name (harvest).

Example:
```
<sti:process>Create RFC</sti:process>
```
sti:user
Specify the harvest user name.

Example:
```
<sti:user>harvest</sti:user>
```
Under the uspsd element, provide values for the following elements:
- sti:product—Specify the product name; the default is USPSD. Specify the same product name used in the connector's key file for Service Desk.
  Example:
```
<sti:product>USPSD</sti:product>
```
- sti:server—specify the Service Desk server name and port in the following format: http://server-name:port-number. Specify the same server name used in the connector's key file for Service Desk, including the URL format.
  Example:
```
<sti:server>  http://localhost:8080 </sti:server>
```
- sti:wsdl—specify the URL for the web service description language (wsdl), one of the services used by Service Desk.
  Example:
```
<sti:wsdl> http://localhost:8080/axis/services/USD_R11_WebService?wsdl
</sti:wsdl>
```
- sti:osuser—specify the Service Desk user name. Specify the same user name used in the connector's key file for Service Desk.
  Example:
```
<sti:osuser>ServiceDesk</sti:osuser>
```
- sti:chgobj—specify chg as the chgobj.
  Example:
```
<sti:chgobj>chg</sti:chgobj>
```
- sti:cntobj—specify cnt as the cntobj.
  Example:
```
<sti:cntobj>cnt</sti:cntobj>
```
- sti:workflowobj—specify wf as the workflowobj.
  Example:
```
<sti:workflowobj>wf</sti:workflowobj>
```
- sti:chgstatusobj—specify chgstat as the chgstatusobj.
  Example:
```
<sti:chgstatusobj>chgstat</sti:chgstatusobj>
```
- sti:taskstatusobj—specify tskstat as the taskstatusobj.
  Example:
```
<sti:taskstatusobj>tskstat</sti:taskstatusobj>
```
Under the workflow element, provide values for following elements:
- sti:createpackage—specify Y (Yes, create package) to create the package, or N (No, do not create package) to not create the package.
  Example:
```
<sti:createpackage>Y</sti:createpackage>
```
- sti:createform—specify Y (Yes, create form) to create the form, or N (No, do not create form) to not create the form.
  Example:
```
<sti:createform>Y</sti:createform>
```
- sti:packageprefix—specify the package prefix.
  Example:
```
<sti:packageprefix>pck</sti:packageprefix>
```
- sti:packagesuffix—specify the package suffix.
  Example:
```
<sti:packagesuffix>pck</sti:packagesuffix>
```
If you want to change table name/column names in the form sql script file (SD_CL_CONNECTOR_INGRES.sql, SD_CL_CONNECTOR_ORACLE.sql, SD_CL_CONNECTOR_SQLSERVER.sql), then change the HARVESTFORM element in the bso.xml file.
If you customize the Harvest project, modify the following elements in the bso.xml file:
- Specify the initial lifecycle state (of the Harvest project) in the state element under the harvest element.
- Specify the process name (harvest) in the process element under the harvest element.
Example:
```
<sti:harvest>
	<sti:product>HARVEST</sti:product>
	<sti:state>Plan</sti:state>
	<sti:process>Create RFC</sti:process>
	<sti:user>harvest</sti:user>
</sti:harvest>
```