Page History

Sv translation

language	en

Cisco JTAPI is a Java-based telephony application programming interface that serves as a basic call control API.

Provides application portability and independence from any particular telephony gear or any particular Operating System.

Anchor

	Cisco Connector Portal Configuration
	Cisco Connector Portal Configuration

Portal Configuration

The new presence connector is created as a sysadmin in the Jtel Web Portal.

Give the connector a name, and select CiscoCUCM Jtapi (Version) as the connector type.

The Configuration of the connector uses XML. In the following example, XML is used in the table below, to explain the settings.

Translations Ignore

Code Block

language	xml
title	Cisco CUCM Jtapi Presence Connector XML Settings

<?xml version="1.0" encoding="UTF-8"?>
<config>
	<implementation>
		<jar>
			<base>jtel-system-presence-connectors-cisco</base>
			<version>1.0</version>
		</jar>
		<class>de.jtel.system.presence.connectors.cisco.v10.CiscoJTAPIImplementation</class>
	</implementation>
	<parameters>
		<providerName>IP_ADDRESS</providerName>
		<user>JTAPI_USER</user>
		<password><![CDATA[JTAPI_USER_PASSWORD]]></password>
	</parameters>
	<addressTranslators>
		<translator>
			<match>^1(..)$</match>
			<replace>498946149501$1</replace>
		</translator>
		<translator>
			<match>^2(..)$</match>
			<replace>498946149502$1</replace>
		</translator>
	</addressTranslators>
	<addressExcluders>
		<excluder>
			<match>^9(..)$</match>
		</excluder>
	</addressExcluders>
	<behavior>
		<syncAcdUsers>0</syncAcdUsers>
		<syncPbxUsers>1</syncPbxUsers>
	</behavior>
</config>

Settings

Setting

Value

Comments

implementation jar base

jtel-system-presence-connectors-cisco.v10

OR

jtel-system-presence-connectors-cisco.v12
OR
 Status
colour Blue
title From Release 3.34
 jtel-system-presence-connectors-cisco.v15

Currently, Cisco v10 or v12 is supported. Configure the appropriate Cisco version.

Status

colour	Blue
title	From Release 3.34

Cisco v15 is also supported with the exact version 15.0.1.12900-4.

implementation jar version

1.0

This version pertains to the jtel version of the connector implementation. Currently, version 1.0 is required (for all Cisco versions).

parameters providerName

IP_ADDRESS

Use the IP Address or DNS Name of the CUCM Server.

parameters user

JTAPI_USER

Use the name of the configured user with JTAPI access in the CUCM Server.

parameters password

JTAPI_USER_PASSWORD

Use the password of the configured user with JTAPI access in the CUCM Server.

Note: if special characters (not allowed in XML) are included in the password, these must be escaped inside a CDATA section as shown in the example configuration above.

addressTranslators

XML Translator Definition

If the numbers reported by the CUCM server via JTAPI are not fully qualified E.164, they can be translated.

This assumes the portal has been configured fully to E.164, and may not be necessary for all installations.

The address translator mechanism provides a way to normalize the numbers before they are used to update the presence information in the jtel System.

A translator consists of two parts:

Match

A regular expression, which matches the number as reported by the CUCM.

For example, the following regex:

^1(..)$

Matches all 3 digit telephone numbers beginning with a 1. A grouping is used to isolate the last two digits of the number into group 1, referred to in the replacement as $1

Replace

The replacement to be made.

For example:

498946149501$1

This would cause the two-digit matched group from the regex to be appended to the string 498946149501.

Example

Input: 123

Output: 49894614950123

Recommendations

A number of translators can be used. They are all applied in sequence, so a little thought might be required to get the desired effect. It is recommended always to work with groupings and a specific length. Also, to prevent erroneous matches, the ^ (begin of string) and $ (end of the string) regex operators should be used.

addressExcluders

XML Excluder Definition

Excluders are used to match number patterns which shall not be monitored.

For example, if trunks are passed to the jtel system, it does not make sense to monitor these entities.

An excluder consists of one part:

Match

A regular expression, which matches the number as reported by the CUCM.

For example, the following regex:

^9(..)$

Matches all 3 digit telephone numbers beginning with a 9, and will not setup monitor points to these numbers.

