If an existing object in WSRR is selected to be the root of a new governed collection, the ServiceRegistryGovernance EJB method makeGovernable() must be invoked, passing the bsrURI for the root.
Assuming the root object is not already a governed object, and assuming any access control that might be in place allows the action, the result will be the creation of a new GovernanceRecord identifying the root of the governed object collection and identifying any related objects that form part of the same collection.
If multiple possible lifecycles have been defined in the governance state machine, an initialTransition parameter can be provided to select a transition to force the collection into the first state for a specific lifecycle. The list of potential initial transitions can be found by invoking the getInitialTransitions() method; only one of the values returned by this method, or null if no initial transition is required, can be provided for the initialTransition parameter. Note that the transition URI you specify must correspond to a state classification that exists in an OWL file stored in the registry, otherwise an exception will be thrown; see the Related link for further information.
The governance record will record the lifecycle state for the root object and all the objects in the governed collection in the form of the state classification URI. In addition, all objects that are contained in the governed collection and all logical objects derived from them will be classified with that same lifecycle state. It is an error to attempt to change this lifecycle state classification in any way other than through the ServiceRegistryGovernance EJB itself; an exception will be thrown if changes are attempted to be made in any other way.