com.cisco.jtapi.extensions
Interface CiscoConsultCall

All Superinterfaces:
javax.telephony.Call, javax.telephony.callcontrol.CallControlCall, CiscoCall, CiscoObjectContainer

public interface CiscoConsultCall
extends CiscoCall

Introduction

The CiscoConsultCall interface extends the CiscoCall interface to expose certain properties of calls that have been created as part of a consultative transfer or consultative conference.

See Also:
Call

Field Summary
 
Fields inherited from interface com.cisco.jtapi.extensions.CiscoCall
CALLSECURITY_AUTHENTICATED, CALLSECURITY_ENCRYPTED, CALLSECURITY_NOTAUTHENTICATED, CALLSECURITY_UNKNOWN, FEATUREPRIORITY_EMERGENCY, FEATUREPRIORITY_NORMAL, FEATUREPRIORITY_URGENT, PLAYTONE_BOTHLOCALANDREMOTE, PLAYTONE_LOCALONLY, PLAYTONE_NOLOCAL_OR_REMOTE, PLAYTONE_REMOTEONLY, SILENT_MONITOR
 
Fields inherited from interface javax.telephony.Call
ACTIVE, IDLE, INVALID
 
Method Summary
 javax.telephony.Connection[] consultWithoutMedia(javax.telephony.TerminalConnection tc, java.lang.String dialedDigits)
          This interface provides applications ability to initiate a consultative call without setting up media for consult call.
 javax.telephony.TerminalConnection getConsultingTerminalConnection()
           Returns the consulting TerminalConnection that was used to create this CiscoConsultCall.
 
Methods inherited from interface com.cisco.jtapi.extensions.CiscoCall
conference, connect, getCalledAddressPI, getCalledPartyInfo, getCallID, getCallingAddressPI, getCallSecurityStatus, getConferenceChain, getCurrentCalledAddress, getCurrentCalledAddressPI, getCurrentCalledDisplayNamePI, getCurrentCalledPartyDisplayName, getCurrentCalledPartyInfo, getCurrentCalledPartyUnicodeDisplayName, getCurrentCalledPartyUnicodeDisplayNamelocale, getCurrentCallingAddress, getCurrentCallingAddressPI, getCurrentCallingDisplayNamePI, getCurrentCallingPartyDisplayName, getCurrentCallingPartyInfo, getCurrentCallingPartyUnicodeDisplayName, getCurrentCallingPartyUnicodeDisplayNamelocale, getGlobalizedCallingParty, getLastRedirectedPartyInfo, getLastRedirectingAddressPI, getLastRedirectingPartyInfo, getModifiedCalledAddress, getModifiedCallingAddress, isConference, startMonitor, startMonitor, transfer
 
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
addObserver, connect, getCallCapabilities, getCapabilities, getConnections, getObservers, getProvider, getState, removeObserver
 
Methods inherited from interface com.cisco.jtapi.extensions.CiscoObjectContainer
getObject, setObject
 

Method Detail

getConsultingTerminalConnection

javax.telephony.TerminalConnection getConsultingTerminalConnection()

Returns the consulting TerminalConnection that was used to create this CiscoConsultCall.

If this Call was created as part of a consultative transfer or consultative conference, the getConsultingTerminalConnection method returns the TerminalConnection that was used to perform the consultation on the original call. This method lets you correlate a ConsultCall with its original call. The original call itself does not have any methods that you can use determine the ConsultCall, if any, to which it is related.

Returns:
Null if this Call does not result from a consultation, or the consulting TerminalConnection of the original Call if this call resulted from a consultation.

consultWithoutMedia

javax.telephony.Connection[] consultWithoutMedia(javax.telephony.TerminalConnection tc,
                                                 java.lang.String dialedDigits)
                                                 throws javax.telephony.InvalidStateException,
                                                        javax.telephony.InvalidArgumentException,
                                                        javax.telephony.MethodNotSupportedException,
                                                        javax.telephony.ResourceUnavailableException,
                                                        javax.telephony.PrivilegeViolationException,
                                                        javax.telephony.InvalidPartyException
This interface provides applications ability to initiate a consultative call without setting up media for consult call. This interface may be invoked when application is creating a consult call and completing transfer before media establishes for consult call. Cisco Unified Communication Manager may some times run into erroneous race condition when consult call is answered, and application completes transfer in the middle of media setup for consult call. To avoid this problem, application that doesn't wait for media setup completion for consult call, may use this method to setup consult call. From CallEvent perspective, this method behaves similar to CallControlCall.consult(TerminalConnection tc, String dialedDigits). Creates a consultation between this Call and an active Call without establishing the media. This consult call may only be transferred, not conferenced. Cisco JTAPI does not support this method with CallControlCall.setConferenceEnable(). Cisco JTAPI only supports this method with CallControlCall.setTransferEnable().

Throws:
javax.telephony.InvalidStateException
javax.telephony.InvalidArgumentException
javax.telephony.MethodNotSupportedException
javax.telephony.ResourceUnavailableException
javax.telephony.PrivilegeViolationException
javax.telephony.InvalidPartyException