Use the information provided in this topic to understand how a Request For Change (RFC) is created for an automation job when an external automation system integrates with BMC Remedy Change Management system.
By integrating with BMC Change Automation integration, for every automation job, you can create a corresponding change record in the BMC Remedy Change Management system. For an automation job to run, the change record must be approved by the change manager. For this purpose, a robust, service-oriented interface called CHG_ChangeServiceInterface is available. The interface of the web service that can be accessed using a web service client.
You need to first access the web service and then create an RFC.
About the CHG_ChangeServiceInterface web service
This web service is provided specially for requests from an automation system. Using this interface, an automation system can send job details along with the requested schedule to the change management system to create a change record for the job. The change record created using this interface always has an automatic task associated with it. This task corresponds to the job in the automation system and holds the job details.
A back end form called CHG:ChangeServiceInterface is created for this inbound communication. This is the form that holds the job attributes received from the web service and the information required to create a change record.
The CHG_ChangeServiceInterface web service enables you to perform the following actions:
- Create a RFC with minimal information supplied by the automation system. For example, if you specify only the job summary, a change record gets created with relevant default data.
- Add resilience to the change creation process. For example, if the automation system does not send the scheduled start date, the system calculates the date for the job based on the server timestamp value.
- Update relevant forms that are associated with the change creation process. For example, the web service updates relevant entries in the Change, Task, and Worklog forms.
- Create CI associations if the CI information is included in the change creation request.
The following sections describe the web service fields and operations.
The fields available in this web service hold the job attribute values and the information required to create a change record.
The following table describes only the important fields available on the web service:The [confluence_table-plus] macro is a standalone macro and it cannot be used inline. Click on this message for details.
This macro generates standalone content. As a consequence you need to make sure to use a syntax that separates your macro from the content before and after it so that it's on a line by itself. For example in XWiki Syntax 2.0+ this means having 2 newline characters (a.k.a line breaks) separating your macro from the content before and after it.
The following 10 additional character fields are provided in the web service to:
- Facilitate data mapping
- Include additional data
- Enable customization on the Change form
Character fields to accommodate customization |
|---|
Character01 Character02 Character03 Character04 Character05 Character06 Character07 Character08 Character09 Character10 |
The CHG_ChangeServiceInterface web service contains the following operations:
- Change_ProcessInterfaceData
- Update_SourceInformation
- Log_ErrorInformation
This operation performs the following functions:
Search for customer and change requester details
This function populates the People details for two types of people profiles in change management:
- Requested By
- If user details are received from the automation system, a people search is performed by calling the People Lookup function.
Input values include [Requester Person ID / Requester Login ID / Requester Corporate ID / Requester Internet E-Mail / Requester First Name / Requester Last Name / Requester Middle Name] - If user details are not received from the automation system, the $USER$ value is used to get the people details.
- Requested For
- If user details are received from the automation system, a people search is performed by calling the People Lookup function.
Input values includes [Customer Person ID / Customer Login ID / Customer Corporate ID / Customer Internet E-Mail / Customer First Name / Customer Last Name / Customer Middle Name] - If user details are not received from the automation system, the Customer details are updated to include Requested By details. [Requested By becomes Requested For].
Search for a relevant template and populate the values in the RFC
This function populates the CHG:ChangeServiceInterface form fields.
- If TemplateID and Template Name are received from the automation system, the change management systems searches the CHG:Template form and applies a relevant template to populate the required details for the change record.
- If TemplateID and Template Name are not received from the automation system, a suitable template is applied based on the template selection rules. For more information, see Scenarios-for-applying-change-templates.
Create or update automatic task
When a change record is created, an automatic task is associated with the change record using the Change template that has the associated task template.
If a suitable change template is not applied, the web service associates an automatic integration task to the change record. The task details are mapped to the job details as follows:
Job values such as Job ID, Job Version, Job Instance ID, and Job Type are added to the Job Details tab of the Task form. This tab is visible only if the task type is Automatic and automatic command is either Integration Job or Scheduled Job.
For more information about viewing these details, see Viewing job details of an automatic task.
For information about the automatic commands, see Automatic commandsin the BMC Remedy Change Management 9.1 online documentation.
Perform data transformation and remediate data errors, if any
This function transforms the data in a format that is accepted by the change management system. For example, if the RFC contains date in UTC format, the date is changed to Epoch format.
Scheduled dates (Start and End dates) are derived from the requested start date and requested end dates of the job. For more information, see Data-transformation-and-remediation.
Update the Request For Change depending upon the input data
This function performs data validation if the required job attributes are not provided in the RFC or if the job attributes are in a format that is not acceptable for creating change records. The change record is created after the data is validated and modified in a format that is acceptable. The change record work log is updated with updates. For example, if a RFC is received from the automation system with Impact as High and Class as No Impact, the Class is changed to Normal.
For more information about work log updates, see Viewing-worklog-updates.
Search for relevant data and update values from different forms
This function searches for relevant data and replaces the old data with the new value and updates relevant forms.
Update work log information
When a RFC is created from the automation system, a default worklog entry is added in the CHG:WorkLog form. This worklog contains data errors or validation error messages. Additional Work log entries are added in the WorkInfoNotes field. For more information, see Viewing-worklog-updates.
Perform Bulk CI association
When a record is created or updated, this function associates relevant configuration items (CIs) with the RFC. An automation system can send either the names or reconciliation IDs of the CIs. This data is captured in the CINameList and CIReconIDList fields of the web service depending upon whether the automation system is integrated with CMDB.
Create change record
This function creates a change record even with minimal information available in the RFC. For example, a change record is created if only job summary is provided. In this case, the change record is created with default values for change class, impact, and urgency.
Depending on the values defined in the RFC, relevant template is applied and a change record is created.
Support for multitenancy
This function provides row-level security and multitenancy by using the following fields:
- Customer Company — If customer company details are not received in the RFC, the value of the requester company is copied to Customer Company.
- Location Company — If location company details are not received in the RFC, the value of the customer company is copied to Location Company.
Support creation of change record by an external system
This web service enables an external system to integrate with change management and create a change record. For example, a Service Request Management system can integrate with a change management system to create a change record by using this web service.
This operation updates of the source information when there is a physical change in the automation host. If the host information changes, the change management system must be notified so that the new host is used in all future communications. This operation replaces the old source ID with the new Source ID in the following forms:
- TMS:TaskTemplate
- TMS:Task
- CHG:ChangeOutboundInterface
This operation logs the error messages when an error is received for following input parameters:
- Action
- SourceID
- InfrastructureChangeID
- TaskID
- ChangeWorkInfoNotes
The Task Worklog is updated with error message. You can see the worklog information in the Work Info tab of the Task form.
Accessing the CHG_ChangeServiceInterface web service
You can access the CHG_ChangeServiceInterface web service by using a web service client such as the SoapUI client.
To access the web service
- Open the SoapUI client.
- Enter the web service URL in the following format to connect to the web service.
http://<midtier_server>:<port>/arsys/WSDL/public/<ARservername>/CHG_ChangeServiceInterface
For example,
http://myMidtierServer:8080/arsys/WSDL/public/myARServer/CHG_ChangeServiceInterface
The contents of the web service are displayed.
Creating a Request For Change
You can create a change record by sending only the job summary as the input in the web service.
To create a Request For Change
- Access the web service.
- In the Summary field, enter the job summary.
- Click Submit.
A change record with default values is created. The following default values are added to the change record:
| |
|---|
| |
| |
| |
| Calculated based on Impact and Urgency values. |
Service-oriented-interface
Receiving-change-record-updates