com.ibm.tivoli.maximo.appt.app

Class ApptBookStatusHandler

java.lang.Object

psdi.mbo.StatusHandler

com.ibm.tivoli.maximo.appt.app.ApptBookStatusHandler

All Implemented Interfaces:

MboConstants

public class ApptBookStatusHandler
extends StatusHandler

Handles all the status changes for a ApptBook object

Field Summary

Fields

Modifier and Type	Field and Description
static boolean[][]	statusChangeMatrix A statusChangeMatrix for the legal status changes that can be made.

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
ApptBookStatusHandler(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 date, java.lang.String memo) Changes the status from the current state to a desired state.
void	checkStatusChangeAuthorization(java.lang.String desiredExternalStatus) Checks to see if the user is authorized to make a status changes.
void	checkUserSecurity(java.lang.String desiredMaxStatus) Check out the users security rights to call the specified status.
void	checkUserSecurity(java.lang.String desiredMaxStatus, boolean applevel)
void	postStatusChange(java.lang.String currentStatus, java.lang.String status, java.util.Date asOfDate, java.lang.String memo) This method is called by the framework's changestatus method.

Methods inherited from class psdi.mbo.StatusHandler

preStatusChange, statusToOptionName, updateMboForStatus

Methods inherited from class java.lang.Object

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

Field Detail

statusChangeMatrix

public static boolean[][] statusChangeMatrix

A statusChangeMatrix for the legal status changes that can be made.

Constructor Detail

ApptBookStatusHandler

public ApptBookStatusHandler(StatefulMbo sm)

Constructor

Method Detail

checkStatusChangeAuthorization

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

Checks to see if the user is authorized to make a status changes. In other words , it checks if the user has the required privilege to change the status. After ensuring that the user has the required privilege, this methods checks if the status change is legal.

Specified by:

checkStatusChangeAuthorization in class StatusHandler

Parameters:

currentExternalStatus - The current external status of the asset.

desiredExternalStatus - The desired external status of the asset.

Throws:

MXException

java.rmi.RemoteException

See Also:

checkUserSecurity, possibleStatusChange

checkUserSecurity

public void checkUserSecurity(java.lang.String desiredMaxStatus)
                       throws MXException,
                              java.rmi.RemoteException

Check out the users security rights to call the specified status. Note the status passed in is the INTERNAL status code.
Note that the SigOption Option Name doesn't always match the status name.

Parameters:

status - The status to check if we can change to.

Throws:

MXAccessException - Throws an access exception "notauthorized" if the check fails.

MXException

java.rmi.RemoteException

checkUserSecurity

public void checkUserSecurity(java.lang.String desiredMaxStatus,
                              boolean applevel)
                       throws MXException,
                              java.rmi.RemoteException

Throws:

MXException

java.rmi.RemoteException

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 MXAccessException is thrown.

Overrides:

canChangeStatus in class StatusHandler

Parameters:

currentMaxStatus - the asset's current status

desiredStatus - the status to change to

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

Throws:

MXApplicationException - (asset, invalidstatus) is thrown if the desired status is not legal.

MXException

java.rmi.RemoteException

changeStatus

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

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

Overrides:

changeStatus in class StatusHandler

Parameters:

currentMaxStatus - the asset's current status

desiredStatus - the status to change to

date - the date as of the status change is to be made

memo - memo text

Throws:

MXException

java.rmi.RemoteException

postStatusChange

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

This method is called by the framework's changestatus method. Any post processing that needs to be done after status changes must be included in this method.

Overrides:

postStatusChange in class StatusHandler

Throws:

MXException

java.rmi.RemoteException