Create a connection

A connection represents the relationship between two data sources.

About connections

You use a connection:

  • To identify the data source whose assets you plan to synchronize.
  • To specify the asset types, fields, and relationships you want to synchronize.
  • To specify the projects you want to synchronize.

You perform these tasks using the Connection Wizard.

Micro Focus Connect creates an item when it encounters an item from either data source that it hasn't seen before (based on ID). An item will be created only if the default mapping for the type is either bi-directional or in the direction of the item to be created. An item will not be created if the data source for the side where the item is to be created has the Allow Create property for the type being created set to FALSE.

When Micro Focus Connect creates items, it uses all of the field mappings regardless of direction of the mapping to populate the newly created item.

Connection considerations

  • The data sources you want to use for a connection must exist before you can complete a connection. See Create a data source for more information.
  • You can delete a connection only if there are no project maps or type maps defined for the connection or if you have not run a successful synchronization.
  • Micro Focus Connect provides a helper tool that allows you to force-delete specific connections. For details see the mfcDeleteConnection script at Batch Utility Scripts.

Back to top

Define a connection

This section describes how to define a connection.

To define a connection:

  1. From the Connections tab on the dashboard, click the + Connection button. The Create Connection Wizard opens.

    Use the Data Source, Types and Fields, and Projects and Rules tabs to define a connection. Click the Next and Previous buttons to navigate between the tabs.

  2. Set fields in the Data Source tab:

    Field Description
    Connection Name Enter a name by which to identify the connection.
    Master Data Source

    Select a data source to use as the master data source.

    You must select a Micro Focus product as the master data source.

    The "master" designation is used as a last resort solution for resolving data conflict. For more details, see Conflict resolution.

    Target Data Source Select a Data Source to use as the target Data Source.
    Error Notification Optionally, use the fields in the Error Notification group to override global error notification email settings specified in Settings

Back to top

Conflict resolution

Micro Focus Connect uses several levels of information in the products to detect changes, and to determine which side made a change most recently. In the rare case where this information is insufficient to determine which side's changes should be applied, Micro Focus Connect resorts to the master data source. Most products provide sufficient details, making the designation almost redundant.

For data sources that do not merge content, the master designation determines which connector changes are applied when changes are detected in both data sources.

Back to top

Next steps: