JSR-043: JTAPI-1.4

javax.telephony.callcenter.events
Interface CallCentCallEv

All Superinterfaces:
CallCentEv, CallEv, Ev
All Known Subinterfaces:
CallCentCallAppDataEv, CallCentConnEv, CallCentConnInProgressEv, CallCentTrunkEv, CallCentTrunkInvalidEv, CallCentTrunkValidEv

Deprecated. as of JTAPI 1.4, replaced by CallCenterCallEvent

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

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

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()
          Deprecated. Returns the called Address associated with this Call.
 Address getCallingAddress()
          Deprecated. Returns the calling Address associated with this call.
 Terminal getCallingTerminal()
          Deprecated. Returns the calling Terminal associated with this Call.
 Address getLastRedirectedAddress()
          Deprecated. 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()
Deprecated. 
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()
Deprecated. 
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()
Deprecated. 
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()
Deprecated. 
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.

JSR-043: JTAPI-1.4

Send comments to: JSR-43@ectf.org