Technical Articles
Migration tool in Cloud Integration Capability of SAP Integration Suite
Introduction
The January 2023 release of SAP Integration Suite now provides a feature in the Cloud Integration capability (6.35.*) to semi-automate the migration of integration scenarios from SAP Process Orchestration to SAP Integration Suite.
New with SAP Cloud Integration capability release (6.39.x) of SAP Integration Suite
The May 2023 release of Cloud Integration in SAP Integration Suite now provides an enhancement in the Migration Tool. Please refer the section – “SAP Cloud Integration release 6.39.x” in this blog.
New with SAP Cloud Integration capability release (6.38.x) of SAP Integration Suite
The April 2023 release of Cloud Integration in SAP Integration Suite now provides an enhancement in the Migration Tool. Please refer the section – “SAP Cloud Integration release 6.38.x” in this blog.
New with SAP Cloud Integration capability release (6.37.x) of SAP Integration Suite
The March 2023 release of Cloud Integration in SAP Integration Suite now provides an enhancement in the Migration Tool. Please refer the section – “SAP Cloud Integration release 6.37.x” in this blog.
New with SAP Cloud Integration capability release (6.36.x) of SAP Integration Suite
The February 2023 release of Cloud Integration in SAP Integration Suite now provides an enhancement in the Migration Tool. Please refer the section – “SAP Cloud Integration release 6.36.x” in this blog.
This feature is described as Migration tooling in the SAP Help Portal (see documentation). Please note, this feature is available across all the editions of SAP Integration Suite editions except Basic and SFSF editions. Please refer the SAP Note 2903776 for more details. Role collection mandated for consuming this feature is “PI_Integration_Developer”. Refer the help document for more details Persona | SAP Help Portal.
What is the Migration tool?
Migration Tooling is a feature in the Cloud Integration capability of the SAP Integration Suite that enables you to semi-automate the migrations of integration scenarios from SAP Process Orchestration to SAP Integration Suite. Before you migrate an integration scenario, it is important to assess the migration of the integration scenarios using the Migration Assessment capability of SAP Integration Suite. For more information, see, Migration Assessment documentation and SAP blog.
Why use the Migration tool?
Migrating integration scenarios manually from SAP Process Orchestration to SAP Integration Suite can be an error prone process and may require a significant investment in human effort. SAP Process Orchestration customers have made significant investment over many years and in order to be able to take advantage of all the new innovation in SAP Integration Suite, it was imperative that we deliver migration tool to help automate this process as much as possible.
The Migration tool will automatically create interfaces in SAP Cloud Integration based on design time artifacts in SAP Process Orchestration based on current scenarios supported through a template-based process. For cases where the artifacts match scenarios supported, much of the migration may be automated, with some manually changes still possibly required. The goal with the migration tool is to ultimately delivery a migration time savings of approximately 60-70 % through automation.
How to use the Migration tool?
In this section, we will explain how to use this feature and leverage the benefits to migrate SAP Process Orchestration integration scenarios. Before that, you should be well versed with certain key aspects, pre-requisites, and boundary conditions:
- Which version of SAP Process Orchestration is supported?
- How to add and configure SAP Process Orchestration system?
- Which SAP Process Orchestration objects are support for semi-automated migration?
- How to assess your SAP Process Orchestration artifacts using the migration assessment tool prior scenario migration?
- Which of the scenarios, for supported objects, can the migration tool migrate based on the currently delivered templates?
Which version of SAP Process Orchestration is supported?
Migration is currently supported only for SAP Process Orchestration 7.5 SP06 and above.
How to add and configure an SAP Process Orchestration system?
You can refer to the documentation to learn how to establish a connection between your SAP Process Orchestration system and the SAP Integration Suite Migration tool so to fetch the SAP Process Orchestration objects from Integration Directory and Enterprise Service Repository.
Which SAP Process Orchestration integration objects are supported semi-automated migration?
Currently, migration of Integrated Configuration Object (ICO) is supported.
How to assess your SAP Process Orchestration artifacts using the migration assessment tool prior scenario migration?
Before doing a migration, it is important to assess the integration scenarios in SAP Process Orchestration. Migration Assessment is a new feature of the Cloud Integration capability of SAP Integration Suite. This feature helps you to estimate the technical efforts involved in the migration process and evaluates how various integration scenarios can be migrated.
You can refer to the documentation to learn in more detail about the Migration Assessment feature:
After running the assessment each object (ICO) will be assigned a migration status. The possible migration statuses for ICOs are Evaluation required, Adjustment required, and Ready to migrate. For details about each status, see Concepts. In the current scope, migration is supported only for ICOs that are in Adjustment required and Ready to migrate statuses.
Which of the scenarios, for supported objects, can the migration tool migrate based on the currently delivered templates?
Integration scenarios in the SAP Process Orchestration system map to integration scenario patterns. Each pattern has been analysed and matched against scenario templates delivered as part of the migration tool in cloud integration.
Every Integration Configuration Object (ICO) that can be migrated has an associated template in the migration tool. Based on the information we provide in the templates; the migration tool is able to create the equivalent integration flows in SAP Integration Suite.
We’ve covered many important points on what this tool is and how it works, now let’s go through the experience of scenario migration by using the Migration tool.
In the steps below, I will explain how we can migrate a point-to-point async scenario which has SOAP adapters and mapping steps in the form of message mapping and XSLT mapping.
You can migrate the integration scenario of your choice, but please make yourself aware of the supported components, templates and known limitations.
Step 1: Open SAP Integration Suite launchpad, navigate to design workspace of integrations and then create or open any existing integration package.
Step 2: Edit the integration package. The migrate button will then be visible to migrate integration scenarios from SAP Process Orchestration to SAP Integration Suite.
Step 4: Select the SAP Process Orchestration system and establish the connection. The SAP Process Orchestration systems which were added as a part of Add an SAP Process Orchestration System are listed here.
Important point:
Every ICO that is ready for migration also has a default template. If there are no associated templates available and yet the ICO is ready for migration, the migration tooling falls back to the default template. Basically, default template creates a point-to-point integration flow; this template has neither the integration scenario nor the communication channels from the source ICO. However, mapping objects such as message mapping, XSLT mapping etc. will be copied and maintained in the point-to-point integration flow
Step 11: After the integration scenario is successfully migrated from SAP Process Orchestration to SAP Integration suite, an Integration flow will be created in the artifact list of the package overview page.
Step 12: Open the anticipated integration flow which is created after a successful migration. In this example, a point-to-point integration flow is created having SOAP Adapter, two message mappings and one XSLT mapping.
Step 13: Certain configuration changes are required to ensure an integration flow is deployable. For example, in the Receiver SOAP Adapter, configure the proxy type as “On-Premise” and provide the associated “Location Id”.
Step 14: Select the XSLT mapping step and open the corresponding resource for verification. You can also verify the resources of the message mapping steps.
Step 15: Deploy the integration flow and trigger the endpoints as usual to process the messages. Check if the security artifacts, like credential name and key alias, that are used in your ICO are correctly configured in the integration flow. Deploy the necessary security artifacts before you deploy the integration flow.
Support components
In the current scope, the migration tooling supports the migration of ICOs that contain the following components:
- Communication Channel: HTTP, REST, SOAP, IDOC, FTP, XI and SFTP
- Events: Timer
- Flow Steps: XSLT Mapping, Message Mapping, XML to JSON Converter, JSON to XML Converter, and Router
If your ICOs contain channels, events, or flow steps that aren’t mentioned here, you would require additional manual effort for the migration. However, we plan to continuously improve the tool to increase the scenario coverage. For more details, you can refer the roadmap section.
Supported Templates
Learn about the various templates that are available in the migration tooling from the documentation.
Known limitation
Know about the limitations of the migration tooling from the documentation.
Benefits
- Accelerate the migration from SAP Process Orchestration to SAP Integration Suite by reducing manual effort.
- Minimize migration errors through an automated migration process.
- Lower cost and risks of migration.
- Included in SAP Integration Suite at no additional cost.
Roadmap items
We have a plan to further improve the migration tool experience by targeting the below roadmap items. While these are part of our current plan, the roadmap may change at any time.
- Summary page on successful scenario migration to find useful information quickly and in one place.
- Support additional adapters during migration such as XI, JDBC, RFC, Mail adapters etc. and reduce the current limitation list.
- Support additional templates to cover more scenarios in migration.
- Java functional libraries support in message mappings
- Reusable message mapping and script collections support in migration.
- Support older versions of SAP Process Orchestration such as 7.4x and 7.3x.
- Support integration flow of SAP Process Orchestration in migration.
- Migrate classical scenarios .
- Mass migration to support multiple ICOs in a single migration execution.
- Migrate all the possible integration scenarios.
SAP Cloud Integration release 6.36.x
In this release of Cloud Integration of SAP Integration Suite, we have enabled the following features in the Migration Tool.
- XI Adapter is supported in the scenario migration from SAP Process Orchestration to SAP Integration Suite.
- Fixed some attributes which were not mapped properly in the scenario migration.
- Success/Summary page on successful scenario migration to find useful information and guidance on the next steps. In the success page, you will also experience the equivalent channel/adapter mappings between SAP Process Orchestration and Integration Suite, supported components and known limitations in the migration tool.
SAP Cloud Integration release 6.37.x
In this release of Cloud Integration of SAP Integration Suite, we have enabled the following features in the Migration Tool.
- All supported adapters are externalized to leverage the benefit of the externalized parameters.
- Easy way to filter the ICOs using the regular expression in the search parameters.
Regular expression (*) is enabled in the search parameters to search the ICOs. In the below example, (*) is used in the Sender Communication Component to filter ICOs. You can use (*) in either of the search parameters to ease the filtering task. - Template definition is shown as an information which will guide user to choose an appropriate template. For more details on the template, user can click the context sensitive help link(?) which will open the corresponding template help document.
SAP Cloud Integration release 6.38.x
In this release of Cloud Integration of SAP Integration Suite, we have enabled the following features in the Migration Tool.
- RFC, JDBC Adapter is supported in the scenario migration from SAP Process Orchestration to SAP Integration Suite.
- Following CSV templates are supported in the migration tool for scenario migration. Refer the help documentation.
- P2P_ASYNC_CSV_001
- P2P_ASYNC_CSV_002
- P2P_ASYNC_CSV_003
- Modularize the integration flow model with local integration process and exception sub process. Local integration process will be used to group the mapping steps and exception sub process for graceful error handling. Refer the help documentation.
SAP Cloud Integration release 6.39.x
In this release of Cloud Integration of SAP Integration Suite, we have enabled the following features in the Migration Tool.
- Supporting Bridge Template in migration tool for scenario migration. Refer the help documentation.
I hope, you can benefit from the enhancements presented in this blog post. If you have any questions or feedback, please feel free to comment on this blog.
This was much awaited from a long time. Thank you.
Thanks Anurag for sharing your view. Please experience this feature and share your feedback with us.
Nice blog . Everything mentioned step and step .
Thanks Venkatesh. Please consume this feature and share your experience, feedback with us.
Hi Kamlesh Zanje
Question about the template part. This is an example of what I see
Can I somehow correlate the template with a specific ICO setup? Or what is the intention of having templates in this context? There is no information to dive into.
Many thanks.
Dimitri
Hello Dimitri,
ICOs which are migratable will have an associated templates. In your above example, there are 4 associated templates which are automatically filtered for the chosen ICO. You can choose either of them which best fits for your scenario migration. Template is used to create equivalent integration flow in ISuite. In order to get more insight on the templates, its description and how the target integration flow in ISuite can be envisioned, I would request you to click context sensitive (?), it will navigate to the help document chapter. Understand the templates and accordingly select the template from the wizard and proceed to the next steps.
Regards,
Kamlesh.
Now I see it! Thanks!
I thought this was linked to ICO configuration or version management, but the templates are named by SAP.
Is there similar blog to cover migration from PI (We are currently on EHP1 NW 7.5 SPS21) to SAP integration suite?
Thanks,
Pallavi.
Hello Pallavi,
You can follow this blog to migrate your scenarios from PI to SAP Integration suite.
Regards,
Kamlesh.
Thanks Kamlesh. Will try it out and come back to you if any queries.
Hi Kamalesh,
im getting below issue. could you please help me here?
Destination created in cockpit but unable to find the destination using assessment tool
Attached screenshot
Hello,
Please refer this documentation Add an SAP Process Orchestration System | SAP Help Portal
to know how to establish a connection between your SAP Process Orchestration system and the migration tool of Cloud integration capability.
If you still face the problem, create an incident for SAP Support.
Regards,
Kamlesh.
Hello @sivaramakrishnaa_ravichandran,
The "systemname" property is missing under the "Additional Properties" section.
Could you please add "systemname" as "J2E" and try again?
The same details are available in this documentation link as well:- Add an SAP Process Orchestration System | SAP Help Portal
Thanks,
Sathish
HI Kamlesh,
This blog really helped me to connect to PO from integration suite. I have successfully connected and downloaded the evaluation report and i can see all my objects comes under size S and Assesment category is Ready to Migrate. Only thing i didn't understand is what is the unit of Weight --> weight means in Hours on in days ?
Hello Satish,
The weight is a factor we aggregate and afterwards map to a T-Shirt Size. So it just describes the complexity of migration such a feature.
Regards,
Kamlesh.