Package wt.vc.wip

Interface WorkInProgressService

All Known Implementing Classes:

StandardWorkInProgressService

@RemoteInterface
public interface WorkInProgressService

Provides server-side functionality as a service that's remotely available for use by a client. The intent is that this interface defines all the necessary server-side functionality for WIP.

Note that the methods in this service do not consider/handle "sandbox" checkouts, but rather are specific to work-in-progress checkouts.

Supported API: true

Extendable: false

Method Summary

Modifier and Type	Method	Description
WTCollection	allWorkingCopiesOf(Workable object)	Navigates to the working copy of an original copy via the CheckoutLink.
WTCollection	checkin(WTCollection objects, String note)	Checkin a WTCollection of Workable objects.
WTCollection	checkin(WTCollection objects, String note, String folder)	Checkin a WTCollection of Workable objects to the folder specified by the name passed.
WTCollection	checkin(WTCollection objects, String note, Folder folder)	Checkin a WTCollection of Workable objects to the folder specified by the name passed.
WTCollection	checkin(WTKeyedMap objects)	Checkin a WTKeyedMap of Workable objects where the key is the Workable object, and the value is the note for that checkin.
WTCollection	checkin(WTKeyedMap workableToNoteMap, WTValuedMap workableToFolderMap)	Checkin a WTKeyedMap of Workable objects to checkin notes the folders specified by WTValuedMap of Workable objects to Folder objects passed.
WTCollection	checkin(WTKeyedMap objects, Folder folder)	Checkin a WTKeyedMap of Workable objects to the folder specified by the name passed.
Workable	checkin(Workable object, String note)	Checkin a workable object.
Workable	checkin(Workable object, String note, boolean isImplicitCheckin)	Checkin a WTCollection of Workable objects.
WTCollection	checkout(WTCollection objects, Folder folder, String note)	Checks out a WTCollection of Workable objects to the specified folder.
WTCollection	checkout(WTCollection objects, Folder folder, String note, boolean allowNonLatestCheckout)	Checks out a WTCollection of Workable objects to the specified folder.
WTCollection	checkout(WTCollection objects, Folder folder, String note, boolean allowNonLatestCheckout, WorkInProgressState wipState)	Checks out a WTCollection of Workable objects to the specified folder.
CheckoutLink	checkout(Workable object, Folder folder, String note)	Checkout a workable object.
CheckoutLink	checkout(Workable object, Folder folder, String note, boolean allowNonLatestCheckout)	Checkout a workable object.
CheckoutLink	checkout(Workable object, Folder folder, String note, boolean allowNonLatestCheckout, boolean isImplicitCheckout)	Checkout a workable object.
CheckoutLink	checkout(Workable object, Folder folder, String note, WorkInProgressState wipState)	Intended to be used to perform a private checkout by passing in a wipState of WorkInProgressState.PRIVATE_WORKING.
WTValuedMap	checkoutMap(WTCollection objects, Folder folder, String note)	Checks out a WTCollection of Workable objects to the specified folder.
WTValuedMap	checkoutMap(WTCollection objects, Folder folder, String note, boolean allowNonLatestCheckout)	Checks out a WTCollection of Workable objects to the specified folder.
WTValuedMap	checkoutMap(WTKeyedMap objects, Folder folder)	Checks out a WTKeyedMap of Workable objects to the specified folder, where the key is the Workable object, and the value is the note for that checkout..
WTValuedMap	checkoutMap(WTKeyedMap objects, Folder folder, boolean allowNonLatestCheckout)	Checks out a WTKeyedMap of Workable objects to the specified folder, where the key is the Workable object, and the value is the note for that checkout.
WTCollection	convertCheckout(WTCollection workables, String note, boolean allowNonLatestCheckout, WorkInProgressState wipState)	Converts the workables, which must be working-copies, into either a private working copy or reserved working copy, depending on the value of the wipState parameter.
CheckoutLink	convertCheckout(Workable workable, String note, boolean allowNonLatestCheckout, WorkInProgressState wipState)	Converts the workable, which must be a working-copy, into either a private working copy or reserved working copy, depending on the value of the wipState parameter.
WTValuedMap	convertCheckoutMap(WTKeyedMap objects, boolean allowNonLatestCheckout, WorkInProgressState wipState)	Converts the Workable objects, which must be working-copies, into either a private working copy or reserved working copy, depending on the value of the wipState parameter.
Workable	derivedFrom(Workable workable)	Deprecated. Use VersionControlService.derivedFrom(wt.vc.Iterated)
WTValuedMap	derivedFroms(WTCollection workables)	Deprecated. Use VersionControlService.derivedFroms(wt.fc.collections.WTCollection)
Map<WTUser,WTCollection>	findCheckedOutObjects(WTCollection containers, WTCollection users)	Find checked-out objects in the collection of containers for the collection of users.
QueryResult	findCheckedOutObjects(WTContainer container)	Find checked out objects for the container, return as a QueryResult.
QueryResult	findCheckedOutObjects(WTContainer container, WTUser name)	Find checked out objects for the container and user, return as a QueryResult.
QueryResult	findCheckedOutObjects(WTUser name)	Find checked out objects for the user, return as a QueryResult.
Folder	getCheckoutFolder()	Gets the folder named "Checked Out" located in the current session user's personal cabinet.
WTCollection	getLocked(WTCollection workables)	Given a collection of workables return the workables from that collection that are on a branch that is locked, i.e.
WTCollection	getLocked(WTCollection workables, WorkInProgressState wipState)	Given a collection of workables return the workables from that collection that are on a branch that is locked, i.e.
WTCollection	isCheckoutAllowed(WTCollection workables)	Given a WTCollection of workables return a WTCollection containing only the workables that can be checked out reserved.
boolean	isCheckoutAllowed(Workable workable)	Given a workable object return true if it can be checked out reserved.
WTCollection	isConvertCheckoutAllowed(WTCollection workingCopies, WorkInProgressState wipState)	Given a WTCollection of working copies of Workables return a WTCollection containing only those working copies that can be converted to the desired type of checkout.
boolean	isConvertCheckoutAllowed(Workable workingCopy, WorkInProgressState wipState)	Given a workable object return true if it can be converted to the desired type of checkout.
boolean	isLocked(Workable workable)	Returns true if the input workable is locked because it or another iteration on its branch has been checked out reserved.
Workable	originalCopyOf(Workable object)	Navigates to the original copy from a working copy via the CheckoutLink.
Workable	undoCheckout(Workable object)	Undo a checkout of a workable object.
WTCollection	undoCheckouts(WTCollection objects)	Given a WTCollection of checked out objects undo each checkout.
void	undoCheckouts(WTUser user, WTContainer container)	Undo all reserved checkouts by the user for objects located in the specified container.
Workable	workingCopyOf(Workable object)	Navigates to the working copy of an original copy via the CheckoutLink.

