Migrate a Neptune DXP - SAP Edition app with the Neptune DXP App Migration Wizard

This guide walks you through the Neptune DXP App Migration wizard in Naia Build. The wizard runs in four steps: Connection, Application, Analyze, and Migrate.

Prerequisites

  • Neptune DXP - Open Edition 24.14 or later and an active subscription-based license. See the Neptune DXP App Migration Wizard for the full list of prerequisites.

Procedure

Opening the wizard

  1. In the Neptune DXP - Open Edition App Designer, open or create the app you want to migrate into, enter Edit mode, then switch to Agent mode in the shell bar.

  2. In the AI experience panel, open the Automations tab, scroll to the end of the list, and select Start next to Migrate your SAP edition app.

Step 1 — Connection

  1. From the remote system dropdown, select the Neptune DXP - SAP Edition system that contains the app you want to migrate.

  2. Select Verify connection.

    • If the connection fails, check that the remote system is correctly configured and reachable from your Neptune DXP - Open Edition environment.

  3. Select Next.

Step 2 — Application

  1. Enter the source app ID, or wait for the wizard to pre-select it if the Neptune DXP - Open Edition app name matches.

    If you see the warning "There is no SAP Edition app called [name] on this remote system. Are you sure this is the right system? If so, pick a different app below", use the dropdown to select the correct app manually.

  2. Select Load app data and confirm the app summary displayed.

  3. Select Next.

Step 3 — Analyze

  1. If your app uses SAP data dictionary field label bindings, expand Advanced Options and select the languages to fetch. See DDIC label fetch behaviour for detail.

  2. Select Run analysis and wait for the report to complete.

  3. Review the report results. See Engineer action reference for a description of each category and recommended action.

  4. If needed, download the diagnostics file for later reference. See Diagnostics file reference for its contents.

  5. Select Next.

Step 4 — Migrate

  1. Review the migration summary (source app, target app name, and analysis outcome).

  2. Select Migrate app and create version.

On success: The App Designer switches to live app mode. Proceed to verify that the app loads and data is returned from the SAP back end as expected.

On failure: Download the diagnostics file and consult Support scope and self-service guidance before raising a Neptune Support ticket.

After migration

  1. Switch to Edit mode and open Resources / GENERATED_MIGRATION_CODE / README. Review the migration summary before making any changes. See Migration output files reference for a description of all generated files.

  2. Address any items flagged in the Analyze report. See Engineer action reference for recommended actions per category.

  3. Complete any remaining post-migration configuration in Neptune DXP - Open Edition. See Migrated app architecture reference for a prioritized breakdown.

  4. To continue developing the app agentically, open Naia Build via Agent mode in shell bar. See Continuing development with Naia Build for guidance on working with migrated apps of different sizes.

Results

After completing these steps you have:

  • A fully structured Neptune DXP - Open Edition app, immediately runnable and connected to your SAP back end via the Neptune DXP - Open Edition proxy.

  • All structural elements, scripts, event handlers, stylesheets, translations, and back-end connectivity transformed automatically by the migration engine.

  • A generated README and Ajax TypeScript files under GENERATED_MIGRATION_CODE documenting what was migrated and what requires further attention.

  • A clear picture from the Analyze report of any SAP-specific elements requiring manual replacement or post-migration configuration in Neptune DXP - Open Edition.

  • A diagnostics file available for download at any point, suitable for Neptune Support if issues arise.

Related topics