Versions Compared

Old Version 16

changes.mady.by.user jtel Support

Saved on

compared with

New Version 17

changes.mady.by.user jtel Support

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Content imported from a Scroll Translations translation file.
Sv translation
languageen

Routing Query

The routing query is implemented via an IVR object with the following properties.


Function

The functionality of the object is as follows:

  • The system uses the settings of the routing application to determine whether it is a test call.
    • For test calls, the test data source is used for the query. For production calls, the production data source is used.
      Note: A test call in the IVR is initiated with the setting "Test call number" in the master data of the routing application.
  • The object implementation then calls the function EXEC pkg_rtma.set_mandant(x) to determine the client with the tenant ID set in the object.
  • Finally, the specified query is executed. The query can contain any variables, for example $caller.

Requirements

Installed and configured Oracle Instant Client on the jtel server, for production (minimum) and test database (optional) See also Oracle ODBC Driver.

System parameters

The following system parameters influence the operation of the object:

ParameterMeaning
Nexus.RIS.DSN.ProductionName of the ODBC data source, for production calls.
Nexus.RIS.DSN.Production.Connect

ODBC connection string for the connection to the production database. Example:

Translations Ignore
DSN=nexus_prod;UID=prod_user;PWD=topsecret

Nexus.RIS.DSN.TestName of the ODBC data source, for test calls.
Nexus.RIS.DSN.Test.Connect

ODBC connection string for the connection to the test database. Example:

Translations Ignore
DSN=nexus_prod;UID=prod_user;PWD=topsecret

Parameters

ParameterMeaning
Tenant IDThe ID of the client that is used for the parameter x (client ID) for the call to EXEC pkg_rtma.set_mandant(x). This call is made transparently in the object itself.
Variable PrefixA prefix that precedes all variables from the query return. For example, if the query returns a field "ISVIP" and "nexus" is used as a prefix, the object declares a variable named nexus.ISVIP
Query

The query to be executed. For example:

Translations Ignore
SELECT COUNT(*) AS RecordCount, MIN(pers.pers_kz_vip) AS isVIP 
FROM person pers, pat_kontakt kont 
WHERE pers.piz = kont.kont_piz AND kont_nummer = '$caller';

Variables

All fields returned from the query are stored in variables. Only the first record is saved if multiple hits are returned.

From the example above, the following variables are declared:

  • nexus.RECORDCOUNT
  • nexus.ISVIP

Note: Oracle always returns field names in uppercase via ODBC. The variables are accordingly created with capital letters, regardless of how they are written in the query itself.

Object outputs

OutputUse when
Found1 or more data sets returned by the query
Not found0 data sets returned by the query.
ErrorAn error occurred in the query or the connection to the database.


Sv translation
languagede

Routing Abfrage

Die Routing Abfrage wird über ein IVR Objekt realisiert, mit folgenden Eigenschaften.


Funktion

Die Funktionsweise des Objekts ist wie folgt:

  • Das System bestimmt, anhand der Einstellungen der Routing Applikation, ob es sich um ein Test-Call handelt.
    • Bei Testcalls, wird die Test Datenquelle für die Abfrage genutzt. Bei Produktionscalls, wird die Produktions-Datenquelle genutzt.
      Hinweis: Ein Testcall in der IVR wird mit der Einstellung "Testrufnummer" im Stammdaten der Routing-Applikation bewirkt.
  • Anschließend ruft die Objektimplementierung die Funktion EXEC pkg_rtma.set_mandant(x) auf, um den Mandanten zu bestimmen, mit der im Objekt eingestellten Mandanten ID.
  • Als letztes, wird die angegebene Query ausgeführt. Die Query kann beliebige Variablen enthalten, beispielsweise $caller.

Voraussetzungen

Installierter und konfigurierter Oracle Instant Client auf den jtel Server, für Produktion (mindestens) sowie Test-Datenbank (Optional). Siehe auch Oracle ODBC Driver.

Systemparameter

Folgende Systemparameter beeinflussen die Operation des Objekts:

ParameterBedeutung
Nexus.RIS.DSN.ProductionName der ODBC Datenquelle, für Produktions-Calls.
Nexus.RIS.DSN.Production.Connect

ODBC Connection-String für die Verbindung zur Produktionsdatenbank. Beispiel:

Translations Ignore
DSN=nexus_prod;UID=prod_user;PWD=topsecret

Nexus.RIS.DSN.TestName der ODBC Datenquelle, für Test-Calls.
Nexus.RIS.DSN.Test.Connect

ODBC Connection-String für die Verbindung zur Testdatenbank. Beispiel:

Translations Ignore
DSN=nexus_prod;UID=prod_user;PWD=topsecret

Parameter

