ManufacturingKnowledge

Configuring Teamcenter Easy Plan > Configuring common Easy Plan options

Customize work package structure names

You can customize standard work package structure names, such as EBOM, MBOM, Process, and Plant. Work packages often contain different structures, which are based on customer data and industry.

Prerequisites

You must have DBA privileges to perform these operations and modify the EP_StructureTypeToDisplayNameDataset preference.

Procedure

  1. Using a text editor, prepare a JSON file.

                 A JavaScript Object Notation (JSON) file is a text-based
                     schema file format used for storing and exchanging data.
                 
                     
                         Top-level keys are structure types, for example,
                             engineering bill of materials (EBOM), manufacturing bill of
                             materials (MBOM), and bill of process (BOP).
                     
                     
                         Each structure type contains key-value pairs:
                                 
                                     The key is the Item Type, such as `Item`or `Erm0RecProcedure`.
                                 
                                 
                                     The value is the display name to be
                                         displayed on the Manage Work
                                             Package page.
                                 
                                 
                                     The special key `Default` provides a default display name
                                         for empty tiles.
                                 
                             
                     
                 
                 Example 
                     SampleStructureDisplayNamesDataset.json
                     Copy`{
    

     "Ebom": {      "Default": "Formula",      "Item": "Formula",       "CPGFormulaMater": "Formula", "PmgOItemSKU": "Formula", "PmgOItemSKUME : "Formula"      },      "Mbom": {      "Default": "Manufacturing Formula",      "Item": "Manufacturing Formula"       "CPGFormulaMater": "Manufacturing Formula", "PmgOItemSKU": "Manufacturing Formula", "PmgOItemSKUME : "Manufacturing Formula"      },      "Bop": {      "Default": "Recipe",      "Erm0RecProcedure": "Recipe",      "Erm0GenRecipProc": "Recipe",      "Erm0LabRecipProc": "Recipe",      "Erm0SiteRecProc": "Recipe"      }  }`

  1. Do one of the following.

                     To create a dataset and update the
                             EP_StructureTypeToDisplayNameDataset
                         preference, from the Teamcenter command prompt, run the
                             update_pref_ep_structure_type_to_display_name_dataset
                         utility.
                     Example 
                         `update_pref_ep_structure_type_to_display_name_dataset
                                 -u=dba_user -p=dba_password -g=dba -mode=import -target=GROUP
                                 -scope=SITE -d=SampleStructureDisplayNamesDataset
                                 -f=SampleStructureDisplayNamesDataset.json`
                     
                     The utility creates a dataset of the type Text with your JSON file, and the
                             EP_StructureTypeToDisplayNameDataset preference is
                         updated with the dataset UID. On the Manage
                             Work Package page, structure types display your custom
                         display names.
                 
                 
                     Manually update the
                             EP_StructureTypeToDisplayNameDataset
                         preference.
                     
                         In Teamcenter, create a new
                                 dataset of the type Text,
                                 and attach your  JSON file to the dataset.
                         Use the database_walker utility or Teamcenter
                                 queries to locate the ObjectUID of the
                                 new dataset.
                         Set the value of the
                                     EP_StructureTypeToDisplayNameDataset
                                 preference to the located
                             ObjectUID.
    

Results

On the Manage Work Package page, structure types are displayed using your custom display names.

Example

The standard structure display names are EBOM, MBOM, Process, and Plant.

The custom structure display names for the Enterprise Recipe Management (ERM) industry are Formula, Manufacturing Formula, Plant, and Recipe.

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