behavior syncAcdUsers

0

Causes all reported extensions to be created as an ACD user. Setting this to 1 is not recommended.

Note: even if this is set to 0, the ACD user's presence status will still be set according to the current Tel1 field in the user record, and TelActive (the active telephone number).

behavior syncPbxUsers

1

Causes all reported extensions to be created as PBX Users. Setting this to 1 is recommended.

Configuration du portail

Le nouveau connecteur de présence est créé en tant qu'administrateur système dans le portail Web de Jtel.

Donnez un nom au connecteur, et sélectionnez CiscoCUCM Jtapi (Version) comme type de connecteur.

La configuration du connecteur utilise le XML. Dans l'exemple suivant, XML est utilisé dans le tableau ci-dessous, pour expliquer les paramètres.

Sv translation

language	de

Cisco JTAPI ist eine Java-basierte Programmierschnittstelle für Telefonieanwendungen, die als grundlegende Anrufsteuerungs-API dient.

JTAPI Bietet Anwendungsportabilität und Unabhängigkeit von einem bestimmten Telefoniegerät oder einem bestimmten Betriebssystem.

Portal Konfiguration

Der neue Präsenzkonnektor wird als Systemadministrator im Jtel-Webportal angelegt.

Geben Sie dem Konnektor einen Namen und wählen Sie CiscoCUCM Jtapi (Version) als Konnektortyp.

Die Konfiguration des Konnektors verwendet XML. Im folgenden Beispiel wird XML in der Tabelle unten verwendet, um die Einstellungen zu erläutern.

Code Block

language	xml
title	Cisco CUCM Jtapi Presence Connector XML-Einstellungen

<?xml version="1.0" encoding="UTF-8"?>
<config>
    <implementation>
        <jar>
            <base>jtel-system-presence-connectors-cisco</base>
            <version>1.0</version>
        </jar>
        <class>de.jtel.system.presence.connectors.cisco.v10.CiscoJTAPIImplementation</class>
    </implementation>
    <parameters>
        <providerName>IP_ADDRESS</providerName>
        <user>JTAPI_USER</user>
        <password><![CDATA[JTAPI_USER_PASSWORD]]></password>
    </parameters>
    <addressTranslators>
        <translator>
            <match>^1(..)$</match>
            <replace>498946149501$1</replace>
        </translator>
        <translator>
            <match>^2(..)$</match>
            <replace>498946149502$1</replace>
        </translator>
    </addressTranslators>
    <addressExcluders>
        <excluder>
            <match>^9(..)$</match>
        </excluder>
    </addressExcluders>
    <behavior>
        <syncAcdUsers>0</syncAcdUsers>
        <syncPbxUsers>1</syncPbxUsers>
    </behavior>
</config>

Einstellungen

