How to Populate UCMDB with Data from BMC Remedyforce

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)`

Create XML Mapping Files.

The XML mapping file describes the topology that should be pulled from the BMC Remedyforce instance and how it should be mapped to the UCMDB class model.

To create your own mapping file, do the following:

Go to Data Flow Management > Adapter Management > Resources > Packages > Remedyforce_Pull > Configuration Files > RemedyforcePull/sample_mapping.xml.

The sample_mapping.xml file is a sample mapping file for your reference, and all mappings are commented out by default.
Right-click this file and select Save As.
Enter a name that you want and click OK.

Customize your own mapping file. The main mapping file elements are described below:

Element	Attribute
<source_ci_type>	name: The CMDB class name of BMC Remedyforce, such as BMC_ComputerSystem. needContainer: When set to true, the CI cannot exist without a root container. This is required by the reconciliation rule of UCMDB, for example, a running software must have a node as its root container.
<target_ci_type>	name: The CI type in UCMDB, such as node.
<target_attribute>	name: The attribute of the CI type in UCMDB.
<map>	type: The type of the attribute mapping, including direct and constant. direct. This type enables taking the attribute value of a BMC Remedyforce CI and setting it to a UCMDB CI attribute unchanged. constant. This type enables setting a constant value on a UCMDB attribute.
<map>	source_attribute: The field name of BMC Remedyforce CMDB class, such as BMCServiceDesk__Description__c.
<link>	source_link_type: The name of relationship in BMC Remedyforce.
<link>	target_link_type: The name of relationship in UCMDB.
<link>	source_ci_type_end1 and source_ci_type_end2: The class names of BMC Remedyforce.
<link>	target_ci_type_end1 and target_ci_type_end2: The CI types in UCMDB.

Create the Integration Point.

Define the integration point as follows:

In UCMDB, go to Data Flow Management > Integration Studio.
Click the New Integration Point button.
In the New Integration Point dialog box, enter a name and description for the integration point.
In the Adapter field, click the Select Adapter button.
In the Select Adapter list, select Remedyforce Pull Integration and click OK.

In the Adapter Properties section, enter the following required properties:

Field	Value
Credentials ID	Select the credential entries you created in step 1 for the Salesforce Rest Protocol.
Mapping File	The name of the XML mapping file you created in step 2. Leave blank if you want all the mapping files in this folder to be processed.
Remote JVM Arguments	The JVM parameters that should be passed to the remote process when the integration is running in a separate process.
Run in Separate Process	Indicated whether to run in a separate process. Default: False.
Data Flow Probe	Select the name of the Data Flow Probe on which the integration will run.
Trigger CI Instance	Select the DataFlowProbe CI, which refers to the same Probe as Data Flow Probe property above.