Transporting Key-User In-App Extensions

Objective

After completing this lesson, you will be able to transport key user in-app extensions

Transporting In-App Extensions

Exporting Software Collections

To move key user in-app extensions through your landscape, you must export them from the customizing tenant of the development system using the Export Software Collection app. Subsequently, use the Import Collection app to deploy them into the test and production systems.

Screenshot of the Export Software Collection app.

In the Export Software Collection app, you create a collection and add the specific extension items you wish to release. It is essential to include items with dependencies in the same collection to ensure they function correctly after the transport.

For instance, if you create a custom business object and a corresponding custom catalog extension, you should export and import them together.

Before exporting, use the Check function to identify potential errors or missing dependencies. If the system detects related items not yet in the collection, select Add Missing Items to include them automatically.

When ready, select Export for a standard release. If you need to deliver urgent fixes for extensions that were previously transported, use the Hotfix option instead.

For detailed guidance, refer to the documentation on exporting software collections in the SAP Help Portal.

Using the Import Collection App

The Import Collection app serves as the central tool for importing various extension types. This includes key user in-app extensions, business content changes from SAP Central Business Configuration, and developer extensions created in the development tenant.

The standard workflow requires importing extensions into the test system first for quality assurance. Once testing is successful, you can forward the collection to the production system directly from the app. To make these changes available to end-users, you must perform a final import within the production system.

Screenshot of the Import Collection app.

The app displays several import types to indicate how a collection was processed:

  • Manual: The import was started manually by a user.
  • Manual (forecast): The system indicates that manual intervention is likely required, often due to potential conflicts or previous failures.
  • Automatic: The import occurred automatically, such as when business content is synchronized between SAP Central Business Configuration and the development system.
  • Automatic (scheduled): The import was executed based on a predefined automation schedule.
  • Not relevant: The collection is no longer eligible for import, typically because it is Outdated or Discarded (for example, if it was not imported before a major software upgrade).

Caution

Importing items can cause business interruptions. For example, if a user is actively working in an app while a software collection modifies that same app, it may lead to errors or session loss.

To manage this risk, check the Business Interruption column in the app. If the risk is high, schedule the import during off-peak hours when user activity is minimal.

Caution

Export, import, and forwarding activities are disabled during the upgrade preparation phase, which typically begins a few days before the scheduled weekend upgrade.

For more information, see the documentation on importing software collections in the SAP Help Portal.