CAD and part BOM action handlers

Two action handlers are provided to make CAD bill of materials (BOM) design to part BOM alignment easier. Both parse the inputs and call USER ITKs. These ITKs can be customized.

ME-update-part-alignment-on-design-change-AH

This action handler updates part revisions in a part BOM related to an input CAD BOM design revision.

• The target folder requires a new design revision.

• The reference folder can optionally contain a previous design revision. If a reference folder is not provided, the handler tries to find a previously linked design revision.

• Action handler mandatory argument:  -forceupdate

• Allowed values:

0

Error if part is not writable.

1

Force update if part is not writable.

2

Revise part and update if part is not writable.

Copy

/**
     @returns
        <ul>
          <li>#ITK_ok on success.
          <li>#POM_invalid_tag if either one of @p new_design_revision and @p 
              old_design_revision are invalid.
          <li>Possibly other errors. 
        </ul>
    */
    extern ME_API int USER_update_part_rev_from_design_rev(
      tag_t new_design_revision,  /**<(I) The new design revision that is to replace 
         the old design revision.*/
      tag_t old_design_revision,  /**<(I) The old design revision that is to replaced 
          with the new design revision.*/
      unsigned int actionIfPartRevIsReleased  /**<(I) Perform action. Valid values are:
          <ul>
             <li>#ME_ERROR_IF_PART_RELEASED to return an error if the part revision to 
                  be aligned is not modifiable. 
                  <br/>This is also the default value if an invalid action is specified.
             <li>#ME_UPDATE_RELEASED_PART_REVISION to overwrite released part revision on align.
             <li>#ME_REVISE_PART_REVISION to revise the non-modifiable part revision and align.
          </ul>*/
    );

ME-update-part-bom-alignment-to-mature-design-AH

This action handler recursively aligns previously aligned part lines in a part BOM to a currently configured design revision in a CAD BOM that matches maturity criterion.

• The maturity criterion can be customized using #USER_is_item_rev_mature.

• If the MEDesignToBom_check_maturity preference value is false, the alignment considers the currently configured design revision as mature. The target folder requires a collaboration context containing one design scope line and one part scope line.

Copy

/**
     @returns
        <ul>
          <li>#ITK_ok on success.
          <li>#POM_invalid_tag if an invalid collaboration context, part 
             or design in @p cc, @p design_scope_line or @p part_scope_line is invalid. 
          <li>Possibly other errors.
        </ul>
    */
extern ME_API int USER_update_part_bom_alignment_to_mature_design(

Related Topics

• What is a part BOM and why use it?