Method Details

checkin

Workable checkin(Workable object,
 String note)
          throws WTException,
WorkInProgressException,
WTPropertyVetoException,
PersistenceException

Checkin a workable object. A PRE_CHECKIN WorkInProgressServiceEvent is emitted within a transaction before the object is checked in, and a POST_CHECKIN WorkInProgressServiceEvent is emitted within the same transaction after the object has been checked in.

Supported API: true

Parameters:

object -

note -

Returns:

Workable

Throws:

WTException

WorkInProgressException

WTPropertyVetoException

PersistenceException

checkin

WTCollection checkin(WTCollection objects,
 String note)
              throws WTException,
WorkInProgressException,
WTPropertyVetoException,
PersistenceException

Checkin a WTCollection of Workable objects. A multi-object PRE_CHECKIN WorkInProgressServiceEvent is emitted within a transaction before the objects are checked in, and a multi-object POST_CHECKIN WorkInProgressServiceEvent is emitted within the same transaction after the collection of objects has been checked in. The supplied note is used as the comment for the checkin of the objects.

Supported API: true

Parameters:

objects - The WTCollection of Workable objects to be checked in.

note - The comment pertaining to the checkin of the Workable objects.

Returns:

WTCollection

Throws:

WTException

WorkInProgressException

WTPropertyVetoException

