Index | Prev | Next

Migrating modules from ProgramModules in a station database

If ProgramModule components are used within the AX-3.8 station (instead of in standalone BOG files in our Workbench file space), you need to migrate that station in the standard way, that is using a station backup .dist file as the source.
Prerequisites:

However, before installing that migrated station, or any other migrated station that uses modules produced by it, you must use Workbench to get refactored modules from its ProgramModules. This means recompiling and saving Programs in each ProgramModule, then running a build on each one. Then you must migrate that station again (now that the necessary refactored modules are available).

 NOTE: If necessary, you can do this on a PC still running the AX-3.8 Supervisor station, but with both Workbench and Workbench installed. 
  1. Run the migration tool on the saved AX-3.8 station backup .dist file.
  2. In the Workbench Nav tree, expand the stations folder under your User Home, to see this newly-migrated station.
  3. Expand the station’s [Either the href or the keyref attribute should be set on graphic elements] Image config.bog file, and navigate to the first ProgramModule.
    4. ======= href="../graphic/configbogicon_0000004850.png" scale="65"> [Either the href or the keyref attribute should be set on graphic elements] Imageconfig.bog file, and navigate to the first ProgramModule.
  4. >>>>>>> bde860ade36eb9acbc8594d08a62aa1a964a8b00
  5. Double-click the ProgramModule for its Program Module Builderni

    Image

  6. Right-click one of the contained Programs and select Views > Program Editor (as above).
  7. In the Program Editor, click Image Save & Compile (ProgramEditor > Save&Compile). Activity occurs in the console area at the bottom of the Workbench window.
    If successful, the Program status should be up-to-date, and the Image Save Bog icon should be available. Click Save Bog.
     NOTE: If the Program compile fails, you need to make one or more modifications to that Program, working in its Program Editor. See Modifying Program objects. 
  8. Repeat steps 5 and 6 for all Programs in the selected ProgramModule, so that all Programs have been successfully compiled and saved.
  9. Double-click the ProgramModule for its Program Module Builder view, then click Image Build.
    Image
    As shown above, a popup dialog appears while the module is created. Completion may take several seconds. Related details should also appear in the console area at the bottom of the Workbench window.
  10. If multiple ProgramModules are in the folder, repeat steps 4 through 8 for each one.
    Image
    As shown above, the module named aaPrgmModule.jar was created by the ProgramModule.
  11. When done migrating modules, right-click the station’s Image config.bog file and click Save.
  12. Close and then restart Workbench. This is necessary to update the registry. Migrated modules should now be ready when running the migration tool on AX-3.8 station backup .dist files, including the station with the source ProgramModules.

Related Links

  • Migrating modules made with the ProgramModule component (Parent Topic)

    • Index | Prev | Next