Migrating Adapter Projects Created on TIBCO ActiveMatrix BusinessWorks™ 6.x to Plug-In Projects

You can migrate a SAP Adapter project created on TIBCO ActiveMatrix BusinessWorks™ 6.x to TIBCO ActiveMatrix BusinessWorks™ Plug-in for SAP Solutions project by using Refactor > Migrate Adapter to Plug-in option in TIBCO Business Studio™ for BusinessWorks™.

For migrating a project successfully, the project should have at least one process using at least one of the adapter palette activities.

Note:
  • Migration from command line is not supported.
  • Migration on TIBCO BusinessWorks™ Container Edition is not supported.
  • RFC/BAPI containing complex types or table types are not supported.
Prerequisite
  • For databases using native drivers in ActiveMatrix BusinessWorks 6.x, the JAR files must be added to the <TIBCO_HOME> directory before the migration is initiated.

Projects Supported for Migration

Migration is provided for the following project specifications:
Project Specification Supported for Migration To
TIBCO ActiveMarix® Adapter for SAP projects created on ActiveMatrix BusinessWorks 6.x in TIBCO Business Studio for BusinessWorks ActiveMatrix BusinessWorks™ Plug-in for SAP Solutions
Migration Restrictions

  • You can migrate ActiveMatrix® Adapter for SAP projects created on ActiveMatrix BusinessWorks 6.x to ActiveMatrix BusinessWorks Plug-in for SAP Solutions. However, vice versa is not possible.

  • Migration supports only those ActiveMatrix® Adapter for SAP projects created on ActiveMatrix BusinessWorks 6.x that have no designtime or runtime errors before refactoring. The projects must be validated and processes must be run successfully end to end before migrating to ActiveMatrix BusinessWorks Plug-in for SAP Solutions projects.

  • After migration, the project should be imported into a new workspace and the studio should be restarted.

  • Migration is based on the information received from the AE activities. All the activities get migrated as it is besides the Adapter Request Response Server, Respond to Adapter Request, Adapter Subscriber, Invoke an Adapter Request-Response Service, and Publish to Adapter activities.

  • If all ActiveMatrix® Adapter for SAP 6.x projects are not migrated to ActiveMatrix BusinessWorks Plug-in for SAP Solutions projects, then export the adapter projects, import it to a new into a workspace or TIBCO_HOME, and then perform the migration of the project.
  • Migration of SNC Client and Server Connections is not supported and after migration the required connections must be created manually.

Considerations when Migrating Projects
Note:
  • Due to the structure of ActiveMatrix® Adapter for SAP project created on ActiveMatrix BusinessWorks 6.x and the migration process, there are some files in the project migrated to ActiveMatrix BusinessWorks Plug-in for SAP Solutions, but are not used and must be ignored. For example, - ae folder and ae2xsd.xsd under AESchemas folder, and so on.
  • An EMF validation error occurs in the migrated ActiveMatrix BusinessWorks Plug-in for SAP Solutions project when a ActiveMatrix® Adapter for SAP project created on ActiveMatrix BusinessWorks 6.x is saved with another name and these two projects are migrated to the plug-in. To resolve this issue, delete the Namespaces or Imports from Process > Dependencies.
  • If you want to use the SAP schemas from the migrated ActiveMatrix BusinessWorks 6.x project, the project needs to be cleaned using the Project > Clean option from TIBCO Business Studio for BusinessWorks. Once the project is cleaned, the schemas can be selected from the .SAP folder. The schema can be re-fetched using the Fetch IDoc or Fetch Function button, which will make it available in the .SAP folder and in the schema picker.
  • In ActiveMatrix® Adapter for SAP project created on ActiveMatrix BusinessWorks 6.x, the Subject and Destination fields configured in the Transport tab must have the same value for service and activity.
  • If there is a ActiveMatrix BusinessWorks 6.x generic activity that uses the SAP adapter AE schema in ActiveMatrix® Adapter for SAP project created on ActiveMatrix BusinessWorks 6.x, after migration the ActiveMatrix BusinessWorks 6.x generic activities might need to be manually fixed to use the plug-in activity schema.
  • For migration of ActiveMatrix® Adapter for SAP project created on ActiveMatrix BusinessWorks 6.x to ActiveMatrix BusinessWorks Plug-in for SAP Solutions project, there are a few projects that need to be manually fixed after migration. For example, in ActiveMatrix® Adapter for SAP project created on ActiveMatrix BusinessWorks 6.x, any schema where attributes are a SAP predefined ABAP type like string, or if the schema is present in ActiveMatrix® Adapter for SAP activity and not present in the plug-in activities or vice-versa and so on. Also in the such adapter project, the schema contains a double underscore (__) while in ActiveMatrix BusinessWorks Plug-in for SAP Solutions project it is underscore (_).
  • Migration supports online schema migration, which means it retrieves the schema from the SAP server during migration for the respective activity. Before migrating a project, ensure that the connection parameters provided are correct in the project or in JSON reference file, otherwise errors might occur post migration.