psdi.app.ticket

Class TKStatusHandler

java.lang.Object

psdi.mbo.StatusHandler

psdi.app.ticket.TKStatusHandler

All Implemented Interfaces:

MboConstants

public class TKStatusHandler
extends StatusHandler

Handles all the status changes for a ticket object

Field Summary

Fields inherited from interface psdi.mbo.MboConstants

ALLROWS, CHANGEDBY_USER, COUNT_ADDITIONS, COUNT_AFTERSAVE, COUNT_DATABASE, COUNT_DELETED, COUNT_EXISTING, DBCONFIG, DELAYVALIDATION, DELAYVALIDATIONONLY, DISCARDABLE, GOTCOMPLETEWHERE, HIDDEN, NO_RELATEDMBOS_OF_OWNERSCHILDREN_FETCH, NOACCESSCHECK, NOACTION, NOADD, NOCOMMIT, NODELETE, NONE, NOOVERWRITE, NOSAVE, NOSETVALUE, NOUPDATE, NOVALIDATION, NOVALIDATION_AND_NOACTION, NOVALIDATION_AND_NOACTION_ALLOWCROSSOVER, READONLY, REBUILD, REQUIRED, SAMEVALUEVALIDATION, SETBYPARENT, USER

Constructor Summary

Constructors

Constructor and Description
TKStatusHandler(StatefulMbo sm) Constructor

Method Summary

Modifier and Type	Method and Description
void	canChangeStatus(java.lang.String currentStatus, java.lang.String desiredStatus, long accessModifier) Defines which status changes are legal.
void	changeStatus(java.lang.String currentStatus, java.lang.String desiredStatus, java.util.Date asOfDate, java.lang.String memo) Change the status from the current state to a desired state.
void	checkStatusChangeAuthorization(java.lang.String desiredStatus) Determines which statuses to show in the list returned by the Mbo's getStatusList method.
void	updateMboForStatus(java.lang.String status) Set the relevant fields to be read only based on the status

Methods inherited from class psdi.mbo.StatusHandler

postStatusChange, preStatusChange, statusToOptionName

Methods inherited from class java.lang.Object

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

Constructor Detail

TKStatusHandler

public TKStatusHandler(StatefulMbo sm)

Constructor

Parameters:

sm -

Method Detail

checkStatusChangeAuthorization

public void checkStatusChangeAuthorization(java.lang.String desiredStatus)
                                    throws MXException,
                                           java.rmi.RemoteException

Determines which statuses to show in the list returned by the Mbo's getStatusList method. This test determines whether a status change is possible by only checking the user's security and the current status of the ticket.

Specified by:

checkStatusChangeAuthorization in class StatusHandler

Parameters:

desiredStatus - The status to change the ticket to. This is the synonym value.

Throws:

MXException - Throws an access exception with group key "access" and error key "notauthorized" if the user does not have security for a status change.

java.rmi.RemoteException

See Also:

The calling method.

canChangeStatus

public void canChangeStatus(java.lang.String currentStatus,
                            java.lang.String desiredStatus,
                            long accessModifier)
                     throws MXException,
                            java.rmi.RemoteException

Defines which status changes are legal. If a status change is not legal, an exception is thrown. This method does need check user's security clearance in mbo level.

Overrides:

canChangeStatus in class StatusHandler

Parameters:

currentStatus - The ticket's current status

desiredStatus - The status to change the ticket to. This is the synonym value.

accessModifier - If this flag is set to NOACCESSCHECK, a work flow controlled ticket may change status.

Throws:

MXException - Throws a MXAccessException with a group key of "ticket". The key will be one of: "new","queued", "inprog", "pending", "resolved", "closed" depending on the desired status parameter. If called on a work flow controlled ticket without the NOACCESSCHECK flag, an access exception with "WORKFLOW" & "IllegalStatusChange" is thrown.

java.rmi.RemoteException

changeStatus

public void changeStatus(java.lang.String currentStatus,
                         java.lang.String desiredStatus,
                         java.util.Date asOfDate,
                         java.lang.String memo)
                  throws MXException,
                         java.rmi.RemoteException

Change the status from the current state to a desired state.

Overrides:

changeStatus in class StatusHandler

Parameters:

asOfDate - The date as of the status change is to be made. If null, set to the current date/time.

currentStatus - The parent Ticket's status now.

memo - Memo text.

desiredStatus - The status to change to.

Throws:

MXException

java.rmi.RemoteException

updateMboForStatus

public void updateMboForStatus(java.lang.String status)
                        throws MXException,
                               java.rmi.RemoteException

Set the relevant fields to be read only based on the status

Overrides:

updateMboForStatus in class StatusHandler

Parameters:

status -

Throws:

MXException

java.rmi.RemoteException