Specifying searching for an object by object ID
The EditByObjId attribute specifies how Metrics Management searches objects in the database for imports that contain the Edit or Add_Edit action. The EditByObjId attribute specifies whether Metrics Management searches on object name or object ID, or on both values. Consider using the EditByObjId attribute to import measures by object ID if you expect measure names to change. Enter the EditByObjId in the XML header in the import file. The EditByObjId attribute accepts the values listed in Table 6‑1.
Table 6‑1 EditByObjId attribute values
Value
Metrics Management searches for objects in the database by
0
Object name. Using the Edit action, if the object name is not found, the object import fails.
1
Object name. Using the Edit action, if the object name is not found, Metrics Management searches by object ID. If both values are not found, the import fails.
2
Object ID. Using the Edit action, if the object ID is not found, Metrics Management searches by object name. If both values are not found, the import fails.
3
Object ID. Using the Edit action, if the object ID is not found, the object import fails. Using the Add_Edit action, if the object ID is not found, the object is added as a new object.
4
Object name and object ID. Using the Edit action, if both values are not found, the object import fails. Using the Add_Edit action, if both values are not found, a new object is created.