psdi.plusc.app.pluscds

Class PlusCDSStatusHandler

java.lang.Object

psdi.mbo.StatusHandler

psdi.plusc.app.pluscds.PlusCDSStatusHandler

All Implemented Interfaces:

MboConstants

public class PlusCDSStatusHandler
extends StatusHandler

Handles all the status changes for a Data Sheet 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
PlusCDSStatusHandler(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 authorised to make a status changes.
void	checkUserSecurity(java.lang.String desiredMaxStatus) Check out the users security rights to call the specified status.

Methods inherited from class psdi.mbo.StatusHandler

postStatusChange, 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. Status DRAFT WAPPR APPR INACTIVE DRAFT false true true true WAPPR true false true true APPR true true false true INACTIVE true true true false The above table must be read from right to left only.
For example if you want to change the status from COMP to WAPPR , look at the left for the COMP row and look at the intersecting WAPPR column. The value is false. This means that this status change is not allowed.

Constructor Detail

PlusCDSStatusHandler

public PlusCDSStatusHandler(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 authorised 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:

desiredExternalStatus - The desired external status of the PO.

Throws:

MXException - the mX exception

java.rmi.RemoteException - the remote exception

See Also:

This method is used to build the list of permitted status changes.

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:

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

Throws:

MXException - the mX exception

java.rmi.RemoteException - the remote exception

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:

currentStatus - the Data Sheet'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:

MXException - the mX exception

java.rmi.RemoteException - the remote exception

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:

currentStatus - the PR'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 - the mX exception

java.rmi.RemoteException - the remote exception