Fuego Process API

fuego.papi
Interface Process

All Superinterfaces:
MDObject

public interface Process
extends MDObject

Contains the metadata of a particular Process. Operations on a process can be done through ProcessServiceSession or ProcessServiceNESession.


Method Summary
 void activate()
          Activate this process
 boolean containsDocumentation(Locale locale)
          Returns if this process contains documentation for an specific locale.
 void deprecate()
          Deprecate this process
 Activity[] getActivities()
          This method returns an activity array all activities of this process
 String[] getActivitiesForParticipant(Participant participant)
          The visible activities in this process for the given participant
 String[] getActivitiesForRoles(String[] roles)
          Return all activities int this process that can be see for these roles
 Activity getActivity(String activity)
          Finds an activity of this process by name or id.
 String[] getApplicationRoles()
          Return all roles with global activities (not include global automatic) in this process
 Activity getBeginActivity()
          Returns the begin activity of this process
 int getCatalogIn()
          Returns this process' catalog identification number.
 String getConsolidatedId()
           
 String getDeployedEngine()
          Return the engine where this process was deployed
 String getDescription(Locale locale)
          Returns this process' localized description.
 String getDocumentation(Locale locale)
          Deprecated. use ProcessServiceNESession.getProcessDocumentation(String, java.util.Locale)
 Map getDocumentationMap()
           
 String getFolderName()
          Returns the name of the process folder into the working folder.
 String[] getGlobalCreationRoles()
          Return all roles with global creation activities (not include global automatic) in this process
 Activity[] getGrabActivitiesForActivity(String activityId)
          Return all grab activities where the instances in the given activity can be grabbed
 String getId()
          Returns this process' id.
 int getIn()
          Returns this process' identification number.
 String[] getInteractiveRoles()
          Return all roles with interactive activities in this process
 String getLabel(Locale locale)
          Returns this process' localized label.
 Map getLabels()
          Returns all localized labels of this process.
 String getLabelWithOU(Locale locale)
          Returns this process' localized label with the organizational unit.
 String getLabelWithOUForParticipant(Locale locale, Participant participant)
          Returns this process' localized label with the organizational unit for a given participant.
 long getLastNewsTimestamp()
           
 String getName()
          Returns this process' name
 String getOrganizationUnit()
          Returns the organization unit where this process is deployed
 String[] getRoles()
          Return all roles in this process
 VarDefinition[] getVars()
          Returns all the variable definitions.
 String getVersion()
          Returns the process version
 boolean hasApplicationRole(String roleId)
          Return if this process has global activity (not include global automatic) in the specific role.
 boolean hasGlobalCreationRole(String roleId)
          Return if this process has global creation activity in the specific role.
 boolean hasInteractiveRole(String roleId)
          Return if this process has an interactive activity in the specific role.
 boolean hasLocalDocumentation()
          Returns if this process contains documentation stored in the folder name
 boolean hasRole(String role)
          Check if this process contains the specific role identification
 boolean isActive()
          Returns true if this process is active.
 boolean isAutomatic()
          Return if this process contains only automatic activities.
 boolean isOnline()
          Returns true if this process is online.
 boolean isVisibleTo(Participant participant)
          Returns true if the participant has any role in this process, otherwise false.
 void setLastNewsTimestamp(long l)
           
 
Methods inherited from interface fuego.papi.MDObject
setDocumentation
 

Method Detail

getCatalogIn


public int getCatalogIn()
Returns this process' catalog identification number.

Returns:
this process' catalog identification number

isActive


public boolean isActive()
Returns true if this process is active. A process is active if it is not deprecated.
Note: In the case of consolidated processes it will return true if one of the process versions included in this consolidated process is active

Returns:
true if this process is active

getActivities


public Activity[] getActivities()
This method returns an activity array all activities of this process

Returns:
An array over the activities in this process

getActivitiesForParticipant


public String[] getActivitiesForParticipant(Participant participant)
The visible activities in this process for the given participant

Parameters:
participant - The participant to filter the activities
Returns:
Activities identification that the roles can see.

getActivitiesForRoles


public String[] getActivitiesForRoles(String[] roles)
Return all activities int this process that can be see for these roles

Parameters:
roles - Role identification
Returns:
Activities identification that the roles can see.

getActivity


public Activity getActivity(String activity)
Finds an activity of this process by name or id.

Parameters:
activity - The name or id of required activity
Returns:
An activity object, null if not found

getApplicationRoles


public String[] getApplicationRoles()
Return all roles with global activities (not include global automatic) in this process

Returns:

isAutomatic


public boolean isAutomatic()
Return if this process contains only automatic activities.

Returns:

getBeginActivity


public Activity getBeginActivity()
Returns the begin activity of this process

Returns:
The begin activity of this process

getConsolidatedId


public String getConsolidatedId()

getDeployedEngine


public String getDeployedEngine()
Return the engine where this process was deployed

Returns:
Engine identification

getDescription


public String getDescription(Locale locale)
Returns this process' localized description.
If the localized process' description is not available, its name is returned.

Specified by:
getDescription in interface MDObject
Parameters:
locale - the desired locale
Returns:
this process' localized description
See Also:
getName()

getDocumentation


