Adding Types to a Connection

A type is a system asset such as a task, topic, change request, or story. When creating a connection, you must add at least one type to synchronize between your source and target. For example, you may want to map a CA Agile Central Hierarchical Requirement to a Story.

Important: The types that are available to add to a connection are limited to the types that you added to your data source. If the type that you want is not listed, return to the Data Sources tab and add the type to the data source. See Creating a Data Source for more information.

Note: Types cannot be deleted.

To add types to a connection:

  1. If you are in the process of creating a connection, navigate to the Types and Fields tab.
    If you are editing an existing connection, on the dashboard, click Options button () and choose Edit from the menu. Navigate to the Types and Fields tab.
  2. Select a direction for data synchronization from the Default Sync Direction list. All synchronizations will be performed in this direction unless you choose to override it. Values for synchronization direction are:
  3. From Master Data is only synchronized from the Master to the Target.
    To Master
    Data is only synchronized to Master from the Target.
    Data is synchronized both to and from the Master and Target. (This is the default.)

  4. Click Auto Type Mapping to have the connection's types and fields automatically mapped, or click Add Type Mapping and perform the remaining steps to manually map types.
    If auto type mapping, all types defined by the selected data sources will be mapped. Fields are auto mapped for each type that is exposed by the data source.
  5. Click the Add Type Mapping button.
    The Add Type Mapping dialog box appears.
  6. The Target Type list contains all the types that you added to your Target data source. Select a type from the list.

    Tip: Micro Focus Connect uses the data source product name for the <system name> displayed in the UI.

  7. The Master Type list contains all the types available in the Master data source. Select the type you want to map.
  8. Click Add Field Mapping. You use the controls that appear to choose the fields for the type you are synchronizing that you want to map.
    1. Select a field to map.
    2. Select the synchronization direction in the Direction list for each field.
    3. The Conversion list allows you to choose if your HTML-based fields should be converted to plain text or vice-versa.

      Note: This is for when you want to override the default behavior. Only use this feature if directed to by the Micro Focus Connect team.

    4. Select the Master field to map to your field.
    5. If you have created user maps and you are currently mapping a user-based field, click the Apply user map option.

      In the connection wizard's Edit Type Mapping dialog box, click the Fields tab and use the Conversion option to:

      Master is HTML When the master side of a field mapping contains html formatted content and you want or can have only string content in the target, this setting enforces conversion of the content between Master and Target.
      Target is HTML When the target side of a field mapping contains html formatted content and you want or can have only string content in the master, this setting enforces conversion of the content between Target and Master.
      Apply user map If neither side of the mapping is a user property, you can apply the user map by selecting this option,
      No Conversion The field data is not altered when synchronizing.

    Tip: If the fields you are synchronizing use different values, you will want to create a value map. See Adding Value Maps to Types for more information.

  9. Click the OK button to save your mappings and close the Add Type Mapping dialog box, or click the Relationships tab to specify the relationships you want to synchronize as described in Adding Relationships to Types.