PersistenceException

checkin

WTCollection checkin(WTCollection objects,
 String note,
 String folder)
              throws WTException,
WorkInProgressException,
WTPropertyVetoException,
PersistenceException

Checkin a WTCollection of Workable objects to the folder specified by the name passed. This API is intended for first time checkin from a personal cabinet only. The supplied note is used as the comment for the checkin of the objects.

Supported API: true

Parameters:

objects - The WTCollection of Workable objects to be checked in.

note - The comment pertaining to the checkin of the Workable objects.

folder - The name of the folder the objects are to be checked in to.

Returns:

WTCollection

Throws:

WTException

WorkInProgressException

WTPropertyVetoException

PersistenceException

checkin

WTCollection checkin(WTCollection objects,
 String note,
 Folder folder)
              throws WTException,
WorkInProgressException,
WTPropertyVetoException,
PersistenceException

Checkin a WTCollection of Workable objects to the folder specified by the name passed. This API is intended for first time checkin from a personal cabinet only. The supplied note is used as the comment for the checkin of the objects.

Supported API: true

Parameters:

objects - The WTCollection of Workable objects to be checked in.

note - The comment pertaining to the checkin of the Workable objects.

folder - The Folder the objects are to be checked in to.

Returns:

WTCollection

Throws:

WTException

WorkInProgressException

WTPropertyVetoException

PersistenceException

checkin

WTCollection checkin(WTKeyedMap objects)
              throws WTException,
WorkInProgressException,
WTPropertyVetoException,
PersistenceException

Checkin a WTKeyedMap of Workable objects where the key is the Workable object, and the value is the note for that checkin. A multi-object PRE_CHECKIN WorkInProgressServiceEvent is emitted within a transaction before the objects are checked in, and a multi-object POST_CHECKIN WorkInProgressServiceEvent is emitted within the same transaction after the collection of objects has been checked in.

The user must have sufficient access to perform a checkin action by meeting at least one of the 2 following criteria:

• User has MODIFY permission on the original, latest copy, MODIFY permission on the working copy folder and be the user who locked the original copy of the object.
• User has ADMINISTRATIVE permission on the original, latest copy of the object.

Supported API: true

Parameters:

objects - The WTKeyedMap of Workable objects to be checked in.

Returns:

WTCollection

Throws:

WTException

WorkInProgressException

WTPropertyVetoException

PersistenceException

checkin

WTCollection checkin(WTKeyedMap objects,
 Folder folder)
              throws WTException,
WorkInProgressException,
WTPropertyVetoException,
PersistenceException

Checkin a WTKeyedMap of Workable objects to the folder specified by the name passed. The WTKeyedMap contains Workable objects as keys and the values are the associated notes. This API is intended for first time checkin from a personal cabinet only.

Supported API: true

Parameters:

objects - The WTKeyedMap of Workable objects to be checked in.

folder - The Folder the objects are to be checked in to.

Returns:

WTCollection

Throws:

WTException

WorkInProgressException

WTPropertyVetoException

PersistenceException

checkin

Workable checkin(Workable object,
 String note,
 boolean isImplicitCheckin)
          throws WTException,
WorkInProgressException,
WTPropertyVetoException,
PersistenceException

Checkin a WTCollection of Workable objects. A multi-object PRE_CHECKIN WorkInProgressServiceEvent is emitted within a transaction before the objects are checked in, and a multi-object POST_CHECKIN WorkInProgressServiceEvent is emitted within the same transaction after the collection of objects has been checked in. The supplied note is used as the comment for the checkin of the objects. isImplicitCheckin controls the EXPLICIT_MODIFICATION event.

Supported API: true

Parameters:

note - The comment pertaining to the checkin of the Workable objects.

isImplicitCheckin - The flag to prevent or allow emission of EXPLICIT_MODIFICATION event for licensing

objects - The WTCollection of Workable objects to be checked in.

Returns:

WTCollection

Throws:

WTException

WorkInProgressException

