Interface java.telephony.callcenter.AgentTerminal
All Packages  Class Hierarchy  This Package  Previous  Next  Index

Interface java.telephony.callcenter.AgentTerminal

public interface AgentTerminal
extends Object
extends CallControlTerminal
The AgentTerminal interface models an agent extension for the ACD feature. AgentTerminal extends CallControlTerminal.

The methods added allow any Terminal to manage the association with an ACDAddress in order to accept calls coming to the ACDAddress.

To observe state changes for the agent, an application must use the methods Terminal.addObserver and Terminal.deleteObserver.


Method Index

 o getAgents()
This returns one or more Agent objects added previously to this AgentTerminal.
 o setAgents(Agent[])
This method either adds an Agent to this AgentTerminal in the state specified or changes the state of a previously added Agent or removes a previously added Agent.

Methods

 o setAgents
  public abstract void setAgents(Agent agents[]) throws PlatformException
This method either adds an Agent to this AgentTerminal in the state specified or changes the state of a previously added Agent or removes a previously added Agent.

If the state was set to LOG_IN, the Agent is added to this AgentTerminal and the post and pre conditions are as follows:

The pre-condition predicates for this method are:
1. (agentTerm.getProvider()).getState() == IN_SERVICE
2. agent.setState (appropriate state)
3. agent.agentAddress (an Address associated with the AgentTerminal)
4. agent.set (any attribute that is needed by the implementation to associate the Agent with the AgentTerminal in the specified state).

The post-condition predicates for this method are:
1. (agentTerm.getProvider()).getState() == IN_SERVICE
2. agent.getState() == (state specified from the setState)

If the Agent has already been added, this method can be used to change the Agent's state and the post and pre conditions are as follows:

The pre-condition predicates for this method are:
1. (agentTerm.getProvider()).getState() == IN_SERVICE
2. (agentTerm.getAgents() union agent) == agent
3. agent.setState (appropriate state)

The post-condition predicates for this method are:
1. (agentTerm.getProvider()).getState() == IN_SERVICE
2. agent.getState() == (state specified from the setState)

If the state was set to LOG_OUT, the Agent is removed from this AgentTerminal and the post and pre conditions are as follows:

The pre-condition predicates for this method are:
1. (agentTerm.getProvider()).getState() == IN_SERVICE
2. (agentTerm.getAgents() union agent) == agent

The post-condition predicates for this method are:
1. (agentTerm.getProvider()).getState() == IN_SERVICE
2. (agentTerm.getAgents() union agent) == nil

Parameters:
agents - being added, changed or removed.
Throws: PlatformException
A platform-specific exception occurred.
 o getAgents
  public abstract Agent[] getAgents() throws PlatformException
This returns one or more Agent objects added previously to this AgentTerminal.

If an Agent has been removed from an AgentTerminal, no Agent object will be returned to represent that.

Returns:
A list of Agents associated with this Terminal.
Throws: PlatformException
An platform-specific exception occurred.

All Packages  Class Hierarchy  This Package  Previous  Next  Index