Migrating Design Time Libraries ( DTL) as Shared Modules

TIBCO ActiveMatrix BusinessWorks™ 5.x design time library source projects can be migrated as ActiveMatrix BusinessWorks™ 6.x shared modules.

Migrating Design Time Libraries Using TIBCO Business Studio™ for BusinessWorks™

Using the ActiveMatrix BusinessWorks 6.x framework, you can migrate TIBCO ActiveMatrix BusinessWorks™ 5.x projects where the business process uses design time libraries to define the processes, resources, subprocesses, and so on.

You can migrate the design time libraries using the following options:
  • Project > Migrate BW Projects option in ActiveMatrix BusinessWorks
  • The command-line option

Procedure

  1. In the Project Migration Wizard, 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. Click the Select Third Party JARs folder field to browse for third party jars only if your project contains a custom XPath.
  4. Click Migrate Project.

Result

After migration, you can 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.

Limitations

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

  • Shared module migration does not support TIBCO 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. To use this feature, add the process name manually.

Migrating Application Modules

TIBCO 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 will 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
sharedModule Set 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.
Set the following properties to link a DTL library to the shared module.
Property Description
dtlDir Provide the project lib folder location here. For example, C:/Users/workspace1/folder/BW5DTLLib.projlib.
sharedModuleDirs Provide the shared module location here. You can provide multiple directory locations using comma separated values. For example, C:/CLIWorkspace,C:/CLIWorkspace/SharedModuleProject1,....