WTPropertyVetoException

PersistenceException

checkout

CheckoutLink checkout(Workable object,
 Folder folder,
 String note)
               throws WTException,
WorkInProgressException,
NonLatestCheckoutException,
WTPropertyVetoException,
PersistenceException

Checkout a workable object. A PRE_CHECKOUT WorkInProgressServiceEvent is emitted within a transaction before the object is checked out, and a POST_CHECKOUT WorkInProgressServiceEvent is emitted within the same transaction after the object has been checked out.

Supported API: true

Parameters:

object -

folder -

note -

Returns:

CheckoutLink

Throws:

WTException

WorkInProgressException

NonLatestCheckoutException

WTPropertyVetoException

PersistenceException

checkout

CheckoutLink checkout(Workable object,
 Folder folder,
 String note,
 boolean allowNonLatestCheckout)
               throws WorkInProgressException,
WTException

Checkout a workable object. This api optionally allows non-latest iterations to be checked out. A PRE_CHECKOUT WorkInProgressServiceEvent is emitted within a transaction before the object is checked out, and a POST_CHECKOUT WorkInProgressServiceEvent is emitted within the same transaction after the object has been checked out.

Supported API: true

Parameters:

object -

folder -

note -

allowNonLatestCheckout -

Returns:

CheckoutLink

Throws:

WorkInProgressException

WTException

checkout

CheckoutLink checkout(Workable object,
 Folder folder,
 String note,
 boolean allowNonLatestCheckout,
 boolean isImplicitCheckout)
               throws WorkInProgressException,
WTException

Checkout a workable object. This api optionally allows non-latest iterations to be checked out. A PRE_CHECKOUT WorkInProgressServiceEvent is emitted within a transaction before the object is checked out, and a POST_CHECKOUT WorkInProgressServiceEvent is emitted within the same transaction after the object has been checked out.

Supported API: true

Parameters:

object -

folder -

note -

allowNonLatestCheckout -

isImplicitCheckout -

Returns:

CheckoutLink

Throws:

WorkInProgressException

WTException

checkout

WTCollection checkout(WTCollection objects,
 Folder folder,
 String note)
               throws WTException,
WorkInProgressException,
NonLatestCheckoutException,
WTPropertyVetoException,
PersistenceException

Checks out a WTCollection of Workable objects to the specified folder. A multi-object PRE_CHECKOUT WorkInProgressServiceEvent is emitted within a transaction before the collection of objects is checked out, and a multi-object POST_CHECKOUT WorkInProgressServiceEvent is emitted within the same transaction after the objects have been checked out. The provided note is used as the comment for the checkout operation.

Supported API: true

Parameters:

objects - The WTCollection of objects to be checked out.

folder - The Folder the objects are to be checked out to.

note - The comment for the checkout operation.

Returns:

WTCollection - The collection returned contains the set of CheckoutLink objects resulting from the operation.

Throws:

WTException

WorkInProgressException

NonLatestCheckoutException

WTPropertyVetoException

PersistenceException

checkout

WTCollection checkout(WTCollection objects,
 Folder folder,
 String note,
 boolean allowNonLatestCheckout)
               throws WorkInProgressException,
WTException

Checks out a WTCollection of Workable objects to the specified folder. This api optionally allows non-latest iterations to be checked out. A multi-object PRE_CHECKOUT WorkInProgressServiceEvent is emitted within a transaction before the collection of objects is checked out, and a multi-object POST_CHECKOUT WorkInProgressServiceEvent is emitted within the same transaction after the objects have been checked out. The provided note is used as the comment for the checkout operation.

Supported API: true

Parameters:

objects -

folder -

note -

allowNonLatestCheckout -

Returns:

WTCollection - The collection returned contains the set of CheckoutLink objects resulting from the operation.

Throws:

WorkInProgressException

WTException

checkout

CheckoutLink checkout(Workable object,
 Folder folder,
 String note,
 WorkInProgressState wipState)
               throws WTException,
WorkInProgressException,
NonLatestCheckoutException,
WTPropertyVetoException,
PersistenceException

