Map process flow overview

The map process flow describes the interactions between the user, IBM® Services, processes, and the environments to which their actions apply.

A source map (map) specifies how data in one format is transformed into data in another format. Source maps must use the .mxl file extension. Additionally, maps with user exits are not supported. A compiled map provides instructions for the transformation of the data that is specified in the source map.

The following list describes each step of the map process flow.

Prerequisite: Before a user can work with maps and assets, the user must fulfill these requirements:
  1. User: Create a map. For more information, see Creating maps.
  2. User: To edit an existing map, from Configuration Hub, check out the map.
  3. User: In a local environment, edit, compile, and run transformation tests on maps by using the map editor tool. Repeat these steps as necessary until you are satisfied with the map updates.
    Note: The process data values input file, if applicable, is not used when you run the transformation test by using the map editor tool.
  4. User: From Configuration Hub, if the map uses process data download the process data values input template.
  5. User: If the map uses process data, edit the process data values input template to create and upload a process data values input file that is used when the transformation test runs. When you edit the process data values input template, you add the values to the appropriate process data elements.
  6. User: In Configuration Hub, upload the revised map (source and compiled version) and an input file to the map repository.
  7. User: In Configuration Hub, to deploy to the Customer Test Environment (CTE), select Deploy to CTE.
  8. System: Process deploys the map into CTE. Configuration Hub displays a success message after deployment and the user can proceed with document flow testing in CTE.
  9. User: Deploy the map to production.
    1. In Configuration Hub, in the Deploy to production card, add deployment information in Production deployment comments.
      Important: The Production deployment comments for a map must include a successful Process ID from InFlight, in which the map was used in a successful end-to-end test in the Customer Test Environment (CTE).
    2. Click Deploy to production. Wait for the deployment process to complete and ensure that the deployment status is successful.
  10. System: Process deploys the map into production Configuration Hub displays a success message after deployment. The map becomes read-only in Configuration Hub.