ch.ecma.csta.binding
Class ParkCall

java.lang.Object
  ch.ecma.csta.CastorObject
      ch.ecma.csta.binding.ParkCall

All Implemented Interfaces:

java.io.Serializable

public class ParkCall
extends ch.ecma.csta.CastorObject
implements java.io.Serializable

This request is not supported.

Parks a call at a specified device. (Moves and queues a connected call to another device).

The device on whose behalf Park Call was invoked (the parking device) is no longer associated with the call (except when the parking device parks a call back to the parking device).

For an illustration of this event, see ECMA 269, section 17.1.20, Figure 17-23 "Park Call Service".

Connection State Transitions:

• The parking connection will transition from one of the allowable initial states of Hold or Connected to one of the allowable final states of Null or Queued (see note).
• The parked connection is unaffected (that is, there is no transition due to this service).
• The parkTo connection will transition from an allowable initial state of Null to an allowable final state of Queued.

Connection state transitions notes: Connection D1C1 may transit to the Queued state for certain shared bridged device configurations (see CSTA Functional Requirements #5).

See ECMA 269, section 17.1.20.3.2, Table 17-111 "Park Call - Device-Type Monitoring Event Sequences" for a table describing the sequence of events for device-type monitoring.

See ECMA 269, section 17.1.20.3.3, Table 17-112 "Park Call - Call-Type Monitoring Event Sequences" for a table describing the sequence of events for call-type monitoring.

CSTA Functional Requirements:

1. As a result of the Park Call service, the call ID associated with this call remains unchanged.
2. A call may be parked at a device which is already involved with the call. In this case the parking device (D1) and the parkTo (D3) are the same. Refer to ECMA 269, section 17.1.20, Figure 17-23 "Conference Call Service". for specific requirements for this configuration.
3. The switching function may have a time-out period for the call once it is parked. If the call is not unparked before the time-out period ends, then the parked call may ringback the parking device or another switching defined device such as an attendant console, for example, or the call may be dropped.
4. Features such as Do Not Disturb and Forwarding are honoured at the parkedTo device when the call is being parked.
5. For Shared Bridged device configurations, when a call is parked from an appearance (parking) all appearances will be cleared from the call (that is, Connection Cleared events with a cause of Normal Clearing), except when the call that is being parked is part of an Independent Shared Bridged device configuration and the appearance that is parking the call is not the last appearance connected into the call. In this case the appearance parking the call will return to the inactive mode (that is, Bridged event with a cause of Normal) and the other appearances are unaffected. For more information, refer to ECMA269, section Annex A.2.3, "Shared-Bridged".
6. This service request does not support the use of a null device identifier or a Diallable Digits format (DD) device identifier that has a partial dialling sequence character (that is, the ";" character) in it for the parkTo parameter. A complete and valid device identifier will be provided, otherwise the switching function will reject the service request with a negative acknowledgement.

Version:

$Revision$ $Date$

See Also:

Serialized Form

Constructor Summary

ParkCall()

Method Summary

boolean	equals(java.lang.Object obj) Note: hashCode() has not been overriden
CorrelatorData	getCorrelatorData() Returns the value of field 'correlatorData'.
CSTACommonArguments	getExtensions() Returns the value of field 'extensions'.
java.lang.String	getLanguagePreferences() Returns the value of field 'languagePreferences'.
ConnectionID	getParking() Returns the value of field 'parking'.
DeviceID	getParkTo() Returns the value of field 'parkTo'.
java.lang.String	getSubjectOfCall() Returns the value of field 'subjectOfCall'.
boolean	isValid() Method isValid
void	marshal(org.xml.sax.ContentHandler handler) Method marshal
void	marshal(java.io.Writer out) Method marshal
void	setCorrelatorData(CorrelatorData correlatorData) Sets the value of field 'correlatorData'.
void	setExtensions(CSTACommonArguments extensions) Sets the value of field 'extensions'.
void	setLanguagePreferences(java.lang.String languagePreferences) Sets the value of field 'languagePreferences'.
void	setParking(ConnectionID parking) Sets the value of field 'parking'.
void	setParkTo(DeviceID parkTo) Sets the value of field 'parkTo'.
void	setSubjectOfCall(java.lang.String subjectOfCall) Sets the value of field 'subjectOfCall'.
static ParkCall	unmarshalParkCall(java.io.Reader reader) Method unmarshalParkCall
void	validate() Method validate

Methods inherited from class ch.ecma.csta.CastorObject

getOldSessionID, hashCode, setOldSessionID, toString

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ParkCall

public ParkCall()

Method Detail

equals

public boolean equals(java.lang.Object obj)

Note: hashCode() has not been overriden

Overrides:

equals in class ch.ecma.csta.CastorObject

Parameters:

obj -

Returns:

boolean

getCorrelatorData

public CorrelatorData getCorrelatorData()

Returns the value of field 'correlatorData'.

Returns:

CorrelatorData

getExtensions

public CSTACommonArguments getExtensions()

Returns the value of field 'extensions'.

Returns:

CSTACommonArguments

getLanguagePreferences

public java.lang.String getLanguagePreferences()

Returns the value of field 'languagePreferences'.

Returns:

String

getParkTo

public DeviceID getParkTo()

Returns the value of field 'parkTo'. The field 'parkTo' has the following description: Specifies the device to which the call is to be parked (parkedto device). This may be either a station or a Park device. Mandatory.

Returns:

DeviceID

getParking

public ConnectionID getParking()

Returns the value of field 'parking'. The field 'parking' has the following description: Specifies the connection to be parked. Mandatory.

Returns:

ConnectionID

getSubjectOfCall

public java.lang.String getSubjectOfCall()

Returns the value of field 'subjectOfCall'.

Returns:

String

isValid

public boolean isValid()

Method isValid

Returns:

boolean

marshal

public void marshal(java.io.Writer out)
             throws org.exolab.castor.xml.MarshalException,
                    org.exolab.castor.xml.ValidationException

Method marshal

Parameters:

out -

Throws:

org.exolab.castor.xml.MarshalException

org.exolab.castor.xml.ValidationException

marshal

public void marshal(org.xml.sax.ContentHandler handler)
             throws java.io.IOException,
                    org.exolab.castor.xml.MarshalException,
                    org.exolab.castor.xml.ValidationException

Method marshal

Parameters:

handler -

Throws:

java.io.IOException

org.exolab.castor.xml.MarshalException

org.exolab.castor.xml.ValidationException

setCorrelatorData

public void setCorrelatorData(CorrelatorData correlatorData)

Sets the value of field 'correlatorData'.

Parameters:

correlatorData - the value of field 'correlatorData'.

setExtensions

public void setExtensions(CSTACommonArguments extensions)

Sets the value of field 'extensions'.

Parameters:

extensions - the value of field 'extensions'.

setLanguagePreferences

public void setLanguagePreferences(java.lang.String languagePreferences)

Sets the value of field 'languagePreferences'.

Parameters:

languagePreferences - the value of field 'languagePreferences'.

setParkTo

public void setParkTo(DeviceID parkTo)

Sets the value of field 'parkTo'. The field 'parkTo' has the following description: Specifies the device to which the call is to be parked (parkedto device). This may be either a station or a Park device. Mandatory.

Parameters:

parkTo - the value of field 'parkTo'.

setParking

public void setParking(ConnectionID parking)

Sets the value of field 'parking'. The field 'parking' has the following description: Specifies the connection to be parked. Mandatory.

Parameters:

parking - the value of field 'parking'.

setSubjectOfCall

public void setSubjectOfCall(java.lang.String subjectOfCall)

Sets the value of field 'subjectOfCall'.

Parameters:

subjectOfCall - the value of field 'subjectOfCall'.

unmarshalParkCall

public static ParkCall unmarshalParkCall(java.io.Reader reader)
                                  throws org.exolab.castor.xml.MarshalException,
                                         org.exolab.castor.xml.ValidationException

Method unmarshalParkCall

Parameters:

reader -

Returns:

ParkCall

Throws:

org.exolab.castor.xml.MarshalException

org.exolab.castor.xml.ValidationException

validate

public void validate()
              throws org.exolab.castor.xml.ValidationException

Method validate

Throws:

org.exolab.castor.xml.ValidationException