Intended to be used to perform a private checkout by passing in a wipState of WorkInProgressState.PRIVATE_WORKING. A PRE_CHECKOUT WorkInProgressServiceEvent is emitted within a transaction before the object is checked out, and a POST_CHECKOUT WorkInProgressServiceEvent is emitted within the same transaction after the object has been checked out.

Supported API: true

Parameters:

object -

folder -

note -

wipState -

Returns:

Throws:

WTException

WorkInProgressException

NonLatestCheckoutException

WTPropertyVetoException

PersistenceException

checkout

WTCollection checkout(WTCollection objects,
 Folder folder,
 String note,
 boolean allowNonLatestCheckout,
 WorkInProgressState wipState)
               throws WTException,
WorkInProgressException,
NonLatestCheckoutException,
WTPropertyVetoException,
PersistenceException

Checks out a WTCollection of Workable objects to the specified folder. This api optionally allows non-latest iterations to be checked out. It also optionally allows the creation of a private checkout by passing in a wipState of WorkInProgressState.PRIVATE_WORKING. Passing in a wipState of WorkInProgressState.WORKING will result in a reserved checkout. A multi-object PRE_CHECKOUT WorkInProgressServiceEvent is emitted within a transaction before the collection of objects is checked out, and a multi-object POST_CHECKOUT WorkInProgressServiceEvent is emitted within the same transaction after the objects have been checked out. The provided note is used as the comment for the checkout operation.

Supported API: true

Parameters:

objects -

folder -

note -

allowNonLatestCheckout -

wipState -

Returns:

WTCollection - The collection returned contains the set of CheckoutLink objects resulting from the operation.

Throws:

WTException

WorkInProgressException

NonLatestCheckoutException

WTPropertyVetoException

PersistenceException

convertCheckout

CheckoutLink convertCheckout(Workable workable,
 String note,
 boolean allowNonLatestCheckout,
 WorkInProgressState wipState)
                      throws WTException,
WorkInProgressException,
NonLatestCheckoutException,
WTPropertyVetoException,
PersistenceException

Converts the workable, which must be a working-copy, into either a private working copy or reserved working copy, depending on the value of the wipState parameter. If wipState is WorkInProgressState.PRIVATE_WORKING then the reserved checkout is converted into a private checkout and if wipState is WorkInProgressState.WORKING then the private checkout is converted into a reserved checkout. A PRE_CONVERT_CHECKOUT WorkInProgressServiceEvent is emitted within a transaction before the object is converted, and a POST_CONVERT_CHECKOUT WorkInProgressServiceEvent is emitted within the same transaction after the object has been converted.

Supported API: true

Parameters:

workable - The working copy of a checkout which is converted into either a private or reserved checkout.

note - The note applied to the working copy.

allowNonLatestCheckout - If true, then a non-latest private checkout can be converted into a reserved checkout.

wipState - Indicates the type of checkout desired, either private or reserved.

Returns:

CheckoutLink

Throws:

WTException - On error

WorkInProgressException

NonLatestCheckoutException

WTPropertyVetoException

PersistenceException

convertCheckout

WTCollection convertCheckout(WTCollection workables,
 String note,
 boolean allowNonLatestCheckout,
 WorkInProgressState wipState)
                      throws WTException,
WorkInProgressException,
NonLatestCheckoutException,
WTPropertyVetoException,
PersistenceException

Converts the workables, which must be working-copies, into either a private working copy or reserved working copy, depending on the value of the wipState parameter. If wipState is WorkInProgressState.PRIVATE_WORKING then the reserved checkout is converted into a private checkout and if wipState is WorkInProgressState.WORKING then the private checkout is converted into a reserved checkout. A multi-object PRE_CONVERT_CHECKOUT WorkInProgressServiceEvent is emitted within a transaction before the object is converted, and a multi-object POST_CONVERT_CHECKOUT WorkInProgressServiceEvent is emitted within the same transaction after the object has been converted.

Supported API: true

Parameters:

workables -

note - The note applied to the working copies.

allowNonLatestCheckout - If true, then a non-latest private checkout can be converted into a reserved checkout.

