Action Request System Java API

com.remedy.arsys.api
Class ActiveLink

java.lang.Object
  |
  +--com.remedy.arsys.api.ObjectBase
        |
        +--com.remedy.arsys.api.ActiveLink

public class ActiveLink
extends ObjectBase
implements IARPersistentObject, java.lang.Cloneable

The ActiveLink class and methods are used to represent the properties of active link objects.

Note:All the constants used in the ActiveLink class are found in the Constants class.


Fields inherited from class com.remedy.arsys.api.ObjectBase
m_changeFlags
 
Method Summary
 void activate()
          Remedy reserved method.
 void clear()
          Clears all of the references to member objects.
 java.lang.Object clone()
          Clone implementation that returns an Object with data cloned from self
 void create()
          Creates this object on the AR System server.
 ActiveLinkActionInfo[] getActionList()
          Returns a list of actions performed if the condition defined by the query parameter is satisfied.
 long getControlField()
          Returns the ID of the field that represents the button, toolbar button, or menu item associated with executing the active link.
 ActiveLinkActionInfo[] getElseList()
          Returns set of actions performed if the condition defined by the query parameter is not satisfied.
 long getEnable()
          Returns the flag identifying whether the active link is disabled (0) or enabled (1).
 long getExecuteMask()
          Returns the masks indicating the form operations that trigger the active link.
 long getFocusField()
          Returns the ID of the field associated with executing the active link by pressing Return or selecting a character menu item.
 InternalID[] getGroupList()
          Returns the list of zero or more groups who can access this active link.
 ActiveLinkKey getKey()
          Returns unique identifier for active link.
 PropInfo[] getObjPropList()
          Returns a list of server object property tags you can specify.
 long getOrder()
          Returns the active link execution order.
 QualifierInfo getQualifier()
          Returns the qualification that determines which set of If/Else actions should be executed.
 WorkflowConnectInfo getWorkflowConnect()
          Returns the list of form names the active link is linked to.
 boolean isPresent()
          Denotes if the field is valid.
 void load()
          Populates this object with information from the AR System server.
 void load(ActiveLinkCriteria criteria)
          Populates this object with information specified by ActiveLinkCriteria from the AR System server.
 void passivate()
          Remedy reserved method.
 void remove()
          Removes this object on the AR System server.
 void setActionList(ActiveLinkActionInfo[] actionList)
          Sets a list of actions performed if the condition defined by the query parameter is satisfied.
 void setContext(ARServerUser ctx)
          Associates ARServerUser information with this AR System server object.
 void setControlField(long controlField)
          Sets the ID of the field that represents the button, toolbar button, or menu item associated with executing the active link.
 void setElseList(ActiveLinkActionInfo[] elseList)
          Sets list of actions performed if the condition defined by the query parameter is not satisfied.
 void setEnable(long enable)
          Sets the flag identifying whether the active link is disabled (0) or enabled (1).
 void setExecuteMask(long executeMask)
          Sets the masks indicating the form operations that trigger the active link.
 void setFocusField(long focusField)
          Sets the ID of the field associated with executing the active link by pressing Return or selecting a character menu item.
 void setGroupList(InternalID[] groupList)
          Sets the list of zero or more groups who can access this active link.
 void setKey(ActiveLinkKey key)
          Sets unique identifier for active link.
 void setObjPropList(PropInfo[] objPropList)
          Sets a list of server object property tags you can specify.
 void setOrder(long order)
          Sets the active link execution order.
 void setQualifier(QualifierInfo query)
          Sets the qualification that determines which set of If/Else actions should be executed.
 void setWorkflowConnect(WorkflowConnectInfo workflowConnect)
          Sets the list of form names the active link is linked to.
 void store()
          Saves the changes made to this object specified by ActiveLinkCriteria on the AR System server.
 void unsetContext()
          Removes the association to a specific user context.
 
Methods inherited from class com.remedy.arsys.api.ObjectBase
getDiary, getHelpText, getLastChangedBy, getLastUpdateTime, getName, getNewName, getOwner, getPermissions, resetChangeFlags, setDiary, setHelpText, setLastChangedBy, setName, setNewName, setOwner, setPermissions
 
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

setContext

public void setContext(ARServerUser ctx)
Description copied from interface: IARPersistentObject
Associates ARServerUser information with this AR System server object.
Specified by:
setContext in interface IARPersistentObject

unsetContext

public void unsetContext()
Description copied from interface: IARPersistentObject
Removes the association to a specific user context. This is equal to setContext(null).
Specified by:
unsetContext in interface IARPersistentObject

clear

public void clear()
Description copied from interface: IARPersistentObject
Clears all of the references to member objects.
Specified by:
clear in interface IARPersistentObject
Overrides:
clear in class ObjectBase

create

public void create()
            throws ARException
Description copied from interface: IARPersistentObject
Creates this object on the AR System server.
Specified by:
create in interface IARPersistentObject

remove

public void remove()
            throws ARException
Description copied from interface: IARPersistentObject
Removes this object on the AR System server.
Specified by:
remove in interface IARPersistentObject

load

public void load()
          throws ARException
Description copied from interface: IARPersistentObject
Populates this object with information from the AR System server.
Specified by:
load in interface IARPersistentObject

load

public void load(ActiveLinkCriteria criteria)
          throws ARException
