Accessing a map version
You can access and download previous versions of maps (and their associated map assets) from the CTE and production environments.
Before you begin
From the side navigation menu, select .
Then, after you select a map, you can access versions of a map that are older than the currently deployed map. You can also download any previous version of a map (including the minor map versions available in the CTE environment) and the associated map assets for each map version. You can view the previously submitted comments about changes that were made to a map so that you can understand the history of the map.
Each map version includes a label that indicates the status of the map.
- Live in production
- It indicates that the map version is deployed in the production environment.
- Went to production
- It indicates that the map version was previously promoted to production, but it is not the current version that is live in production.
- Currently in CTE
- It indicates that the map version is now deployed in the CTE environment.
A minor (point) version of a map is created in the CTE environment when you upload a revised version of the map after the map is successfully deployed to CTE. In this scenario, map version 4.2 is created when you upload a revised map after the map version 4.1 was already deployed to CTE. A major version of a map is created in the CTE environment when you check out a map. In this scenario, a new map version is created (5.1). Therefore, the map version changes from 4.2 to 5.1 when the map is checked out. The map version number in the production environment matches the version number of that same map in the CTE environment.
The Map versions card includes the following information:
- Deployed to CTE
- The date and time that the map was deployed to CTE. Not displayed if the map was not deployed to CTE.
- Deployed to production
- The date and time that the map was deployed to production. Displayed only on the Production tab. Not displayed if the map was not deployed to production.
- Modified by
- The user who was responsible for the last modification that was made to the map version.
- Checked out by
- The user who owns the map check-out. Not displayed if the map is not currently checked out or if the current map version is not selected.
- Prod Config Center
- The production Config Center version number of the map or -- if there is no version number. Displayed only for IBM Support.
- CTE Config Center
- The CTE Config Center version number of the map or -- if there is no version number. Displayed only for IBM Support.
- Change description
- The description of changes that were made to the map when it was uploaded.
- Map assets
-
Any map assets that are associated with a map version are available for you to download.Tip: If no Map assets are displayed for a map version that indicates that the map version was checked out but not uploaded to CTE.
- MRS document
- The Map Requirements Specification (MRS) document provides details about an MXL map, including
its functions and its dependencies (for example, the code lists on which the map is dependent). This
asset is available for every version of the MXL map.Important: By default, the MRS document includes field definitions but does not include inactive fields.
- Source map
- The original or updated map that was created or modified. This asset is available to be downloaded for a particular version after a source map is uploaded.
- Compiled map
- When the source map is compiled it results in a compiled map, which is used by the translator to transform data. This asset is available to be downloaded for a particular version after a compiled map is uploaded.
- Input file
- The data that is transformed by the compiled map. This asset is available to be downloaded for a particular version after an input file is uploaded.
- Transformation test output file
- The output file that contains the data that is transformed by the compiled map. This asset is available to be downloaded for a particular version after the transformation test is run as part of the deployment to CTE.
- Transformation test report file
- The report file that contains the errors and warnings that occur when the data is transformed by the compiled map. This asset is available to be downloaded for a particular version after the transformation test is run as part of the deployment to CTE, if errors or warnings occurred during the test. This asset is also available to be downloaded after you run the map test tool, if errors or warning occurred during the test.
- Quality review report
- A summary of the validation that was done on the map. This asset is available to be downloaded for a particular CTE map version after the transformation test is run as part of the deployment to CTE. The quality review report is downloaded as a comma-separated values (CSV) file named <MapName>_QualityReview_<MapVersion>.csv.
- Process data values input template
- A template that is generated for the process data for the selected map version. The template is downloaded as a text file named <MapName>_ProcessDataTemplate_<MapVersion>.txt, and contains name-value pairs in which the values are blank. You can edit the process data values input template (external to Configuration Hub) to create a process data values input file that is used when the transformation test runs. This asset is available to be downloaded for every map that uses process data.
- Process data values input file
- The process data values input file for the selected map version. The process data values input file is created when you edit the process data values input template (external to Configuration Hub) to create a file that is used when the transformation test runs. The process data values input file is downloaded as a text file with the naming convention <MapName>_ProcessData_<MapVersion>.txt. You can edit the process data values input file (external to Configuration Hub) to update it. The process data values input file is used when the transformation test runs. This asset is available to be downloaded for every map that uses process data for which a process data values input file was uploaded.
- Process data output file
- The process data output file for a selected version. The process data output file is created when the transformation test or map test tool is run for a map.
- Production readiness review
- The status of the map production readiness review (Pending, Rejected, or Approved) and the date and time the review was completed (for Rejected and Approved statuses only; not displayed for Pending status). Not displayed if the map was not submitted for a production readiness review.
- Production deployment request
- The date and time that the map production deployment request was submitted. Not displayed if a production deployment request was not submitted for the map.