This documentation supports the 9.1 to 9.1 Service Pack 3 version and its patches of BMC Atrium Core. The documentation for version 9.1.04 and its patches is available here.

To view the latest version, select the version from the Product version menu.

Configuring Atrium Integrator for data import

Using Atrium Integrator to import data into BMC Atrium Configuration Management Database (BMC Atrium CMDB) from a third-party source consists of the following tasks:

  1. Configure source and target connection.
  2. Create a job or transformation.
  3. Edit your transformation or job.
  4. Verify and run your job.

To quickly understand Atrium Integrator jobs and data integration, watch the following video:

For more detailed information about importing data with Atrium Integrator, see Overview of the data transfer process.


To create an integration job, use the Integration Job Builder wizard which automatically populates data and includes templates for typical integrations.


When configuring Atrium Integrator, consider the following recommendations:

  • Transform your data on the way in so that all sources (BMC and third-party) are normalized for commonly used attributes like Domain and those related to memory and disk size. 

    For example, DriveSize for BMC_Media should be specified in GB. For more information about attributes, see BMC Atrium CMDB Data Model Help and Class Manager.
  • Provide data to help reconciliation by ensuring that CI attributes used for identification have unique values and are populated consistently.
  • If you need to customize the data mappings in an integration job, familiarize yourself with the Common Data Model so that you can select the appropriate classes and attributes. You can also verify that data types match for the data mappings and plan unique identifying fields.
  • Consider bringing in data by chunks and designating separate BMC Atrium Integration Engine instances for such activity so that, if you have a large amount of data to import, you can spread the import work across multiple instances.
  • Do not run more than one Atrium Integrator, Normalization Engine, or Reconciliation Engine job at the same time because they might query or update the same data.
  • Map the attributes that the Normalization Engine uses to normalize CIs: NameManufacturerNameModelPatchNumber, and VersionNumber. If you do not map these attributes, then the Normalization Engine cannot normalize the CIs.

Configuring source and target connections

You must define connection parameters (such as host name, port number, user name, and password) to your external data store and BMC Atrium CMDB. After you create a connection, you can reuse it for multiple transformations or jobs.

For instructions about creating datastore connections, see the Working with Atrium Integrator data store connections.

Creating jobs in BMC Atrium Integrator

Use the Integration Builder wizard to create a job or transformation.After you specify the source and the CIs that you want to import, the wizard makes recommendations on the relationships for the selected CIs.

For detailed instructions about creating jobs, see Creating a job in Atrium Integrator.

Editing transformations in BMC Atrium Integrator

You can add intermediate steps for cleaning up or manipulating your data before adding it to BMC Atrium CMDB. Spoon provides support for JavaScript and a wide variety of prebuilt functions.

For detailed instructions about editing transformations, see Editing Atrium Integrator jobs and transformations.

Was this page helpful? Yes No Submitting... Thank you