GetObjectStatusInTool As ObjectStatusInTool - Integration - Update 44 - Help - Hexagon

SmartPlant Integration COM Help

Language
English
Product
Integration
Search by Category
Help
SmartPlant Foundation / SDx Version
10
Smart P&ID Version
9 (2019)
Smart Engineering Manager Version
10 (2019)

Description

This method checks the status of an object in the design tool. This call is made to the design tool when an object is found to be missing from the published data, but was previously published or claimed. Such an object was either deleted, moved, unclaimed, or given a new ID (UID updated). The return value should be one of the following enumerations.

enum (

Deleted = 1,

Moved = 2,

Unclaimed = 3,

UIDUpdated = 4

} ObjectStatusInTool

If the return value is Deleted, a tombstone will be generated. If the return value is Moved, the object will be added to a moved object collection. If the return value is Unclaimed, an unclaim instruction is generated, and the object will be added to the unclaimed object collection in SmartPlant Foundation.

If the return value is UIDUpdated, sObjNewUID must be returned with the new UID value of the object. For UIDUpdated status, an UpdateUIDInstruction is generated.

This method is also called when the existence of a moved object is checked.

Arguments

Name

Data type

Input/output

Description

sObjUID

String (maximum 128 characters)

Input

UID of the object.

sObjName

String (maximum 256 characters)

Input

Name of the object.

sClassUID

String (maximum 128 characters)

Input

UID of the class definition of the object.

sObjNewUID

String (maximum 128 characters)

Input

The new UID of the object. This value is returned only when the method return status is UIDUpdated.

Return Value

ObjectStatusInTool

Comments

If the method fails, the tool will raise an error and set Err.Number and Err.Description appropriately.