Show custom Service Manager fields in Release Control Analysis

Search for	Example	Results
A single word	`cat`	Topics that contain the word "cat". You will also find its grammatical variations, such as "cats".
A phrase. You can specify that the search results contain a specific phrase.	`"cat food"` (quotation marks)	Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase.

Search for	Operator	Example
Two or more words in the same topic	`AND` `and` `+` (plus symbol) `&` (ampersand)	`cat AND dog` `"cat food"+milk` `"cat food"&"dog food"`
Either word in a topic	`OR` `or` `\|` (pipe)	`cat OR dog` `cat \| dog`
Topics that do not contain a specific word or phrase	`NOT` `not` `!` (exclamation point)	`NOT cat` `! dog`
Topics that contain one string and do not contain another	`^` (caret)	`cat ^ mouse`
A combination of search types	`( )` parentheses	`cat + (dog \| mouse)` `cat \| dog + (! mouse)`

Applies to User Roles:

System Administrator

The RC integration uses the ChangeRC record for Change and the ChangeTaskRC record for Task to expose Service Manager fields to RC. If you want to create custom exposed fields in the Web Service, you need to perform the following tasks in Service Manager and RC, respectively. The following example shows how to show custom Service Manager Change fields in RC analysis.

Task 1: Set which fields to expose to RC in Service Manager

Log on to Service Manager as the System Administrator.

Go to Tailoring > Web Services > WSDL configuration.

In the Object Name field, type ChangeRC, and click Search.

The ChangeRC extaccess record opens.

Select the Fields tab to view exposed fields or add one or more new fields. For details about how to create custom exposed fields in Service Manager Web Services, see Service Manager Web Services.

Click Save.

Task 2: Configure RC to show the new custom field values

Note

The already exposed field of Location (middle,location) is used in this example.
When the WSDL configuration in Service Manager is changed, the RC adapter has to be re-generated by running the SdiConfigurer.bat utility. Refer to Configure the RC adapter for more information.

Log on to RC as a System Administrator.

Go to Module > Administrator > Configuration > Integrations > Fields.

Open the Miscellaneous section of the fields, and select the site-location field.

On the Field Definition tab, change the Category to Analysis Data.

On the Details Layout tab, select the Show in Details tab checkbox.

Click the Save button and select a new name for the saved version, such as new field site location.

Go to Module > Administrator > Configuration > Integrations > Service Desk Adapters, and choose your Service Manager adapter (for example, sm-adapter).

Select convertChange.js from the adapter's drop-down list. Content of this Java script file is displayed in the right pane..

Edit the file by adding a line for the Location field as follows:

function convert(sm_rfc, generic_rfc) {
     generic_rfc.setField("request-id", sm_rfc.get("header.changeNumber"));   
     generic_rfc.setField("company", sm_rfc.get("header.company"));
     generic_rfc.setField("creation-time",

convertDate(sm_rfc.get("header.origDateEntered")));
     generic_rfc.setField("last-update-time",

convertDate(sm_rfc.get("sysmodtime")));
     generic_rfc.setField("contact-person",

sm_rfc.get("header.coordinator"));
     generic_rfc.setField("initiated-by",

sm_rfc.get("header.requestedBy"));
     generic_rfc.setField("opened-by",

sm_rfc.get("header.openedBy")); 
     generic_rfc.setField("implementors",

sm_rfc.get("header.coordinator"));
     generic_rfc.setField("contact-phone",

sm_rfc.get("header.coordinatorPhone"));
     generic_rfc.setField("category", sm_rfc.get("header.category"));
     generic_rfc.setField("subcategory",sm_rfc.get("header.subcategory"));
     generic_rfc.setField("emergency",sm_rfc.get("emergency"));
     generic_rfc.setField("site-location", sm_rfc.get("middle.location"));
// Requested End Date
    setDateField(sm_rfc.get("requestedDate"), "requested-end-date", generic_rfc);
// Change Priority
var sm_rfc_priority = sm_rfc.get("header.priority");
var rc_priority = "Unknown priority";
if (sm_rfc_priority == 1)
    rc_priority = PRIORITY_IMMEDIATE;
else if (sm_rfc_priority == 2)
    rc_priority = PRIORITY_HIGH;
else if (sm_rfc_priority == 3)  
    rc_priority = PRIORITY_NORMAL;
else if (sm_rfc_priority == 4)
    rc_priority = PRIORITY_LOW;
[. . .]

Add a line to the file for each field you entered in the ChangeRC extaccess record, as shown above.

Note Remember to use the dbdict-based field name rather than the WSDL Caption for the sm_rfc, as shown above. The generic_rfc uses the field name as defined in Integrations > Fields.

Click the Save button to save the modified JavaScript record, and if prompted, enter a new name.

Click the Activate button.

Log out and then log back in.

Re-update the change records for the change to take effect.

Click a change, and then click Details in the lower portion of the screen.

The Site Location field displays in Analysis > Changes.

Related topics