wt.change2
Class StandardChangeService2

java.lang.Object
  extended bywt.services.StandardManager
      extended bywt.change2.StandardChangeService2
All Implemented Interfaces:
ChangeService2, Manager, NetFactor, Serializable

public class StandardChangeService2
extends StandardManager
implements ChangeService2, Serializable

Standard server-side implementation of the ChangeService2 interfaces. The public, static methods in this class are accessed through the syntax:

 ChangeHelper2.service.[method] 

Use the newStandardChangeService2 static factory method(s), not the StandardChangeService2 constructor, to construct instances of this class. Instances must be constructed using the static factory(s), in order to ensure proper initialization of the instance.



Supported API: true

Extendable: false

See Also:
ChangeService2, ChangeService2Fwd, ChangeHelper2, Serialized Form

Field Summary
private static String CLASSNAME
           
private static String OID
           
private static int PC_QUERY_SIZE
           
private static boolean proIInstalled
           
private static String RESOURCE
           
private static String ROLE_A
           
private static String ROLE_B
           
private static boolean USE_FOLDER_DELEGATE
           
private static boolean USE_LIFECYCLE_DELEGATE
           
private static boolean VERBOSE
           
private static boolean WINDCHILL_PDM
           
 
Fields inherited from class wt.services.StandardManager
 
Fields inherited from interface wt.change2.ChangeService2
PENDING_ORDER_STATES, PENDING_REQUEST_STATES
 
Fields inherited from interface wt.services.Manager
MANAGER_SERVICE, STARTUP_AUTOMATIC, STARTUP_MANUAL, STATUS_EMERGENCY_SHUTDOWN, STATUS_EMERGENCY_SHUTTING_DOWN, STATUS_SHUTDOWN, STATUS_SHUTDOWN_ERRORS, STATUS_SHUTDOWN_FAILURE, STATUS_SHUTTING_DOWN, STATUS_STARTED, STATUS_STARTED_ERRORS, STATUS_STARTING_UP, STATUS_STARTUP_FAILURE
 
Constructor Summary
StandardChangeService2()
           
 
Method Summary
protected  void assignLocation(ChangeItemIfc target)
          Assign a folder or cabinet location through a delegate.
protected  ChangeItemIfc assignLocation(ChangeItemIfc target, ChangeItemIfc source)
          Assign a folder or cabinet location through a delegate, based on the folder or cabinet of another change object.
protected  ChangeItemIfc changeFolder(ChangeItemIfc target, ChangeItemIfc source)
           
private  void checkChangeItemLock(Lockable target)
           
private  void checkChangeItemModification(Persistable target, String messageID)
           
protected  void checkDeleteOfChangeable(Changeable2 deleteTarget)
          On a PersistenceManager PRE-DELETE event, prevent deleting a Changeable object that is attached to a change object.
protected  void checkDeleteOfChangeableCollection(WTArrayList target_list)
           
protected  void checkDeleteOfChangeRecord(ChangeRecordIfc target)
           
protected  void checkLocation(FolderEntry target)
           
protected  void checkModifyOfAffectedActivityData(AffectedActivityData target)
           
protected  void checkModifyOfChangeRecord(ChangeRecordIfc target)
           
protected  void checkModifyOfRelevantAnalysisData(RelevantAnalysisData target)
           
protected  void checkModifyOfRelevantRequestData2(RelevantRequestData2 target)
           
protected  void checkStoreOfAffectedActivityData(AffectedActivityData target)
           
protected  void checkStoreOfChangeRecord(ChangeRecordIfc target)
           
protected  void checkStoreOfFormalizedBy(FormalizedByIfc target)
           
protected  void checkStoreOfRelevantAnalysisData(RelevantAnalysisData target)
           
protected  void checkStoreOfRelevantRequestData2(RelevantRequestData2 target)
           
protected  void checkStoreOfReportedAgainst(ReportedAgainst target)
           
protected  void chooseLifeCycle(ChangeItemIfc ci)
           
protected  void copyChangeableLinks(Changeable2 original, Changeable2 working)
           
protected  void copyChangeableLinks(WTKeyedMap changeable_map, WTCollection changeable_list)
           
 AddressedByIfc deleteAddressedBy(ChangeRequestIfc cr, ChangeOrderIfc co)
          Delete the AddressedByIfc relationship implied by the two arguments.
 AffectedActivityData deleteAffectedActivityData(AffectedActivityData aad)
          Delete the AffectedActivityData relationship only.
 AnalysisActivityIfc deleteAnalysisActivity(AnalysisActivityIfc aa)
          Deletes the concrete subclass of AnalysisActivityIfc from the database.
 ChangeActivityIfc deleteChangeActivity(ChangeActivityIfc ca)
          Deletes the concrete subclass of ChangeActivityIfc from the database.
 ChangeInvestigationIfc deleteChangeInvestigation(ChangeInvestigationIfc ci)
          Deletes the concrete subclass of ChangeInvestigationIfc from the database.
 ChangeIssueIfc deleteChangeIssue(ChangeIssueIfc ci)
          Deletes the concrete subclass of ChangeIssueIfc from the database.
protected  void deleteChangeLinks(WTCollection changeableList)
          Delete change item links with given changeables
 ChangeOrderIfc deleteChangeOrder(ChangeOrderIfc co)
          Deletes the concrete subclass of ChangeOrderIfc from the database.
 ChangeProposalIfc deleteChangeProposal(ChangeProposalIfc cp)
          Deletes the concrete subclass of ChangeProposalIfc from the database.
 ChangeRecord2 deleteChangeRecord(ChangeRecord2 cr)
          Delete the ChangeRecord2 relationship only.
 ChangeRequestIfc deleteChangeRequest(ChangeRequestIfc cr)
          Deletes the concrete subclass of ChangeRequestIfc from the database.
 FormalizedByIfc deleteFormalizedBy(ChangeRequestIfc cr, ChangeIssueIfc ci)
          Delete the FormalizedByIfc relationship implied by the two arguments.
 FormalizedByIfc deleteFormalizedBy(Class linkClass, ChangeRequestIfc cr, ChangeIssueIfc ci)
          Delete the FormalizedByIfc relationship implied by the three arguments.
 RelevantAnalysisData deleteRelevantAnalysisData(RelevantAnalysisData rad)
          Delete the RelevantAnalysisData relationship only.
private static void dispatchVetoableEvent(String eventType, Object eventTarget, Object secondaryEventTarget)
           
private  void emitCAStateChangedEvent(ChangeActivity2 ca)
           
 Set filterForPendingChanges(Set changeable2Refs)
          Queries the database to compute the subset of the argument set of references to persistent Changeable2 objects whose members have pending changes.
private  WTArrayList filterTargets(WTCollection targets)
           
 ChangeRequestIfc findChangeRequest(Object theObject)
          Uses Change2DelegateFactory and FindChangeRequestDelegate mechanism to find the change request associated with the object passed in.
private  void fixDomainAssignment(CabinetMember target, FolderEntry source)
          Silently fixes the domain assignment of the non-Foldered target change object to match that of the source change object only if the cabinet previously assigned by the rules service (i.e., not assigned by a ChooseFolderDelegate) resulted in an incorrect domain assignment.
 QueryResult getAffectingChangeActivities(Changeable2 changeable)
          Returns a QueryResult of ChangeActivity2 objects related to the given Changeable2 object by the AffectedActivityData assocation.
 QueryResult getAffectingChangeActivities(Changeable2 changeable, boolean onlyChangeActivities)
          Returns a QueryResult of ChangeActivity2 objects related to the given Changeable2 object by the AffectedActivityData assocation.
 QueryResult getAnalysisActivities(Changeable2 changeable)
          Retrieves the AnalysisActivity objects related to the given Changeable2 object by the RelevantAnalysisData assocation.
 QueryResult getAnalysisActivities(Changeable2 changeable, boolean onlyAnalysisActivities)
          Retrieves the AnalysisActivity objects related to the given Changeable2 object by the RelevantAnalysisData assocation.
 QueryResult getAnalysisActivities(ChangeAnalysisIfc ca)
          Retrieves the AnalysisActivityIfc objects related to the given ChangeAnalysisIfc object by the DetailedByIfc assocation.
 QueryResult getAnalysisActivities(ChangeAnalysisIfc ca, boolean onlyAnalysisActivities)
          Retrieves the AnalysisActivityIfc objects related to the given ChangeAnalysisIfc object by the DetailedByIfc assocation.
private  SearchCondition getAttachedSc(Class link_class, String other_role, long[] target_ids)
           
 QueryResult getChangeables(AnalysisActivityIfc aa)
          Retrieves the Changeable2 objects related to the given AnalysisActivityIfc object by the ResearchedByIfc assocation.
 QueryResult getChangeables(AnalysisActivityIfc aa, boolean onlyChangeables)
          Retrieves the Changeable2 objects related to the given AnalysisActivityIfc object by the RelevantAnalysisData assocation.
 QueryResult getChangeables(ChangeIssueIfc changeIssue)
          Retrieves the Changeable2 objects related to the given ChangeIssueIfc object by the ReportedAgainst association.
 QueryResult getChangeables(ChangeIssueIfc changeIssue, boolean onlyChangeables)
          Retrieves the Changeable2 objects related to the given ChangeIssueIfc object by the Reported Against association.
 QueryResult getChangeables(ChangeRequestIfc cr)
          Retrieves the Changeable2 objects related to the given ChangeRequestIfc object by the RelevantRequestDataIfc assocation.
 QueryResult getChangeables(ChangeRequestIfc cr, boolean onlyChangeables)
          Retrieves the Changeable2 objects related to the given ChangeRequestIfc object by the RelevantRequestDataIfc assocation.
 QueryResult getChangeablesAfter(ChangeActivityIfc ca)
          Retrieves the Changeable2 objects related to the given ChangeActivityIfc object by the ChangeRecord2 assocation.
 QueryResult getChangeablesAfter(ChangeActivityIfc ca, boolean onlyChangeables)
          Retrieves the Changeable2 objects related to the given ChangeActivityIfc object by the ChangeRecord2 assocation.
 QueryResult getChangeablesAfter(ChangeOrderIfc co)
          Retrieves the Changeable2 objects related to the given ChangeOrderIfc object through its IncludedInIfc association with its ChangeActivityIfc and then by their ChangeRecord2 assocations.
 QueryResult getChangeablesAfter(ChangeOrderIfc co, boolean onlyChangeables)
          Retrieves the Changeable2 objects related to the given ChangeOrderIfc object through its IncludedInIfc associations with its ChangeActivityIfc object and then by their ChangeRecord2 assocations.
 QueryResult getChangeablesBefore(ChangeActivityIfc ca)
          Retrieves the Changeable2 objects related to the given ChangeActivityIfc object by the AffectedActivityData assocation.
 QueryResult getChangeablesBefore(ChangeActivityIfc ca, boolean onlyChangeables)
          Retrieves the Changeable2 objects related to the given ChangeActivityIfc object by the AffectedActivityData assocation.
 QueryResult getChangeablesBefore(ChangeOrderIfc co)
          Retrieves the Changeable2 objects related to the given ChangeOrderIfc object through the IncludedInIfc association with each of its ChangeActivityIfc objects and then by their AffectedActivityData assocation.
 QueryResult getChangeablesBefore(ChangeOrderIfc co, boolean onlyChangeables)
          Retrieves the Changeable2 objects related to the given ChangeOrderIfc object through the IncludedInIfc association of each of its ChangeActivityIfc object and then by their AffectedActivityData assocations.
 QueryResult getChangeActivities(ChangeOrderIfc co)
          Retrieves the ChangeActivityIfc objects related to the given ChangeOrderIfc object by the IncludedInIfc assocation.
 QueryResult getChangeActivities(ChangeOrderIfc co, boolean onlyChangeActivities)
          Retrieves the ChangeActivityIfc objects related to the given ChangeOrderIfc object by the IncludedInIfc assocation.
 QueryResult getChangeAnalysis(AnalysisActivityIfc aa)
          Retrieves the ChangeAnalysisIfc object related to the given AnalysisActivityIfc object by the DetailedByIfc assocation.
 QueryResult getChangeAnalysis(AnalysisActivityIfc aa, boolean onlyChangeAnalysis)
          Retrieves the ChangeAnalysisIfc object related to the given AnalysisActivityIfc object by the DetailedByIfc assocation.
 QueryResult getChangeInvestigations(ChangeRequestIfc cr)
          Retrieves the ChangeInvestigationIfc objects related to the given ChangeRequestIfc object by the ResearchedByIfc assocation.
 QueryResult getChangeInvestigations(ChangeRequestIfc cr, boolean onlyChangeInvestigations)
          Retrieves the ChangeInvestigationIfc objects related to the given ChangeRequestIfc object by the ResearchedByIfc assocation.
 QueryResult getChangeIssues(ChangeRequestIfc cr)
          Retrieves the ChangeIssueIfc objects related to the given ChangeRequestIfc object by the FormalizedByIfc assocation.
 QueryResult getChangeIssues(ChangeRequestIfc cr, boolean onlyChangeIssues)
          Retrieves the ChangeIssueIfc objects related to the given ChangeRequestIfc object by the FormalizedByIfc assocation.
 ChangeItem getChangeItem(Class theClass, long id)
          Retrieves the ChangeItem object that corresponds to the given Class and id.
 ChangeItem getChangeItem(String oid)
          Retrieves the ChangeItem object that corresponds to the given oid.
 QueryResult getChangeOrder(ChangeActivityIfc ca)
          Retrieves the ChangeOrderIfc object related to the given ChangeActivityIfc object by the IncludedInIfc assocation.
 QueryResult getChangeOrder(ChangeActivityIfc ca, boolean onlyChangeActivity)
          Retrieves the ChangeOrderIfc object related to the given ChangeActivityIfc object by the IncludedInIfc assocation.
 QueryResult getChangeOrders(ChangeRequestIfc cr)
          Retrieves the ChangeOrderIfc objects related to the given ChangeRequestIfc object by the AddressedByIfc assocation.
 QueryResult getChangeOrders(ChangeRequestIfc cr, boolean onlyChangeOrders)
          Retrieves the ChangeOrderIfc objects related to the given ChangeRequestIfc object by the AddressedByIfc assocation.
 QueryResult getChangeProposals(ChangeRequestIfc cr)
          Retrieves the ChangeProposalIfc objects related to the given ChangeRequestIfc object by the ResearchedByIfc assocation.
 QueryResult getChangeProposals(ChangeRequestIfc cr, boolean onlyChangeProposals)
          Retrieves the ChangeProposalIfc objects related to the given ChangeRequestIfc object by the ResearchedByIfc assocation.
 QueryResult getChangeRequest(ChangeAnalysisIfc ca)
          Retrieves the ChangeRequestIfc object related to the given ChangeAnalysisIfc object by the ResearchedByIfc assocation.
 QueryResult getChangeRequest(ChangeAnalysisIfc ca, boolean onlyChangeRequest)
          Retrieves the ChangeRequestIfc object related to the given ChangeAnalysisIfc object by the ResearchedByIfc assocation.
 QueryResult getChangeRequest(ChangeIssueIfc ci)
          Retrieves the ChangeRequestIfc object related to the given ChangeIssueIfc object by the FormalizedByIfc assocation.
 QueryResult getChangeRequest(ChangeIssueIfc ci, boolean onlyChangeRequest)
          Retrieves the ChangeRequestIfc object related to the given ChangeIssueIfc object by the FormalizedByIfc assocation.
 QueryResult getChangeRequest(ChangeOrderIfc co)
          Retrieves the ChangeRequestIfc object related to the given ChangeOrderIfc object by the AddressedByIfc assocation.
 QueryResult getChangeRequest(ChangeOrderIfc co, boolean onlyChangeRequest)
          Retrieves the ChangeRequestIfc object related to the given ChangeOrderIfc object by the AddressedByIfc assocation.
 QueryResult getChangingChangeActivities(Changeable2 changeable)
          Returns a QueryResult of ChangeActivity2 objects related to the given Changeable2 object by the ChangeRecord2 assocation.
 QueryResult getChangingChangeActivities(Changeable2 changeable, boolean onlyChangeActivities)
          Returns a QueryResult of ChangeActivity2 objects related to the given Changeable2 object by the ChangeRecord2 assocation.
