|
Genesys 8.0 SCXML Technical Reference |
||
| < Parameter Elements Events > | |||
This is the initiation or creation of a voice interaction between a customer or resource and a resource. This is equivalent to the T-Server TMakeCall or TMakePredictiveCall functions.
|
Name |
Required |
Type |
Default Value |
Valid Values |
Description |
|---|---|---|---|---|---|
|
requestid |
false |
location expression |
none |
Any valid location expression |
This is the location for the request ID that is returned as part of this request. Any data model expression evaluating to a data model location. See SCXML Location Expressions for details. The location's value will be set to an internally generated unique string identifier to be associated with the action being sent. If this attribute is not specified, the event identifier is dropped. This identifier can be tested by the completion event handler to distinguish among several outstanding requests. If this attribute is not specified, the identifier can be acquired from the fetch completion event. Every request must receive a unique identifier. |
|
from |
true |
value expression |
none |
Any valid string or resource object |
A value expression which returns the address that this call is to be made from. See SCXML Legal Data Values and Value Expressions |
|
to |
true |
value expression |
none |
Any valid string or resource object |
A value expression which returns the destination address for this call. See SCXML Legal Data Values and Value Expressions |
|
type |
false |
NMTOKEN |
regular |
regular, agent, supervisor, priority, agent priority, predictive |
This defines the type of call that is to be created.
|
|
reason |
false |
value expression |
none |
Any valid string |
A value expression which returns the reason for making this call. See SCXML Legal Data Values and Value Expressions for details. |
|
udata |
false |
value expression |
none |
Any valid ECMAScript object |
A value expression which returns a valid ECMAScript object. This object's data will become part of the call's interaction object. See SCXML Legal Data Values and Value Expressions for details. |
|
hints |
false |
value expression |
none |
Any valid ECMAScript object |
A value expression which returns the ECMAScript object containing information which may be used by the implementing functional module when establishing this call. This information may consist of protocol-specific parameters, protocol selection guidelines, and so on. Note: The meaning of these hints is specific to the implementing functional module. See SCXML Legal Data Values and Value Expressions for details. |
|
timeout |
false |
value expression |
none |
A value expression which returns an integer |
A value expression which returns an integer which represents the number of seconds to wait. See SCXML Legal Data Values and Value Expressions
for details. The integer returned is interpreted as a time interval. This interval begins when |
The following is an example:
<state id="do_createcall"> <datamodel> <data id="reqid"/> </datamodel> <onentry> <ixn:createcall requestid="_data.reqid" from="'1234'" to="'+1919466600'" /> </onentry> <transition event="voice.createcall.done" target="statex"/> <transition event="error.voice.createcall" target="statey"/> </state>
None
The following events can be generated as part of this action:
This action puts a voice interaction on hold for a specific resource's device. This is equivalent to the T-Server THoldCall function.
|
Name |
Required |
Type |
Default Value |
Valid Values |
Description |
|---|---|---|---|---|---|
|
requestid |
false |
location expression |
none |
Any valid location expression |
This is the location for the request ID that is returned as part of this request. Any data model expression evaluating to a data model location. See SCXML Location Expressions for details. The location's value will be set to an internally generated unique string identifier to be associated with the action being sent. If this attribute is not specified, the event identifier is dropped. This identifier can be tested by the completion event handler to distinguish among several outstanding requests. If this attribute is not specified, the identifier can be acquired from the fetch completion event. Every request must receive a unique identifier. |
|
interactionid |
true |
value expression |
Any value expression that returns a valid string |
A value expression which returns the _genesys.FMname.interactions[x].g_uid associated with this request. See SCXML Legal Data Values and Value Expressions for details. |
|
|
resource |
true |
value expression |
none |
Any valid string or resource object |
A value expression which returns the holding device address for this call. See SCXML Legal Data Values and Value Expressions |
|
hints |
false |
value expression |
none |
Any valid ECMAScript object |
A value expression which returns the ECMAScript object containing information which may be used by the implementing functional module when holding this call. This information may consist of protocol-specific parameters, protocol selection guidelines, and so on. Note: The meaning of these hints is specific to the implementing functional module. See SCXML Legal Data Values and Value Expressions for details. |
The following is an example:
<state id="do_holdcall"> <datamodel> <data id="reqid"/> <data id="ixnid"/> </datamodel> <onentry> <ixn:hold requestid="_data.reqid" interactionid="_data.ixnid" resource="'1234'" /> </onentry> <transition event="voice.hold.done" target="statex"/> <transition event="error.voice.hold" target="statey"/> </state>
None
The following events can be generated as part of this action:
This action retrieves a voice interaction from hold for a specific resource's device. This is equivalent to the T-Server TRetrieveCall function.
|
Name |
Required |
Type |
Default Value |
Valid Values |
Description |
|---|---|---|---|---|---|
|
requestid |
false |
location expression |
none |
Any valid location expression |
This is the location for the request ID that is returned as part of this request. Any data model expression evaluating to a data model location. See SCXML Location Expressions for details. The location's value will be set to an internally generated unique string identifier to be associated with the action being sent. If this attribute is not specified, the event identifier is dropped. This identifier can be tested by the completion event handler to distinguish among several outstanding requests. If this attribute is not specified, the identifier can be acquired from the fetch completion event. Every request must receive a unique identifier. |
|
interactionid |
true |
value expression |
Any value expression that returns a valid string |
A value expression which returns the _genesys.FMname.interactions[x].g_uid associated with this request. See SCXML Legal Data Values and Value Expressions for details. |
|
|
resource |
true |
value expression |
none |
Any valid string or resource object |
A value expression which returns the retrieved device address for this call. See SCXML Legal Data Values and Value Expressions |
|
hints |
false |
value expression |
none |
Any valid ECMAScript object |
A value expression which returns the ECMAScript object containing information which may be used by the implementing functional module when retrieving this call. This information may consist of protocol-specific parameters, protocol selection guidelines, and so on. Note: The meaning of these hints is specific to the implementing functional module. See SCXML Legal Data Values and Value Expressions for details. |
The following is an example:
<state id="do_retrievecall"> <datamodel> <data id="reqid"/> <data id="ixnid"/> </datamodel> <onentry> <ixn:retrieve requestid="_data.reqid" interactionid="_data.ixnid" resource="'1234'" /> </onentry> <transition event="voice.retrieve.done" target="statex"/> <transition event="error.voice.retrieve" target="statey"/> </state>
None
The following events can be generated as part of this action:
This action extends an existing voice interaction to consult with a new resource's device. This is equivalent to the T-Server TInitiateTransfer and TInitiateConference functions.
|
Name |
Required |
Type |
Default Value |
Valid Values |
Description |
|---|---|---|---|---|---|
|
requestid |
false |
location expression |
none |
Any valid location expression |
This is the location for the request ID that is returned as part of this request. Any data model expression evaluating to a data model location. See SCXML Location Expressions for details. The location's value will be set to an internally generated unique string identifier to be associated with the action being sent. If this attribute is not specified, the event identifier is dropped. This identifier can be tested by the completion event handler to distinguish among several outstanding requests. If this attribute is not specified, the identifier can be acquired from the fetch completion event. Every request must receive a unique identifier. |
|
interactionid |
true |
value expression |
Any value expression that returns a valid string |
A value expression which returns the _genesys.FMname.interactions[x].g_uid associated with this request. See SCXML Legal Data Values and Value Expressions for details. |
|
|
from |
true |
value expression |
none |
Any valid string or resource object |
A value expression which returns the address that this consultation is to be made from. See SCXML Legal Data Values and Value Expressions |
|
to |
true |
value expression |
none |
Any valid string or resource object |
A value expression which returns the destination address for this consultation See SCXML Legal Data Values and Value Expressions |
|
udata |
false |
value expression |
none |
Any valid ECMAScript object |
A value expression which returns a valid ECMAScript object. This object's data will be come part of the consultation call's interaction object. See SCXML Legal Data Values and Value Expressions for details. |
|
hints |
false |
value expression |
none |
Any valid ECMAScript object |
A value expression which returns the ECMAScript object containing information which may be used by the implementing functional module when consulting. This information may consist of protocol-specific parameters, protocol selection guidelines, and so on. Note: The meaning of these hints is specific to the implementing functional module. See SCXML Legal Data Values and Value Expressions for details. |
The following is an example:
<state id="do_consultationcall"> <datamodel> </datamodel> <onentry> <ixn:consultation requestid="_data.reqid" interactionid="_data.ixnid" from="'1234'" to="'5678'" /> </onentry> <transition event="voice.consultation.done" target="statex"/> <transition event="error.voice.consultation" target="statey"/> </state>
None
The following events can be generated as part of this action:
This action alternates a resource from a held call and an active call. This is equivalent to the T-Server TAlternateCall function.
|
Name |
Required |
Type |
Default Value |
Valid Values |
Description |
|---|---|---|---|---|---|
|
requestid |
false |
location expression |
none |
Any valid location expression |
This is the location for the request ID that is returned as part of this request. Any data model expression evaluating to a data model location. See SCXML Location Expressions for details. The location's value will be set to an internally generated unique string identifier to be associated with the action being sent. If this attribute is not specified, the event identifier is dropped. This identifier can be tested by the completion event handler to distinguish among several outstanding requests. If this attribute is not specified, the identifier can be acquired from the fetch completion event. Every request must receive a unique identifier. |
|
heldinteractionid |
true |
value expression |
Any value expression that returns a valid string |
A value expression which returns the _genesys.FMname.interactions[x].g_uid associated with this request. See SCXML Legal Data Values and Value Expressions for details. |
|
|
heldresource |
true |
value expression |
none |
Any valid string or resource object |
A value expression which returns the address that is the held call. For details, see See SCXML Legal Data Values and Value Expressions |
|
activeinteractionid |
true |
value expression |
Any value expression that returns a valid string |
A value expression which returns the _genesys.FMname.interactions[x].g_uid associated with this request. See SCXML Legal Data Values and Value Expressions for details. |
|
|
activeresource |
true |
value expression |
none |
Any valid string or resource object |
A value expression which returns the address that is in the active call. For details, see See SCXML Legal Data Values and Value Expressions |
|
hints |
false |
value expression |
none |
Any valid ECMAScript object |
A value expression which returns the ECMAScript object containing information which may be used by the implementing functional module when altering. This information may consist of protocol-specific parameters, protocol selection guidelines, and so on. Note: The meaning of these hints is specific to the implementing functional module. See SCXML Legal Data Values and Value Expressions for details. |
The following is an example:
<state id="do_alternatecall"> <datamodel> <data id="reqid"/> <data id="Aixnid"/> <data id="Hixnid"/> </datamodel> <onentry> <ixn:alternate requestid="_data.reqid" heldinteractionid="_data.Hixnid" heldresource="'1234'" activeinteractionid="_data.Aixnid" activeresource="'5678'" /> </onentry> <transition event="voice.alternate.done" target="statex"/> <transition event="error.voice.alternate" target="statey"/> </state>
None
The following events can be generated as part of this action:
This action drops the active call in the consultation and retrieves the held call for a specific resource. This is equivalent to the T-Server TReconnectCall function.
|
Name |
Required |
Type |
Default Value |
Valid Values |
Description |
|---|---|---|---|---|---|
|
requestid |
false |
location expression |
none |
Any valid location expression |
This is the location for the request ID that is returned as part of this request. Any data model expression evaluating to a data model location. See SCXML Location Expressions for details. The location's value will be set to an internally generated unique string identifier to be associated with the action being sent. If this attribute is not specified, the event identifier is dropped. This identifier can be tested by the completion event handler to distinguish among several outstanding requests. If this attribute is not specified, the identifier can be acquired from the fetch completion event. Every request must receive a unique identifier. |
|
heldinteractionid |
true |
value expression |
Any value expression that returns a valid string |
A value expression which returns the _genesys.FMname.interactions[x].g_uid associated with this request. See SCXML Legal Data Values and Value Expressions for details. |
|
|
heldresource |
true |
value expression |
none |
Any valid string or resource object |
A value expression which returns the address that is the held call. For details, see See SCXML Legal Data Values and Value Expressions |
|
activeinteractionid |
true |
value expression |
Any value expression that returns a valid string |
A value expression which returns the _genesys.FMname.interactions[x].g_uid associated with this request. See SCXML Legal Data Values and Value Expressions for details. |
|
|
activeresource |
true |
value expression |
none |
Any valid string or resource object |
A value expression which returns the address that is in the active call. For details, see See SCXML Legal Data Values and Value Expressions |
|
hints |
false |
value expression |
none |
Any valid ECMAScript object |
A value expression which returns the ECMAScript object containing information which may be used by the implementing functional module when reconnection is done. This information may consist of protocol-specific parameters, protocol selection guidelines, and so on. Note: The meaning of these hints is specific to the implementing functional module. See SCXML Legal Data Values and Value Expressions for details. |
The following is an example:
<state id="do_reconnectcall"> <datamodel> <data id="reqid"/> <data id="Aixnid"/> <data id="Hixnid"/> </datamodel> <onentry> <ixn:reconnect requestid="_data.reqid" heldinteractionid="_data.Hixnid" heldresource="'1234'" activeinteractionid="_data.Aixnid" activeresource="'5678'" /> </onentry> <transition event="voice.reconnect.done" target="statex"/> <transition event="error.voice.reconnect" target="statey"/> </state>
None
The following events can be generated as part of this action:
This action conferences a consultation call from a specific resource. This is equivalent to the T-Server TCompleteConference function.
|
Name |
Required |
Type |
Default Value |
Valid Values |
Description |
|---|---|---|---|---|---|
|
requestid |
false |
location expression |
none |
Any valid location expression |
This is the location for the request ID that is returned as part of this request. Any data model expression evaluating to a data model location. See SCXML Location Expressions for details. The location's value will be set to an internally generated unique string identifier to be associated with the action being sent. If this attribute is not specified, the event identifier is dropped. This identifier can be tested by the completion event handler to distinguish among several outstanding requests. If this attribute is not specified, the identifier can be acquired from the fetch completion event. Every request must receive a unique identifier. |
|
heldinteractionid |
true |
value expression |
Any value expression that returns a valid string |
A value expression which returns the _genesys.FMname.interactions[x].g_uid associated with this request. See SCXML Legal Data Values and Value Expressions for details. |
|
|
activeinteractionid |
true |
value expression |
Any value expression that returns a valid string |
A value expression which returns the _genesys.FMname.interactions[x].g_uid associated with this request. See SCXML Legal Data Values and Value Expressions for details. |
|
|
resource |
true |
value expression |
none |
Any valid string or resource object |
A value expression which returns the address that is conferencing the call. For details, see See SCXML Legal Data Values and Value Expressions |
|
hints |
false |
value expression |
none |
Any valid ECMAScript object |
A value expression which returns the ECMAScript object containing information which may be used by the implementing functional module when conferencing. This information may consist of protocol-specific parameters, protocol selection guidelines, and so on. Note: The meaning of these hints is specific to the implementing functional module. See SCXML Legal Data Values and Value Expressions for details. |
The following is an example:
<state id="do_conferencecall"> <datamodel> <data id="reqid"/> <data id="Aixnid"/> <data id="Hixnid"/> </datamodel> <onentry> <ixn:conference requestid="_data.reqid" heldinteractionid="_data.Hixnid" activeinteractionid="_data.Aixnid" resource="'1234'"/> </onentry> <transition event="voice.conference.done" target="statex"/> <transition event="error.voice.conference" target="statey"/> </state>
None
The following events can be generated as part of this action:
This action transfers a consultation call from a specific resource. This is equivalent to the T-Server TCompleteTransfer function.
|
Name |
Required |
Type |
Default Value |
Valid Values |
Description |
|---|---|---|---|---|---|
|
requestid |
false |
location expression |
none |
Any valid location expression |
This is the location for the request ID that is returned as part of this request. Any data model expression evaluating to a data model location. See SCXML Location Expressions for details. The location's value will be set to an internally generated unique string identifier to be associated with the action being sent. If this attribute is not specified, the event identifier is dropped. This identifier can be tested by the completion event handler to distinguish among several outstanding requests. If this attribute is not specified, the identifier can be acquired from the fetch completion event. Every request must receive a unique identifier. |
|
heldinteractionid |
true |
value expression |
Any value expression that returns a valid string |
A value expression which returns the _genesys.FMname.interactions[x].g_uid associated with this request. See SCXML Legal Data Values and Value Expressions for details. |
|
|
activeinteractionid |
true |
value expression |
Any value expression that returns a valid string |
A value expression which returns the _genesys.FMname.interactions[x].g_uid associated with this request. See SCXML Legal Data Values and Value Expressions for details. |
|
|
resource |
true |
value expression |
none |
Any valid string or resource object |
A value expression which returns the address that is transferring the call. For details, see See SCXML Legal Data Values and Value Expressions |
|
hints |
false |
value expression |
none |
Any valid ECMAScript object |
A value expression which returns the ECMAScript object containing information which may be used by the implementing functional module when transferring. This information may consist of protocol-specific parameters, protocol selection guidelines, and so on. Note: The meaning of these hints is specific to the implementing functional module. See SCXML Legal Data Values and Value Expressions for details. |
The following is an example:
<state id="do_transfercall"> <datamodel> <data id="reqid"/> <data id="Aixnid"/> <data id="Hixnid"/> </datamodel> <onentry> <ixn:conference requestid="_data.reqid" heldinteractionid="_data.Hixnid" activeinteractionid="_data.Aixnid" resource="'1234'"/> </onentry> <transition event="voice.transfer.done" target="statex"/> <transition event="error.voice.transfer" target="statey"/> </state>
None
The following events can be generated as part of this action:
|
Genesys 8.0 SCXML Technical Reference |
||
| < Parameter Elements Events > | |||