Einstellung	Wert	Kommentare
Implementation jar base	jtel-system-presence-connectors-cisco.v10 ODER jtel-system-presence-connectors-cisco.v12	Derzeit wird Cisco v10 oder v12 unterstützt. Konfigurieren Sie die entsprechende Cisco-Version.
Implementation jar version	1.0	Diese Version bezieht sich auf die Jtel-Version der Konnektor-Implementierung. Derzeit ist Version 1.0 erforderlich (für alle Cisco-Versionen).
Parameter providerName	IP_ADDRESS	Verwenden Sie die IP-Adresse oder den DNS-Namen des CUCM-Servers.
Paremeter user	JTAPI_USER	Verwenden Sie den Namen des konfigurierten Benutzers mit JTAPI-Zugriff im CUCM-Server.
Parameter password	JTAPI_USER_PASSWORD	Verwenden Sie das Kennwort des konfigurierten Benutzers mit JTAPI-Zugriff im CUCM-Server. Hinweis: Wenn Sonderzeichen (in XML nicht erlaubt) im Passwort enthalten sind, müssen diese innerhalb eines CDATA-Abschnitts maskiert werden, wie in der obigen Beispielkonfiguration gezeigt.
addressTranslators	XML Translator Definition	Wenn die vom CUCM-Server über JTAPI gemeldeten Zahlen nicht vollständig E.164-qualifiziert sind, können sie übersetzt werden. Dies setzt voraus, dass das Portal vollständig auf E.164 konfiguriert wurde, und ist möglicherweise nicht für alle Installationen erforderlich. Der Adressübersetzungsmechanismus bietet eine Möglichkeit, die Nummern zu normalisieren, bevor sie zur Aktualisierung der Präsenzinformationen im JTAPI-System verwendet werden. Ein Adressübersetzer besteht aus zwei Teilen: Vergleich Ein regulärer Ausdruck, der mit der vom CUCM gemeldeten Zahl übereinstimmt. Zum Beispiel der folgende reguläre Ausdruck: ^1(..)$ Stimmt mit allen dreistelligen Telefonnummern überein, die mit einer 1 beginnen. Eine Gruppierung wird verwendet, um die letzten beiden Ziffern der Nummer in Gruppe 1 zu isolieren, die in der Ersetzung als $1 bezeichnet wird Ersetze Die Ersetzung muss vorgenommen werden. Zum Beispiel: 498946149501$1 Dies würde dazu führen, dass die zweistellige übereinstimmende Gruppe aus dem Regex an die Zeichenfolge 498946149501 angehängt wird. Beispiel Eingabe: 123 Ausgabe: 49894614950123 Empfehlungen Es kann eine Reihe von Übersetzern eingesetzt werden. Sie werden alle nacheinander eingesetzt, so dass ein wenig Nachdenken erforderlich sein könnte, um den gewünschten Effekt zu erzielen. Es wird empfohlen, immer mit Gruppierungen und einer bestimmten Länge zu arbeiten. Um fehlerhafte Übereinstimmungen zu vermeiden, sollten auch die RegEx-Operatoren ^ (Anfang der Zeichenkette) und $ (Ende der Zeichenkette) verwendet werden.
addressExcluders	XML Excluder Definition	Excluder werden verwendet, um Zahlenmuster abzugleichen, die nicht überwacht werden sollen. Wenn z.B. Trunks an das Jtel-System übergeben werden, ist es nicht sinnvoll, diese Entitäten zu überwachen. Ein Excluder besteht aus einem Teil: Vergleich Ein regulärer Ausdruck, der mit der vom CUCM gemeldeten Zahl übereinstimmt. Zum Beispiel der folgende reguläre Ausdruck: ^9(..)$ Stimmt mit allen 3-stelligen Telefonnummern überein, die mit einer 9 beginnen, und richtet keine Monitorpunkte auf diese Nummern ein.
Verhalten syncAcdUsers	0	Bewirkt, dass alle gemeldeten Erweiterungen als ACD-Benutzer erstellt werden. Es wird nicht empfohlen, diesen Wert auf 1 zu setzen. Hinweis: Selbst wenn dieser Wert auf 0 gesetzt wird, wird der Anwesenheitsstatus des ACD-Benutzers dennoch entsprechend dem aktuellen Tel1-Feld im Benutzerdatensatz und TelActive (der aktiven Telefonnummer) gesetzt.
Verhalten syncPbxUsers	1	Bewirkt, dass alle gemeldeten Nebenstellen als PBX-Benutzer erstellt werden. Es wird empfohlen, diesen Wert auf 1 zu setzen.

Sv translation

language	fr

Cisco JTAPI est une interface de programmation d'applications de téléphonie basée sur Java qui sert d'API de base pour le contrôle des appels.

Fournit la portabilité des applications et l'indépendance par rapport à un équipement téléphonique particulier ou à un système d'exploitation particulier.

Anchor

Cisco Connector Portal Configuration

Translations Ignore

Code Block

language	xml
title	Cisco CUCM Jtapi Presence Connector Paramètres XML

<?xml version="1.0" encoding="UTF-8"?> <config> <implementation> <jar> <base>jtel-system-presence-connectors-cisco</base> <version>1.0</version> </jar> <class>de.jtel.system.presence.connectors.cisco.v10.CiscoJTAPIImplementation</class> </implementation> <parameters> <providerName>IP_ADDRESS</providerName> <user>JTAPI_USER</user> <password><![CDATA[JTAPI_USER_PASSWORD]]></password> </parameters> <addressTranslators> <translator> <match>^1(..)$</match> <replace>498946149501$1</replace> </translator> <translator> <match>^2(..)$</match> <replace>498946149502$1</replace> </translator> </addressTranslators> <addressExcluders> <excluder> <match>^9(..)$</match> </excluder> </addressExcluders> <behavior> <syncAcdUsers>0</syncAcdUsers> <syncPbxUsers>1</syncPbxUsers> </behavior> </config>

