com.avaya.jtapi.tsapi
Interface LucentCallEx2

All Superinterfaces:

Call, CallCenterCall, CallControlCall, ITsapiCall, ITsapiCallInfo, LucentCall, LucentCallEx, LucentCallInfo

All Known Subinterfaces:

LucentV5Call, LucentV7Call

public interface LucentCallEx2
extends LucentCallEx

This interface was added to provide the fastConnect feature for IDLE calls. Note that this feature only requires TSAPI private data version 4, so correspondingly this interface extends LucentCallEx. In turn LucentV5Call and successive interfaces extend this interface and Avaya Call objects discovered to implement those interfaces support this feature.

See Also:

Call, LucentCall, LucentV5Call

Field Summary

Fields inherited from interface javax.telephony.Call

ACTIVE, IDLE, INVALID

Fields inherited from interface javax.telephony.Call

ACTIVE, IDLE, INVALID

Fields inherited from interface javax.telephony.callcenter.CallCenterCall

ANSWERING_TREATMENT_CONNECT, ANSWERING_TREATMENT_DROP, ANSWERING_TREATMENT_NONE, ANSWERING_TREATMENT_PROVIDER_DEFAULT, ENDPOINT_ANSWERING_MACHINE, ENDPOINT_ANY, ENDPOINT_FAX_MACHINE, ENDPOINT_HUMAN_INTERVENTION, MAX_RINGS, MIN_RINGS

Fields inherited from interface javax.telephony.Call

ACTIVE, IDLE, INVALID

Fields inherited from interface com.avaya.jtapi.tsapi.LucentCallInfo

AR_ANSWER_MACHINE_DETECTED, AR_ANSWER_NORMAL, AR_ANSWER_TIMED, AR_ANSWER_VOICE_ENERGY, AR_IN_QUEUE, AR_NONE, AR_SIT_INEFFECTIVE_OTHER, AR_SIT_INTERCEPT, AR_SIT_NO_CIRCUIT, AR_SIT_REORDER, AR_SIT_UNKNOWN, AR_SIT_VACANT_CODE

Method Summary

Connection

fastConnect(Terminal origterm, Address origaddr, java.lang.String dialedDigits, boolean priorityCall, UserToUserInfo userInfo, java.lang.String destRoute) Initiate a call and return the Connection of the originating party.

Methods inherited from interface com.avaya.jtapi.tsapi.LucentCallEx

connectDirectAgent, consultDirectAgent

Methods inherited from interface com.avaya.jtapi.tsapi.LucentCall

connect, connectDirectAgent, connectPredictive, connectSupervisorAssist, consult, consultDirectAgent, consultSupervisorAssist

Methods inherited from interface javax.telephony.Call

addCallListener, addObserver, connect, getCallCapabilities, getCallListeners, getCapabilities, getConnections, getObservers, getProvider, getState, removeCallListener, removeObserver

Methods inherited from interface javax.telephony.callcontrol.CallControlCall

addParty, conference, consult, consult, drop, getCalledAddress, getCallingAddress, getCallingTerminal, getConferenceController, getConferenceEnable, getLastRedirectedAddress, getTransferController, getTransferEnable, offHook, setConferenceController, setConferenceEnable, setTransferController, setTransferEnable, transfer, transfer

Methods inherited from interface javax.telephony.Call

addCallListener, addObserver, connect, getCallCapabilities, getCallListeners, getCapabilities, getConnections, getObservers, getProvider, getState, removeCallListener, removeObserver

Methods inherited from interface javax.telephony.callcenter.CallCenterCall

connectPredictive, getApplicationData, getTrunks, setApplicationData

Methods inherited from interface javax.telephony.Call

addCallListener, addObserver, connect, getCallCapabilities, getCallListeners, getCapabilities, getConnections, getObservers, getProvider, getState, removeCallListener, removeObserver

Methods inherited from interface com.avaya.jtapi.tsapi.LucentCallInfo

getDeliveringACDAddress, getDistributingAddress, getLookaheadInfo, getOriginalCallInfo, getReason, getTrunk, getUserEnteredCode, getUserToUserInfo

Method Detail

fastConnect

Connection fastConnect(Terminal origterm,
                       Address origaddr,
                       java.lang.String dialedDigits,
                       boolean priorityCall,
                       UserToUserInfo userInfo,
                       java.lang.String destRoute)
                       throws TsapiResourceUnavailableException,
                              TsapiPrivilegeViolationException,
                              TsapiInvalidPartyException,
                              TsapiInvalidArgumentException,
                              TsapiInvalidStateException,
                              TsapiMethodNotSupportedException

Initiate a call and return the Connection of the originating party. This API call is similar to the standard JTAPI API method connect() in Call in its preconditions, and to the Avaya method connect() in LucentCall in its parameters.

fastConnect compared to Call.connect and LucentCall.connect

It adds the destRoute parameter, which is exposing a TSAPI parameter useful for sending FACs (Feature Access Codes) such as TAC (Trunk Access Code) codes.

Post Conditions

The biggest difference between fastConnect and the connect methods is that fastConnect only waits for and returns a single Connection for the call (a Connection for the calling party).

Since fastConnect returns immediately after receiving confirmation that the creation of a call has been confirmed, the returned connection may be in the javax.telephony.Connection.IDLE state. Similar to the Call.connect method, the state of the returned Connection may have advanced beyond Connection.IDLE.

If the state has advanced to Connection.DISCONNECTED, that is, if the originator actually becomes disconnected from the call (for example, because the call ends rapidly), fastConnect shall return a null Connection reference.

Parameters:

origterm - The originating Terminal for this telephone call.

origaddr - The originating Address for this telephone call.

dialedDigits - The destination address string for this telephone call.

priorityCall - If true, attempt to place a priority call.

userInfo - Associate caller information, up to 96 bytes (with Avaya CT 1.2 or higher, or formally named CVCT 3.3 or higher that is connected to a DEFINITY G3V8 or higher; otherwise the limit is 32 bytes).

destRoute - Specifies the TAC/ARS/AAR information for an off-PBX destination, if the information is not included in the calledDevice. Alternatively may specify a FAC (feature access code) prefix for the calledDevice.

Returns:

the originating Connection for the Call, or, null if the originating Connection has advanced to the Connection.DISCONNECTED state.

Throws:

TsapiResourceUnavailableException - An internal resource necessary for placing the phone call is unavailable.

TsapiPrivilegeViolationException - The application does not have the proper authority to place a telephone call.

TsapiInvalidPartyException - Either the originator or the destination does not represent a valid party required to place a telephone call.

TsapiInvalidArgumentException - An argument provided is not valid either by not providing enough information for this method or is inconsistent with another argument.

TsapiInvalidStateException - Some object required by this method is not in a valid state as designated by the pre-conditions for this method.

TsapiMethodNotSupportedException - The implementation does not support this method.

See Also:

Call, Connection, CallControlConnection, LucentCall