public String getDocumentation(Locale locale)
Deprecated. use ProcessServiceNESession.getProcessDocumentation(String, java.util.Locale)

Returns the path of the process localized documentation HTML.
If the localized process documentation is not available or was not loaded yet, null is returned. This method do not load the process documentation, it just returns what was previously loaded by ProcessServiceNESession.getProcessDocumentation(String, java.util.Locale).

Specified by:
getDocumentation in interface MDObject
Parameters:
locale - the desired locale
Returns:
this process localized documentation path
See Also:
ProcessServiceNESession.getProcessDocumentation(java.lang.String, java.util.Locale)

getDocumentationMap


public Map getDocumentationMap()

getFolderName


public String getFolderName()
Returns the name of the process folder into the working folder.

Specified by:
getFolderName in interface MDObject
Returns:
The folder name

getGlobalCreationRoles


public String[] getGlobalCreationRoles()
Return all roles with global creation activities (not include global automatic) in this process

Returns:

getGrabActivitiesForActivity


public Activity[] getGrabActivitiesForActivity(String activityId)
Return all grab activities where the instances in the given activity can be grabbed

Parameters:
activityId - Activity identification to obtain the grab activities
Returns:

getId


public String getId()
Returns this process' id.
A process id is of the form:
"/OrganizationalUnit/ProcessName#Version"

Specified by:
getId in interface MDObject
Returns:
this process' id

getIn


public int getIn()
Returns this process' identification number.

Returns:
this process' identification number

getInteractiveRoles


public String[] getInteractiveRoles()
Return all roles with interactive activities in this process

Returns:

getLabel


public String getLabel(Locale locale)
Returns this process' localized label.
If the localized process' label is not available, its name is returned.

Specified by:
getLabel in interface MDObject
Parameters:
locale - the desired locale
Returns:
this process' localized label
See Also:
getName()

getLabelWithOU


public String getLabelWithOU(Locale locale)
Returns this process' localized label with the organizational unit.
If the process is deployed in the root OU, then it is the same label,
but if the process is deployed in another ou, then the result is : label (ou)

Parameters:
locale - the desired locale
Returns:
this process' localized label plus the organizational unit
See Also:
getLabel(Locale locale)

getLabelWithOUForParticipant


public String getLabelWithOUForParticipant(Locale locale,
                                           Participant participant)
Returns this process' localized label with the organizational unit for a given participant.
If the process is deployed in the root OU, then it is the same label,
but if the process is deployed in another ou, then the result is : label (ou)

Parameters:
locale - the desired locale
participant - the participant to use
Returns:
this process' localized label plus the organizational unit
See Also:
getLabel(Locale locale)

getLabels


public Map getLabels()
Returns all localized labels of this process.

Returns:
A map with all localized labels (The key of the map is the language abreviation).

setLastNewsTimestamp


public void setLastNewsTimestamp(long l)

getLastNewsTimestamp


public long getLastNewsTimestamp()

getName


public String getName()
Returns this process' name

Specified by:
getName in interface MDObject
Returns:
this process' name

isOnline


public boolean isOnline()
Returns true if this process is online.
Note: In the case of consolidated processes it will return true if one of the process versions included in this consolidated process is online

Returns:
true if this process is online

getOrganizationUnit


public String getOrganizationUnit()
Returns the organization unit where this process is deployed


getRoles


public String[] getRoles()
Return all roles in this process

Returns:

getVars


public VarDefinition[] getVars()
Returns all the variable definitions. Through the VarDefinition object can be obtained all the following information: - The id of the variable - The mask of the variable - The size of the variable - The label of the variable for a given Locale

Returns:
The array with the process definitions of all the variables from this process

getVersion


public String getVersion()
Returns the process version


isVisibleTo


public boolean isVisibleTo(Participant participant)
Returns true if the participant has any role in this process, otherwise false.

Parameters:
participant - The participant to check.

activate


public void activate()
Activate this process


containsDocumentation


public boolean containsDocumentation(Locale locale)
Returns if this process contains documentation for an specific locale.

Specified by:
containsDocumentation in interface MDObject
Parameters:
locale - specific java.util.Locale to verify if this process contains documentation for that language.
Returns:
True if this process conatins documentation for that java.util.Locale

deprecate


public void deprecate()
Deprecate this process


hasApplicationRole


public boolean hasApplicationRole(String roleId)
Return if this process has global activity (not include global automatic) in the specific role.

Parameters:
roleId - Role identification
Returns:

hasGlobalCreationRole


public boolean hasGlobalCreationRole(String roleId)
Return if this process has global creation activity in the specific role.

Parameters:
roleId - Role identification
Returns:

hasInteractiveRole


public boolean hasInteractiveRole(String roleId)
Return if this process has an interactive activity in the specific role.

Parameters:
roleId - Role identification
Returns:

hasLocalDocumentation


public boolean hasLocalDocumentation()
Returns if this process contains documentation stored in the folder name

Specified by:
hasLocalDocumentation in interface MDObject
Returns:
True if this process contains documentation stored.

hasRole


public boolean hasRole(String role)
Check if this process contains the specific role identification

Parameters:
role - Role identification
Returns:

Fuego Process API

© Copyright 1996/2003 Fuego Inc. All Rights Reserved