Paramètres

Actuellement, Cisco v10 ou v12 est pris en charge. Configurez la version Cisco appropriée.

Si les chiffres communiqués par le serveur CUCM via JTAPI ne sont pas entièrement qualifiés E.164, ils peuvent être traduits.

Cela suppose que le portail a été entièrement configuré au format E.164, et peut ne pas être nécessaire pour toutes les installations.

Le mécanisme de traduction d'adresses permet de normaliser les numéros avant qu'ils ne soient utilisés pour mettre à jour les informations de présence dans le système jtel.

Un traducteur se compose de deux parties:

Correspondance

Une expression régulière, qui correspond au nombre indiqué par le CUCM.

Par exemple, la regex suivante:

^1(..)$

Correspond à tous les numéros de téléphone à 3 chiffres commençant par un 1. Un regroupement est utilisé pour isoler les deux derniers chiffres du numéro dans le groupe 1, appelé dans le remplacement "$1

Remplacer

Le remplacement à effectuer.

Par exemple:

498946149501$1

Ainsi, le groupe à deux chiffres de la regex serait ajouté à la chaîne 498946149501.

Exemple

Entrée: 123

Résultat: 49894614950123

Recommendations

Un certain nombre de traducteurs peuvent être utilisés. Ils sont tous appliqués dans l'ordre, de sorte qu'un peu de réflexion peut être nécessaire pour obtenir l'effet souhaité. Il est recommandé de toujours travailler avec des groupes et une longueur spécifique. De plus, pour éviter les correspondances erronées, les opérateurs de regex ^ (début de la chaîne) et $ (fin de la chaîne) doivent être utilisés.

Les exclusions sont utilisées pour faire correspondre des modèles de numéros qui ne doivent pas être contrôlés.

Par exemple, si des troncs sont passés au système jtel, il n'est pas logique de surveiller ces entités.

Une exclusion se compose d'une partie:

Correspondance

Une expression régulière, qui correspond au nombre indiqué par le CUCM.

Par exemple, la regex suivante:

^9(..)$

Correspond à tous les numéros de téléphone à 3 chiffres commençant par un 9, et ne mettra pas de points de surveillance sur ces numéros.

Permet de créer toutes les extensions signalées en tant qu'utilisateurs de PBX. Il est recommandé de régler ce paramètre sur 1

Paramètre	Valeur	Commentaires
implementation jar base	jtel-system-presence-connectors-cisco.v10 OU jtel-system-presence-connectors-cisco.v12
implementation jar version	1,0	Cette version se rapporte à la version jtel de l'implémentation du connecteur. Actuellement, la version 1,0 est requise (pour toutes les versions de Cisco).
paramètres providerName	IP_ADDRESS	Utilisez l'adresse IP ou le nom DNS du serveur CUCM.
paramètres utilisateur	JTAPI_USER	Utilisez le nom de l'utilisateur configuré avec un accès JTAPI dans le serveur CUCM.
paramètres mot de passe	JTAPI_USER_PASSWORD	Utilisez le nom de l'utilisateur configuré avec un accès JTAPI dans le serveur CUCM. Remarque : si des caractères spéciaux (non autorisés en XML) sont inclus dans le mot de passe, ils doivent être échappés dans une section CDATA comme indiqué dans l'exemple de configuration ci-dessus.
addressTranslators	Définition du traducteur XML	addressExcluders	Définition de l'exclusion XML
comportement syncAcdUsers	0	Permet de créer toutes les extensions signalées en tant qu'utilisateur de l'ACD. Il n'est pas recommandé de régler ce paramètre sur 1. Remarque : même si ce paramètre est réglé sur 0, le statut de présence de l'utilisateur ACD sera toujours défini en fonction du champ Tel1 actuel dans l'enregistrement de l'utilisateur, et TelActive (le numéro de téléphone actif).
comportement syncAcdUsers	1	.

Page tree

Versions Compared

Old Version 17

New Version Current

Key

Portal Configuration

Settings

Configuration du portail

Portal Konfiguration

Einstellungen

Paramètres