private  long[] getChunk(long[] ids, int i)
           
 TableModel getCMIIBaseline(WTPart assembly)
          Queries the database to compute whether the argument reference to a persistent Changeable2 object has a pending change.
 String getConceptualClassname()
          Deprecated.  
private  String getDisplayName(Class object)
           
private  List getEffectivity(Changeable2 doc, WTPart part)
           
 ChangeRequest2 getFormalizingChangeRequest(ChangeIssue ci)
          Retrieves the ChangeRequest2 object that formalizes the given ChangeIssue object.
private  long getId(Persistable obj)
           
 QueryResult getImplementedChangeActivities(Changeable2 changeable)
          Returns a QueryResult of ChangeActivity2 objects related to the given Changeable2 object by the ChangeRecord2 assocation.
 QueryResult getImplementedChangeActivities(Changeable2 changeable, boolean onlyChangeActivities)
          Returns a QueryResult of ChangeActivity2 objects related to the given Changeable2 object by the ChangeRecord2 assocation.
private  ObjectIdentifier getOid(Object object)
          Returns object's associated oid.
private  String getOidString(Object object)
          Returns String representation of the object's oid (debugging).
 QueryResult getProblemProducts(ChangeIssueIfc changeIssue)
          Retrieves the WTProductMaster objects related to the given ChangeIssueIfc object by the ProblemProduct association.
 QueryResult getProblemProducts(ChangeIssueIfc changeIssue, boolean onlyProducts)
          Retrieves the WTProductMaster objects related to the given ChangeIssueIfc object by the ProblemProduct association.
 QueryResult getRelevantChangeRequests(Changeable2 changeable)
          Returns a QueryResult of ChangeRequest2 objects related to the given Changeable2 object by the RelevantRequestData2 association.
 QueryResult getRelevantChangeRequests(Changeable2 changeable, boolean onlyChangeRequests)
          Returns a QueryResult of ChangeRequest2 objects related to the given Changeable2 object by the RelevantRequestData2 association.
 Folder getRelevantFolder(ChangeItemIfc changeItem)
          Returns the folder that is 'relevant' for the argument change object.
 QueryResult getReportedAgainstChangeIssue(Changeable2 changeable)
          Returns a QueryResult of ChangeIssues objects related to the given Changeable2 object by the ReportedAgainst assocation.
private  ArrayList getRow(Changeable2 doc, String item_ad, String ad, WTPart part)
           
private  List getRows(int level, Set partUsages, String item_ad, View view)
           
private  List getRows(int level, WTPartUsageLink usage, String item_ad, View view)
           
private  Set getRows(Set changeables, String item_ad, String ad, WTPart part)
           
 QueryResult getSubjectProducts(ChangeRequestIfc cr)
          Retrieves the WTProductMaster objects related to the given ChangeRequestIfc object by the SubjectProductIfc assocation.
 QueryResult getSubjectProducts(ChangeRequestIfc cr, boolean onlyProducts)
          Retrieves the WTProductMaster objects related to the given ChangeRequestIfc object by the SubjectProductIfc assocation.
 QueryResult getUniqueAffectingChangeOrders(Changeable2 changeable)
          Returns a QueryResult of unique ChangeOrder2 objects that are indirectly related to the given Changeable2 object.
 QueryResult getUniqueImplementedChangeOrders(Changeable2 changeable)
          Returns a QueryResult of unique ChangeOrder2 objects that are indirectly related to the given Changeable2 object.
private  String getVersionInfo(Changeable2 changeable)
           
private  void handleLifeCycleException(ChooseLifeCycleDelegate delegate, LifeCycleManaged lcm)
          Throw an appropriate exception in response to a problem setting a life cycle on a new change object
 boolean hasPendingChange(ObjectReference changeable2Ref)
          Queries the database to compute whether the argument reference to a persistent Changeable2 object has a pending change.
private  boolean isAttached(long[] target_ids, Class link_class, String change_role)
           
private  boolean isCheckNeeded(Persistable object)
           
private  QuerySpec newChangeLinkSpec(Class linkClass, Class changeClass, String role, long[] oids)
          Returns a new query spec selecting the class name and OID of the changeables whose OIDs are specified, and are associated with the named link class (linking the changeable to the named change class).
private  WhereExpression newPendingChangeOrderExpression(FromClause fc, int idx)
          Returns a new where expression testing whether a change activity is associated with a pending change order, based on the from clause and index of a query selecting that change activity.
static StandardChangeService2 newStandardChangeService2()
          Default factory for the class.
static boolean pendingChangeExist(Object object)
          Deprecated. use ChangeHelper2.service.hasPendingChange(ObjectReference)
static boolean pendingChangeExist(ObjectReference objectRef)
          Deprecated. use ChangeHelper2.service.hasPendingChange(ObjectReference)
static Set pendingChanges(Set objectRefs)
          Deprecated. use ChangeHelper2.service.filterForPendingChanges(Set)
protected  void performStartupProcess()
          Listens for the following events: PRE_STORE Set number attribute on all change objects.
protected  void propagateDeleteToAnalysisActivity(ChangeAnalysisIfc deleteTarget, DetailedByIfc deleteLink)
           
protected  void propagateDeleteToChangeActivity(ChangeOrderIfc deleteTarget, IncludedInIfc deleteLink)
           
protected  void propagateDeleteToChangeAnalysis(ChangeRequestIfc deleteTarget, ResearchedByIfc deleteLink)
           
protected  void propagateDeleteToChangeOrder(ChangeRequestIfc deleteTarget, AddressedByIfc deleteLink)
           
private  void propagateFolderChange(ChangeAnalysisIfc order)
           
private  void propagateFolderChange(ChangeOrderIfc order)
           
private  void propagateFolderChange(ChangeRequestIfc request)
           
 void registerEvents(ManagerService managerService)
          Register events with the passed ManagerService.
private  boolean sameBranch(Iterated iter1, Iterated iter2)
          Returns whether two iterations belong to the same branch.
 AddressedByIfc saveAddressedBy(ChangeRequestIfc cr, ChangeOrderIfc co)
          Stores the given concrete subclass of AddressedByIfc in the database.
 Vector saveAffectedActivityData(Vector aadVector)
          Stores all the AffectedActivityData objects in the input vector and returns a vector of the persisted (or updated) AffectedActivityData objects.
 AnalysisActivityIfc saveAnalysisActivity(ChangeAnalysisIfc ca, AnalysisActivityIfc aa)
          Stores the given concrete subclass of AnalysisActivityIfc in the database and associates it to the given ChangeAnalysisIfc; the ChangeAnalysisIfc must be persistent already.
 ChangeActivityIfc saveChangeActivity(ChangeOrderIfc co, ChangeActivityIfc ca)
          Stores the given concrete subclass of ChangeActivityIfc in the database and associates it to the given ChangeOrderIfc; the ChangeOrderIfc must be persistent already.
 ChangeInvestigationIfc saveChangeInvestigation(ChangeRequestIfc cr, ChangeInvestigationIfc ci)
          Stores the given concrete subclass of ChangeInvestigationIfc in the database and associates it to the given ChangeRequestIfc; theChangeRequestIfc must be persistent already.
 ChangeIssueIfc saveChangeIssue(ChangeIssueIfc ci)
          Stores the given concrete subclass of ChangeIssueIfc in the database.
 ChangeOrderIfc saveChangeOrder(ChangeRequestIfc cr, ChangeOrderIfc co)
          Stores the given concrete subclass of ChangeOrderIfc in the database and associates it to the given ChangeRequestIfc; theChangeRequestIfc must be persistent already.
 ChangeProposalIfc saveChangeProposal(ChangeRequestIfc cr, ChangeProposalIfc cp)
          Stores the given concrete subclass of ChangeProposalIfc in the database and associates it to the given ChangeRequestIfc; theChangeRequestIfc must be persistent already.
 Vector saveChangeRecord(Vector crVector)
          Stores all the ChangeRecord2 objects in the input vector and returns a vector of the persisted (or updated) ChangeRecord2 objects.
 ChangeRequestIfc saveChangeRequest(ChangeRequestIfc cr)
          Stores the given concrete subclass of ChangeRequestIfc in the database.
 FormalizedByIfc saveFormalizedBy(ChangeRequestIfc cr, ChangeIssueIfc ci)
          Stores the given concrete subclass of FormalizedByIfc in the database.
 Vector saveRelevantAnalysisData(Vector radVector)
          Stores all the RelevantAnalysisData objects in the input vector and returns a vector of the persisted (or updated) RelevantAnalysisData objects.
 ResearchedByIfc saveResearchedBy(ChangeRequestIfc cr, ChangeProposalIfc cp)
          Stores the given concrete subclass of ResearchedByIfc in the database.
private  String showCollection(Collection collection)
          Returns String representation of the list passed as argument (debugging).
 Vector storeAssociations(Class theClass, ChangeItemIfc ci, Vector changeables)
          Stores all the associations between the ChangeItemIfc object and the Changeable2 objects in the input vector and returns a vector of the persisted association objects.
 void unattachChangeable(Changeable2 refObject, ChangeItem changeItem, Class linkClass, String changeRole)
          Deletes the association between a ChangeItem and a Changeable2.
 void unattachProduct(WTProductMaster refObject, ChangeItemIfc changeItem, Class linkClass, String changeRole)
          Deletes the association between a ChangeItem and a Changeable2.
 
Methods inherited from class wt.services.StandardManager
emergencyShutdown, emergencyShutdownComplete, emergencyShuttingDown, getClassInfo, getManagerService, getManagerStatus, getName, getStartupType, init, initialize, initialize, isStarted, newStandardManager, newStandardManager, performEmergencyShutdownProcess, performShutdownProcess, setManagerService, shutdown, shutdownFailure, shutdownSuccess, shuttingDown, started, startedErrors, startingUp, startup, startupFailure, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

RESOURCE

private static final String RESOURCE
See Also:
Constant Field Values

CLASSNAME

