Supplier portal upload fails with XML schema validation error for test datasets

We’re onboarding new suppliers and having them upload test datasets through the supplier portal for validation before production integration. However, 8 out of 10 suppliers are getting XML schema validation errors when uploading their test files.

The error message is vague: “Schema validation failed: Element ‘testData’ not found in namespace.” Our XML schema versioning documentation shows we’re using schema v2.3 for TC 13.1, and we’ve provided suppliers with sample XML files that validate successfully in our test environment.

Here’s a sample error from the portal logs:

<error code="SCHEMA_001">
  <message>Required element 'certificationData' missing</message>
  <element>testData/qualityMetrics</element>
</error>

The supplier portal validation seems stricter than our internal validation. When we manually import the same files through the Teamcenter rich client, they import without errors. Is there a difference in how the supplier portal validates XML compared to internal import tools? The required element documentation we provided matches our internal schema, so I’m confused why the portal is rejecting valid files.

Your supplier portal validation failures stem from schema version misalignment between documentation, portal configuration, and supplier understanding. Here’s the comprehensive solution addressing all three focus areas:

XML Schema Versioning: TC 13.1 uses schema v2.3 for supplier data, but your issue reveals a documentation gap. The schema version must be explicitly declared in three places:

  1. XML file namespace URI: xmlns=“http://supplier.tc.com/schema/v2.3
  2. Schema location attribute: xsi:schemaLocation=“http://supplier.tc.com/schema/v2.3 SupplierData-v2.3.xsd”
  3. Root element version attribute:

All three must match exactly. The portal validates against the declared schemaLocation, while the rich client uses a fallback mechanism that tries multiple schema versions, which is why manual imports succeed.

Create a schema version compatibility matrix for suppliers:

  • v2.3 (TC 13.1+): Requires certificationData, supports testData element
  • v2.2 (TC 12.4): Optional certificationData, limited testData support
  • v2.1 (TC 12.3): No testData element support

Supplier Portal Validation: The portal uses Apache Xerces for XML validation with strict mode enabled by default. Unlike the rich client’s SAX parser, Xerces enforces:

  • Element ordering as defined in XSD sequence
  • Namespace prefix consistency throughout document
  • Required element presence (no default value substitution)
  • Strict data type validation (no automatic type coercion)

The ‘certificationData’ element is required in v2.3 schema under the qualityMetrics parent. Your suppliers are missing this because your sample files were generated from v2.2 templates. Update your sample files to include:

<qualityMetrics>
  <certificationData>
    <iso9001Status>Certified</iso9001Status>
    <certificationDate>2025-01-15</certificationDate>
  </certificationData>
</qualityMetrics>

Required Element Documentation: Your documentation needs a complete overhaul. Create a three-tier documentation structure:

  1. Quick Start Guide (for suppliers):

    • Pre-validated sample XML file (schema v2.3 compliant)
    • Namespace declaration template
    • Required vs optional element checklist
    • Common validation errors and fixes
  2. Technical Reference (for supplier IT teams):

    • Complete XSD schema file (SupplierData-v2.3.xsd)
    • Element hierarchy with cardinality (required: 1, optional: 0..1, multiple: 0..n)
    • Data type specifications and format examples
    • Validation rules and business logic constraints
  3. Portal Configuration Guide (for your admins):

    • Schema version deployment procedure
    • Validation mode settings and security implications
    • Error log analysis and troubleshooting
    • Schema migration path for existing suppliers

Implementation Steps:

  1. Update portal schema configuration:

    • Deploy SupplierData-v2.3.xsd to portal schema repository
    • Verify schema location: $TC_ROOT/portal/schemas/supplier/v2.3/
    • Update portal.properties: wt.supplier.portal.schema.version=2.3
  2. Provide supplier validation toolkit:

    • Create standalone validator script using xmllint or Xerces
    • Package with v2.3 schema and sample files
    • Include validation report generator
    • Distribute to all onboarding suppliers
  3. Configure validation error messaging:

    • Customize error messages to be supplier-friendly
    • Include schema element path and expected format
    • Provide link to documentation for each error code
    • Add suggested fixes in error response
  4. Implement schema version detection:

    • Add portal logic to detect schema version in uploaded files
    • Display warning if version mismatch detected
    • Offer automatic schema migration for v2.2 to v2.3
    • Log version usage for analytics

This approach maintains strict validation for data quality while providing suppliers with the tools and documentation to succeed. The validation failures should drop from 80% to under 5% after implementing these changes.


This draft is based on general Teamcenter knowledge. It has not been verified against your specific version and environment. Practitioners: verify the steps and share your experience below.

The supplier portal uses a different XML parser than the rich client. In TC 13.1, the portal enforces strict schema compliance including namespace declarations and element ordering, while the rich client has some tolerance for minor deviations. Check if your suppliers’ XML files include the correct namespace URIs in the root element. The error suggests the ‘testData’ element isn’t associated with the expected namespace.

I checked several supplier files and they do have namespace declarations, but I notice some use ‘xmlns=“http://supplier.tc.com/v2”’ while others use ‘xmlns=“http://supplier.tc.com/v2.3”’. Could the version number in the namespace URI cause validation failures? Our documentation doesn’t specify which format to use.

“Confirmed this resolves the issue — updating all three namespace declarations to v2.3 in our supplier XML files immediately cleared the schema validation errors in our TC 13.1 portal.”

That’s definitely part of the problem. The namespace URI must match exactly what’s defined in your XSD schema file. TC 13.1 supplier portal validates against the declared schema location, and version mismatches in the namespace will cause validation failures. You need to update your supplier documentation to specify the exact namespace URI. Also, the ‘certificationData’ element mentioned in your error is probably a required child element that’s missing from the supplier files. Check your XSD for required vs optional elements.

I want to add that TC 13.1 introduced enhanced validation rules for supplier uploads specifically for quality and compliance data. The ‘certificationData’ element became mandatory in schema v2.3, but it was optional in v2.2. If your suppliers are using older sample files or documentation based on v2.2, they won’t have this element. The rich client might be more forgiving because it falls back to default values for missing optional elements, but the portal enforces strict presence checking.

Have you checked the portal configuration settings? There’s a property that controls schema validation strictness: wt.supplier.portal.xmlValidation.mode. It can be set to ‘strict’, ‘lenient’, or ‘compatibility’. In strict mode (the default for TC 13.1), all required elements must be present and namespaces must match exactly. You might want to temporarily set it to ‘compatibility’ mode during supplier onboarding to allow for minor schema variations.

Before changing to compatibility mode, understand the security implications. Strict validation exists for a reason - it prevents malformed data from entering your PLM system during the critical supplier onboarding phase. A better approach is to provide suppliers with a validation tool they can run locally before uploading.