wt.epm.workspaces
Class EPMStandardWorkspaceManager

java.lang.Object
  wt.services.StandardManager
      wt.epm.workspaces.EPMStandardWorkspaceManager

All Implemented Interfaces:

Serializable, EPMWorkspaceManager, NetFactor, wt.services.Manager

public class EPMStandardWorkspaceManager
extends StandardManager
implements EPMWorkspaceManager, Serializable

Use the newEPMStandardWorkspaceManager static factory method(s), not the EPMStandardWorkspaceManager 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:

Serialized Form

Field Summary

Fields inherited from interface wt.epm.workspaces.EPMWorkspaceManager

POPULATE_WS_FLAG_DEPENDENCIES_ALL, POPULATE_WS_FLAG_DEPENDENCIES_NONE, POPULATE_WS_FLAG_DEPENDENCIES_REQUIRED, POPULATE_WS_FLAG_DOC_CENTRIC, POPULATE_WS_FLAG_FT_CHECK_COMPATIBILITY, POPULATE_WS_FLAG_FT_INCLUDE_ALL, POPULATE_WS_FLAG_FT_INCLUDE_GENERIC, POPULATE_WS_FLAG_FT_INCLUDE_INSTANCES, POPULATE_WS_FLAG_INCLUDE_DRAWINGS, POPULATE_WS_FLAG_PART_CENTRIC

Method Summary

EPMWorkspace	addToWorkspace(EPMWorkspace workspace, WTCollection baselineables) Add the specified baselineable objects and family table objectsto the Workspace.
WTSet	checkin(EPMWorkspace workspace, WTKeyedMap toCheckin) Checks in the given list of working copies or new objects.
WTSet	checkin(EPMWorkspace workspace, WTKeyedMap toCheckin, wt.epm.EPMGhostResolver.EPMGhostResolverDelegate ghostResolutionDelegate) Checks in the given list of working copies or new objects.
WTValuedMap	checkout(EPMWorkspace workspace, WTCollection objects) Checks out the given list of objects to the given workspace folder.
EPMWorkspace	createTransparentWorkspace(WTContainer container, WTPartConfigSpec partConfigSpec, EPMDocConfigSpec docConfigSpec) Creates a new transparent workspace for the given container Supported API: true
WTSet	getObjectsInWorkspace(EPMWorkspace workspace, Class classObject) Get the set of objects included in the Checkpoint associated with the workspace.
WTSet	getWorkspaces(WTPrincipal user, WTContainerRef solution) Returns all of the workspaces associated with a given user and container.
EPMWorkspace	populateWorkspace(EPMWorkspace workspace, WTCollection baselineables) Adds the Baselineable item iterations to the Workspace.
EPMWorkspace	populateWorkspace(EPMWorkspace workspace, WTCollection baselineables, int flags) Adds the Baselineable item iterations to the Workspace.
EPMWorkspace	removeFromWorkspace(EPMWorkspace workspace, WTCollection baselinables) Remove the specified objects from the Workspace.
void	setAttributes(EPMWorkspace workspace, WTKeyedMap attrValues) Set the attribute values (IBA) passed for each of the EPMDocument passed in attrValues.
WTSet	undoCheckout(EPMWorkspace workspace, WTCollection workingCopies) Undoes check out the given list of working copies from the given workspace folder.
WTSet	undoCheckout(WTCollection workingCopies) Undoes check out the given list of working copies from the given workspace folder.
WTSet	undoCheckoutAndRestoreInWorkspace(EPMWorkspace workspace, WTCollection workingCopies) Undoes check out the given list of working copies from the given workspace folder and restores originals in Workspace baseline.

Methods inherited from class wt.services.StandardManager

getManagerService, getManagerStatus, getName, getStartupType

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Detail

checkout

public WTValuedMap checkout(EPMWorkspace workspace,
                            WTCollection objects)
                     throws WTException

Checks out the given list of objects to the given workspace folder. Returns a map whose keys are the given list of object and whose values are the working copies.

Supported API: true

Specified by:

checkout in interface EPMWorkspaceManager

Parameters:

workspace -

objects - A collection of objects to be checked out.

Returns:

WTValuedMap

Throws:

WTException

undoCheckout

public WTSet undoCheckout(EPMWorkspace workspace,
                          WTCollection workingCopies)
                   throws WTException

Undoes check out the given list of working copies from the given workspace folder. Returns a WTSet of originals. Please note that the object is removed from the workspace. If the desired behavior is to restore the original to the workspace, use undoCheckoutAndRestoreInWorkspace.

Supported API: true

Specified by:

undoCheckout in interface EPMWorkspaceManager

Parameters:

workspace -

workingCopies - A collection of objects to be checked out.

Returns:

WTSet

Throws:

WTException

checkin

public WTSet checkin(EPMWorkspace workspace,
                     WTKeyedMap toCheckin)
              throws WTException

Checks in the given list of working copies or new objects.

Supported API: true

Specified by:

checkin in interface EPMWorkspaceManager

Parameters:

workspace -

toCheckin - The keys are the working copies to be checked in and the values are CheckinOption objects. If the CheckinOption is null, the checkin comment is set to an empty string and the object is moved to the target folder.

Returns:

WTSet

Throws:

WTException

checkin

public WTSet checkin(EPMWorkspace workspace,
                     WTKeyedMap toCheckin,
                     wt.epm.EPMGhostResolver.EPMGhostResolverDelegate ghostResolutionDelegate)
              throws WTException

Checks in the given list of working copies or new objects.

Supported API: true

Specified by:

checkin in interface EPMWorkspaceManager

Parameters:

workspace -

toCheckin - The keys are the working copies to be checked in and the values are CheckinOption objects. If the CheckinOption is null, the checkin comment is set to an empty string and the object is moved to the target folder.

