We have introduced a standard format for BOM (Bill of Materials) named WATS Standard BOM Format (WSBF) which is based on XML. This format enables easier integration for 3rd party systems to add BOM lists to WATS, for use during Repair (UUR) / Rework.
1. Format definition
The structure of the format is based on two XML elements named BOM (Header) and Component (List).
|Partnumber||Product Part Number (Required)|
|Revision||Product Revision (Required)|
|Number||Component Part Number (Required)|
|Rev||Component Revision (Required)|
|FunctionBlock||Mapping to function block on article|
|Qty||Quantity of component references|
|Ref||Component references (Required) - references must be separated by semicolon|
The components might be added in two different ways.
- Unique components (Number/Rev)
- Non-unique components (same Number/Rev) with unique component references
An XML example and the XSD schema is found at the bottom of this article. You may use Microsoft .NET framework to build the BOM lists using our class definition WATS WSBF.cs, and for an example on how to build, please see WATS WSBF Example.cs.
2. Upload using Product Manager in Control Panel
Browse to the Product Manager and select Part number/Revision. Choose the "BOM" tab and upload BOM.
3. Upload using WATS Rest API
To use the API, you must authenticate all requests (please see Authentication). As an example, using Postman, you will need to send the XML in the body using a PUT request.
Note that the PUT request will fail if one of the following criteria are met:
- XML was not sent in the request body
- BOM element is missing part number and/or revision
- BOM element does not contain any components
- BOM element contains components without Number
After a successful response, a product and product revision are inserted (unless they already exist) in the database, based on the Part Number and Revision specified in the BOM. Inserted products/revisions can be seen using the Product Manager. Uploading a BOM will overwrite if there's already an existing one for the product revision.
4. Use BOM during UUR (Repair) / Rework
After the BOM is uploaded, the repair operation might need some adjustments based on your requirements. By default, a repair operation has the BOM binding set to Optional. This means that the operator can skip using the BOM list and provide a custom component reference if it matches the operation's CompRef mask.
Component references from the BOM list can be used during repair if the BOM binding is set to Optional or Required.