Workday errors in plain English.

Submit an Error
errors / soap-web-services / soap-ox-composite-report-migration-specified-hierarchic-reference

OX Composite Report Migration Fails: "Specified_Hierarchic_Reference" Validation Error

✓ Verified SOAP Web Services 6 lookups
The error <faultcode>SOAP-ENV:Client.validationError</faultcode><faultstring>Validation error occurred. The entered information does not meet the restrictions defined for this field. (Specified_Hierarchic_Reference).</faultstring>

What it means

A Composite Report migrated with Object Transporter fails on a specific row's hierarchic reference, even though every sub-report and dependent object migrated fine. The fault's XPath points at a row inside the report's region data, but gives no readable detail about why. The real cause is usually a misconfigured row that Workday already flags as a migration risk in the UI, just not inside the OX fault itself.

Troubleshooting

  1. Read the fault's XPath (in the detail block) to identify which row index inside the report's Composite_Report_Region_Data is failing.
  2. In the source tenant, open the report and use Related Actions > Print (or Preview) rather than trying to debug from the OX error alone. Workday shows a distinct warning banner listing exactly which rows have misconfigured filter criteria that could impact migration.
  3. For each flagged row, check whether its underlying reference (a Ledger Account Summary, cost center hierarchy, or similar) is fully configured, for example a Ledger Account Summary with no Ledger Accounts assigned.
  4. Fix or remove the misconfigured row and re-run the print preview to confirm the warning clears before re-attempting the OX migration.
⚡ Quick fix

Open the report in the source tenant and check Related Actions > Print for a migration-risk warning naming the specific row, then remove or fix that row's reference (for example a Ledger Account Summary with no accounts assigned) and re-run the migration.

✓ Permanent fix

Before migrating any Composite or Matrix report with Object Transporter, check the report's Print or Preview output in the source tenant first, since Workday's own migration-risk warnings there are far more specific than the SOAP fault OX ultimately throws. Add this check to the migration runbook rather than debugging blind from the XPath.

Was this helpful?

Related errors