Downloading and setting up the map editor

The map editor and standards library are available for use in the Windows™ operating system. You download the map editor and standards library from the Configuration Hub user interface and then configure the map editor to communicate with Configuration Hub.

Before you begin

Make sure that the following prerequisites are installed on the computer to be used for the map editor before you download the map editor and standards library.

  • For map editor to run properly on your Windows operating system, make sure that your system meets the Java™ requirements. To use the remote map test function in the map editor, a 32-bit Java Runtime Environment (JRE) from IBM® is necessary on both the 32-bit and 64-bit operating systems. For more information, see Map Editor Java requirements.

  • The Microsoft™ XML Core Services (MSXML) 6.0 libraries are necessary for the IBM Sterling B2B Integrator Map Editor to function properly with maps in the .mxl format. The libraries are included with Microsoft Windows 10 and later.

About this task

The following versions are installed in this task for map editor and standards library package version 3.0.2:
  • IBM Sterling B2B Integrator Map Editor version 8.0.3.0, with copyright date 2000, 2018. This version and date combination includes Standards Processing Engine (SPE) functions.
  • IBM Sterling Standards Database for EDI version 8.0.
Note: If you previously downloaded and installed map editor and standards library package for version 2.0.0, uninstall IBM Sterling B2B Map Editor from your device. For more information on uninstalling, see the Windows operating system documentation.

Procedure

  1. Download the map editor and standards X12Plus.mdb and EDIFACT.mdb files from the Configuration Hub user interface.
    1. From the User menu, select Map editor and standards > Download.
    2. Review the License agreement and click Agree.
    3. Click Start download to initiate the download of the map editor and standards package.
  2. Install the map editor and its dependencies.

    The downloaded file contains installers for map editor and standards library. For reference, it also contains the license in text format.

    1. Extract the downloaded MapToolPackage_3.0.2.zip file to a working directory.
    2. Install the map editor. Start the SPEMapEditorInstall.exe installer and follow the prompts. During the installation, change the destination Path folder name to SPE Map Editor when prompted.
      Image showing the Choose Folder dialog box
      As a result, the new destination resembles the following path: %PROGRAMFILES(X86)%\Sterling Commerce\SPE Map Editor.
      Image showing the new path result for Destination Folder
      After the installation is complete, make sure that you can start the map editor.
    3. Create an ODBC database source name (DSN) by referring to the following substeps:
      1. Click Start > Control Panel.
      2. From the Administrative Tools dialog box, double-click ODBC Data Sources (32-bit). Make sure that the file is located in the following folder location: C:\Windows\SysWOW64\odbcad32.exe
      3. Click User DSN.
      4. Click Add.
      5. From the list of drivers, select Microsoft Access Driver (*.mdb).
      6. Input EDIFACT in the Data Sources Name field.
      7. In Database, click Select, and browse for the EDIFACT.mdb file.
      8. Repeat these substeps to create a DSN for the X12 standard. In the Data Sources Name field, input X12 and then select the X12Plus.mdb file.
    4. Verify that the correct version of the map editor is installed by checking that the Date modified of the mapper.exe file is 15 July 2021.
  3. Configure the map editor to communicate with Configuration Hub.

    This step is necessary so that you can run transformation tests and validation directly in the map editor.

    Note: If you did not uninstall the earlier version, the following error might occur.
    Map editor error message
    1. Open the map editor on the computer where you installed it.
    2. In the map editor, open a map and then select Functions > SPE Remote Map Test to display SPE Remote Map Test.
    3. In the Login Server and dashboard port field, enter confighub.b2b.ibm.com:443 (for North American users) or confighub-eu.b2b.ibm.com:443 (for European Union users) as the value.
    4. Select the Use SSL checkbox.
    5. In the Login Server User Name field, enter your IBMid.
    6. In the Login Server User Password field, enter your Authentication key from the My account page.
    7. In the Translation Object field, browse to a compiled map file on your local file system.
    8. In the Data File field, browse to the input file (for the specified map) on your local file system.
    9. Click Run Test.