wipState - Indicates the type of checkout desired, either private or reserved.

Returns:

WTCollection - The collection returned contains the set of CheckoutLink objects resulting from the operation.

Throws:

WTException

WorkInProgressException

NonLatestCheckoutException

WTPropertyVetoException

PersistenceException

convertCheckoutMap

WTValuedMap convertCheckoutMap(WTKeyedMap objects,
 boolean allowNonLatestCheckout,
 WorkInProgressState wipState)
                        throws WTException

Converts the Workable objects, which must be working-copies, into either a private working copy or reserved working copy, depending on the value of the wipState parameter. If wipState is WorkInProgressState.PRIVATE_WORKING then the reserved checkout is converted into a private checkout and if wipState is WorkInProgressState.WORKING then the private checkout is converted into a reserved checkout.

Supported API: true

Parameters:

objects - A keyed map where keys are the working copies whose type of checkout is changed and values Strings which are the checkout notes

allowNonLatestCheckout - If true, then a non-latest private checkout can be converted into a reserved checkout.

wipState - Indicates the type of checkout desired, either private or reserved.

Returns:

A valued-map where the keys are the Workables that were passed in the objects map and the values is the CheckoutLink

Throws:

WTException - On error

derivedFrom

Workable derivedFrom(Workable workable)
              throws WorkInProgressException,
WTException

Deprecated.

Use VersionControlService.derivedFrom(wt.vc.Iterated)

Given a workable return its derived from workable and null if one does not exist

Supported API: true

Parameters:

workable -

Returns:

Workable

Throws:

WorkInProgressException

WTException

derivedFroms

WTValuedMap derivedFroms(WTCollection workables)
                  throws WorkInProgressException,
WTException

Deprecated.

Use VersionControlService.derivedFroms(wt.fc.collections.WTCollection)

Given a collection of workables return a WTValuedMap with keys = objects in iterations that have a derivedFrom, values = corresponding derived from iterations.

Supported API: true

Parameters:

workables -

Returns:

WTValuedMap

Throws:

WorkInProgressException

WTException

undoCheckout

Workable undoCheckout(Workable object)
               throws WTException,
WorkInProgressException,
WTPropertyVetoException,
PersistenceException

Undo a checkout of a workable object. A PRE_UNDO_CHECKOUT WorkInProgressServiceEvent is emitted within a transaction before the object's checkout is undone, and a POST_UNDO_CHECKOUT WorkInProgressServiceEvent is emitted within the same transaction after the object has had its checkout undone.

Supported API: true

Parameters:

object -

Returns:

Workable

Throws:

WTException

WorkInProgressException

WTPropertyVetoException

PersistenceException

undoCheckouts

void undoCheckouts(WTUser user,
 WTContainer container)
            throws WTException,
WorkInProgressException,
WTPropertyVetoException,
PersistenceException

Undo all reserved checkouts by the user for objects located in the specified container. A PRE_UNDO_CHECKOUT WorkInProgressServiceEvent is emitted within a transaction before the object's checkout is undone, and a POST_UNDO_CHECKOUT WorkInProgressServiceEvent is emitted within the same transaction after the object has had its checkout undone.

Supported API: true

Parameters:

user -

container -

Throws:

WTException

WorkInProgressException

WTPropertyVetoException

PersistenceException

undoCheckouts

WTCollection undoCheckouts(WTCollection objects)
                    throws WTException,
WorkInProgressException,
WTPropertyVetoException,
PersistenceException

Given a WTCollection of checked out objects undo each checkout. A multi-object PRE_UNDO_CHECKOUT WorkInProgressServiceEvent is emitted within a transaction before the checkout of the objects is undone, and a multi-object POST_UNDO_CHECKOUT WorkInProgressServiceEvent is emitted within the same transaction after the checkout of the collection of objects has been undone.

The user must have sufficient access to perform an undoCheckouts action by meeting at least one of the 3 following conditions:

• User has ADMINISTRATIVE permission on the original (checked out) copy of the object.
• User has ADMINISTRATIVE permission on the working copy of the object.
• User has DELETE permission on the working copy of the object and user has MODIFY permission on the working copy's Folder.

