How to Populate UCMDB with Data from BMC Remedyforce

1. Prerequisite - Set up protocol credentials

   Make sure that you have set up the Salesforce Rest Protocol. For credential information, see Supported Protocols.

2. 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:

   1. 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.

   2. Right-click this file and select Save As.

   3. Enter a name that you want and click OK.

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

3. Create the Integration Point.

   Define the integration point as follows:

   1. In UCMDB, go to Data Flow Management > Integration Studio.

   2. Click the New Integration Point button.

   3. In the New Integration Point dialog box, enter a name and description for the integration point.

   4. In the Adapter field, click the Select Adapter button.

   5. In the Select Adapter list, select Remedyforce Pull Integration and click OK.

   6. 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.

   7. Click OK to save the integration point. At this point, a default integration job definition is automatically created.

4. Define a synchronization schedule for the integration job, if desired.

   Jobs can also be run manually, without a schedule.

5. Run full data synchronization.

   Click to synchronize all data.