KB: PLM Synchronization Fails When Part Number Is Used as Source Criteria

Solution Details

Synchronization Failure When Filtering by Part Number

Source criteria are used to filter and select components for PLM synchronization. If the primary key attribute, such as Part Number, is used as a source criteria filter, synchronization may fail with the following error:

[PLM id <unknown>]: (400) You must give a value for required attribute Number. [HTTP/1.1 400 400]

This issue affects component synchronization configurations that attempt to filter components using a value that is not available prior to synchronization.

Primary Key Is Created During Synchronization

Part Number is generated during the PLM synchronization process. When it is used as a source criteria filter, the system cannot correctly identify or match components before synchronization occurs. As a result, validation of required attributes fails and the synchronization process returns the error indicating that the required Number attribute is missing.

Use Preexisting Attributes for Component Selection

• Do not use Part Number as a source criteria filter for multi-component synchronization.
• Use attributes that exist before synchronization, such as Component Type or Folder Name.
• If synchronizing a single component, ensure the Part Number specified in the configuration exactly matches the value assigned to the component.
• For single-side synchronization (To Altium or To PLM), manually populate the primary key value before synchronization.

Update Configuration and Retry Synchronization

Checkpoints Before You Start

• Ensure you have access to the correct XML configuration file.
• Verify which attributes exist before synchronization.
• Validate that the new attribute is correctly formatted in XML.
• Confirm the Part Number matches exactly in both the XML configuration and design tool when synchronizing a single component.
• Run XML validation before proceeding.
• Review logs after synchronization to confirm successful processing.
• Ensure any manually entered Part Number value is accurate for single-side synchronization.

1. Review the XML Configuration

   • Open the XML configuration file used for PLM synchronization.
   • Locate the <SourceCriteria> section.
   • Check whether Part Number is being used as a filter.

2. Verify Source Criteria Usage

   • Confirm that source criteria are intended to select components for synchronization.
   • Ensure Part Number is not used as a filter unless synchronizing a single known component.
   • Select an alternative attribute such as Component Type or Folder Name for broader synchronization scenarios.

3. Remove or Replace the Incorrect Filter

   If Part Number is listed under <SourceCriteria>, remove it and replace it with an attribute that exists before synchronization.

   <SourceCriteria>
       <ns2:Attribute>
           <ns2:Key>Component Type</ns2:Key>
           <ns2:Value>Capacitor Ceramic</ns2:Value>
       </ns2:Attribute>
   </SourceCriteria>

4. Validate Single-Component Synchronization Settings

   • Verify that the component contains the exact Part Number specified in the XML file.
   • Confirm the value in the design tool before starting synchronization.

5. Validate and Save the Configuration

   • Validate the XML syntax.
   • Save the updated configuration file.

6. Retry PLM Synchronization

   • Run the synchronization process again.
   • Confirm that the error no longer appears.
   • Review synchronization logs to verify successful component processing.

7. Configure Single-Side Synchronization Correctly

   • If synchronization is configured as To Altium or To PLM, manually populate the primary key value.
   • No Create & Update option is available in this synchronization mode.
   • Generate the PLM Part Number manually and populate the corresponding Altium Component parameter before synchronization.

Additional Notes

For single-component synchronization scenarios that rely on Part Number filtering, the configured Part Number value must exactly match the component value available in the design environment.

References

• Altium On-Prem Enterprise Server: PLM Integration
  • Sync Parameters - Add Parameter Criteria