Migrating Design Time Libraries (DTL) as Shared Modules

ActiveMatrix BusinessWorks 5.x design time library source projects are migrated as ActiveMatrix BusinessWorks 6.x shared modules.

Migrating Design Time Libraries Using TIBCO Business Studio for BusinessWorks

Use the ActiveMatrix BusinessWorks 6.x framework to migrate ActiveMatrix BusinessWorks 5.x projects where the business process uses design time libraries to define processes, resources, and subprocesses.

You can migrate the design time libraries using the following options:
  • Project > Migrate BW Projects option in TIBCO Business Studio for BusinessWorks
  • The command-line option
    Procedure
  1. In the Project Migration Wizard dialog box, click Migrate Single BusinessWorks 5.x Project and select the Migrate as Shared Module check box.
  2. Provide the Project Location details and the XPATH Function Group Configuration details if a custom XPath is used in the project.
  3. To browse for third party jars only if your project contains a custom XPath, click the Select Third Party JARs folder field .
  4. Click Migrate Project.
ResultAfter migration, view the folder structure of the resources, including the resource, schema, wsdl, and so on that are available in the shared module under the Module Descriptors > Provides tab.

After migration, do not perform refactoring operations on any of the resources, such as the schema, ActiveMatrix BusinessWorks 6.x shared resources, and service definitions. The resource properties, and naming conventions must be retained as they are. Mapping issues, if any, can be corrected, and resource specific properties of the shared resources can be changed.

Limitations

  • Shared module migration does not support ActiveMatrix BusinessWorks 5.x AE schemas. AE Schemas are migrated as part of the application module.
  • Custom XPath function project duplication should be managed manually by deleting the duplicate source projects.
  • DTL migration does not support the Process Name Dynamic Override feature of the Call Process activity. Instead, add the process name manually.

Migrating Application Modules

ActiveMatrix BusinessWorks 5.x projects using design time libraries can be migrated as application modules by linking the corresponding shared modules to the DTL libraries.

Select the Link DTL to Shared Module check box.

Select the required DTL project, and click OK.

Mapping the DTL to the <Do Not Migrate> option does not link the DTL to the shared module.

Note: Multiple DTL libraries can be linked to one shared module. After migration all the DTL libraries refer to the same shared module to resolve resource references.

Migrating Design Time Libraries Using Command line

Design time library source projects can be migrated as shared modules using the command line.

Set the following properties to migrate DTL projects as a shared module using the bw6migration.properties file.

Property Description
sharedModuleSet the property to true to create an ActiveMatrix BusinessWorks 6.x shared module.

Set the property to false to migrate the DTL as an application module.

Note: The shared module and the application module must be maintained in the same workspace while performing migration using the command line.

Mapping a Design Time Library to a Shared Module

Set the following properties to link a DTL library to the shared module.

Property Description
dtlDirProvide the project lib folder location. For example, C:/Users/workspace1/folder/BW5DTLLib.projlib.
sharedModuleDirsProvide the shared module location. You can provide multiple directory locations using comma separated values. For example, C:/CLIWorkspace,C:/CLIWorkspace/SharedModuleProject1,....