This topic is relevant if you are interested in synchronizing user fields with Micro Focus Connect.
The Micro Focus Connect batch utilities offer an alternative and potentially more powerful way to create and maintain user maps. To learn more about our supported command line utilities, see Batch Utility Scripts.
About User matching and User maps
User matching involves finding a user representation across two products such that a user in one system is the same user as one from the other system.
Within Micro Focus Connect, users can be represented in a product using different methods:
If you use the same user representation in both products, you do not need to use User maps.
When the user representation is inconsistent, you must define User maps. User maps describe how a user is identified in all your data sources.
Define User maps:
In the UI
Import an xml file
Use batch utilities to automate User map creation and updates
User maps define users that have different user names across multiple Data sources. User maps allow you to map these two users together so that Micro Focus Connect knows they are the same user.
Each User map defines one user's identity across your different data sources.
To define a User map:
- On the top banner, select the User Maps tab.
- Click Add User Map. A User Map entry is added to the grid. In this User Map, you will specify a single user's various identities across the different Data Sources.
Double-click the User Map placeholder text, and rename the User Map.
The User map name is used internally only.
- Add rows to the User map.
- On each row, select a Data Source, and enter the user's name as it's defined in the Data source.
- Repeat the above steps to create Data maps for all the users in your Data sources.
- Click Save.
Import User maps
You can import User maps via a structured xml file.
To create a template of the xml file, it is recommended to first define a User map in the UI and export it.
To import User maps:
- Create one or two User maps in the UI. For details, see Define User maps in the UI.
Export the User maps:
- In the top banner, click the gear button, and select Export.
- In the Export Connect Data dialog box, select the Users tab.
- Select the User Maps you want to export, and click Export.
Open the exported file.
A User map record follows this form:
<UserMap> <name>User Map2</name> <User> <type>DataSource</type> <value>Jira DataSource</value> <name>Example Jira TeamDev</name> </User> <User> <type>DataSource</type> <value>Octane DataSource</value> <name>example.octteamdev@localhost</name> </User> </UserMap>
Repeat the above structure in the xml file to define a User map for each user.
The User Map name. An internal label identifying the user for whom you are creating the User Map. The name should be unique.
The user's name as found in the Data Source
You are allowed to specify multiple names for the same user within the same Data Source.
Caution: Do not change any of the data outside of the <UserMaps> block. This information is necessary to allow Micro Focus Connect to re-import the file.
- After completing all the User maps, save the file with an .xml extension.
Import the xml file:
- In the top banner, click the gear button, and select Import.
- Select your modified xml file.
- If the xml file contains records that are already defined in the UI, select Overwrite existing elements.
- Click Import.
Enable User maps
After you create User maps, you need to associate them with user fields inside your Connections.
To enable User maps:
- Select the Connections tab.
- Click the gear alongside a Connection and select Edit.
- In the Update Connection dialog box, click Next to navigate to the Types and Fields tab.
- Select a type and click (Edit).
- For each user field in the list, select the Enable User Map column.