private static final String CLASSNAME

OID

private static final String OID
See Also:
Constant Field Values

ROLE_A

private static final String ROLE_A
See Also:
Constant Field Values

ROLE_B

private static final String ROLE_B
See Also:
Constant Field Values

VERBOSE

private static boolean VERBOSE

USE_FOLDER_DELEGATE

private static boolean USE_FOLDER_DELEGATE

USE_LIFECYCLE_DELEGATE

private static boolean USE_LIFECYCLE_DELEGATE

WINDCHILL_PDM

private static boolean WINDCHILL_PDM

PC_QUERY_SIZE

private static int PC_QUERY_SIZE

proIInstalled

private static boolean proIInstalled
Constructor Detail

StandardChangeService2

public StandardChangeService2()
Method Detail

getConceptualClassname

public String getConceptualClassname()
Deprecated.  

Returns the conceptual (modeled) name for the class.

Supported API: false

Specified by:
getConceptualClassname in interface NetFactor
Overrides:
getConceptualClassname in class StandardManager
Returns:
String

performStartupProcess

protected void performStartupProcess()
                              throws ManagerException
Listens for the following events: PRE_STORE Set number attribute on all change objects. Veto change item if in personal cabinet. Veto store of change item link if item is Workable and Checked Out PRE_MODIFY Veto modify of change item link if item is Workable and Checked Out PRE_DELETE Veto delete of change item link if item is Workable and Checked Out CLEANUP_LINK Propogate deletes of change items to subordinate items. POST_CHECKOUT Copy links to changeable items when changeable items are checked out. NEW_ITERATION Copy links to changeable items when changeable items get a new iteration, but only when the old iteration is not null and the branch identifiers are the same. POST_CHANGE_FOLDER Propagate folder changes.

Supported API: false

Overrides:
performStartupProcess in class StandardManager
Throws:
ManagerException

registerEvents

public void registerEvents(ManagerService managerService)
Register events with the passed ManagerService.

Supported API: false

Specified by:
registerEvents in interface Manager
Overrides:
registerEvents in class StandardManager
Parameters:
managerService -

newStandardChangeService2

public static StandardChangeService2 newStandardChangeService2()
                                                        throws WTException
Default factory for the class.

Supported API: false

Returns:
StandardChangeService2
Throws:
WTException

deleteAffectedActivityData

public AffectedActivityData deleteAffectedActivityData(AffectedActivityData aad)
                                                throws WTException,
                                                       ChangeException2
Delete the AffectedActivityData relationship only. The ChangeActivityIfc object and Changeable2 object that the AffectedActivityData relationship links together will still both exist after the relationship is deleted.

Supported API: true

Specified by:
deleteAffectedActivityData in interface ChangeService2
Parameters:
aad -
Returns:
AffectedActivityData
Throws:
WTException
ChangeException2
See Also:
AffectedActivityData, ChangeActivityIfc, Changeable2

deleteAnalysisActivity

public AnalysisActivityIfc deleteAnalysisActivity(AnalysisActivityIfc aa)
                                           throws ChangeException2,
                                                  WTException
Deletes the concrete subclass of AnalysisActivityIfc from the database. The associated (or relevant) DetailedByIfc concrete associations will be deleted by the Persistence Manager and all related change objects will be deleted by listeners on ChangeService2, with the exception of related ChangeAnalysisIfc (ChangeInvestigationIfc or ChangeProposalIfc) objects. This method should be called rather than calling the Persistence Manager delete method directly.

Supported API: true

Specified by:
deleteAnalysisActivity in interface ChangeService2
Parameters:
aa -
Returns:
AnalysisActivityIfc
Throws:
ChangeException2
WTException

deleteChangeActivity

public ChangeActivityIfc deleteChangeActivity(ChangeActivityIfc ca)
                                       throws ChangeException2,
                                              WTException
Deletes the concrete subclass of ChangeActivityIfc from the database. The associated (or relevant) IncludedInIfc concrete associations will be deleted by the Persistence Manager and all related change objects will be deleted by listeners on ChangeService2, with the exception of related ChangeOrderIfc objects. This method should be called rather than calling the Persistence Manager delete method directly.

Supported API: true

Specified by:
deleteChangeActivity in interface ChangeService2
Parameters:
ca -
Returns:
ChangeActivityIfc
Throws:
ChangeException2
WTException

deleteChangeInvestigation

public ChangeInvestigationIfc deleteChangeInvestigation(ChangeInvestigationIfc ci)
                                                 throws ChangeException2,
                                                        WTException
Deletes the concrete subclass of ChangeInvestigationIfc from the database. The associated (or relevant) ResearchedByIfc concrete associations will be deleted by the Persistence Manager and all related change objects will be deleted by listeners on ChangeService2, with the exception of related ChangeRequestIfc objects. This method should be called rather than calling the Persistence Manager delete method directly.

Supported API: true

Specified by:
deleteChangeInvestigation in interface ChangeService2
Parameters:
ci -
Returns:
ChangeInvestigationIfc
Throws:
ChangeException2
WTException

deleteChangeIssue

public ChangeIssueIfc deleteChangeIssue(ChangeIssueIfc ci)
                                 throws ChangeException2,
                                        WTException
Deletes the concrete subclass of ChangeIssueIfc from the database. The associated (or relevant) FormalizedByIfc concrete associations will be deleted by the Persistence Manager and all related change objects will be deleted by listeners on ChangeService2, with the exception of related ChangeRequestIfc objects. This method should be called rather than calling the Persistence Manager delete method directly.

Supported API: true

Specified by:
deleteChangeIssue in interface ChangeService2
Parameters:
ci -
Returns:
ChangeIssueIfc
Throws:
ChangeException2
WTException

deleteChangeOrder

public ChangeOrderIfc deleteChangeOrder(ChangeOrderIfc co)
                                 throws ChangeException2,
                                        WTException
Deletes the concrete subclass of ChangeOrderIfc from the database. The associated (or relevant) AddressedByIfc concrete associations will be deleted by the Persistence Manager and all related change objects will be deleted by listeners on ChangeService2, with the exception of related ChangeRequestIfc objects. This method should be called rather than calling the Persistence Manager delete method directly.

Supported API: true

Specified by:
deleteChangeOrder in interface ChangeService2
Parameters:
co -
Returns:
ChangeOrderIfc
Throws:
ChangeException2
WTException

deleteChangeProposal

public ChangeProposalIfc deleteChangeProposal(ChangeProposalIfc cp)
                                       throws ChangeException2,
                                              WTException
Deletes the concrete subclass of ChangeProposalIfc from the database. The associated (or relevant) ResearchedByIfc concrete associations will be deleted by the Persistence Manager and all related change objects will be deleted by listeners on ChangeService2, with the exception of related ChangeRequestIfc objects. This method should be called rather than calling the Persistence Manager delete method directly.

Supported API: true

Specified by:
deleteChangeProposal in interface ChangeService2
Parameters:
cp -
Returns:
ChangeProposalIfc
Throws:
ChangeException2
WTException

deleteChangeRecord

public ChangeRecord2 deleteChangeRecord(ChangeRecord2 cr)
                                 throws WTException,
                                        ChangeException2
Delete the ChangeRecord2 relationship only. The ChangeActivityIfc object and Changeable2 object that the ChangeRecord2 relationship links together will still both exist after the relationship is deleted.

Supported API: true

Specified by:
deleteChangeRecord in interface ChangeService2
Parameters:
cr -
Returns:
ChangeRecord2
Throws:
WTException
ChangeException2
See Also:
ChangeRecord2, ChangeActivityIfc, Changeable2

deleteChangeRequest

public ChangeRequestIfc deleteChangeRequest(ChangeRequestIfc cr)
                                     throws WTException,
                                            ChangeException2
Deletes the concrete subclass of ChangeRequestIfc from the database. The associated (or relevant) FormalizedByIfc concrete associations will be deleted by the Persistence Manager and all related change objects will be deleted by listeners on ChangeService2, with the exception of related ChangeIssueIfc objects. This method should be called rather than calling the Persistence Manager delete method directly.

Supported API: true

Specified by:
deleteChangeRequest in interface ChangeService2
Parameters:
cr -
Returns:
ChangeRequestIfc
Throws:
WTException
ChangeException2

deleteFormalizedBy

public FormalizedByIfc deleteFormalizedBy(ChangeRequestIfc cr,
                                          ChangeIssueIfc ci)
                                   throws WTException,
                                          ChangeException2
Delete the FormalizedByIfc relationship implied by the two arguments. The concrete subclasses of the ChangeRequestIfc, the ChangeIssueIfc and the FormalizedByIfc relationship must already be Persistent. In the event there is no FormalizedByIfc (the two objects passed in are not related) then there will be no exception generated, instead a null will be returned..

Supported API: true

Specified by:
deleteFormalizedBy in interface ChangeService2
Parameters:
cr -
ci -
Returns:
FormalizedByIfc
Throws:
WTException
ChangeException2

deleteRelevantAnalysisData

public RelevantAnalysisData deleteRelevantAnalysisData(RelevantAnalysisData rad)
                                                throws WTException,
                                                       ChangeException2
Delete the RelevantAnalysisData relationship only. The AnalysisActivityIfc object and Changeable2 object that the RelevantAnalysisData relationship links together will still both exist after the relationship is deleted.

Supported API: true

Specified by:
deleteRelevantAnalysisData in interface ChangeService2
Parameters:
rad -
Returns:
RelevantAnalysisData
Throws:
WTException
ChangeException2
See Also:
RelevantAnalysisData, AnalysisActivityIfc, Changeable2

getAffectingChangeActivities

public QueryResult getAffectingChangeActivities(Changeable2 changeable,
                                                boolean onlyChangeActivities)
                                         throws ChangeException2,
                                                WTException
Returns a QueryResult of ChangeActivity2 objects related to the given Changeable2 object by the AffectedActivityData assocation. These Changeable2 objects represent revisions that need to be changed as part of the change process If onlyChangeActivities is true, the QueryResult returned contains a set of ChangeActivity2 objects.

If onyChangeActivities is false, the QueryResult returned contains a set of AffectedActivityData link objects that have references to the Changeable objects.

Supported API: true

Specified by:
getAffectingChangeActivities in interface ChangeService2
Parameters:
changeable -
onlyChangeActivities -
Returns:
QueryResult
Throws:
ChangeException2
WTException
See Also:
WTChangeActivity2, Changeable2

getAffectingChangeActivities

public QueryResult getAffectingChangeActivities(Changeable2 changeable)
                                         throws ChangeException2,
                                                WTException
Returns a QueryResult of ChangeActivity2 objects related to the given Changeable2 object by the AffectedActivityData assocation. These Changeable2 objects represent revisions that need to be changed as part of the change process.

Supported API: true

Specified by:
getAffectingChangeActivities in interface ChangeService2
Parameters:
changeable -
Returns:
QueryResult
Throws:
ChangeException2
WTException
See Also:
WTChangeActivity2, Changeable2

getAnalysisActivities

public QueryResult getAnalysisActivities(Changeable2 changeable,
                                         boolean onlyAnalysisActivities)
                                  throws ChangeException2,
                                         WTException
Retrieves the AnalysisActivity objects related to the given Changeable2 object by the RelevantAnalysisData assocation. These Changeable2 objects represent revisions that are important for the completion of a particular AnalysisActivity. If onlyAnalysisActivities is true, the QueryResult returned contains a set of AnalysisActivity objects.

If onlyAnalysisActivities is false, the QueryResult returned contains a set of RelevantAnalysisData link objects that have references to the Changeable objects.

Supported API: true

Specified by:
getAnalysisActivities in interface ChangeService2
Parameters:
changeable -
onlyAnalysisActivities -
Returns:
QueryResult
Throws:
ChangeException2
WTException
See Also:
WTChangeInvestigation, Changeable2

getAnalysisActivities

public QueryResult getAnalysisActivities(Changeable2 changeable)
                                  throws ChangeException2,
                                         WTException
Retrieves the AnalysisActivity objects related to the given Changeable2 object by the RelevantAnalysisData assocation. These Changeable2 objects represent revisions that are important for the completion of a particular AnalysisActivity.

Supported API: true

Specified by:
getAnalysisActivities in interface ChangeService2
Parameters:
changeable -
Returns:
QueryResult
Throws:
ChangeException2
WTException
See Also:
WTChangeInvestigation, Changeable2

getAnalysisActivities

public QueryResult getAnalysisActivities(ChangeAnalysisIfc ca)
                                  throws WTException,
                                         ChangeException2
Retrieves the AnalysisActivityIfc objects related to the given ChangeAnalysisIfc object by the DetailedByIfc assocation. These AnalysisActivityIfc objects represent activies that part of the particular ChangeAnalysisIfc. The QueryResult returned contains a set of AnalysisActivityIfc objects, not a set of DetailedByIfc link objects that have references to the ChangeAnalysisIfc objects. Use the two parameter version of this method to return the DetailedByIfc link objects.

Supported API: true

Specified by:
getAnalysisActivities in interface ChangeService2
Parameters:
ca -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
AnalysisActivityIfc, AnalysisActivityIfc, DetailedByIfc

