šĀ Transporting Configuration Between Tenants in SAP Sales & Service Cloud V2: A Change Project Guide
With SAP Sales Cloud Version 2 (V2), SAP continues its modernisation to reinvent the CRM experienceāoffering a cleaner, more modern interface and a scalable architecture designed for enterprise-level growth. As organizations adopt V2, one topic that frequently surfaces for implementation teams isĀ how to reliably transport configuration changes between environments, particularly from Test (QA) to Production.
In this blog, weāll walk through the essentials of executing aĀ Change ProjectĀ in SAP Sales Cloud V2, with a special focus on transporting configuration specifically forĀ CaseĀ andĀ Case TypeĀ services. Youāll learn how the process works, why itās needed, and the best practices for ensuring a smooth transportation of changes.
šĀ What Is a Change Project in SAP Sales & Service Cloud V2?
AĀ Change ProjectĀ is SAPās structured way of capturing and transporting configuration changes across environments. It allows you to:
- Record configuration updates in a designatedĀ source systemĀ (such as a staging or development tenant).
- Transport these validated changes intoĀ target systemsĀ like Test or Production.
- Use a multi-tier setup where one source tenant can push changes to multiple targets for the same customer ID.
- Eliminates the need to manually configure the same Case Configurations across multiple tenants.
šĀ The Two-Step Transport Process
Transporting configuration in SAP Sales Cloud V2 happens in two key phases:
1ļøā£Ā Initial Load
Before delta transports can be used, the system requires that all connected tenants ā or any tenants that intend to participate in Change Project transports ā are properly synchronised.
This is where theĀ Initial LoadĀ comes in.
Hereās what happens during this phase (Source To Target):
- The initial load ensures that configuration data for the chosen service (e.g., Case or Case Type) is identical across the source and target tenants.
- It must be triggered by the customer because certain pre-checks or preparations may be required in the source environment.
- By default, the initial load takes theĀ current configuration from the SourceĀ and applies it to the Target tenant(s).
- After completion,Ā both tenants are fully aligned, with no extra or missing configuration.
Note:Ā For most existing customers, the initial load is typically performed from theĀ ProductionĀ tenant to theĀ TestĀ tenant. This approach is considered safer because it does not pose any risk to the Production environment. Therefore, this direction of initial loadāfrom PROD to TESTāwill also be supported.
Once the Initial Load is done, youāre ready to move on to continuous change recording.
2ļøā£Ā Delta Load
After synchronisation, any configuration changes you make in the source system are:
- Automatically captured within the currently checked-out Change Project.
- Stored as delta changes.
- Transportable whenever the administrator decides to push them to the target environments.
This offers flexibility and controlāonly the changes you want, when you want them.
šĀ Ā Understanding the Initial Load Process
When you trigger theĀ Initial Load, the system collectsĀ all existing configuration dataĀ for the selected serviceāeven if those configurations were createdĀ beforeĀ the Change Project existed. Keep in mind that the Initial Load must be executedĀ individually for each service.
In this blog, weāll focus onĀ CaseĀ andĀ Case TypeĀ services.
šļøĀ Ā What Gets Transported?
Case:Ā The following code list configurations are included when transporting Case Configuration data:
- Status Dictionary Entries
- Status Schemas
- Priorities
- Source Settings
Case Type:Ā Transport inclusions for Case Type include:
- Case Type Code List
- Case Type Template Versions
- Action Catalog
These two services are registered separately so that dependent and independent configurations remain logically separated.
šĀ Case Type Service Dependencies
The Case Type service depends on several other services. Initial Load for Case Type can only proceedĀ afterĀ the Initial Load of all dependent services is completed.
Dependent Services:
- Approval
- Autoflow
- Mashup
- Extensibility
- Form Admin
This ensures that all necessary underlying data is already present in the target tenant before Case Type configurations are transported.
Before proceeding with Initial Load for Case or Case Type, make sure to go through the Important Considerations and Initial Load Behaviour sections.
Now, letās walk through the Initial Load and Delta Load processes.
šĀ Executing the Initial Load & Delta Load
šĀ Step-by-Step: Initial Load for Case
Step 1: Start Initial Load (Case)
After configuring source and target tenants as mentioned inĀ Change Project, initiate theĀ Initial LoadĀ for the Case service by navigating toĀ Settings ā All Settings ā Change Project ā Administration ā Registered Services ā Case ā Start Initial Load.Ā Confirm the pop-up.
A Change Project titledĀ āInitial Load for CaseāĀ is automatically created in the Source tenant.
This captures all configuration items related to Status Dictionary Entries, Status Schema, Origin (Source Settings) and Priority
The Change Project will appear with the statusĀ WORK IN PROGRESS, meaning itās ready to be published.
Step 2: Publish the Change Project (Source Tenant)
In the Test (source) tenant, Login and navigate to:
Settings ā All Settings ā Change Project ā Administration ā Initial Load for Case ā Publish.
Step 3: Transport the Change Project
Continue in the Test tenant:
Settings ā All Settings ā Change Project ā Administration ā Initial Load for Case ā Transport.
You will be prompted to select the target tenants. Choose the appropriate ones and proceed. In my scenario, I had two target tenants.
After transporting, the change project status in the source system changes toĀ Transported.
Step 4: Activate in Target Tenant
Log in to the Production (target) tenant:
Settings ā All Settings ā Change Project ā Administration ā All Change Projects
You will see theĀ Initial Load for CaseĀ project with the statusĀ Imported.
Once you're satisfied with the incoming configurations, clickĀ PublishĀ to activate the changes.
Step-5:Ā šĀ Performing Initial Load for Case Type
Since Case Type depends on other services, you must first complete Initial Loads for all dependent services.
The system enforces this and hides any services whose Initial Loads are already complete.
š§ŖĀ Step-by-Step Behaviour for Case Type
Letās assume that initial load is done From Target to Source for Case Type.
Since the steps for performing the Initial Load for Case Type are nearly identical to those for Case, I wonāt repeat them here. Instead, Iāll focus on explaining theĀ Template VersionĀ concept in Case Type, which requires a more detailed walkthrough.
Step 1 ā Before Initial Load
Case TypeĀ ZABCĀ exists in both source (Quality) and target (Production), with versions as shown in the pre-load state.
Step 2 ā After Initial Load (Prod ā Source)
After performing the Initial Load from Production to Quality
Here CHT Means Change Transport.
- TheĀ Source DRAFTĀ version is removed, and theĀ Target DRAFTĀ version becomes the new DRAFT in the source tenant.
- All existing template versions in the source are moved toĀ INACTIVEĀ status, and the prefixĀ āCHTāĀ is added to each version that is deactivated.
- All incoming template versions from the targetāwhetherĀ ACTIVE,Ā DRAFT, orĀ INACTIVEāare created in the source exactly as they exist in the target.
This aligns both tenants to the same configuration baseline and visually user can co-relate the versions going forward.
šYouāve now completed the Case and Case Type Initial Load and successfully transported configurations between the tenants in SAP Sales Cloud V2!
šĀ Delta Load
WhenĀ Delta LoadĀ is enabled:
- Any configuration changes made toĀ CaseĀ orĀ Case TypeĀ in the source tenant are automatically captured in the checked out Change Projectāthis happens when the project is checked out and the changes are performed. If a Change Project is not checked out, you will be getting an error as below.
- Solution:Ā Go to the Change Project list and either create a new Delta-type change project (which will automatically check it out for your logged-in user) or open an existing open change project and check it out. This step ensures the system can track and store your delta changes correctly.
- When the administrator decides to transport these updates or the delta change projectsĀ to the target tenant, the captured changes are transported and published based on the adminās choice.
- Since Case configuration handling is straightforward, I wonāt go through those steps here.
- Case TypeĀ however, behaves differently. After the delta Change Project is transported and published in the Production (target) tenant, the template version statuses are updated as follows with continuing above example.Ā
- Version 4Ā transitions fromĀ DRAFT ā ACTIVE
- Version 3Ā transitions fromĀ ACTIVE ā INACTIVE
ā ļøĀ Important Considerations
When you perform theĀ Initial Load, the system importsĀ all existing configurationĀ for the selected serviceāincluding configurations createdĀ beforeĀ the Change Project existed.
As a result:
- TheĀ Initial Load must be executed separately for each service.
- CaseĀ andĀ Case TypeĀ each require their own independent Initial Load.
- The order is important:
Run Initial Load for Case Service first, and then run Initial Load for Case Type.Ā
- SinceĀ CatalogĀ is a master data entity and is referenced withinĀ Case Type configurations, itās important that customers maintain theĀ same Catalog Display IDĀ across all tenants before implementing Change Projects for Case Type. The system relies on matching Catalog Display IDs between the source and target tenants when validating and transporting data, and this alignment is required for both the Initial Load and Delta Load processes for Case Type.
- Additional points:
- Service Levels are not includedĀ in the Change Project scope.
- Decision Table ConfigurationsāConfigurations such as Service Level Determination, Case Routing to Employee, and Case Routing to Team are not transported through Change Projects as they may contain tenant specific data. Also they support import/export using excel.
- However, the decision table ID maintained againstĀ Case Routing to TeamĀ andĀ Case Routing to EmployeeĀ within the Case Template versionĀ isĀ transported. You only need to recreate the corresponding decision table in the target tenant using the same DisplayId.
- TheĀ Number Range nameĀ is included in the Change Project for Case Types; however, theĀ actual number range values may differĀ between source and target tenants.Ā
- Hence, In the target tenant – the number range remainsĀ editableĀ under:
Settings ā Case Management ā Number Range.
- Hence, In the target tenant – the number range remainsĀ editableĀ under:
- Ensure that organizational units have identical IDs in both the source and target tenants.
- Party schemas and business document services are not treated as hard dependencies. If your process relies on them, make sure they are transported (via Initial Load) to the target tenant before performing the initial load for Case Type.
In this blog series, weāll walk through how to execute these steps specifically forĀ CaseĀ andĀ Case TypeĀ configurations in SAP Sales Cloud V2.
šĀ Initial Load Behaviour
Before initiating the Initial Load, itās important to understand how the target tenant will react to incoming configuration if the initial load is done in Source to Target Direction:
- New configuration in the targetĀ ā will beĀ added
- Existing configuration (common)Ā ā will beĀ updated
- Configuration missing in the source but present in the targetĀ ā will beĀ deleted
Before any deletion occurs, the system performs aĀ usage check.
If a configuration is actively used in Case transactions or referenced by other configurations, the system will fail the Initial Load, indicating that the configuration cannot be removed.
ā Ā Best PracticesĀ
- Transporting Deletions:Ā Ā When transporting deleted configurations between tenantsātypically during a delta transportāmake sure to first verify in the target tenant whether the configuration you plan to delete is actively used. You can quickly check this by usingĀ Case OWL Advanced Filters, which provide visibility into all configuration fields related to bothĀ CaseĀ andĀ Case Type.
š ļøĀ Admin Options When Conflicts Occur
If an Initial Load fails because a configuration is still in use, administrators generally have below option to resolve the issue. Below, weāll walk through these option using an example where the Initial Load direction isĀ Source ā Target.
- Recreate the configuration in the source tenant:Ā Ā Ā Usually, delete conflict in target occurs If a configuration cannot be deleted due to transactional dependencies. If that's the case recreate the same configuration in the source tenant and then retry the Initial Load.
š¦ Conclusion
Transporting configuration in SAP Sales Cloud V2 is simple with Change Projects. By using Initial and Delta loads and managing dependencies, you can move only the right changes across tenants with control and consistency.



