Services#
ValidatePlacementList#
A BOM is Valid if:
- All the Reference Designators match MES BOM's Designators;
- All Products or a subset of them exist in the MES BOM.
The configuration entry, /SMT/PreBomCheck/UseCaseSensitive, determines whether case sensitivity is enforced when comparing the Product Name and Reference Designator lists from the equipment with those defined in the BOM. By default, this setting is set to false.
ValidatePlacementList service signature
The input object ValidatePlacementListInput contains the following information:
| Name | Type | Description |
|---|---|---|
| ResourceName | String | Resource where the validation should take place |
| MaterialName | String | The panel code to be validated |
| PlacementLists | List of ComponentPlacements | Components list grouped by ReferenceDesignators, containing the ReferenceDesignators and a list of ComponentNames |
The output object ValidatePlacementListOutput contains the following information:
| Name | Type | Description |
|---|---|---|
| BomValid | Boolean | Comparison result |
| ProductName | String | Material product name |
| ProductBomName | String | Resolved BOM name |
Error Translations#
The localized messages used by the service are:
- IoTValidatePlacementListDuplicateComponentName
- Component list of reference has a duplicate component name
- IoTValidatePlacementListDuplicateReferenceDesignator
- Placement list has a duplicate reference designator
- IoTValidatePlacementListSubstituteBOMEntryMismatch
- The reference designators of the substitute BOM entry don't match the parent BOM entry's reference designators.
Pre Conditions:#
- Material must exist in system;
- Resource must exist in system;
- PlacementLists cannot be empty;
- BOMContext SmartTable must be correctly configured for the current Step and BOM material product;
- Designators are unique and the Substitutes have the same designator or empty.
At MES, similar BOM items should be grouped by Designator field. Check this example:
If you have Substitute Products configured they must not have Designator filled or have the same Designator as parent Product:
BOM Context smart table should be correctly defined, for example:
