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