Integrate > Micro Focus Release Control (RC) > Release Control integration setup > Show custom Service Manager fields in Release Control Analysis

Show custom Service Manager fields in Release Control Analysis

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

  1. Log on to Service Manager as the System Administrator.
  2. Go to Tailoring > Web Services > WSDL configuration.
  3. In the Object Name field, type ChangeRC, and click Search.

    The ChangeRC extaccess record opens.

  4. 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.
  5. 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.

  1. Log on to RC as a System Administrator.
  2. Go to Module > Administrator > Configuration > Integrations > Fields.
  3. Open the Miscellaneous section of the fields, and select the site-location field.
  4. On the Field Definition tab, change the Category to Analysis Data.
  5. On the Details Layout tab, select the Show in Details tab checkbox.
  6. Click the Save button and select a new name for the saved version, such as new field site location.
  7. Go to Module > Administrator > Configuration > Integrations > Service Desk Adapters, and choose your Service Manager adapter (for example, sm-adapter).
  8. Select convertChange.js from the adapter's drop-down list. Content of this Java script file is displayed in the right pane..
  9. 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;
    [. . .]
                    
  10. 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.

  11. Click the Save button to save the modified JavaScript record, and if prompted, enter a new name.
  12. Click the Activate button.
  13. Log out and then log back in.
  14. Re-update the change records for the change to take effect.
  15. Click a change, and then click Details in the lower portion of the screen.

    The Site Location field displays in Analysis > Changes.

Related topics

Micro Focus Release Control (RC)
Release Control integration setup
Web Services

Configure the RC adapter
Add a Release Control integration
Enable LW-SSO for the Release Control integration
Configure language and time zone for the RC integration
Verify the RC integration setup