Finding and downloading maps

You can use the search and sort functions on the Mappings page to find your maps that are currently used in IBM Sterling B2B Integration SaaS. You can also filter the display to view which maps are locked or checked out, and which user currently holds a lock or check-out on maps.

The search is not case-sensitive and you can enter any part of the map name. After you find a map, you can download it, and check it out to edit it in the map editor. The available actions that you can take on a map depend on the status of the map. Company administrators (admins) can do some override actions, such as overriding a check-out or lock.

You can sort the list of maps on the Mappings page in ascending or descending order by clicking any column heading.

The Checked out tab displays all maps that are currently checked out. The Locked tab displays all maps that are currently locked. Click Filter on the Checked out or Locked tab to further filter the maps held by users or business alias.

You can download the most recent map, regardless of the status of the map.

From the Mappings page, click the Download icon for the map that you want to download. The Download map modal is displayed.
Be sure that the Source map checkbox is selected.
If you want to download the MRS document that is associated with this map, select the MRS document checkbox.
Click Download. The source map (and the MRS document, if selected) is downloaded to your default folder.

The Mappings page includes the following information:

All: Displays a list of all of your company's maps.
Available: Displays a list of all of your company's maps that are not locked or checked out.
Checked out: Displays a list of all of your company's maps that are checked out.
Locked: Displays a list of all of your company's maps that are locked.
Status: The status of a map. Possible map statuses are Work in progress and Final. The status Conflict might occur when an update to the map is made outside of Configuration Hub.
Name: The name of the map.
Provider type: Displays the schema provider for the map. For example, SI, XSLT, Schematron, or XSD.
Held by: The user who holds a lock or check-out on the map.
Date last modified: The date on which the map was last updated.
Production version: The version number of the map that is live in production.
CTE version: The version number of the map that is deployed in CTE.
Download: Download the map that is live in production.

When you select a map from the Mappings page, the general details for that map are displayed.

Live in production: The version of the map that is deployed in production. Not displayed if the map is not deployed to production.
Checked out by: The user that currently owns the check-out on the map. Not displayed if the map is not checked out.
Reason for check out: The reason provided when the map was checked out or the check-out was transferred. Not displayed if the map is not checked out or if a reason was not provided.
Locked by: The user that currently owns the lock on the map. Not displayed if the map is not locked.
Reason for lock: The reason provided when the map was locked. Not displayed if the map is not locked or if a reason was not provided.
Status: The status of the map. Possible map statuses are Work in progress and Final. The status Conflict might occur when an update to the map is made outside of Configuration Hub.
CTE business alias: The CTE business alias that is associated with the map.
Production business alias: The production business alias that is associated with the map.
Map description: The description of the map. A company administrator (admin) can update the map description if the map is not checked out. Not displayed if a map description does not exist.

Map statuses

The status of each map is displayed on the Mappings page and the Map details page for that map. Possible map statuses include Final and Work in progress. The status Conflict might occur when an update to the map is made outside of Configuration Hub.

Final: Indicates that a map is ready to be checked out if a user wants to change it. It can also be locked or downloaded as read-only.
Work in progress: Indicates that a map is being modified by the user who checked it out.
Conflict: This status might occur when an update to a map is made outside of Configuration Hub. You cannot do any action on a map in this status. If a map is in Conflict status, IBM Support follows a synchronization process to fix the conflict.