Migrating Projects Using TIBCO Business Studio™ for BusinessWorks™

This section describes how to use the Migrate BW Projects menu option in TIBCO Business Studio for BusinessWorks.

Prerequisites

  • Perform validation and ensure that ActiveMatrix BusinessWorks 5.x project does not have errors.
  • Optionally, schemas without namespaces should be refactored before migration.
  • Remove spaces in the namespace.
  • Remove or update any retrieve WSDL processes.
  • It is recommended to add missing namespaces for the schemas.
  • Ensure that there are no spaces or special characters in folder names.
  • Global variables with integer values and a String data type must be updated to data type as Integer. Examples include timeouts, message size, and so on.
  • Ensure that no two resources, such as schemas, WSDLs, and DTDs have the same name when they have a common hierarchical structure or layout.

Procedure

  1. In TIBCO Business Studio for BusinessWorks, choose Project > Migrate BW Projects.

  2. In the Project Migration Wizard dialog box, to migrate a single ActiveMatrix BusinessWorks 5.x project, click Migrate Single BusinessWorks 5x Project

    To migrate multiple projects, click Migrate Multiple BusinessWorks 5.x Projects

    When migrating a single ActiveMatrix BusinessWorks 5.x project, you can also migrate selective processes or subprocesses. Select the Select Processes for Migration check box, and provide the required information as explained in Step 6, below.

    After the required information is provided, the Select Processes button is displayed.

    Note: The Select Processes for Migration check box is disabled when you select the Migrate Multiple BusinessWorks 5.x Projects option. Use this check box only to migrate single projects.
    The list of processes in the selected ActiveMatrix BusinessWorks 5.x project are displayed in the Project Migration Wizard dialog box. The processes can be viewed in the Flat Hierarchy or in the Tree Hierarchy structures.
  3. To select all the subprocesses under the main process, click Select Linked Processes. Clear the check box for the process you do not want to migrate.
    To view the static and dynamic processes that are selected for migration, click Show Linked Process Hierarchy.
  4. While migrating selective processes, to select or clear the already migrated existing processes, on the Select Processes page of the Project Migration Wizard dialog box, select the Re-Select Process check box.
    Note: During the re-migration process, the module properties are not changed.
  5. Click Migrate Project.
  6. Specify the relevant information in the following fields.
    1. Click Browse in the Select Project(s) to be migrated field and provide the location of the ActiveMatrix BusinessWorks 5.x project to migrate.
      Note: Select CTRL+ Spacebar to retrieve the history of the last five migrated project paths.
    2. The Select Migrated Project Location field displays the location of the current open workspace where the project is migrated. To provide a different workspace, click Browse.
    3. While migrating any project from version 6.6.1 of TIBCO ActiveMatrix BusinessWorks™ onwards, the default XPATH language for transitions is pre-set to XPATH 1.0. Select XPATH 2.0 to set the XPATH language for transitions to XPATH 2.0. The transitions are migrated by default to XPATH 2.0 for versions prior to 6.6.1 of TIBCO ActiveMatrix BusinessWorks™.
      Note: The XPATH language for transition is introduced to get rid of invalid comparison or conversion issues on transitions or groups while migrating TIBCO ActiveMatrix BusinessWorks™ 5.x projects.
    4. To browse for third party jars required for your project, click the Select Third Party JAR's folder field.
    5. The Single XPath Function Group Project check box is selected by default, to create all custom XPaths as a single plugin project and under a single custom XPath.
      After migration, the custom XPath function group plugin project is included in the application project. The classes folder is located in the customXPathFunction.jar file, and is no longer available in the plug-in project. This jar file is also added to the project class path.
    6. In the Select ProjectLibs (DTLs) used by Project field, click Browse to select the project libraries to be used for the project.
    7. In the Select Java Libraries used by Project field, click Browse and provide the location of the JAR files on disk if the ActiveMatrix BusinessWorks 5.x project is using external JAR files in context with Java activities.
      Important: TIBCO recommends that you place the external JAR files in a single location.

      These JAR files can then be in-lined in the migrated ActiveMatrix BusinessWorks 6.x project.

    8. To generate the dot (.) properties file which is used for performing command-line migration, click Export. For more information about the (.) properties file, see Command line Configuration File Template.
    9. To browse the (.) properties file which populates the referred 5.x project path for migration, click Import.
  7. Click Migrate Project.
    • The process count displayed on the Migrate page of the Project Migration Wizard is inclusive of migration service agents.
    • The tooltip available for the Migration progress bar displays the general information about migration process.
    • The Project Migration Wizard dialog box displays the migration status in blue and green colors, where blue and green colors indicate the start and the completion of the migration process respectively.
    • To cancel the migration process anytime, in the Project Migration Wizard, click Cancel.
  8. Click Finish after the migration is complete.

Project with Subprocess after Migration

Subprocesses in ActiveMatrix BusinessWorks 6.x use a standardized concept of receiving messages and replying to messages through a service.

Before Migration

After Migration

The Call Process is migrated as a Direct Call Process.