getAnalysisActivities

public QueryResult getAnalysisActivities(ChangeAnalysisIfc ca,
                                         boolean onlyAnalysisActivities)
                                  throws WTException,
                                         ChangeException2
Retrieves the AnalysisActivityIfc objects related to the given ChangeAnalysisIfc object by the DetailedByIfc assocation. These AnalysisActivityIfc objects represent investigations that are important for the completion of a particular ChangeAnalysisIfc. If onlyAnalysisActivities is true, the QueryResult returned contains a set of AnalysisActivityIfc objects.

If onlyAnalysisActivities is false, the QueryResult returned contains a set of DetailedByIfc link objects that have references to the AnalysisActivityIfc objects.

Supported API: true

Specified by:
getAnalysisActivities in interface ChangeService2
Parameters:
ca -
onlyAnalysisActivities -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
AnalysisActivityIfc, ChangeAnalysisIfc, DetailedByIfc

getChangeables

public QueryResult getChangeables(AnalysisActivityIfc aa)
                           throws WTException,
                                  ChangeException2
Retrieves the Changeable2 objects related to the given AnalysisActivityIfc object by the ResearchedByIfc assocation. These Changeable2 objects represent changeables that are relevant to the completion of a particular AnalysisActivityIfc. The QueryResult returned contains a set of Changeable2 objects, not a set of RelevantAnalysisData link objects that have references to the Changeable2 objects. There is another method that contains the RelevantAnalysisData link objects. Get the working copy if the current user was the one who checked it out, otherwise get the checked out copy.

Supported API: true

Specified by:
getChangeables in interface ChangeService2
Parameters:
aa -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
Changeable2, AnalysisActivityIfc, RelevantAnalysisData

getChangeables

public QueryResult getChangeables(AnalysisActivityIfc aa,
                                  boolean onlyChangeables)
                           throws WTException,
                                  ChangeException2
Retrieves the Changeable2 objects related to the given AnalysisActivityIfc object by the RelevantAnalysisData assocation. These Changeable2 objects represent investigations that are important for the completion of a particular AnalysisActivityIfc. If onlyChangeables is true, the QueryResult returned contains a set of Changeable2 objects.

If onlyChangeables is false, the QueryResult returned contains a set of RelevantAnalysisData link objects that have references to the Changeable2 objects. Get the working copy if the current user was the one who checked it out, otherwise get the checked out copy.

Supported API: true

Specified by:
getChangeables in interface ChangeService2
Parameters:
aa -
onlyChangeables -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
Changeable2, AnalysisActivityIfc, RelevantAnalysisData

getChangeables

public QueryResult getChangeables(ChangeRequestIfc cr)
                           throws WTException,
                                  ChangeException2
Retrieves the Changeable2 objects related to the given ChangeRequestIfc object by the RelevantRequestDataIfc assocation. These Changeable2 objects represent additional documentation for the Change Request. The QueryResult returned contains a set of Changeable2 objects, not a set of RelevantAnalysisData link objects that have references to the Changeable2 objects. There is another method that contains the RelevantAnalysisData link objects. Get the working copy if the current user was the one who checked it out, otherwise get the checked out copy.

Supported API: true

Specified by:
getChangeables in interface ChangeService2
Parameters:
cr -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
Changeable2, ChangeRequestIfc, RelevantRequestData2

getChangeables

public QueryResult getChangeables(ChangeRequestIfc cr,
                                  boolean onlyChangeables)
                           throws WTException,
                                  ChangeException2
Retrieves the Changeable2 objects related to the given ChangeRequestIfc object by the RelevantRequestDataIfc assocation. These Changeable2 objects represent additional documentation for the Change Request. If onlyChangeables is true, the QueryResult returned contains a set of Changeable2 objects.

If onlyChangeables is false, the QueryResult returned contains a set of RelevantRequestDataIfc link objects that have references to the Changeable2 objects. Get the working copy if the current user was the one who checked it out, otherwise get the checked out copy.

Supported API: true

Specified by:
getChangeables in interface ChangeService2
Parameters:
cr -
onlyChangeables -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
Changeable2, ChangeRequestIfc, RelevantRequestData2

getChangeablesAfter

public QueryResult getChangeablesAfter(ChangeActivityIfc ca)
                                throws WTException,
                                       ChangeException2
Retrieves the Changeable2 objects related to the given ChangeActivityIfc object by the ChangeRecord2 assocation. These Changeable2 objects represent changeables that have been changed to implement the ChangeActivityIfc. The changeables returned are only the latest iterations (wt.vc.VersionControlHelper.getSearchCondition is used to do this) and then only the items that the user is allowed to see are returned (wt.vc.config.MultipleLatestConfigSpec.process is used to do this). The QueryResult returned contains a set of Changeable2 objects, not a set of ChangeRecord2 link objects that have references to the Changeable2 objects. There is another method that contains the ChangeRecord2 link objects. Get the working copy if the current user was the one who checked it out, otherwise get the checked out copy.

Supported API: true

Specified by:
getChangeablesAfter in interface ChangeService2
Parameters:
ca -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
Changeable2, ChangeActivityIfc, ChangeRecord2, VersionControlHelper, MultipleLatestConfigSpec

getChangeablesAfter

public QueryResult getChangeablesAfter(ChangeActivityIfc ca,
                                       boolean onlyChangeables)
                                throws WTException,
                                       ChangeException2
Retrieves the Changeable2 objects related to the given ChangeActivityIfc object by the ChangeRecord2 assocation. These Changeable2 objects represent changeables that have been changed to implement the ChangeActivityIfc. The changeables returned are only the latest iterations (wt.vc.VersionControlHelper.getSearchCondition is used to do this) and then only the items that the user is allowed to see are returned (wt.vc.config.MultipleLatestConfigSpec.process is used to do this). If onlyChangeables is true, the QueryResult returned contains a set of Changeable2 objects.

If onlyChangeables is false, the QueryResult returned contains a set of ChangeRecord2 link objects that have references to the Changeable2 objects. Get the working copy if the current user was the one who checked it out, otherwise get the checked out copy.

Supported API: true

Specified by:
getChangeablesAfter in interface ChangeService2
Parameters:
ca -
onlyChangeables -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
Changeable2, ChangeActivityIfc, ChangeRecord2

getChangeablesAfter

public QueryResult getChangeablesAfter(ChangeOrderIfc co)
                                throws WTException,
                                       ChangeException2
Retrieves the Changeable2 objects related to the given ChangeOrderIfc object through its IncludedInIfc association with its ChangeActivityIfc and then by their ChangeRecord2 assocations. These Changeable2 objects represent changeables that have been affected by the implementation of the ChangeOrderIfc. The changeables returned are only the latest iterations (wt.vc.VersionControlHelper.getSearchCondition is used to do this) and then only the items that the user is allowed to see are returned (wt.vc.config.MultipleLatestConfigSpec.process is used to do this). The QueryResult returned contains a set of Changeable2 objects, not a set of ChangeRecord2 link objects that have references to the Changeable2 objects. There is another method that contains the ChangeRecord2 link objects. Get the working copy if the current user was the one who checked it out, otherwise get the checked out copy.

Supported API: true

Specified by:
getChangeablesAfter in interface ChangeService2
Parameters:
co -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
Changeable2, ChangeOrderIfc, ChangeActivityIfc, IncludedInIfc, ChangeRecord2

getChangeablesAfter

public QueryResult getChangeablesAfter(ChangeOrderIfc co,
                                       boolean onlyChangeables)
                                throws WTException,
                                       ChangeException2
Retrieves the Changeable2 objects related to the given ChangeOrderIfc object through its IncludedInIfc associations with its ChangeActivityIfc object and then by their ChangeRecord2 assocations. These Changeable2 objects represent changeables that have been changed to implement the ChangeOrderIfc. The changeables returned are only the latest iterations (wt.vc.VersionControlHelper.getSearchCondition is used to do this) and then only the items that the user is allowed to see are returned (wt.vc.config.MultipleLatestConfigSpec.process is used to do this). If onlyChangeables is true, the QueryResult returned contains a set of Changeable2 objects.

If onlyChangeables is false, the QueryResult returned contains a set of ChangeRecord2 link objects that have references to the Changeable2 objects. Get the working copy if the current user was the one who checked it out, otherwise get the checked out copy.

Supported API: true

Specified by:
getChangeablesAfter in interface ChangeService2
Parameters:
co -
onlyChangeables -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
Changeable2, ChangeOrderIfc, ChangeActivityIfc, IncludedInIfc, ChangeRecord2

getChangeablesBefore

public QueryResult getChangeablesBefore(ChangeActivityIfc ca)
                                 throws WTException,
                                        ChangeException2
Retrieves the Changeable2 objects related to the given ChangeActivityIfc object by the AffectedActivityData assocation. These Changeable2 objects represent changeables that may need to be changed for the completion of a particular ChangeActivityIfc. The QueryResult returned contains a set of Changeable2 objects, not a set of AffectedActivityData link objects that have references to the Changeable2 objects. There is another method that contains the AffectedActivityData link objects. Get the working copy if the current user was the one who checked it out, otherwise get the checked out copy.

Supported API: true

Specified by:
getChangeablesBefore in interface ChangeService2
Parameters:
ca -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
Changeable2, ChangeActivityIfc, AffectedActivityData

getChangeablesBefore

public QueryResult getChangeablesBefore(ChangeActivityIfc ca,
                                        boolean onlyChangeables)
                                 throws WTException,
                                        ChangeException2
Retrieves the Changeable2 objects related to the given ChangeActivityIfc object by the AffectedActivityData assocation. These Changeable2 objects represent changeables that are may need to be changed for the completion of a particular ChangeActivityIfc. If onlyChangeables is true, the QueryResult returned contains a set of Changeable2 objects.

If onlyChangeables is false, the QueryResult returned contains a set of AffectedActivityData link objects that have references to the Changeable2 objects. Get the working copy if the current user was the one who checked it out, otherwise get the checked out copy.

Supported API: true

Specified by:
getChangeablesBefore in interface ChangeService2
Parameters:
ca -
onlyChangeables -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
Changeable2, ChangeActivityIfc, AffectedActivityData

getChangeablesBefore

public QueryResult getChangeablesBefore(ChangeOrderIfc co)
                                 throws WTException,
                                        ChangeException2
Retrieves the Changeable2 objects related to the given ChangeOrderIfc object through the IncludedInIfc association with each of its ChangeActivityIfc objects and then by their AffectedActivityData assocation. These Changeable2 objects represent changeables that may be affected by the completion of a particular ChangeOrderIfc. The QueryResult returned contains a set of Changeable2 objects, not a set of AffectedActivityData link objects that have references to the Changeable2 objects. There is another method that contains the AffectedActivityData link objects. Get the working copy if the current user was the one who checked it out, otherwise get the checked out copy.

Supported API: true

Specified by:
getChangeablesBefore in interface ChangeService2
Parameters:
co -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
Changeable2, ChangeOrderIfc, ChangeActivityIfc, IncludedInIfc, AffectedActivityData

getChangeablesBefore

public QueryResult getChangeablesBefore(ChangeOrderIfc co,
                                        boolean onlyChangeables)
                                 throws WTException,
                                        ChangeException2
Retrieves the Changeable2 objects related to the given ChangeOrderIfc object through the IncludedInIfc association of each of its ChangeActivityIfc object and then by their AffectedActivityData assocations. These Changeable2 objects represent changeables that are may be affected by the completion of a particular ChangeOrderIfc. If onlyChangeables is true, the QueryResult returned contains a set of Changeable2 objects.

If onlyChangeables is false, the QueryResult returned contains a set of AffectedActivityData link objects that have references to the Changeable2 objects. Get the working copy if the current user was the one who checked it out, otherwise get the checked out copy.

Supported API: true

Specified by:
getChangeablesBefore in interface ChangeService2
Parameters:
co -
onlyChangeables -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
Changeable2, ChangeOrderIfc, ChangeActivityIfc, IncludedInIfc, AffectedActivityData

getChangeActivities

public QueryResult getChangeActivities(ChangeOrderIfc co)
                                throws WTException,
                                       ChangeException2
Retrieves the ChangeActivityIfc objects related to the given ChangeOrderIfc object by the IncludedInIfc assocation. These ChangeActivityIfc objects represent activies that part of the particular ChangeOrderIfc The QueryResult returned contains a set of ChangeActivityIfc objects, not a set of IncludedInIfc link objects that have references to the ChangeOrderIfc objects. Use the two parameter version of this method to return the IncludedInIfc link objects.

Supported API: true

Specified by:
getChangeActivities in interface ChangeService2
Parameters:
co -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
ChangeActivityIfc, ChangeOrderIfc, IncludedInIfc

getChangeActivities

public QueryResult getChangeActivities(ChangeOrderIfc co,
                                       boolean onlyChangeActivities)
                                throws WTException,
                                       ChangeException2
Retrieves the ChangeActivityIfc objects related to the given ChangeOrderIfc object by the IncludedInIfc assocation. These ChangeActivityIfc objects represent investigations that are important for the completion of a particular ChangeOrderIfc. If onlyChangeActivities is true, the QueryResult returned contains a set of ChangeActivityIfc objects.

