javax.telephony.callcenter.events
Interface CallCentCallEv

All Superinterfaces:

CallCentEv, CallEv, Ev

All Known Subinterfaces:

CallCentCallAppDataEv, CallCentConnEv, CallCentConnInProgressEv, CallCentTrunkEv, CallCentTrunkInvalidEv, CallCentTrunkValidEv

public interface CallCentCallEv

extends CallCentEv, CallEv

The CallCentCallEv interface is the base event interface for all call center package Call-related events. Each Call-related event defined in this package must extend this interface. This interface extends both the core CallEv and the CallCentEv interfaces. All events which extend this interface are reported via the CallCenterCallObserver interface.

Additional Call Information

This interface supports methods which return additional information regarding the telephone call. Specifically, it returns the calling address, calling terminal, called address, and last redirected address information. This information is returned by the getCallingAddress(), getCallingTerminal(), getCalledAddress(), and getLastRedirectedAddress() methods on this interface, respectively.

The call center package defines the following interfaces which extend this interface: CallCentConnEv, CallCentAppDataEv, and CallCentTrunkEv

Avaya is providing its backward-compatible Observer model implementation in this release; in the specification this interface is deprecated as of JTAPI 1.4, replaced by CallCenterCallEvent

See Also:

Call, Address, Terminal, CallEv, CallCenterCallObserver, CallCenterCall, CallCenterTrunk, CallCentEv, CallCentConnEv, CallCentTrunkEv, CallCentCallAppDataEv

Field Summary

Fields inherited from interface javax.telephony.callcenter.events.CallCentEv

CAUSE_NO_AVAILABLE_AGENTS

Fields inherited from interface javax.telephony.events.Ev

CAUSE_CALL_CANCELLED, CAUSE_DEST_NOT_OBTAINABLE, CAUSE_INCOMPATIBLE_DESTINATION, CAUSE_LOCKOUT, CAUSE_NETWORK_CONGESTION, CAUSE_NETWORK_NOT_OBTAINABLE, CAUSE_NEW_CALL, CAUSE_NORMAL, CAUSE_RESOURCES_NOT_AVAILABLE, CAUSE_SNAPSHOT, CAUSE_UNKNOWN, META_CALL_ADDITIONAL_PARTY, META_CALL_ENDING, META_CALL_MERGING, META_CALL_PROGRESS, META_CALL_REMOVING_PARTY, META_CALL_STARTING, META_CALL_TRANSFERRING, META_SNAPSHOT, META_UNKNOWN

Method Summary

Address	getCalledAddress() Returns the called Address associated with this Call.
Address	getCallingAddress() Returns the calling Address associated with this call.
Terminal	getCallingTerminal() Returns the calling Terminal associated with this Call.
Address	getLastRedirectedAddress() Returns the last redirected Address associated with this Call.
CallCenterTrunk[]	getTrunks() Deprecated. JTAPI v1.2

Methods inherited from interface javax.telephony.callcenter.events.CallCentEv

getCallCenterCause

Methods inherited from interface javax.telephony.events.Ev

getCause, getID, getMetaCode, getObserved, isNewMetaEvent

Methods inherited from interface javax.telephony.events.CallEv

getCall

Method Detail

getCallingAddress

public Address getCallingAddress()

Returns the calling Address associated with this call. The calling Address is defined as the Address which placed the telephone call.

If the calling address is unknown or not yet known, this method returns null.

Returns:

The calling Address.

getCallingTerminal

public Terminal getCallingTerminal()

Returns the calling Terminal associated with this Call. The calling Terminal is defined as the Terminal which placed the telephone call.

If the calling Terminal is unknown or not yet know, this method returns null.

Returns:

The calling Terminal.

getCalledAddress

public Address getCalledAddress()

Returns the called Address associated with this Call. The called Address is defined as the Address to which the call has been originally placed.

If the called address is unknown or not yet known, this method returns null.

Returns:

The called Address.

getLastRedirectedAddress

public Address getLastRedirectedAddress()

Returns the last redirected Address associated with this Call. The last redirected Address is the Address at which the current telephone call was placed immediately before the current Address. This is common if a Call is forwarded to several Addresses before being answered.

If the the last redirected address is unknown or not yet known, this method returns null.

Returns:

The last redirected Address for this telephone Call.

getTrunks

public CallCenterTrunk[] getTrunks()

Deprecated. JTAPI v1.2

Returns an array of all Trunks currently being used for this Call. If there are no Trunks being used, this method returns null.

Note: This method has been replaced in JTAPI v1.2 and later with the CallCenterCall.getTrunks() method.

Returns:

An array of Trunks, null if there are none.