Invoking the Method Using SOAP

The wsdl for the exposed operations is accessible at http(s)://<host>:<port>/interactiondata/interactdata.wsdl.

The Interaction Server exposes the operation getVariablesSetData to retrieve routing information to be used by the Genesys routing script. The operation takes the following parameters:

Parameter

Description

protocolVersion

Version of the Interaction Server protocol.

accountID

ID of the customer’s account with Jacada.

uniqueID

The  Interaction Server Unique Identifier.

variableSet

The variable set to be exposed.

applicationKey

The Agent App application key.

The Interaction Designer can be used to define which variables in an Interaction will be sent as part of the getVariablesSetData operation. For further details, refer to the Jacada Interaction Server API Guide.

The output of the getVariablesSetData operation is a set of key-value pairs, where the key is the variable name defined in the Interaction Designer, and the value is the assigned value for that variable.

Note: The variable names are modified to the Java standard of Camel notations. For example, First Name is changed to firstName.

The SOAP response includes the tag <return><result>, which holds a string repressing the outcome of the web service invocation: either Success or Failure.

The actual values are returned under the xml tag <return><voice><data><entry>.

The sections below provide an example of a successful response, as well as details about failure responses.

tog_minusResponse Example

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">

   <S:Body>

      <ns2:getVariablesSetDataResponse xmlns:ns2="http://interact.jacada.com/services/interactiondata">

         <return>

            <result>Success</result>

            <voice>

               <data>

                  <entry>

                     <key>agentSkill</key>

                     <value>tech support</value>

                  </entry>

                  <entry>

                     <key>customerId</key>

                     <value>123456</value>

                  </entry>

                  <entry>

                     <key>customerProfile</key>

                     <value/>

                  </entry>

                  <entry>

                     <key>firstName</key>

                     <value>evgeny</value>

                  </entry>

                  <entry>

                     <key>language</key>

                     <value>EN</value>

                  </entry>

                  <entry>

                     <key>lastName</key>

                     <value>Gorodinsky</value>

                  </entry>

                  <entry>

                     <key>phoneNumber</key>

                     <value/>

                  </entry>

                  <entry>

                     <key>targetTelephonyQueue</key>

                     <value/>

                  </entry>

               </data>

            </voice>

         </return>

      </ns2:getVariablesSetDataResponse>

   </S:Body>

</S:Envelope>
tog_minusFault Handling

Failure to retrieve the information will result in the following response:

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">

   <S:Body>

      <ns2:getRoutingDataResponse xmlns:ns2="http://interact.jacada.com/services/interactiondata">

         <return>

            <result>Failure</result>

         </return>

      </ns2:getRoutingDataResponse>

   </S:Body>

</S:Envelope>

You can capture this by mapping the output key getRoutingDataResponse.return.result to a string variable. This will hold Failure in case of a failure response.