If onlyChangeActivities is false, the QueryResult returned contains a set of IncludedInIfc link objects that have references to the ChangeActivityIfc objects.

Supported API: true

Specified by:
getChangeActivities in interface ChangeService2
Parameters:
co -
onlyChangeActivities -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
ChangeActivityIfc, ChangeOrderIfc, IncludedInIfc

getChangeInvestigations

public QueryResult getChangeInvestigations(ChangeRequestIfc cr)
                                    throws WTException,
                                           ChangeException2
Retrieves the ChangeInvestigationIfc objects related to the given ChangeRequestIfc object by the ResearchedByIfc assocation. These ChangeInvestigationIfc objects represent investigations that are important for the completion of a particular ChangeRequestIfc. The QueryResult returned contains a set of ChangeInvestigationIfc objects, not a set of ResearchedByIfc link objects that have references to the ChangeRequestIfc objects. Use the two parameter version of this method to return the ResearchedByIfc link objects.

Supported API: true

Specified by:
getChangeInvestigations in interface ChangeService2
Parameters:
cr -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
ChangeInvestigationIfc, ChangeRequestIfc, ResearchedByIfc

getChangeInvestigations

public QueryResult getChangeInvestigations(ChangeRequestIfc cr,
                                           boolean onlyChangeInvestigations)
                                    throws WTException,
                                           ChangeException2
Retrieves the ChangeInvestigationIfc objects related to the given ChangeRequestIfc object by the ResearchedByIfc assocation. These ChangeInvestigationIfc objects represent investigations that are important for the completion of a particular ChangeRequestIfc. If onlyChangeRequests is true, the QueryResult returned contains a set of ChangeInvestigationIfc objects.

If onlyChangeRequests is false, the QueryResult returned contains a set of ResearchedByIfc link objects that have references to the ChangeInvestigationIfc objects.

Supported API: true

Specified by:
getChangeInvestigations in interface ChangeService2
Parameters:
cr -
onlyChangeInvestigations -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
ChangeInvestigationIfc, ChangeRequestIfc, ResearchedByIfc

getChangeIssues

public QueryResult getChangeIssues(ChangeRequestIfc cr)
                            throws WTException,
                                   ChangeException2
Retrieves the ChangeIssueIfc objects related to the given ChangeRequestIfc object by the FormalizedByIfc assocation. These ChangeIssueIfc objects represent issues that will formally be addressed by the particular ChangeRequestIfc. The QueryResult returned contains a set of ChangeIssueIfc objects, not a set of FormalizedByIfc link objects that have references to the ChangeRequestIfc objects. Use the two parameter version of this method to return the FormalizedByIfc link objects.

Supported API: true

Specified by:
getChangeIssues in interface ChangeService2
Parameters:
cr -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
ChangeIssueIfc, ChangeRequestIfc, FormalizedByIfc

getChangeIssues

public QueryResult getChangeIssues(ChangeRequestIfc cr,
                                   boolean onlyChangeIssues)
                            throws WTException,
                                   ChangeException2
Retrieves the ChangeIssueIfc objects related to the given ChangeRequestIfc object by the FormalizedByIfc assocation. These ChangeIssueIfc objects represent investigations that are important for the completion of a particular ChangeRequestIfc. If onlyChangeIssues is true, the QueryResult returned contains a set of ChangeIssueIfc objects.

If onlyChangeIssues is false, the QueryResult returned contains a set of FormalizedByIfc link objects that have references to the ChangeIssueIfc objects.

Supported API: true

Specified by:
getChangeIssues in interface ChangeService2
Parameters:
cr -
onlyChangeIssues -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
ChangeIssueIfc, ChangeRequestIfc, FormalizedByIfc

getChangeOrders

public QueryResult getChangeOrders(ChangeRequestIfc cr)
                            throws WTException,
                                   ChangeException2
Retrieves the ChangeOrderIfc objects related to the given ChangeRequestIfc object by the AddressedByIfc assocation. These ChangeOrderIfc objects represent orders that will implement the particular ChangeRequestIfc. The QueryResult returned contains a set of ChangeOrderIfc objects, not a set of AddressedByIfc link objects that have references to the ChangeRequestIfc objects. Use the two parameter version of this method to return the AddressedByIfc link objects.

Supported API: true

Specified by:
getChangeOrders in interface ChangeService2
Parameters:
cr -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
ChangeOrderIfc, ChangeRequestIfc, AddressedByIfc

getChangeOrders

public QueryResult getChangeOrders(ChangeRequestIfc cr,
                                   boolean onlyChangeOrders)
                            throws WTException,
                                   ChangeException2
Retrieves the ChangeOrderIfc objects related to the given ChangeRequestIfc object by the AddressedByIfc assocation. These ChangeOrderIfc objects represent investigations that implement the completion of a particular ChangeRequestIfc. If onlyChangeOrders is true, the QueryResult returned contains a set of ChangeOrderIfc objects.

If onlyChangeOrders is false, the QueryResult returned contains a set of AddressedByIfc link objects that have references to the ChangeOrderIfc objects.

Supported API: true

Specified by:
getChangeOrders in interface ChangeService2
Parameters:
cr -
onlyChangeOrders -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
ChangeOrderIfc, ChangeRequestIfc, AddressedByIfc

getChangeProposals

public QueryResult getChangeProposals(ChangeRequestIfc cr)
                               throws WTException,
                                      ChangeException2
Retrieves the ChangeProposalIfc objects related to the given ChangeRequestIfc object by the ResearchedByIfc assocation. These ChangeProposalIfc objects represent proposals that are proposed for the completion of a particular ChangeRequestIfc. The QueryResult returned contains a set of ChangeProposalIfc objects, not a set of ResearchedByIfc link objects that have references to the ChangeRequestIfc objects. Use the two parameter version of this method to return the ResearchedByIfc link objects.

Supported API: true

Specified by:
getChangeProposals in interface ChangeService2
Parameters:
cr -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
ChangeProposalIfc, ChangeRequestIfc, ResearchedByIfc

getChangeProposals

public QueryResult getChangeProposals(ChangeRequestIfc cr,
                                      boolean onlyChangeProposals)
                               throws WTException,
                                      ChangeException2
Retrieves the ChangeProposalIfc objects related to the given ChangeRequestIfc object by the ResearchedByIfc assocation. These ChangeProposalIfc objects represent investigations that are important for the completion of a particular ChangeRequestIfc. If onlyChangeProposals is true, the QueryResult returned contains a set of ChangeProposalIfc objects.

If onlyChangeProposals is false, the QueryResult returned contains a set of ResearchedByIfc link objects that have references to the ChangeProposalIfc objects.

Supported API: true

Specified by:
getChangeProposals in interface ChangeService2
Parameters:
cr -
onlyChangeProposals -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
ChangeProposalIfc, ChangeRequestIfc, ResearchedByIfc

getFormalizingChangeRequest

public ChangeRequest2 getFormalizingChangeRequest(ChangeIssue ci)
                                           throws ChangeException2,
                                                  WTException
Retrieves the ChangeRequest2 object that formalizes the given ChangeIssue object.

Supported API: true

Specified by:
getFormalizingChangeRequest in interface ChangeService2
Parameters:
ci -
Returns:
ChangeRequest2
Throws:
ChangeException2
WTException
See Also:
ChangeRequest2, ChangeIssue

getImplementedChangeActivities

public QueryResult getImplementedChangeActivities(Changeable2 changeable)
                                           throws ChangeException2,
                                                  WTException
Returns a QueryResult of ChangeActivity2 objects related to the given Changeable2 object by the ChangeRecord2 assocation. These Changeable2 objects represent revisions that have been changed as part of the change process

Supported API: true

Specified by:
getImplementedChangeActivities in interface ChangeService2
Parameters:
changeable -
Returns:
QueryResult
Throws:
ChangeException2
WTException
See Also:
WTChangeActivity2, Changeable2

getImplementedChangeActivities

public QueryResult getImplementedChangeActivities(Changeable2 changeable,
                                                  boolean onlyChangeActivities)
                                           throws ChangeException2,
                                                  WTException
Returns a QueryResult of ChangeActivity2 objects related to the given Changeable2 object by the ChangeRecord2 assocation. These Changeable2 objects represent revisions that have been changed as part of the change process If onlyChangeActivities is true, the QueryResult returned contains a set of ChangeActivity2 objects.

If onlyChangeActivities is false, the QueryResult returned contains a set of ChangeRecord2 link objects that have references to the Changeable objects.

Supported API: true

Specified by:
getImplementedChangeActivities in interface ChangeService2
Parameters:
changeable -
onlyChangeActivities -
Returns:
QueryResult
Throws:
ChangeException2
WTException
See Also:
WTChangeActivity2, Changeable2

saveAnalysisActivity

public AnalysisActivityIfc saveAnalysisActivity(ChangeAnalysisIfc ca,
                                                AnalysisActivityIfc aa)
                                         throws ChangeException2,
                                                WTException
Stores the given concrete subclass of AnalysisActivityIfc in the database and associates it to the given ChangeAnalysisIfc; the ChangeAnalysisIfc must be persistent already. If the AnalysisActivityIfc object is LifeCycleManaged, this method uses Change2DelegateFactory to get a ChooseLifeCycleDelegate to programatically assign the LifeCycle. If the ChangeAnalysistIfc object is Foldered, this method uses Change2DelegateFactory to get a ChooseFolderDelegate to programatically assign the Folder.

Supported API: true

Specified by:
saveAnalysisActivity in interface ChangeService2
Parameters:
ca -
aa -
Returns:
AnalysisActivityIfc
Throws:
ChangeException2
WTException
See Also:
Change2DelegateFactory, ChooseLifeCycleDelegate, ChooseFolderDelegate

saveChangeActivity

public ChangeActivityIfc saveChangeActivity(ChangeOrderIfc co,
                                            ChangeActivityIfc ca)
                                     throws ChangeException2,
                                            WTException
Stores the given concrete subclass of ChangeActivityIfc in the database and associates it to the given ChangeOrderIfc; the ChangeOrderIfc must be persistent already. If the ChangeActivityIfc object is LifeCycleManaged, this method uses Change2DelegateFactory to get a ChooseLifeCycleDelegate to programatically assign the LifeCycle. If the ChangeActivityIfc object is Foldered, this method uses Change2DelegateFactory to get a ChooseFolderDelegate to programatically assign the Folder.

Supported API: true

Specified by:
saveChangeActivity in interface ChangeService2
Parameters:
co -
ca -
Returns:
ChangeActivityIfc
Throws:
ChangeException2
WTException
See Also:
Change2DelegateFactory, ChooseLifeCycleDelegate, ChooseFolderDelegate

saveChangeInvestigation

public ChangeInvestigationIfc saveChangeInvestigation(ChangeRequestIfc cr,
                                                      ChangeInvestigationIfc ci)
                                               throws ChangeException2,
                                                      WTException
Stores the given concrete subclass of ChangeInvestigationIfc in the database and associates it to the given ChangeRequestIfc; theChangeRequestIfc must be persistent already. If the ChangeInvestigationIfc object is LifeCycleManaged, this method uses Change2DelegateFactory to get a ChooseLifeCycleDelegate to programatically assign the LifeCycle. If the ChangeInvestigationIfc object is Foldered, this method uses Change2DelegateFactory to get a ChooseFolderDelegate to programatically assign the Folder.

Supported API: true

Specified by:
saveChangeInvestigation in interface ChangeService2
Parameters:
cr -
ci -
Returns:
ChangeInvestigationIfc
Throws:
ChangeException2
WTException
See Also:
Change2DelegateFactory, ChooseLifeCycleDelegate, ChooseFolderDelegate

saveChangeIssue

public ChangeIssueIfc saveChangeIssue(ChangeIssueIfc ci)
                               throws ChangeException2,
                                      WTException
Stores the given concrete subclass of ChangeIssueIfc in the database. If the ChangeIssueIfc object is LifeCycleManaged, this method uses Change2DelegateFactory to get a ChooseLifeCycleDelegate to programatically assign the LifeCycle. If the ChangeIssueIfc object is Foldered, this method uses Change2DelegateFactory to get a ChooseFolderDelegate to programatically assign the Folder.

Supported API: true

Specified by:
saveChangeIssue in interface ChangeService2
Parameters:
ci -
Returns:
ChangeIssueIfc
Throws:
ChangeException2
WTException
See Also:
Change2DelegateFactory, ChooseLifeCycleDelegate, ChooseFolderDelegate

saveChangeOrder

public ChangeOrderIfc saveChangeOrder(ChangeRequestIfc cr,
                                      ChangeOrderIfc co)
                               throws ChangeException2,
                                      WTException
Stores the given concrete subclass of ChangeOrderIfc in the database and associates it to the given ChangeRequestIfc; theChangeRequestIfc must be persistent already. If the ChangeOrderIfc object is LifeCycleManaged, this method uses Change2DelegateFactory to get a ChooseLifeCycleDelegate to programatically assign the LifeCycle. If the ChangeRequestIfc object is Foldered, this method uses Change2DelegateFactory to get a ChooseFolderDelegate to programatically assign the Folder.