Supported API: true

Parameters:

objects - The WTCollection of checked out objects.

Returns:

WTCollection

Throws:

WTException

WorkInProgressException

WTPropertyVetoException

PersistenceException

originalCopyOf

Workable originalCopyOf(Workable object)
                 throws WTException,
WorkInProgressException

Navigates to the original copy from a working copy via the CheckoutLink. The working copy may be a reserved working copy or a private working copy.

Supported API: true

Parameters:

object -

Returns:

Workable

Throws:

WTException

WorkInProgressException

workingCopyOf

Workable workingCopyOf(Workable object)
                throws WTException,
WorkInProgressException

Navigates to the working copy of an original copy via the CheckoutLink. Will not return private working copies. Use allWorkingCopiesOf(Workable) to get all working copies from reserved and private checkouts.

Supported API: true

Parameters:

object -

Returns:

Workable

Throws:

WTException

WorkInProgressException

allWorkingCopiesOf

WTCollection allWorkingCopiesOf(Workable object)
                         throws WTException,
WorkInProgressException

Navigates to the working copy of an original copy via the CheckoutLink. Will return working copies from reserved checkout as well as private checkout. Use getWorkingToOriginalMap(wt.fc.collections.WTCollection) for a multi-object version of this API.

Supported API: true

Parameters:

object -

Returns:

Workable

Throws:

WTException

WorkInProgressException

getCheckoutFolder

Folder getCheckoutFolder()
                  throws WTException

Gets the folder named "Checked Out" located in the current session user's personal cabinet.

Supported API: true

Returns:

Folder

Throws:

WTException

isLocked

boolean isLocked(Workable workable)
          throws WorkInProgressException,
WTException

Returns true if the input workable is locked because it or another iteration on its branch has been checked out reserved.

Supported API: true

Parameters:

workable -

Returns:

boolean

Throws:

WorkInProgressException

WTException

getLocked

WTCollection getLocked(WTCollection workables)
                throws WorkInProgressException,
WTException

Given a collection of workables return the workables from that collection that are on a branch that is locked, i.e. where one object is checked out.

Supported API: true

Parameters:

workables -

Returns:

WTCollection

Throws:

WorkInProgressException

WTException

getLocked

WTCollection getLocked(WTCollection workables,
 WorkInProgressState wipState)
                throws WorkInProgressException,
WTException

Given a collection of workables return the workables from that collection that are on a branch that is locked, i.e. where one object is checked out, and having the input WorkInProgressState.

Supported API: true

Parameters:

workables -

wipState -

Returns:

WTCollection

Throws:

WorkInProgressException

WTException

findCheckedOutObjects

QueryResult findCheckedOutObjects(WTContainer container)
                           throws WTException

Find checked out objects for the container, return as a QueryResult.

Supported API: true

Parameters:

container -

Returns:

QueryResult

Throws:

WTException

findCheckedOutObjects

QueryResult findCheckedOutObjects(WTContainer container,
 WTUser name)
                           throws WTException

Find checked out objects for the container and user, return as a QueryResult.

Supported API: true

Parameters:

container -

name -

Returns:

QueryResult

Throws:

WTException

findCheckedOutObjects

QueryResult findCheckedOutObjects(WTUser name)
                           throws WTException

Find checked out objects for the user, return as a QueryResult.

Supported API: true

Parameters:

name -

Returns:

QueryResult

Throws:

WTException

findCheckedOutObjects

Map<WTUser,WTCollection> findCheckedOutObjects(WTCollection containers,
 WTCollection users)
                                        throws WTException

Find checked-out objects in the collection of containers for the collection of users. Return as a map of users to collections of working copies of their checked-out objects.

Supported API: true

Parameters:

containers - Collection of WTContainers. The objects returned will be in one of these containers.

users - Collection of WTUsers. The objects returned will be checked out to one of these users.

Returns:

Mapinvalid input: '<'WTUser,WTCollection>

Throws:

WTException

checkoutMap

