TeamcenterKnowledge

Setup Prerequisites

Migrate absolute alignment data as relative alignment data

Design occurrences and part occurrences can be aligned based on their absolute position or relative position. The absolute position of an occurrence is its position in a structure with respect to the topmost part of the structure irrespective of whether the occurrence belongs to another assembly within the structure. The relative position of an occurrence is its position with respect to the assembly it belongs to.

Restrictions and limitations

The newest Teamcenter solution to perform design and engineering BOM (Usage BOM or Assembly BOM) alignment supports only relative alignment. If a different Teamcenter solution is already set up for alignment, you must migrate the existing absolute alignment data as relative alignment data.

Procedure

  1. Install Product Master Automation for design and engineering BOM alignment.

  2. Disable the existing alignment application and enable the new alignment functionality.

  3. Run the following utility at the Teamcenter command prompt to migrate the absolute alignment data as relative alignment data:

    cba_migrate_design_ebom -u=user_id {-p=password | -pf=password_file} -g=group -dbomroot=dbom_item_id -drevrule=dbom_revision_rule -ebomroot=ebom_item_id -erevrule=ebom_revision_rule -log=absolute_path_to_logfilename -report=absolute_path_to_fileName -removeJT=true/false
    

    Here, the -log and -report arguments are optional.

    For more information about this utility, see its help: cba_migrate_design_ebom -h

Results

After the data is migrated, a migration report is available in the file name that you specified in the -report argument of the cba_migrate_design_ebom utility. In case you did not specify a location in the -report argument, the report is available in the folder from where you ran the cba_migrate_design_ebom utility.

The column Displays
Status Any alignment data that failed to migrate. A link is created between the design and its corresponding part when the data is migrated successfully.
Error Info Information related to the error returned by the migration utility.
CBA1 publish link ID The absolute alignment links that are found by the utility before the migration.
New CBA3 publish link ID The alignment links that are newly created by the utility after the migration.
pma0IsPartRequired Property Any change made to the pma0IsPartRequired property of a design.
fnd0AssemblyIndicator Property Any change made to the fnd0AssemblyIndicator property of a design.
fnd0HasMultipleDesigns Property Any change made to the fnd0HasMultipleDesigns property of a part.

Source: https://docs.sw.siemens.com/en-US/doc/282219420/PL20251212545240207.dbom_ebom_alignment_admin/xid2132884 · retrieved 2026-07-11