Supported API: true

Specified by:
saveChangeOrder in interface ChangeService2
Parameters:
cr -
co -
Returns:
ChangeOrderIfc
Throws:
ChangeException2
WTException
See Also:
Change2DelegateFactory, ChooseLifeCycleDelegate, ChooseFolderDelegate

saveChangeProposal

public ChangeProposalIfc saveChangeProposal(ChangeRequestIfc cr,
                                            ChangeProposalIfc cp)
                                     throws ChangeException2,
                                            WTException
Stores the given concrete subclass of ChangeProposalIfc in the database and associates it to the given ChangeRequestIfc; theChangeRequestIfc must be persistent already. If the theChangeRequestIfc object is LifeCycleManaged, this method uses Change2DelegateFactory to get a ChooseLifeCycleDelegate to programatically assign the LifeCycle. If the theChangeRequestIfc object is Foldered, this method uses Change2DelegateFactory to get a ChooseFolderDelegate to programatically assign the Folder.

Supported API: true

Specified by:
saveChangeProposal in interface ChangeService2
Parameters:
cr -
cp -
Returns:
ChangeProposalIfc
Throws:
ChangeException2
WTException
See Also:
Change2DelegateFactory, ChooseLifeCycleDelegate, ChooseFolderDelegate

saveChangeRequest

public ChangeRequestIfc saveChangeRequest(ChangeRequestIfc cr)
                                   throws ChangeException2,
                                          WTException
Stores the given concrete subclass of ChangeRequestIfc in the database. If the object is LifeCycleManaged, this method uses Change2DelegateFactory to get a ChooseLifeCycleDelegate to programatically assign the LifeCycle.

Supported API: true

Specified by:
saveChangeRequest in interface ChangeService2
Parameters:
cr -
Returns:
ChangeRequestIfc
Throws:
ChangeException2
WTException
See Also:
Change2DelegateFactory, ChooseLifeCycleDelegate

saveFormalizedBy

public FormalizedByIfc saveFormalizedBy(ChangeRequestIfc cr,
                                        ChangeIssueIfc ci)
                                 throws ChangeException2,
                                        WTException
Stores the given concrete subclass of FormalizedByIfc in the database. It constructs the FormalizedByIfc based on the ChangeRequestIfc and ChangeIssueIfc objects passed in, using the FormalizedByDelegate.

Supported API: true

Specified by:
saveFormalizedBy in interface ChangeService2
Parameters:
cr -
ci -
Returns:
FormalizedByIfc
Throws:
ChangeException2
WTException
See Also:
FormalizedByIfc, ChangeRequestIfc, ChangeIssueIfc, FormalizedByDelegate

saveRelevantAnalysisData

public Vector saveRelevantAnalysisData(Vector radVector)
                                throws ChangeException2,
                                       WTException
Stores all the RelevantAnalysisData objects in the input vector and returns a vector of the persisted (or updated) RelevantAnalysisData objects.

Supported API: true

Specified by:
saveRelevantAnalysisData in interface ChangeService2
Parameters:
radVector -
Returns:
Vector
Throws:
ChangeException2
WTException
See Also:
RelevantAnalysisData

saveAffectedActivityData

public Vector saveAffectedActivityData(Vector aadVector)
                                throws ChangeException2,
                                       WTException
Stores all the AffectedActivityData objects in the input vector and returns a vector of the persisted (or updated) AffectedActivityData objects.

Supported API: true

Specified by:
saveAffectedActivityData in interface ChangeService2
Parameters:
aadVector -
Returns:
Vector
Throws:
ChangeException2
WTException
See Also:
AffectedActivityData

saveChangeRecord

public Vector saveChangeRecord(Vector crVector)
                        throws ChangeException2,
                               WTException
Stores all the ChangeRecord2 objects in the input vector and returns a vector of the persisted (or updated) ChangeRecord2 objects.

Supported API: true

Specified by:
saveChangeRecord in interface ChangeService2
Parameters:
crVector -
Returns:
Vector
Throws:
ChangeException2
WTException
See Also:
ChangeRecord2

getChangeRequest

public QueryResult getChangeRequest(ChangeIssueIfc ci)
                             throws WTException,
                                    ChangeException2
Retrieves the ChangeRequestIfc object related to the given ChangeIssueIfc object by the FormalizedByIfc assocation. These ChangeRequestIfc object represents the request that will formally address the particular ChangeIssueIfc. The QueryResult returned contains zero or one ChangeRequestIfc object, not zero or one FormalizedByIfc link object that has a reference to the ChangeRequestIfc object. There is another method that contains the FormalizedByIfc link object.

Supported API: true

Specified by:
getChangeRequest in interface ChangeService2
Parameters:
ci -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
ChangeRequestIfc, ChangeIssueIfc, FormalizedByIfc

getChangeRequest

public QueryResult getChangeRequest(ChangeIssueIfc ci,
                                    boolean onlyChangeRequest)
                             throws WTException,
                                    ChangeException2
Retrieves the ChangeRequestIfc object related to the given ChangeIssueIfc object by the FormalizedByIfc assocation. The ChangeRequestIfc object represents the request that formally address the ChangeRequestIfc. If onlyChangeRequest is true, the QueryResult returned contains zero or one ChangeRequest objects.

If onlyChangeRequest is false, the QueryResult returned contains zero or one FormalizedByIfc link objects that has a reference to the ChangeRequestIfc object.

Supported API: true

Specified by:
getChangeRequest in interface ChangeService2
Parameters:
ci -
onlyChangeRequest -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
ChangeRequestIfc, ChangeIssueIfc, FormalizedByIfc

getChangeRequest

public QueryResult getChangeRequest(ChangeAnalysisIfc ca)
                             throws WTException,
                                    ChangeException2
Retrieves the ChangeRequestIfc object related to the given ChangeAnalysisIfc object by the ResearchedByIfc assocation. These ChangeRequestIfc object represents the request for which the ChangeAnalysisIfc is performing . The QueryResult returned contains zero or one ChangeRequestIfc object, not zero or one ResearchedByIfc link object that has a reference to the ChangeRequestIfc object. There is another method that contains the ResearchedByIfc link object.

Supported API: true

Specified by:
getChangeRequest in interface ChangeService2
Parameters:
ca -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
ChangeRequestIfc, ChangeAnalysisIfc, ResearchedByIfc

getChangeRequest

public QueryResult getChangeRequest(ChangeAnalysisIfc ca,
                                    boolean onlyChangeRequest)
                             throws WTException,
                                    ChangeException2
Retrieves the ChangeRequestIfc object related to the given ChangeAnalysisIfc object by the ResearchedByIfc assocation. The ChangeRequestIfc object represents the request that formally address the ChangeRequestIfc. If onlyChangeRequest is true, the QueryResult returned contains zero or one ChangeRequest objects.

If onlyChangeRequest is false, the QueryResult returned contains zero or one ResearchedByIfc link objects that has a reference to the ChangeRequestIfc object.

Supported API: true

Specified by:
getChangeRequest in interface ChangeService2
Parameters:
ca -
onlyChangeRequest -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
ChangeRequestIfc, ChangeAnalysisIfc, ResearchedByIfc

getChangeRequest

public QueryResult getChangeRequest(ChangeOrderIfc co)
                             throws WTException,
                                    ChangeException2
Retrieves the ChangeRequestIfc object related to the given ChangeOrderIfc object by the AddressedByIfc assocation. These ChangeRequestIfc object represents the request for which the ChangeOrderIfc is performing . The QueryResult returned contains zero or one ChangeRequestIfc object, not zero or one AddressedByIfc link object that has a reference to the ChangeRequestIfc object. There is another method that contains the AddressedByIfc link object.

Supported API: true

Specified by:
getChangeRequest in interface ChangeService2
Parameters:
co -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
ChangeRequestIfc, ChangeOrderIfc, AddressedByIfc

getChangeRequest

public QueryResult getChangeRequest(ChangeOrderIfc co,
                                    boolean onlyChangeRequest)
                             throws WTException,
                                    ChangeException2
Retrieves the ChangeRequestIfc object related to the given ChangeOrderIfc object by the AddressedByIfc assocation. The ChangeRequestIfc object represents the request that is addressed by the ChangeOrderIfc. If onlyChangeRequest is true, the QueryResult returned contains zero or one ChangeRequest objects.

If onlyChangeRequest is false, the QueryResult returned contains zero or one AddressedByIfc link objects that has a reference to the ChangeRequestIfc object.

Supported API: true

Specified by:
getChangeRequest in interface ChangeService2
Parameters:
co -
onlyChangeRequest -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
ChangeRequestIfc, ChangeOrderIfc, AddressedByIfc

getChangeAnalysis

public QueryResult getChangeAnalysis(AnalysisActivityIfc aa)
                              throws WTException,
                                     ChangeException2
Retrieves the ChangeAnalysisIfc object related to the given AnalysisActivityIfc object by the DetailedByIfc assocation. These ChangeAnalysisIfc object represents the request for which the AnalysisActivityIfc is performing . The QueryResult returned contains zero or one ChangeAnalysisIfc object, not zero or one DetailedByIfc link object that has a reference to the ChangeAnalysisIfc object. There is another method that contains the DetailedByIfc link object.

Supported API: true

Specified by:
getChangeAnalysis in interface ChangeService2
Parameters:
aa -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
ChangeAnalysisIfc, AnalysisActivityIfc, DetailedByIfc

getChangeAnalysis

public QueryResult getChangeAnalysis(AnalysisActivityIfc aa,
                                     boolean onlyChangeAnalysis)
                              throws WTException,
                                     ChangeException2
Retrieves the ChangeAnalysisIfc object related to the given AnalysisActivityIfc object by the DetailedByIfc assocation. The ChangeAnalysisIfc object represents the request that is addressed by the AnalysisActivityIfc. If onlyChangeAnalysis is true, the QueryResult returned contains zero or one ChangeAnalysisIfc objects.

If onlyChangeAnalysis is false, the QueryResult returned contains zero or one DetailedByIfc link objects that has a reference to the ChangeAnalysisIfc object.

Supported API: true

Specified by:
getChangeAnalysis in interface ChangeService2
Parameters:
aa -
onlyChangeAnalysis -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
ChangeAnalysisIfc, AnalysisActivityIfc, AddressedByIfc

getChangeOrder

public QueryResult getChangeOrder(ChangeActivityIfc ca)
                           throws WTException,
                                  ChangeException2
Retrieves the ChangeOrderIfc object related to the given ChangeActivityIfc object by the IncludedInIfc assocation. These ChangeOrderIfc object represents the request for which the ChangeActivityIfc is performing . The QueryResult returned contains zero or one ChangeOrderIfc object, not zero or one IncludedInIfc link object that has a reference to the ChangeOrderIfc object. There is another method that contains the IncludedInIfc link object.

Supported API: true

Specified by:
getChangeOrder in interface ChangeService2
Parameters:
ca -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
ChangeOrderIfc, ChangeActivityIfc, IncludedInIfc

getChangeOrder

public QueryResult getChangeOrder(ChangeActivityIfc ca,
                                  boolean onlyChangeActivity)
                           throws WTException,
                                  ChangeException2
Retrieves the ChangeOrderIfc object related to the given ChangeActivityIfc object by the IncludedInIfc assocation. The ChangeOrderIfc object represents the request that is addressed by the ChangeActivityIfc. If onlyChangeOrder is true, the QueryResult returned contains zero or one ChangeOrderIfc objects.

If onlyChangeOrder is false, the QueryResult returned contains zero or one IncludedInIfc link objects that has a reference to the ChangeOrderIfc object.

Supported API: true

Specified by:
getChangeOrder in interface ChangeService2
Parameters:
ca -
onlyChangeActivity -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
ChangeOrderIfc, ChangeActivityIfc, IncludedInIfc

getChangingChangeActivities

public QueryResult getChangingChangeActivities(Changeable2 changeable,
                                               boolean onlyChangeActivities)
                                        throws ChangeException2,
                                               WTException
Returns a QueryResult of ChangeActivity2 objects related to the given Changeable2 object by the ChangeRecord2 assocation. These Changeable2 objects represent revisions that need to be changed as part of the change process If onlyChangeActivities is true, the QueryResult returned contains a set of ChangeActivity2 objects.

If onyChangeActivities is false, the QueryResult returned contains a set of AffectedActivityData link objects that have references to the Changeable objects.

Supported API: true

Specified by:
getChangingChangeActivities in interface ChangeService2
Parameters:
changeable -
onlyChangeActivities -
Returns:
QueryResult
Throws:
ChangeException2
WTException
See Also:
WTChangeActivity2, Changeable2

getChangingChangeActivities

public QueryResult getChangingChangeActivities(Changeable2 changeable)
                                        throws ChangeException2,
                                               WTException
Returns a QueryResult of ChangeActivity2 objects related to the given Changeable2 object by the ChangeRecord2 assocation. These Changeable2 objects represent revisions that need to be changed as part of the change process

Supported API: true