WTValuedMap checkoutMap(WTCollection objects,
 Folder folder,
 String note)
                 throws WTException,
WorkInProgressException,
NonLatestCheckoutException,
WTPropertyVetoException,
PersistenceException,
ObjectsAlreadyCheckedOutException

Checks out a WTCollection of Workable objects to the specified folder. A multi-object PRE_CHECKOUT WorkInProgressServiceEvent is emitted within a transaction before the collection of objects is checked out, and a multi-object POST_CHECKOUT WorkInProgressServiceEvent is emitted within the same transaction after the objects have been checked out. The provided note is used as the comment for the checkout operation.

Supported API: true

Parameters:

objects - The WTCollection of objects to be checked out.

folder - The Folder the objects are to be checked out to.

note - The comment for the checkout operation.

Returns:

WTValuedMap - The WTValuedMap returned contains the checked out Workable object as the key and the resulting CheckoutLink object as the value.

Throws:

WTException

WorkInProgressException

NonLatestCheckoutException

WTPropertyVetoException

PersistenceException

ObjectsAlreadyCheckedOutException

checkoutMap

WTValuedMap checkoutMap(WTCollection objects,
 Folder folder,
 String note,
 boolean allowNonLatestCheckout)
                 throws WorkInProgressException,
WTException

Checks out a WTCollection of Workable objects to the specified folder. This api optionally allows non-latest iterations to be checked out. A multi-object PRE_CHECKOUT WorkInProgressServiceEvent is emitted within a transaction before the collection of objects is checked out, and a multi-object POST_CHECKOUT WorkInProgressServiceEvent is emitted within the same transaction after the objects have been checked out. The provided note is used as the comment for the checkout operation.

Supported API: true

Parameters:

objects -

folder -

note -

allowNonLatestCheckout -

Returns:

WTValuedMap - The WTValuedMap returned contains the checked out Workable object as the key and the resulting CheckoutLink object as the value.

Throws:

WorkInProgressException

WTException

checkoutMap

WTValuedMap checkoutMap(WTKeyedMap objects,
 Folder folder)
                 throws WTException,
WorkInProgressException,
NonLatestCheckoutException,
WTPropertyVetoException,
PersistenceException,
ObjectsAlreadyCheckedOutException

Checks out a WTKeyedMap of Workable objects to the specified folder, where the key is the Workable object, and the value is the note for that checkout.. A multi-object PRE_CHECKOUT WorkInProgressServiceEvent is emitted within a transaction before the collection of objects is checked out, and a multi-object POST_CHECKOUT WorkInProgressServiceEvent is emitted within the same transaction after the objects have been checked out. The provided note is used as the comment for the checkout operation.

Supported API: true

Parameters:

objects - The WTCollection of objects to be checked out.

folder - The Folder the objects are to be checked out to.

Returns:

WTValuedMap - The WTValuedMap returned contains the checked out Workable object as the key and the resulting CheckoutLink object as the value.

Throws:

WTException

WorkInProgressException

NonLatestCheckoutException

WTPropertyVetoException

PersistenceException

ObjectsAlreadyCheckedOutException

checkoutMap

WTValuedMap checkoutMap(WTKeyedMap objects,
 Folder folder,
 boolean allowNonLatestCheckout)
                 throws WorkInProgressException,
WTException

Checks out a WTKeyedMap of Workable objects to the specified folder, where the key is the Workable object, and the value is the note for that checkout. This api optionally allows non-latest checkouts.

A multi-object PRE_CHECKOUT WorkInProgressServiceEvent is emitted within a transaction before the collection of objects is checked out, and a multi-object POST_CHECKOUT WorkInProgressServiceEvent is emitted within the same transaction after the objects have been checked out. The provided note is used as the comment for the checkout operation.

The user must have sufficient access to perform the checkoutMap action. In order for that to be true, all of the following conditions must be met:

• User has MODIFY permission on the original copy of the object.
• User has CREATE permission for the object type in the AdministrativeDomain of the proposed checkout folder.
• User has MODIFY permission on the proposed checkout Folder.

Supported API: true