Data migration

SAP Migration Cockpit Templates: Fill, Validate, Load

How SAP Migration Cockpit templates are structured, which fields break a load, and how staging tables, files, and direct transfer differ.

Updated September 2026Evidence-led guideSAP Migration Cockpit templates
Built for

SAP data migration leads and functional consultants preparing loads into S/4HANA with the Migration Cockpit.

Decision supported

Which transfer approach fits the object and the landscape, and what has to be right in a template before a load is attempted rather than debugged.

Decision context

The Migration Cockpit gives you a migration object, a template, a validation step, a simulation, and a load. Most of the effort is in the template, and most of the failures are three things: a mandatory field left empty, a value that has no mapping, and a dependent object that was not loaded first.

The three transfer approaches are not interchangeable. Staging tables suit high volume and repeated cycles because the data sits in database tables you can query and correct. Files suit smaller objects and business-owned data because a spreadsheet is something a functional owner can actually fill. Direct transfer from an SAP source avoids the extraction entirely for the objects and releases where it is supported.

Which objects and approaches are available depends on your S/4HANA release and deployment, and the delivered object list changes between releases. Check what your system offers before designing around an object you read about elsewhere.

How a template is structured

A migration object's template has one sheet per target structure, and the sheets are related by keys. Understanding that relationship is what turns template filling from guesswork into a mapping exercise.

  • One sheet per structure: a header sheet and one or more item or dependent sheets, joined by a key that you assign.
  • The key you put in the header sheet is yours, not SAP's. It links the rows across sheets during the load and is not the number the target document receives.
  • Mandatory fields are marked in the template. A blank mandatory field fails validation, which is the cheap failure. A wrong value in an optional field frequently loads and fails later.
  • Field-level help in the template names the target field, which is how you resolve a mapping question without guessing.
  • Do not add, rename, reorder, or delete columns in a delivered template. Structural changes belong in the migration object, not in the spreadsheet.
  • Very large files are a practical problem rather than a conceptual one. Split by a business key so a failed batch is re-runnable, rather than by row count.

The failures worth preventing

These account for most of the time lost in a migration cycle, and all of them are visible before the load.

  • Unmapped values. Every source value in a mapping-relevant field has to have a target value confirmed before simulation. An unconfirmed mapping stops the run, so confirm mappings as a task rather than as a reaction.
  • Dependency order. Loading a dependent object before its master data produces a wall of errors that all say the same thing. Load order is a design decision, not a runtime discovery.
  • Date and number formats that survived a spreadsheet round trip. A leading zero lost from an account or a material number is the classic one.
  • Units, currencies, and language keys that are valid in the source and not configured in the target.
  • Duplicate keys within the file, which produce partial loads that are harder to correct than a clean failure.
  • Configuration not yet in the target: number ranges, account determination, and organisational units the data references.

Simulate, then load, then reconcile

Simulation runs the object's logic without posting. Treat it as the gate, not as a formality, because a simulation error is cheap and a partial load is not.

  • Validate the file first. This catches structural and mandatory-field problems before anything else runs.
  • Confirm every mapping task. Mappings left open block the run and are the most common reason a cycle stalls overnight.
  • Simulate and read the messages by category rather than by row. The same root cause usually produces hundreds of rows.
  • Load, then reconcile immediately: record counts, control totals, and for financial objects the balance comparison against the source.
  • Keep the file, the mapping state, and the result together. Re-running a load six weeks later against a template nobody kept is how a cutover loses an evening.
  • Record the runtime. Migration Cockpit load times at production volume are the input to the cutover downtime budget, and they are rarely measured until the last rehearsal.

What the workflow must cover

  • Load order from dependencies. Derive the object load sequence from the data dependencies rather than from the order the templates were prepared.
  • Pre-load validation. Check mandatory fields, formats, duplicate keys, and referenced configuration before a load consumes a rehearsal window.
  • Reconciliation as an artifact. Compare source and target counts, control totals, and balances as a retained record rather than a verbal confirmation.
  • Runtime capture. Record measured load durations at production volume so the cutover downtime budget uses observation rather than estimate.

Implementation workflow

Start with a bounded customer scenario and explicit acceptance criteria. Preserve native SAP permissions and accountable review while the software creates a repeatable evidence chain.

  1. Confirm which objects and transfer approaches your release actually offers.
  2. Design the load order from object dependencies.
  3. Fill templates without changing their structure, and resolve mappings as a task.
  4. Validate, simulate, correct by root cause, then load.
  5. Reconcile immediately and record the runtime for the cutover budget.

Evidence to require

A transformation claim should resolve to observable artifacts, decisions, and execution receipts. Ask for the following evidence in a representative evaluation:

  • Object and approach availability for the release
  • Load order design
  • Template validation result
  • Mapping confirmation state
  • Simulation messages by root cause
  • Load result per object
  • Reconciliation output
  • Measured runtime at production volume

Boundaries and non-claims

Adranum separates analysis, proposal, human review, package creation, customer-local validation, and production execution. A later state never rewrites the evidence that supported an earlier decision.

  • The delivered migration object list and the supported transfer approaches vary by S/4HANA release and deployment. Verify in your own system.
  • A successful load is not a correct load. Only reconciliation against the source shows that.
  • Migration Cockpit covers the objects SAP delivers or you model. Everything else needs another path, and pretending otherwise costs a cycle.

Buyer checklist

  • Which transfer approach fits this object and volume?
  • Is the load order derived from dependencies?
  • Are all mapping tasks confirmed before simulation?
  • What does reconciliation compare, and against what source figure?
  • Has the load runtime been measured at production volume?

Practical answers

What is the difference between staging tables and file transfer in the Migration Cockpit?

Staging tables hold the data in database tables you can query, correct, and reload, which suits high volume and repeated cycles. File transfer uses templates a functional owner can fill, which suits smaller and business-owned objects. Availability depends on your release and deployment.

Can Migration Cockpit templates be modified?

Not by editing the spreadsheet structure. If you need an extra field or a different mapping, change the migration object in the Migration Object Modeler, then download a fresh template that reflects the change.

Why does a migration run stop waiting for mappings?

Because a mapping-relevant source value has no confirmed target value. Treat mapping confirmation as a scheduled task with an owner before simulation, rather than as something discovered when the run halts.

Continue the evaluation

Related SAP workflows