Specified by:
getChangingChangeActivities in interface ChangeService2
Parameters:
changeable -
Returns:
QueryResult
Throws:
ChangeException2
WTException
See Also:
WTChangeActivity2, Changeable2

getChangeItem

public ChangeItem getChangeItem(Class theClass,
                                long id)
                         throws WTException,
                                ChangeException2
Retrieves the ChangeItem object that corresponds to the given Class and id. Uses ObjectIdentifier and PersistenceHelper.

Supported API: true

Specified by:
getChangeItem in interface ChangeService2
Parameters:
theClass -
id -
Returns:
ChangeItem
Throws:
WTException
ChangeException2

storeAssociations

public Vector storeAssociations(Class theClass,
                                ChangeItemIfc ci,
                                Vector changeables)
                         throws ChangeException2,
                                WTException
Stores all the associations between the ChangeItemIfc object and the Changeable2 objects in the input vector and returns a vector of the persisted association objects.

Supported API: true

Specified by:
storeAssociations in interface ChangeService2
Parameters:
theClass -
ci -
changeables -
Returns:
Vector
Throws:
ChangeException2
WTException

getChangeItem

public ChangeItem getChangeItem(String oid)
                         throws WTException,
                                ChangeException2
Retrieves the ChangeItem object that corresponds to the given oid. Uses the ReferenceFactory.

Supported API: true

Specified by:
getChangeItem in interface ChangeService2
Parameters:
oid -
Returns:
ChangeItem
Throws:
WTException
ChangeException2
See Also:
ReferenceFactory

findChangeRequest

public ChangeRequestIfc findChangeRequest(Object theObject)
                                   throws WTException,
                                          ChangeException2
Uses Change2DelegateFactory and FindChangeRequestDelegate mechanism to find the change request associated with the object passed in.

Supported API: true

Specified by:
findChangeRequest in interface ChangeService2
Parameters:
theObject -
Returns:
ChangeRequestIfc
Throws:
WTException
ChangeException2
See Also:
ChangeRequestIfc, Change2DelegateFactory, FindChangeRequestDelegate

getRelevantChangeRequests

public QueryResult getRelevantChangeRequests(Changeable2 changeable,
                                             boolean onlyChangeRequests)
                                      throws ChangeException2,
                                             WTException
Returns a QueryResult of ChangeRequest2 objects related to the given Changeable2 object by the RelevantRequestData2 association. This association links product data that the user considers relevant to the change request. If onlyChangeRequests is true, the QueryResult returned contains a set of ChangeActivity2 objects.

If onlyChangeRequests is false, the QueryResult returned contains a set of RelevantRequestData2 link objects that have references to the Changeable2 object.

Supported API: true

Specified by:
getRelevantChangeRequests in interface ChangeService2
Parameters:
changeable -
onlyChangeRequests -
Returns:
QueryResult
Throws:
ChangeException2
WTException
See Also:
WTChangeRequest2, Changeable2

getRelevantChangeRequests

public QueryResult getRelevantChangeRequests(Changeable2 changeable)
                                      throws ChangeException2,
                                             WTException
Returns a QueryResult of ChangeRequest2 objects related to the given Changeable2 object by the RelevantRequestData2 association. This association links product data that the user considers relevant to the change request.

Supported API: true

Specified by:
getRelevantChangeRequests in interface ChangeService2
Parameters:
changeable -
Returns:
QueryResult
Throws:
ChangeException2
WTException
See Also:
WTChangeRequest2, Changeable2

unattachChangeable

public void unattachChangeable(Changeable2 refObject,
                               ChangeItem changeItem,
                               Class linkClass,
                               String changeRole)
                        throws ChangeException2,
                               WTException
Deletes the association between a ChangeItem and a Changeable2. Also removes the associated working copy if the Changeable2 is checked out.

Supported API: true

Specified by:
unattachChangeable in interface ChangeService2
Parameters:
refObject - A Changeable2 object to be disassociatd from a ChangeItem.
changeItem - The ChangeItem associated to the Changeable2.
linkClass - The associated link Class, which has a ChangeItem as role A.
changeRole - The role name.
Throws:
ChangeException2
WTException

getSubjectProducts

public QueryResult getSubjectProducts(ChangeRequestIfc cr,
                                      boolean onlyProducts)
                               throws WTException,
                                      ChangeException2
Retrieves the WTProductMaster objects related to the given ChangeRequestIfc object by the SubjectProductIfc assocation. These WTProductMaster objects represent additional documentation for the Change Request. The QueryResult returned contains a set of WTProductMaster objects, not a set of SubjectProduct link objects that have references to the WTProductMaster objects. There is another method that contains the SubjectProduct link objects. Get the working copy if the current user was the one who checked it out, otherwise get the checked out copy.

Supported API: true

Specified by:
getSubjectProducts in interface ChangeService2
Parameters:
cr -
onlyProducts -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
WTProductMaster, ChangeRequestIfc, SubjectProduct

getSubjectProducts

public QueryResult getSubjectProducts(ChangeRequestIfc cr)
                               throws WTException,
                                      ChangeException2
Retrieves the WTProductMaster objects related to the given ChangeRequestIfc object by the SubjectProductIfc assocation. These WTProductMaster objects represent additional documentation for the Change Request. If onlyProducts is true, the QueryResult returned contains a set of WTProductMaster objects.

If onlyProducts is false, the QueryResult returned contains a set of SubjectProductIfc link objects that have references to the WTProductMaster objects. Get the working copy if the current user was the one who checked it out, otherwise get the checked out copy.

Supported API: true

Specified by:
getSubjectProducts in interface ChangeService2
Parameters:
cr -
Returns:
QueryResult
Throws:
WTException
ChangeException2
See Also:
WTProductMaster, ChangeRequestIfc, SubjectProduct

unattachProduct

public void unattachProduct(WTProductMaster refObject,
                            ChangeItemIfc changeItem,
                            Class linkClass,
                            String changeRole)
                     throws ChangeException2,
                            WTException
Deletes the association between a ChangeItem and a Changeable2. Also removes the associated working copy if the Changeable2 is checked out.

Supported API: true

Specified by:
unattachProduct in interface ChangeService2
Parameters:
refObject - A Changeable2 object to be disassociatd from a ChangeItem.
changeItem - The ChangeItem associated to the Changeable2.
linkClass - The associated link Class, which has a ChangeItem as role A.
changeRole - The role name.
Throws:
ChangeException2
WTException

deleteFormalizedBy

public FormalizedByIfc deleteFormalizedBy(Class linkClass,
                                          ChangeRequestIfc cr,
                                          ChangeIssueIfc ci)
                                   throws WTException,
                                          ChangeException2
Delete the FormalizedByIfc relationship implied by the three arguments. The concrete subclasses of the ChangeRequestIfc, the ChangeIssueIfc and the FormalizedByIfc relationship must already be persistent. In the event there is no FormalizedByIfc (the change objects passed in are not related) then there will be no exception generated, instead a null will be returned.

Supported API: true

Specified by:
deleteFormalizedBy in interface ChangeService2
Parameters:
linkClass -
cr -
ci -
Returns:
FormalizedByIfc
Throws:
WTException
ChangeException2

getChangeables

public QueryResult getChangeables(ChangeIssueIfc changeIssue)
                           throws WTException,
                                  ChangeException2
Retrieves the Changeable2 objects related to the given ChangeIssueIfc object by the ReportedAgainst association.

Supported API: true

Specified by:
getChangeables in interface ChangeService2
Parameters:
changeIssue -
Returns:
QueryResult
Throws:
WTException
ChangeException2

getChangeables

public QueryResult getChangeables(ChangeIssueIfc changeIssue,
                                  boolean onlyChangeables)
                           throws WTException,
                                  ChangeException2
Retrieves the Changeable2 objects related to the given ChangeIssueIfc object by the Reported Against association. If onlyChangeables is true, the QueryResult returned contains a set of Changeable2 objects.

If onlyChangeables is false, the QueryResult returned contains a set of ReportedAgainst link objects that have references to the Changeable2 objects.

Supported API: true

Specified by:
getChangeables in interface ChangeService2
Parameters:
changeIssue -
onlyChangeables -
Returns:
QueryResult
Throws:
WTException
ChangeException2

getProblemProducts

public QueryResult getProblemProducts(ChangeIssueIfc changeIssue,
                                      boolean onlyProducts)
                               throws WTException,
                                      ChangeException2
Retrieves the WTProductMaster objects related to the given ChangeIssueIfc object by the ProblemProduct association.

Supported API: true

Specified by:
getProblemProducts in interface ChangeService2
Parameters:
changeIssue -
onlyProducts -
Returns:
QueryResult
Throws:
WTException
ChangeException2

getProblemProducts

public QueryResult getProblemProducts(ChangeIssueIfc changeIssue)
                               throws WTException,
                                      ChangeException2
Retrieves the WTProductMaster objects related to the given ChangeIssueIfc object by the ProblemProduct association.

Supported API: true

Specified by:
getProblemProducts in interface ChangeService2
Parameters:
changeIssue -
Returns:
QueryResult
Throws:
WTException
ChangeException2

deleteAddressedBy

public AddressedByIfc deleteAddressedBy(ChangeRequestIfc cr,
                                        ChangeOrderIfc co)
                                 throws WTException,
                                        ChangeException2
Delete the AddressedByIfc relationship implied by the two arguments. The concrete subclasses of the ChangeRequestIfc, the ChangeOrderIfc and the AddressedByIfc relationship must already be Persistent. In the event there is no AddressedByIfc (the two objects passed in are not related) then there will be no exception generated, instead a null will be returned..

Supported API: true

Specified by:
deleteAddressedBy in interface ChangeService2
Parameters:
cr -
co -
Returns:
AddressedByIfc
Throws:
WTException
ChangeException2

getReportedAgainstChangeIssue

public QueryResult getReportedAgainstChangeIssue(Changeable2 changeable)
                                          throws WTException,
                                                 ChangeException2
Returns a QueryResult of ChangeIssues objects related to the given Changeable2 object by the ReportedAgainst assocation.

Supported API: true

Specified by:
getReportedAgainstChangeIssue in interface ChangeService2
Parameters:
changeable -
Returns:
QueryResult
Throws:
WTException
ChangeException2

getUniqueImplementedChangeOrders

public QueryResult getUniqueImplementedChangeOrders(Changeable2 changeable)
                                             throws ChangeException2,
                                                    WTException
Returns a QueryResult of unique ChangeOrder2 objects that are indirectly related to the given Changeable2 object. This method obtains all ChangeActivity2 objects connected to the given Changeable2 via the ChangeRecord2 association, and then obtains all of the parent ChangeOrder2 objects via the IncludedIn2 association. Finally, the result is filtered to remove duplicates.

Supported API: true

Specified by:
getUniqueImplementedChangeOrders in interface ChangeService2
Parameters:
changeable -
Returns:
QueryResult
Throws:
ChangeException2
WTException

getUniqueAffectingChangeOrders

public QueryResult getUniqueAffectingChangeOrders(Changeable2 changeable)
                                           throws ChangeException2,
                                                  WTException
Returns a QueryResult of unique ChangeOrder2 objects that are indirectly related to the given Changeable2 object. This method obtains all ChangeActivity2 objects connected to the given Changeable2 via the AffectedActivityData association, and then obtains all of the parent ChangeOrder2 objects via the IncludedIn2 association. Finally, the result is filtered to remove duplicates.

Supported API: true

Specified by:
getUniqueAffectingChangeOrders in interface ChangeService2
Parameters:
changeable -
Returns:
QueryResult
Throws:
ChangeException2
WTException

saveResearchedBy

public ResearchedByIfc saveResearchedBy(ChangeRequestIfc cr,
                                        ChangeProposalIfc cp)
                                 throws ChangeException2,
                                        WTException
Stores the given concrete subclass of ResearchedByIfc in the database. It constructs the ResearchedByIfc based on the ChangeRequestIfc and ChangeProposalIfc objects passed in, using the ResearchedByDelegate.

Supported API: true

Specified by:
saveResearchedBy in interface ChangeService2
Parameters:
cr -
cp -
Returns:
ResearchedByIfc
Throws:
ChangeException2
WTException
See Also:
ResearchedByIfc, ChangeRequestIfc, ChangeProposalIfc, ResearchedByDelegate

saveAddressedBy

public AddressedByIfc saveAddressedBy(ChangeRequestIfc cr,
                                      ChangeOrderIfc co)
                               throws ChangeException2,
                                      WTException
Stores the given concrete subclass of AddressedByIfc in the database. It constructs the ArrdesssedByIfc based on the ChangeRequestIfc and ChangeOrderIfc objects passed in, using theAddressedByDelegate.

Supported API: true

Specified by:
saveAddressedBy in interface ChangeService2
Parameters:
cr -
co -
Returns:
AddressedByIfc
Throws:
ChangeException2
WTException
See Also:
AddressedByIfc, ChangeRequestIfc, ChangeOrderIfc, AddressedByDelegate

getRelevantFolder

public Folder getRelevantFolder(ChangeItemIfc changeItem)
                         throws WTException