ParameterBedeutung
Mandanten IDDie ID des Mandanten, der beim Aufruf auf EXEC pkg_rtma.set_mandant(x) für den Parameter x (Mandanten ID) genutzt wird. Dieser Aufruf erfolgt transparent im Objekt selbst.
VariablenpräfixEin Präfix, der allen Variablen aus der Query-Rückgabe vorangesetzt wird. Beispielsweise, gibt die Query ein Feld "ISVIP" zurück, und als Präfix wird "nexus" verwendet, so deklariert das Objekt eine Variable mit Namen nexus.ISVIP
Abfrage

Die auszuführende Abfrage. Beispielsweise:

Translations Ignore
SELECT COUNT(*) AS RecordCount, MIN(pers.pers_kz_vip) AS isVIP 
FROM person pers, pat_kontakt kont 
WHERE pers.piz = kont.kont_piz AND kont_nummer = '$caller';

Variablen

Sämtliche Felder, die aus der Query zurückgegeben werden, werden in Variablen gespeichert. Es wird immer nur der erste Datensatz gespeichert, falls Mehrfachtreffer zurückgegeben werden.

Aus den Beispiel oben, werden folgende Variablen deklariert:

  • nexus.RECORDCOUNT
  • nexus.ISVIP

Hinweis: Oracle gibt über ODBC die Feldnamen immer in Großbuchstaben zurück. Die Variablen werden dementsprechend mit Großbuchstaben angelegt, unabhängig der Schreibweise im Query selbst.

Objektausgänge

AusgangNutzen wenn
Gefunden1 oder mehrere Datensätze vom Query zurückgegeben.
Nicht gefunden0 Datensätze vom Query zurückgegeben.
FehlerEin Fehler erfolgte in der Abfrage oder die Verbindung zu der Datenbank.


Sv translation
languagefr

Requête de routage

La requête de routage est implémentée via un objet IVR ayant les propriétés suivantes.


Fonction

La fonctionnalité de l'objet est la suivante :

  • Le système utilise les paramètres de l'application de routage pour déterminer s'il s'agit d'un appel test.
    • Pour les appels tests, la source de données test est utilisée pour la requête. Pour les appels de production, la source de données de production est utilisée.
      Note: Un appel test dans l'IVR est lancé avec le réglage "Numéro d'appel test" dans les données de base de l'application de routage.
  • La mise en œuvre de l'objet appelle alors la fonction EXEC pkg_rtma.set_mandant(x) pour déterminer le client avec le numéro d'identification du locataire défini dans l'objet.
  • Enfin, la requête spécifiée est exécutée. La requête peut contenir n'importe quelle variable, par exemple $caller.

Conditions

Installé et configuré Oracle Instant Client sur le serveur jtel, pour la production (minimum) et la base de données de test (optionnel) Voir aussi Oracle ODBC Driver.

Paramètres du Système

Les paramètres suivants du système influencent le fonctionnement de l'objet :

ParamètreSignification
Nexus.RIS.DSN.ProductionNom de la source de données ODBC, pour les appels de production.
Nexus.RIS.DSN.Production.Connect

Chaîne de connexion ODBC pour la connexion à la base de données de production. Exemple :

Translations Ignore
DSN=nexus_prod;UID=prod_user;PWD=topsecret

Nexus.RIS.DSN.TestNom de la source de données ODBC, pour les appels d'essai.
Nexus.RIS.DSN.Test.Connect

Chaîne de connexion ODBC pour la connexion à la base de données de test. Exemple :

Translations Ignore
DSN=nexus_prod;UID=prod_user;PWD=topsecret

Paramètres

ParamètreSignification
ID du locataireL'ID du client qui est utilisé pour le paramètre x (ID du client) pour l'appel à EXEC pkg_rtma.set_mandant(x). Cet appel est effectué de manière transparente dans l'objet lui-même.
Préfixe variableUn préfixe qui précède toutes les variables du retour de la requête. Par exemple, si la requête renvoie un champ "ISVIP" et que "nexus" est utilisé comme préfixe, l'objet déclare une variable nommée nexus.ISVIP
Requête

La requête à exécuter. Par exemple:

Translations Ignore
SELECT COUNT(*) AS RecordCount, MIN(pers.pers_kz_vip) AS isVIP 
FROM person pers, pat_kontakt kont 
WHERE pers.piz = kont.kont_piz AND kont_nummer = '$caller';

Variables

Tous les champs renvoyés par la requête sont stockés dans des variables. Seul le premier enregistrement est sauvegardé si plusieurs résultats sont renvoyés.

Dans l'exemple ci-dessus, les variables suivantes sont déclarées :

  • nexus.RECORDCOUNT
  • nexus.ISVIP

Note : Oracle renvoie toujours les noms de champs en majuscules via ODBC. Les variables sont donc créées avec des majuscules, quelle que soit la façon dont elles sont écrites dans la requête elle-même.

Résultats de l'objet

RésultatUtilisé lorsque ...
Trouvé1 ou plusieurs ensembles de données renvoyés par la requête
Non trouvé0 ensemble de données retournées par la requête.
ErreurUne erreur s'est produite dans la requête ou la connexion à la base de données.