Hermes.

Net V4

Call custom function from HNet IVR editor

Hermes.Net V4

Auteur : Vocalcom
Date : 03/06/2015
Version: 1.0
Applies To: Hermes.Net 4

Copyright © 2001-2008 VOCALCOM S.A., 7 rue de Tilsitt 75017 PARIS – FRANCE. Tous droits réservés. 1/3
 Hermes.Net V4

Description

Il est souvent utile de pouvoir appeler, à partir d’un SVI, une ou des commandes externes non
disponibles dans l’éditeur de SVI. Par exemple : appeler un web service, exécuter une requête spécifique,
utiliser une dll spécifique, etc. Pour cela, jusqu’à présent il était possible de déclarer un fichier VBS où l’on
pouvait ajouter des fonctions Visual basic. Ce mécanisme se basait sur l’utilisation d’une DLL (onscript.dll) qui
gérait les échanges entre Onnet et le VBS. Suite à de nombreux problèmes rencontrés avec cette Dll, il a été
décidé de remplacer ce principe par un autre beaucoup plus adapté aux développeurs et beaucoup plus
puissant. Ci-dessous, est expliqué comment utiliser cette fonctionnalité.

Setup
Setup of this feature is quite simple.
It is using the same behavior thane vent sent from Onnet to OnData.

Binary file used (DLL) is placed in OnData Directory

OnData\service\RunTimeIVRWebService.dll

Functions used on ARBO side are placed in Onnet directory

Onnet\onh220\OnVdac.onh

DotNet Assembly that allow to call specifics function are in OnData

OnData\service\Ivr_Plugins\Ivr_External_Fct.cs

DotNet binary required for your assembly compilation are in OnData.

OnData\service\Ivr_Plugins\Ivr_External_Fct.def

Copyright © 2001-2008 VOCALCOM S.A., 7 rue de Tilsitt 75017 PARIS – FRANCE. Tous droits réservés. 2/3
 Hermes.Net V4

How it works

Methods existing in the IVR_External_fct.cs file should at least have one input parameter . This parameter is the
identifier of the call, and is unique for a contact.
The name of the class: IVR_Plugin , should not be changed.
The methods will only return the string .
When the methods require several parameters , these parameters will be separated by " @|@ ".

Warning:
- the current exchange protocol between Onnet and OnData limits sockets to 512 characters . This implies that
the sum of the parameters passed to IVRLIB_CALL_BACKGRD should not exceed 512 characters.
- The RunTimeIVRWebSrvice.dll dll contains standard functions called by the IVR editor. The features present in
the assembly for inclusion should not be termed as below:
o DB_Select_Request
o DB_Select_A_Field
o DB_Insert_Request
o DB_Update_Request
o Create_Code_TellNumber
o SEND_Event_To_Debuger
- This will not cause an error, but the standard function will be called instead of the one located in the enclosed
assembly.

Copyright © 2001-2008 VOCALCOM S.A., 7 rue de Tilsitt 75017 PARIS – FRANCE. Tous droits réservés. 3/3