Returns the folder that is 'relevant' for the argument change object. In the case of a 'primary' change object -- a change issue, change request, or change order -- this is simply the object's folder. In the case of a 'secondary' change object -- a change analysis, analysis activity, or change activity -- this is the folder of its associated 'primary' change object.

Supported API: false

Specified by:
getRelevantFolder in interface ChangeService2
Parameters:
changeItem -
Returns:
Folder
Throws:
WTException

filterForPendingChanges

public Set filterForPendingChanges(Set changeable2Refs)
                            throws WTException
Queries the database to compute the subset of the argument set of references to persistent Changeable2 objects whose members have pending changes. A Changeable2 object has a pending change if it satisfies either of the following conditions:

Supported API: false

Specified by:
filterForPendingChanges in interface ChangeService2
Parameters:
changeable2Refs - set of wt.fc.ObjectReference objects referencing Changeable2 objects to be filtered for pending changes
Returns:
a new set of new wt.fc.ObjectReference objects that is the subset of the argument set whose members reference Changeable2 objects having pending changes
Throws:
WTException

hasPendingChange

public boolean hasPendingChange(ObjectReference changeable2Ref)
                         throws WTException
Queries the database to compute whether the argument reference to a persistent Changeable2 object has a pending change. A Changeable2 object has a pending change if it satisfies either of the following conditions:

Supported API: false

Specified by:
hasPendingChange in interface ChangeService2
Parameters:
changeable2Ref - reference to a Changeable2 object to be tested for pending change
Returns:
true if and only if the argument reference is to a Changeable2 object having a pending change
Throws:
WTException

getCMIIBaseline

public TableModel getCMIIBaseline(WTPart assembly)
                           throws WTException
Queries the database to compute whether the argument reference to a persistent Changeable2 object has a pending change. A Changeable2 object has a pending change if it satisfies either of the following conditions:

Supported API: false

Specified by:
getCMIIBaseline in interface ChangeService2
Parameters:
assembly -
Returns:
true if and only if the argument reference is to a Changeable2 object having a pending change
Throws:
WTException

chooseLifeCycle

protected void chooseLifeCycle(ChangeItemIfc ci)
                        throws ChangeException2,
                               WTException
Throws:
ChangeException2
WTException

assignLocation

protected ChangeItemIfc assignLocation(ChangeItemIfc target,
                                       ChangeItemIfc source)
                                throws ChangeException2,
                                       WTException
Assign a folder or cabinet location through a delegate, based on the folder or cabinet of another change object.

Parameters:
target - The target change object.
source - The source change object.
Returns:
ChangeItemIfc Returns the target change object.
Throws:
ChangeException2
WTException

assignLocation

protected void assignLocation(ChangeItemIfc target)
                       throws ChangeException2,
                              WTException
Assign a folder or cabinet location through a delegate.

Parameters:
target - The target change object.
Returns:
ChangeItemIfc Returns the target change object.
Throws:
ChangeException2
WTException

changeFolder

protected ChangeItemIfc changeFolder(ChangeItemIfc target,
                                     ChangeItemIfc source)
                              throws ChangeException2,
                                     WTException
Throws:
ChangeException2
WTException

checkChangeItemLock

private void checkChangeItemLock(Lockable target)
                          throws WTException
Throws:
WTException

checkChangeItemModification

private void checkChangeItemModification(Persistable target,
                                         String messageID)
                                  throws WTException
Throws:
WTException

checkStoreOfAffectedActivityData

protected void checkStoreOfAffectedActivityData(AffectedActivityData target)
                                         throws WTException
Throws:
WTException

checkStoreOfChangeRecord

protected void checkStoreOfChangeRecord(ChangeRecordIfc target)
                                 throws WTException
Throws:
WTException

checkStoreOfFormalizedBy

protected void checkStoreOfFormalizedBy(FormalizedByIfc target)
                                 throws WTException
Throws:
WTException

checkStoreOfRelevantAnalysisData

protected void checkStoreOfRelevantAnalysisData(RelevantAnalysisData target)
                                         throws WTException
Throws:
WTException

checkStoreOfRelevantRequestData2

protected void checkStoreOfRelevantRequestData2(RelevantRequestData2 target)
                                         throws WTException
Throws:
WTException

checkStoreOfReportedAgainst

protected void checkStoreOfReportedAgainst(ReportedAgainst target)
                                    throws WTException
Throws:
WTException

checkModifyOfAffectedActivityData

protected void checkModifyOfAffectedActivityData(AffectedActivityData target)
                                          throws WTException
Throws:
WTException

checkModifyOfChangeRecord

protected void checkModifyOfChangeRecord(ChangeRecordIfc target)
                                  throws WTException
Throws:
WTException

checkModifyOfRelevantAnalysisData

protected void checkModifyOfRelevantAnalysisData(RelevantAnalysisData target)
                                          throws WTException
Throws:
WTException

checkModifyOfRelevantRequestData2

protected void checkModifyOfRelevantRequestData2(RelevantRequestData2 target)
                                          throws WTException
Throws:
WTException

checkDeleteOfChangeRecord

protected void checkDeleteOfChangeRecord(ChangeRecordIfc target)
                                  throws WTException
Throws:
WTException

propagateDeleteToChangeAnalysis

protected void propagateDeleteToChangeAnalysis(ChangeRequestIfc deleteTarget,
                                               ResearchedByIfc deleteLink)
                                        throws WTException
Throws:
WTException

propagateDeleteToChangeOrder

protected void propagateDeleteToChangeOrder(ChangeRequestIfc deleteTarget,
                                            AddressedByIfc deleteLink)
                                     throws WTException
Throws:
WTException

propagateDeleteToAnalysisActivity

protected void propagateDeleteToAnalysisActivity(ChangeAnalysisIfc deleteTarget,
                                                 DetailedByIfc deleteLink)
                                          throws WTException
Throws:
WTException

propagateDeleteToChangeActivity

protected void propagateDeleteToChangeActivity(ChangeOrderIfc deleteTarget,
                                               IncludedInIfc deleteLink)
                                        throws WTException
Throws:
WTException

copyChangeableLinks

protected void copyChangeableLinks(Changeable2 original,
                                   Changeable2 working)
                            throws WTException,
                                   WTPropertyVetoException
Throws:
WTException
WTPropertyVetoException

copyChangeableLinks

protected void copyChangeableLinks(WTKeyedMap changeable_map,
                                   WTCollection changeable_list)
                            throws WTException
Throws:
WTException

deleteChangeLinks

protected void deleteChangeLinks(WTCollection changeableList)
                          throws WTException
Delete change item links with given changeables

Throws:
WTException

checkDeleteOfChangeableCollection

protected void checkDeleteOfChangeableCollection(WTArrayList target_list)
                                          throws WTException,
                                                 ChangeException2
Throws:
WTException
ChangeException2

getChunk

private long[] getChunk(long[] ids,
                        int i)

filterTargets

private WTArrayList filterTargets(WTCollection targets)
                           throws WTException
Throws:
WTException

isCheckNeeded

private boolean isCheckNeeded(Persistable object)
                       throws WTException
Throws:
WTException

checkDeleteOfChangeable

protected void checkDeleteOfChangeable(Changeable2 deleteTarget)
                                throws WTException,
                                       ChangeException2
On a PersistenceManager PRE-DELETE event, prevent deleting a Changeable object that is attached to a change object. Note that we are not preventing the valid WIP deletes or the deletion of a session iteration.

Throws:
WTException
ChangeException2

isAttached

private boolean isAttached(long[] target_ids,
                           Class link_class,
                           String change_role)
                    throws WTException
Throws:
WTException

getAttachedSc

private SearchCondition getAttachedSc(Class link_class,
                                      String other_role,
                                      long[] target_ids)
                               throws WTException
Throws:
WTException

propagateFolderChange

private void propagateFolderChange(ChangeRequestIfc request)
                            throws ChangeException2,
                                   WTException
Throws:
ChangeException2
WTException

propagateFolderChange

private void propagateFolderChange(ChangeOrderIfc order)
                            throws ChangeException2,
                                   WTException
Throws:
ChangeException2
WTException

propagateFolderChange

private void propagateFolderChange(ChangeAnalysisIfc order)
                            throws ChangeException2,
                                   WTException
Throws:
ChangeException2
WTException

checkLocation

protected void checkLocation(FolderEntry target)
                      throws ChangeException2,
                             WTException
Throws:
ChangeException2
WTException

emitCAStateChangedEvent

private void emitCAStateChangedEvent(ChangeActivity2 ca)
                              throws ChangeException2,
                                     WTException
Throws:
ChangeException2
WTException

getDisplayName

private String getDisplayName(Class object)

handleLifeCycleException

private void handleLifeCycleException(ChooseLifeCycleDelegate delegate,
                                      LifeCycleManaged lcm)
                               throws ChangeException2,
                                      WTException
Throw an appropriate exception in response to a problem setting a life cycle on a new change object

Parameters:
delegate - A ChooseLifeCycleDelegate object
lcm - A LifeCycleManaged object
Throws:
ChangeException2
wt.fc.WTException
WTException

dispatchVetoableEvent

private static void dispatchVetoableEvent(String eventType,
                                          Object eventTarget,
                                          Object secondaryEventTarget)
                                   throws WTException,
                                          WTPropertyVetoException
Throws:
WTException
WTPropertyVetoException

pendingChangeExist

public static boolean pendingChangeExist(Object object)
Deprecated. use ChangeHelper2.service.hasPendingChange(ObjectReference)

Determine if a Changeable object has an associated ChangeOrder or ChangeRequest in the state of OPEN, IMPLEMENTATION, UNDERREVIEW.

Supported API: false


pendingChangeExist

public static boolean pendingChangeExist(ObjectReference objectRef)
Deprecated. use ChangeHelper2.service.hasPendingChange(ObjectReference)

Determine if a Changeable object has an associated ChangeOrder or ChangeRequest in the state of OPEN, IMPLEMENTATION, UNDERREVIEW.

Supported API: false

Parameters:
objectRef - a reference to a Changeable2 object

pendingChanges

public static Set pendingChanges(Set objectRefs)
                          throws WTException
Deprecated. use ChangeHelper2.service.filterForPendingChanges(Set)

Given a set of object references to changeables, returns a new set that is the subset whose members have pending changes.

Supported API: false

Throws:
WTException

newChangeLinkSpec

private QuerySpec newChangeLinkSpec(Class linkClass,
                                    Class changeClass,
                                    String role,
                                    long[] oids)
                             throws WTException
Returns a new query spec selecting the class name and OID of the changeables whose OIDs are specified, and are associated with the named link class (linking the changeable to the named change class). The query spec represents a join between the named link class and the named change class, where the former is at query index 0, and the latter at query index 1.

Throws:
WTException

newPendingChangeOrderExpression

private WhereExpression newPendingChangeOrderExpression(FromClause fc,
                                                        int idx)
                                                 throws WTException,
                                                        WTPropertyVetoException
Returns a new where expression testing whether a change activity is associated with a pending change order, based on the from clause and index of a query selecting that change activity.

Throws:
WTException
WTPropertyVetoException

fixDomainAssignment

private void fixDomainAssignment(CabinetMember target,
                                 FolderEntry source)
                          throws WTException
Silently fixes the domain assignment of the non-Foldered target change object to match that of the source change object only if the cabinet previously assigned by the rules service (i.e., not assigned by a ChooseFolderDelegate) resulted in an incorrect domain assignment.

Parameters:
target - the non-foldered change object (change analysis, analysis activity, or change activity) source the "parent" of the target change object (change request, change analysis, or change order)
Throws:
ClassCastException - if the target or source is not DomainAdministered NullPointerException if either argument is non-persistent
WTException

getId

private long getId(Persistable obj)
            throws WTException
Throws:
WTException

getOid

private ObjectIdentifier getOid(Object object)
Returns object's associated oid. Accepts not only Persistable as argument but also ObjectReference and ObjectIdentifier objects. Returns 'null' if object is null.


getOidString

private String getOidString(Object object)
Returns String representation of the object's oid (debugging).


sameBranch

private boolean sameBranch(Iterated iter1,
                           Iterated iter2)
                    throws WTException
Returns whether two iterations belong to the same branch.

Throws:
WTException

showCollection

private String showCollection(Collection collection)
                       throws WTException
Returns String representation of the list passed as argument (debugging).

Throws:
WTException

getRows

private List getRows(int level,
                     Set partUsages,
                     String item_ad,
                     View view)
              throws WTException
Throws:
WTException

getRows

private List getRows(int level,
                     WTPartUsageLink usage,
                     String item_ad,
                     View view)
              throws WTException
Throws:
WTException

getRows

private Set getRows(Set changeables,
                    String item_ad,
                    String ad,
                    WTPart part)
             throws WTException
Throws:
WTException

getRow

private ArrayList getRow(Changeable2 doc,
                         String item_ad,
                         String ad,
                         WTPart part)
                  throws WTException
Throws:
WTException

getEffectivity

private List getEffectivity(Changeable2 doc,
                            WTPart part)
                     throws WTException
Throws:
WTException

getVersionInfo

private String getVersionInfo(Changeable2 changeable)
                       throws WTException
Throws:
WTException