Populates this object with information specified by ActiveLinkCriteria from the AR System server.

store

public void store()
           throws ARException
Saves the changes made to this object specified by ActiveLinkCriteria on the AR System server.
Specified by:
store in interface IARPersistentObject

activate

public void activate()
Remedy reserved method.
Specified by:
activate in interface IARPersistentObject

passivate

public void passivate()
Remedy reserved method.
Specified by:
passivate in interface IARPersistentObject

isPresent

public boolean isPresent()
Denotes if the field is valid.

getOrder

public long getOrder()
Returns the active link execution order. Use a value between 0 and 1000 (inclusive). When multiple active links are associated with a form, the value associated with each active link determines the order in which they are processed (from lowest to highest).

setOrder

public void setOrder(long order)
Sets the active link execution order. Use a value between 0 and 1000 (inclusive). When multiple active links are associated with a form, the value associated with each active link determines the order in which they are processed (from lowest to highest).

getExecuteMask

public long getExecuteMask()
Returns the masks indicating the form operations that trigger the active link. You can use any of the following constants:

setExecuteMask

public void setExecuteMask(long executeMask)
Sets the masks indicating the form operations that trigger the active link. You can use any of the following constants:

getControlField

public long getControlField()
Returns the ID of the field that represents the button, toolbar button, or menu item associated with executing the active link. The system returns zero if the executeMask does not include the Constants.AR_EXECUTE_ON_BUTTON condition.

setControlField

public void setControlField(long controlField)
Sets the ID of the field that represents the button, toolbar button, or menu item associated with executing the active link. The system returns zero if the executeMask does not include the Constants.AR_EXECUTE_ON_BUTTON condition.

getFocusField

public long getFocusField()
Returns the ID of the field associated with executing the active link by pressing Return or selecting a character menu item. The system returns zero if the executeMask does not include the Constants.AR_EXECUTE_ON_RETURN or Constants.AR_EXECUTE_ON_MENU_CHOICE conditions.

setFocusField

public void setFocusField(long focusField)
Sets the ID of the field associated with executing the active link by pressing Return or selecting a character menu item. The system returns zero if the executeMask does not include the Constants.AR_EXECUTE_ON_RETURN or Constants.AR_EXECUTE_ON_MENU_CHOICE conditions.

getEnable

public long getEnable()
Returns the flag identifying whether the active link is disabled (0) or enabled (1).

setEnable

public void setEnable(long enable)
Sets the flag identifying whether the active link is disabled (0) or enabled (1).

getWorkflowConnect

public WorkflowConnectInfo getWorkflowConnect()
Returns the list of form names the active link is linked to. The active link must be associated with a single form or a list of forms that currently exists on the server.

setWorkflowConnect

public void setWorkflowConnect(WorkflowConnectInfo workflowConnect)
Sets the list of form names the active link is linked to. The active link must be associated with a single form or a list of forms that currently exists on the server.

getGroupList

public InternalID[] getGroupList()
Returns the list of zero or more groups who can access this active link. Access to this information is limited to users with AR System administrator privileges only.

setGroupList

public void setGroupList(InternalID[] groupList)
Sets the list of zero or more groups who can access this active link. Access to this information is limited to users with AR System administrator privileges only.

getQualifier

public QualifierInfo getQualifier()
Returns the qualification that determines which set of If/Else actions should be executed. The system returns zero (Constants.AR_COND_OP_NONE) if the active link has no qualification.

setQualifier

public void setQualifier(QualifierInfo query)
Sets the qualification that determines which set of If/Else actions should be executed. The system returns zero (AR_COND_OP_NONE) if the active link has no qualification.

getObjPropList

public PropInfo[] getObjPropList()
Returns a list of server object property tags you can specify. The constant values listed below are defined by Remedy Corporation. If getObjPropList parameter is NULL, a list of zero properties is returned.

setObjPropList

public void setObjPropList(PropInfo[] objPropList)
Sets a list of server object property tags you can specify. The constant values listed below are defined by Remedy Corporation: If setObjPropList parameter is NULL, a list of zero properties is returned.

getActionList

public ActiveLinkActionInfo[] getActionList()
Returns a list of actions performed if the condition defined by the query parameter is satisfied. This list can contain from 1 to 25 actions (limited by Constants.AR_MAX_ACTIONS).

setActionList

public void setActionList(ActiveLinkActionInfo[] actionList)
Sets a list of actions performed if the condition defined by the query parameter is satisfied. This list can contain from 1 to 25 actions (limited by Constants.AR_MAX_ACTIONS).

getElseList

public ActiveLinkActionInfo[] getElseList()
Returns set of actions performed if the condition defined by the query parameter is not satisfied. This list can contain from 0 to 25 actions.

setElseList

public void setElseList(ActiveLinkActionInfo[] elseList)
Sets list of actions performed if the condition defined by the query parameter is not satisfied. This list can contain from 0 to 25 actions.

getKey

public ActiveLinkKey getKey()
Returns unique identifier for active link.

setKey

public void setKey(ActiveLinkKey key)
Sets unique identifier for active link.

clone

public java.lang.Object clone()
                       throws java.lang.CloneNotSupportedException
Clone implementation that returns an Object with data cloned from self
Overrides:
clone in class ObjectBase

Action Request System Java API