Understand how UCO-enabled objects are added to the MES database as entities

In the following example, if you select the UCO that is a child of the AAS_1_SQA_1 object, the Entity Model Builder creates MES entities only for the objects above it in the branch, up to and including the Bearing Plant (area). The utilization, OEE, and job production attribute configuration information is extracted from the UCOs and stored as the corresponding property settings for the target entity (in this case, the AAS_1_SQA_1 entity).

The following figure shows the resulting entity tree in MES Client. You could also have selected the parent application object that has a UCO child attached to it and then run Entity Model Builder to create the same structure.

Since the other UCOs in the same equipment model are not directly part of the selected equipment tree branch, they are not included in the entity creation because they are not part of the direct parent/child equipment structure to the AAS_1_SQA_1 object.

Note the following additional behaviors about UCOs and using Entity Model Builder to create or modify their entities in the MES database:

• If you select multiple application objects with UCOs, the Entity Model Builder creates entities for all of them.

• If the selected application object is not a UCO, does not have a UCO below it, and is not part of a utilization/OEE configuration hierarchy, then the Entity Model Builder does not create any entities.

• The Entity Model Builder only creates new entities and new entity hierarchies that do not already exist.

• To delete an entity, you must delete it using MES Client. For more information on managing entities, see the MES Client User Guide.

• If there is already an entity in the MES database with the same name as the application object with a UCO, Entity Model Builder will overwrite its corresponding properties with the UCO attribute settings.

• Though the Entity Model Builder never deletes an existing entity or removes any capabilities (including UCO capabilities), it can re-parent entities at any level to reflect new structural changes to the System Platform equipment model hierarchy.

• When the Entity Model Builder encounters an error, the error will be indicated in the progress window and the UCO will remain in the unsynchronized state. It will not be possible to deploy or redeploy the UCO until it is synchronized with the MES database. Additional diagnostic information is also available in the Logger.