ghostResolutionDelegate -

Returns:

WTSet

Throws:

WTException

addToWorkspace

public EPMWorkspace addToWorkspace(EPMWorkspace workspace,
                                   WTCollection baselineables)
                            throws WTException

Add the specified baselineable objects and family table objectsto the Workspace. If another item in theWorkspace has the same Master as the Baselineable, then the current item in the Workspace is replaced with this Baselineable. If the iteration is currently part of theWorkspace, then nothing occurs and no exception is thrown

Supported API: true

Specified by:

addToWorkspace in interface EPMWorkspaceManager

Parameters:

workspace - The workspace to be affected by the call.

baselineables -

Returns:

EPMWorkspace

Throws:

WTException

removeFromWorkspace

public EPMWorkspace removeFromWorkspace(EPMWorkspace workspace,
                                        WTCollection baselinables)
                                 throws WTException

Remove the specified objects from the Workspace.

Supported API: true

Specified by:

removeFromWorkspace in interface EPMWorkspaceManager

Parameters:

workspace - The workspace to be affected by the call.

baselinables -

Returns:

EPMWorkspace

Throws:

WTException

populateWorkspace

public EPMWorkspace populateWorkspace(EPMWorkspace workspace,
                                      WTCollection baselineables)
                               throws WTException

Adds the Baselineable item iterations to the Workspace.

Supported API: true

Specified by:

populateWorkspace in interface EPMWorkspaceManager

Parameters:

workspace - The workspace to be affected by the call.

baselineables - A collection of objects to be added (together with the related items determined by the populareRule) to the workspace.

Returns:

EPMWorkspace

Throws:

WTException

populateWorkspace

public EPMWorkspace populateWorkspace(EPMWorkspace workspace,
                                      WTCollection baselineables,
                                      int flags)
                               throws WTException

Adds the Baselineable item iterations to the Workspace.

Supported API: true

Specified by:

populateWorkspace in interface EPMWorkspaceManager

Parameters:

workspace - The workspace to be affected by the call.

baselineables - A collection of objects to be added (together with the related items determined by the populareRule) to the workspace.

flags - Population flags

Returns:

EPMWorkspace

Throws:

WTException

getObjectsInWorkspace

public WTSet getObjectsInWorkspace(EPMWorkspace workspace,
                                   Class classObject)
                            throws WTException

Get the set of objects included in the Checkpoint associated with the workspace.

Supported API: true

Specified by:

getObjectsInWorkspace in interface EPMWorkspaceManager

Parameters:

workspace - The workspace to be affected by the call.

classObject -

Returns:

WTSet

Throws:

WTException

getWorkspaces

public WTSet getWorkspaces(WTPrincipal user,
                           WTContainerRef solution)
                    throws WTException

Returns all of the workspaces associated with a given user and container. If user is not specified, current principal is used. If container is not specified, all the workspaces of the user are returned. If the container is a reference to a PDMLink container, returns all the workspaces of that solution and not that specific PDMLink container. In order to get the workspaces associated with that specific PDMLink container, filters the returns set accordingly.

Supported API: true

Specified by:

getWorkspaces in interface EPMWorkspaceManager

Parameters:

user -

solution -

Returns:

WTSet

Throws:

WTException

undoCheckoutAndRestoreInWorkspace

public WTSet undoCheckoutAndRestoreInWorkspace(EPMWorkspace workspace,
                                               WTCollection workingCopies)
                                        throws WTException

Undoes check out the given list of working copies from the given workspace folder and restores originals in Workspace baseline. Returns a WTSet of originals.

Supported API: true

Specified by:

undoCheckoutAndRestoreInWorkspace in interface EPMWorkspaceManager

Parameters:

workspace -

workingCopies - A collection of objects to be checked out.

Returns:

WTSet

Throws:

WTException

setAttributes

public void setAttributes(EPMWorkspace workspace,
                          WTKeyedMap attrValues)
                   throws WTException

Set the attribute values (IBA) passed for each of the EPMDocument passed in attrValues. It handles propogation of IBA values to Family table instances that inherit the values from generics. The API can also be used to set IBA values on instances where the attribute is part of Family Table.

Supported API: true

Specified by:

setAttributes in interface EPMWorkspaceManager

Parameters:

workspace - EPMWorkspace to which the passed EPMDocuments are checked-out.

attrValues - WTKeyedMap where key is EPMDocument and the value is a Map of IBA ExtHid and IBA value. The IBA value can be NULL.

Throws:

WTException

undoCheckout

public WTSet undoCheckout(WTCollection workingCopies)
                   throws WTException

Undoes check out the given list of working copies from the given workspace folder. Returns a WTSet of originals. Please note that the object is removed from the workspace. If the desired behavior is to restore the original to the workspace, use undoCheckoutAndRestoreInWorkspace.

Supported API: true

Specified by:

undoCheckout in interface EPMWorkspaceManager

Parameters:

workingCopies - A collection of objects to be checked out.

Returns:

WTSet

Throws:

WTException

createTransparentWorkspace

public EPMWorkspace createTransparentWorkspace(WTContainer container,
                                               WTPartConfigSpec partConfigSpec,
                                               EPMDocConfigSpec docConfigSpec)
                                        throws WTException

Creates a new transparent workspace for the given container

Supported API: true

Specified by:

createTransparentWorkspace in interface EPMWorkspaceManager

Parameters:

container -

partConfigSpec - partConfigSpec for the Workspace, If null, then latest config spec will be assigned to the part config spec.

docConfigSpec - docConfigSpec for the Workspace, If null, then latest config spec will be assigned to the document config spec.

Returns:

EPMWorkspace

Throws:

WTException