com.groiss.wf
Interface ApplicationAdapter

All Superinterfaces:

HasResource

All Known Implementing Classes:

DefaultApplicationAdapter

public interface ApplicationAdapter
extends HasResource

Interface for classes customizing the application behaviour. your implementation will be used for an application if it is registered in the application administration as application class.

Method Summary

Right	getFinishRight(ActivityInstance ai) Returns the right which is needed for sending the process to next agent The system checks if the sending user has this right for the agent and org.
java.util.List	getFinishRights() Return the list of finish rights used in this application.
java.lang.String	getNewProcessId(ProcessInstance pi) The method is called whenever a new process Id is needed
com.groiss.wf.distri.Packer	getPacker() Return the Packer used for distributing activities of this application.
java.util.Vector	getUserProperties(User u) Returns the user properties a user can set.
void	modifyDetailLinks(KeyedList links, java.lang.StringBuffer title, ProcessInstance pi, ActivityInstance ai) You can modify the title and links in the detail view of the process.
void	notifyUser(User u, ActivityInstance ai) The method is called when an email-notification about a new worklist entry is sent.
void	onAbort(ProcessInstance pi) A process is aborted
void	onAddDocument(ProcessInstance pi, DMSFolder f, DMSObject o) Called when a document is added to a process of this application.
void	onReactivate(ProcessInstance pi) A process is reactivated
void	onRemoveDocument(ProcessInstance pi, DMSFolder f, DMSObject o) Called when a document is removed from a process of this application.
void	onSeeAgain(ActivityInstance ai) An ActivityInstance is taken out of the suspension list.
void	onSeeLater(ActivityInstance ai) An ActivityInstance is put into the suspension list.

Methods inherited from interface com.groiss.org.HasResource

getResource, localizeNames, setApplication

Method Detail

getNewProcessId

java.lang.String getNewProcessId(ProcessInstance pi)
                                 throws java.lang.Exception

The method is called whenever a new process Id is needed

Parameters:

pi - the process instance for which the id should be generated

Throws:

java.lang.Exception

onSeeLater

void onSeeLater(ActivityInstance ai)

An ActivityInstance is put into the suspension list.

Parameters:

ai - an activity instance

onSeeAgain

void onSeeAgain(ActivityInstance ai)

An ActivityInstance is taken out of the suspension list.

Parameters:

ai - an activity instance

onAbort

void onAbort(ProcessInstance pi)
             throws java.lang.Exception

A process is aborted

Parameters:

pi - the process instance

Throws:

java.lang.Exception

onReactivate

void onReactivate(ProcessInstance pi)
                  throws java.lang.Exception

A process is reactivated

Parameters:

pi - the process instance

Throws:

java.lang.Exception

onAddDocument

void onAddDocument(ProcessInstance pi,
                   DMSFolder f,
                   DMSObject o)
                   throws java.lang.Exception

Called when a document is added to a process of this application.

Parameters:

pi - the process instance

f - the folder where the object will be added

o - the object to add

Throws:

java.lang.Exception

onRemoveDocument

void onRemoveDocument(ProcessInstance pi,
                      DMSFolder f,
                      DMSObject o)
                      throws java.lang.Exception

Called when a document is removed from a process of this application.

Parameters:

pi - the process instance

f - the folder

o - the object to add

Throws:

java.lang.Exception

notifyUser

void notifyUser(User u,
                ActivityInstance ai)
                throws java.lang.Exception

The method is called when an email-notification about a new worklist entry is sent.

Parameters:

u - the recipient

ai - an activity instance

Throws:

java.lang.Exception

getUserProperties

java.util.Vector getUserProperties(User u)

Returns the user properties a user can set.

Parameters:

u - The user whose properties should be returned

Returns:

a Vector of Pairs (com.groiss.ds.Pair) of labels (a string) and components (com.groiss.gui).

getFinishRight

Right getFinishRight(ActivityInstance ai)

Returns the right which is needed for sending the process to next agent The system checks if the sending user has this right for the agent and org.-unit of the given ai.

Parameters:

ai - the new ActivityInstance

getFinishRights

java.util.List getFinishRights()

Return the list of finish rights used in this application.

Returns:

a List of rights

getPacker

com.groiss.wf.distri.Packer getPacker()

Return the Packer used for distributing activities of this application.

Returns:

a Packer object

modifyDetailLinks

void modifyDetailLinks(KeyedList links,
                       java.lang.StringBuffer title,
                       ProcessInstance pi,
                       ActivityInstance ai)
                       throws java.lang.Exception

You can modify the title and links in the detail view of the process.

Parameters:

links - a keyed list of Link objects, keys are form{i}, documents, notes, history, process

title -

pi - the process instance

ai - the activity instance, may be null (for example when called from search)

Throws:

java.lang.Exception