Benutzerhandbuch Customer Interaction Express 3.3 CGI-Server
Version 1.0 22-07-2015 COMPAS ID: -
© 2015 Avaya Inc. Alle Rechte vorbehalten. Hinweis Obwohl angemessene Bemühungen unternommen wurden, um sicherzustellen, dass die Informationen in diesem Dokument zum Zeitpunkt der Drucklegung vollständig und akkurat waren, übernimmt Avaya Inc. keine Haftung für eventuelle Fehler. In zukünftigen Versionen können an den in diesem Dokument enthaltenen Informationen Änderungen und Korrekturen angebracht werden. Ausführliche Support-Informationen finden Sie in dem vollständigen Dokument Avaya Support-Hinweise für Softwaredokumentation mit der Dokumentnummer 03-600758.
Haftungsausschluss für die Dokumentation Avaya Inc. übernimmt keine Haftung für Änderungen, Zusätze oder Löschungen an der ursprünglich veröffentlichten Version dieser Dokumentation, außer wenn diese von Avaya durchgeführt wurden. Der Kunde und/oder der Endbenutzer willigen ein, Avaya sowie die Vertreter, Bediensteten und Angestellten von Avaya gegenüber allen Klagen, Gerichtsverfahren, Forderungen und Urteilen, die aus Änderungen, Zusätzen oder Löschungen an dieser Dokumentation oder im Zusammenhang damit entstehen, in dem vom Kunden oder Endbenutzer vorgenommenen Umfang der Änderungen, Zusätze oder Löschungen zu entschädigen und schadenfrei zu halten. Haftungsausschluss für Links Avaya Inc. übernimmt keine Verantwortung für den Inhalt oder die Zuverlässigkeit von durch Links verknüpften Websites und billigt nicht unbedingt die darin beschrieben oder angebotenen Produkte, Dienste oder Informationen. Es wird keine Garantie übernommen dafür, dass diese Links in jedem Fall funktionieren und dass die verknüpften Seiten immer verfügbar sind. Garantie Avaya Inc. übernimmt für dieses Produkt eine beschränkte Garantie. Die Bedingungen dieser beschränkten Garantie können Sie Ihrem Verkaufsvertrag entnehmen. In der folgenden Website finden Sie Informationen zur Standardgarantie von Avaya sowie zum Support für dieses Produkt, während es der Garantie unterliegt: http://www.avaya.com/support Copyright Sofern nicht explizit anders angegeben, ist das Produkt durch Urheber- und andere Eigentumsrechte geschützt. Die unberechtigte Vervielfältigung, Übertragung oder Verwendung kann entsprechend dem anwendbaren Gesetz strafrechtlich als auch zivil verfolgt werden. Avaya-Support Avaya stellt eine Hotline zur Verfügung, unter der Sie Probleme berichten oder Fragen zu Ihrem Produkt stellen können. Für Kunden und Business Partner in Deutschland lautet die Support-Telefonnummer +49 180 274 18 52. Weitere Support-Telefonnummern finden Sie auf der Avaya-Website: http://www.avaya.com/support
Inhaltsverzeichnis Wissenswertes über diese Anleitung . . . . . . . . . . . . . . . . . . . . . . . . Fragen zur Anleitung . . . . . . . . . . . . . . . . . . An wen richtet sich die Anleitung? . . . . . . . . . Welche Informationen enthält die Anleitung? . . . . Welche Informationen enthält die Anleitung nicht? Welche Schreibweisen werden verwendet? . . . . Welche Ausgabe der Anleitung liegt hier vor? . . . Was hat sich geändert? . . . . . . . . . . . . . . . Wo finden Sie weitere Informationen? . . . . . . . Wie erhalten Sie ein gedrucktes Exemplar? . . . . . . Voraussetzungen . . . . . . . . . . . . . . . . . . Drucken der Anleitung . . . . . . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
5 . . . . . . . . . . .
CGI-Server, was ist das? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Funktionen . . . . . Systemarchitektur . . Arbeitsweise . . Abbildung . . . . Komponenten . . . . Web-Server . . . CGI-Skript cgicc. Prozess cgi_srv . HTML-Forms . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
9 . . . . . . . . .
Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Konfiguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
9 9 9 10 11 11 11 12 12
13
Installieren. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Startparameter des Prozesses cgi_srv . . . . . . . . . . . . . . . . . . . . . . . . . . . . Watchdog-Konfiguration ergänzen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Voraussetzung . . . . . . . . . . . . . . . . . . . . . . . . . Konfiguration von IIS (Windows 2003 Server) als Web Server . Schritt 1: Vorbereiten . . . . . . . . . . . . . . . . . . . . Schritt 2: Prüfen. . . . . . . . . . . . . . . . . . . . . . . Schritt 3: Einstellen . . . . . . . . . . . . . . . . . . . . . Schritt 4: Testen . . . . . . . . . . . . . . . . . . . . . . Konfiguration von Apache 2.0 als Web Server . . . . . . . . . Schritt 1: Vorbereiten . . . . . . . . . . . . . . . . . . . . Schritt 2: Web-Seiten kopieren . . . . . . . . . . . . . . . Schritt 3: Testen . . . . . . . . . . . . . . . . . . . . . . Funktionsaufrufe . . . . . . . . . . . . . . . . . . . . . . . . Funktion form . . . . . . . . . . . . . . . . . . . . . . . . Funktion request/cj . . . . . . . . . . . . . . . . . . . . . Funktion request/cjcancel. . . . . . . . . . . . . . . . . . Verwendete CGI-Feldnamen . . . . . . . . . . . . . . . . . .
5 5 5 5 5 6 6 7 8 8 8
13 14 14
15 . . . . . . . . . . . . . . .
15 16 16 18 19 21 22 22 23 24 25 25 27 28 29
Glossar
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31
Index
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33
Version 1.0 22-07-2015
3
Inhalt
4 Benutzerhandbuch CIE 3.3 CGI-Server
Wissenswertes über diese Anleitung
Wissenswertes über diese Anleitung Fragen zur Anleitung Bevor sie die Anleitung lesen haben Sie vielleicht einige Fragen dazu. Hier beantworten wir Ihnen einige Fragen zur Anleitung.
An wen richtet sich die Anleitung? Diese Anleitung richtet sich an Personen, die den CGI-Server installieren und konfigurieren möchten. Es spielt dabei keine Rolle, ob Sie die Anleitung als Druckmedium oder Online nutzen. Dieses Dokument ist auch als Dokumentation für den HTML-Programmierer gedacht. Nutzen Sie die Anleitung, wie Sie möchten, ob als Nachschlagwerk oder um sich umfassend über die Möglichkeiten des CGI-Servers zu informieren.
Welche Informationen enthält die Anleitung? Diese Anleitung enthält Informationen, um den CGI-Server installieren und konfigurieren zu können. Die Beispiele können mit geringen Änderungen zum Testen der Funktionen benutzt werden. Weitere Beispiele findet man in der Datei cgi_srv.zip auf dem CIE-Server.
Welche Informationen enthält die Anleitung nicht? Diese Anleitung enthält keine Informationen zu anderen CIE-Anwendungen oder zum CIE-Server.
Welche Schreibweisen werden verwendet? In der folgenden Dokumentation werden die folgenden Schreibweisen und Markierungen verwendet. • Befehle, Menüs, Schaltflächen, Feldbezeichnungen sind fett gekennzeichnet. • In eckigen Klammern "[ ]" sind englische Begriffe angegeben. • In den Klammern "{ }" sind deutsche Begriffe angegeben.
Version 1.0 22-07-2015
5
Welche Ausgabe der Anleitung liegt hier vor? Die folgende Tabelle zeigt Informationen zur vorliegenden Ausgabe der Anleitung. Erstellt am:
22. Juli 2015
Basis
CIE-System Version 3.3
Bearbeiter
Brunhilde Krüger, Andreas Marquardt
Verfügbar als
Acrobat-Reader-Datei
Was hat sich geändert? Die folgende Tabelle zeigt die Historie dieses Dokuments. Version
Datum
Änderungen
1.0
22.07.2015
CIE 3.3
6 Benutzerhandbuch CIE 3.3 CGI-Server
Wissenswertes über diese Anleitung
Wo finden Sie weitere Informationen? Diese Anleitung beschreibt Kenntnisse und Voraussetzungen und zeigt Anleitungen, die Sie benötigen, um ein CIE-System installieren und konfigurieren zu können. Informationen zur Bedienung von Anwendungen des CIE-Systems finden Sie in den folgenden Anleitungen. Auch diese Anleitungen können Sie als Druckmedium (Acrobat Reader) oder Online nutzen. • Benutzerhandbuch Customer Interaction Express Konfiguration • Benutzerhandbuch Customer Interaction Express TaskFlow-Editor • Benutzerhandbuch Customer Interaction Express User Interface • Benutzerhandbuch Customer Interaction Express WallBoard • Benutzerhandbuch Customer Interaction Express Dialer • Benutzerhandbuch Customer Interaction Express IVR-Editor • Benutzerhandbuch Customer Interaction Express Adressbuch-Administrator • Benutzerhandbuch Customer Interaction Express Textbaustein-Administrator • Benutzerhandbuch Customer Interaction Express UMR Archivierung • Benutzerhandbuch TTrace • Installation und Konfiguration TTrace • Benutzerhandbuch Watchdog
Version 1.0 22-07-2015
7
Wie erhalten Sie ein gedrucktes Exemplar? Sie würden lieber die Anleitung auf Papier lesen, als diese am Personalcomputer anzusehen - kein Problem. Sie können diese Anleitung drucken. Dafür wurde diese Anleitung speziell aufbereitet. Sie erhalten dadurch eine gedruckte Anleitung, wie Sie es gewohnt sind. Die Anleitung wird im A4-Format gedruckt. Die gedruckte Anleitung benötigt etwa 34 Seiten.
Voraussetzungen Um die Anleitung drucken zu können, müssen die folgenden Voraussetzungen erfüllt sein. • Sie benötigen die DVD CIE. • Ein Acrobat Reader Version 5 oder höher muss auf Ihrem Personalcomputer installiert sein. Die entsprechende Software befindet sich auch auf der DVD CIE. • Ein grafikfähiger Drucker muss an Ihrem Personalcomputer eingerichtet sein.
Drucken der Anleitung Sie möchten die Anleitung ausdrucken. 1. Wechseln Sie im Dateimanager in den Ordner doc auf der DVD. 2. Doppelklicken Sie auf die Datei cie_32_cgi_server_de.pdf. Die Anwendung Acrobat Reader öffnet und zeigt die Anleitung. 3. Wählen Sie Drucken im Menü Datei der Anwendung Acrobat Reader. Die Datei wird gedruckt.
8 Benutzerhandbuch CIE 3.3 CGI-Server
CGI-Server, was ist das?
CGI-Server, was ist das? Ein CGI-Server ermöglicht es, dass ein WWW-Client Funktionen eines CIE Systems nutzt.
Funktionen Der CGI-Server ermöglicht Web-Clients Call-Center Funktionen über die CGI-Schnittstelle zu nutzen. CGI steht für Common Gateway Interface. Folgende Funktionen können ausgeführt werden. • Einleiten von Rückruf via Outbound-Dialer. Hierzu werden Einträge in den Datenbanktabellen ODCJ, ODCJTag und ODDailyPeriod und ODLifeTime vorgenommen. • Alle über die CGI-Schnittstelle gesendeten Felder werden als CallTags mit vorangestelltem CGI_ in der Tabelle ODCJTag abgelegt. Angegebene Perioden werden in ODDailyPeriod abgelegt. • Anfordern von HTML-Seiten, die vor dem Senden an den Client noch einem Ersetzungsalgorithmus unterworfen werden, um in die Seiten aktuelle Informationen über das Call-Center einfügen zu können.
Systemarchitektur Arbeitsweise Ein WWW-Client fordert den Web-Server auf, ein bestimmtes CGI-Skript auszuführen. Der WWW-Client erhält entsprechende HTML-Seiten. Ein CGI-Skript ist ein ausführbares Programm. Das CGI-Skript wird vom Web-Server ausgeführt. Dabei werden vom WWW-Client übertragene Informationen (z.B. Rufnummer) als Variable übergeben (standardisierte CGI-Schnittstelle). Der CGI-Server leitet Informationen an das CIE System weiter. Außerdem erhält der CGI-Server vom CIE System bestimmte Informationen. Um den CGI-Server nicht auf jeder Rechnerarchitektur zur Verfügung zu stellen, wird folgender Weg gewählt: Ein Prozess cgi_srv arbeitet auf dem CIE-Server. Im Web-Server ist ein CGI-Skript installiert, das die übergebenen Variablen über eine Socket-Verbindung an den Prozess cgi_srv überträgt. Eine Antwort des Prozesses cgi_srv wird an den Web-Server übergeben.
Version 1.0 22-07-2015
9
Abbildung Die folgende Abbildung zeigt schematisch die Systemarchitektur.
WWW-Server Web-Client (Browser)
CGISkript
HTTP-Server Apache oder IIS
CGI-Schnittstelle
cgicc
HTTP-Protokoll Internet
Kunden-Netzwerk SocketVerbindung
CIE-Server
DB
db_srv
Dateien
HTML-Forms Eintrag von CallJobs Auslesen von Informationen
10 Benutzerhandbuch CIE 3.3 CGI-Server
cgi_srv
CGI-Server, was ist das?
Komponenten Um einen CGI-Server zu nutzen, benötigt man folgende zusätzliche Komponenten im CIE System. • Web-Server • CGI-Skript cgicc • Prozess cgi_srv • HTML-Forms
Web-Server Als Web-Server können Sie jeden Web-Server einsetzen, der CGI-Skripte abarbeiten kann. Der CGI-Server wurde mit folgenden Web-Servern getestet. • Apache 2.0 (2.2.4) • Microsoft Internet Information Server (IIS) (Version 6.0 und 5.1) Für diese beiden Web-Server gibt es Beispiel-HTML-Seiten. Auf der DVD von CIE 2.0 finden Sie diese im Ordner Examples\CGI Examples.
CGI-Skript cgicc Das CGI-Skript cgicc dient als Schnittstelle zwischen Web-Server und dem Prozess cgi_srv. Funktionen Bei einem Aufruf führt das CGI-Skript cgicc die folgenden Funktionen durch. • Aufbauen einer Socket-Verbindung zum Prozess cgi_srv • Interpretieren der Variablen • Einpacken der Variablen in einen Puffer • Übertragen des Puffers über die Socket-Verbindung an den Prozess cgi_srv • Lesen der Antwort von der Socket-Verbindung • Schließen der Socket-Verbindung • Übergeben der Antwort an den Web-Server Das Programm steht vorübersetzt für Microsoft Windows 2003 zur Verfügung. Das CGI-Skript cgicc kann als Quellcode zur Verfügung gestellt werden. Um das CGI-Skript einfach zu portieren, ist das CGI-Skript cgicc in C geschrieben. Das CGI-Skript cgicc verwendet nur Standard-Unix-Funktionen. Außerdem erfordert das CGI-Skript keine weiteren Bibliotheken oder Layered Products.
Version 1.0 22-07-2015
11
Konfiguration von cgicc Das CGI-Skript cgicc muss wissen, auf welchem Host/Port der Call-Center CGI-Server Verbindungen annimmt. Diese Information wird im cgi-bin Verzeichnis des Web-Servers in einer Datei abgelegt. Dateiname UNIX: .cgicc Dateiname Windows: cgicc.txt Die Datei beinhaltet eine Zeile mit Beispiel: myhost 5567
Prozess cgi_srv Der Prozess cgi_srv initialisiert sich und bearbeitet dann eintreffende Anfragen des CGI-Skripts cgicc. CGI-Skripte können auf verschiedenen HTTP-Servern arbeiten und ein Call-Center ansprechen. Initialisierung Die Initialisierungsphase des CGI-Servers umfasst folgende Schritte. • Aufbau einer Corba-Verbindung zur Call-Center Datenbank und Öffnen einer Datenbank-Session. • Anlegen eines Serverports, um Requests von cgicc bearbeiten zu können. Abarbeiten von Web-Requests Für jede aufgebaute Verbindung eines CGI-Skripts cgicc wird ein neuer Thread erzeugt. Dieser Thread hat folgende Funktionen. • Lesen des Pakets mit den Environment-Variablen von der Socketverbindung. • Aufbereitung des Pakets. Die CGI-Felder werden in einer Liste mit Paaren (Name, Wert) abgelegt. • Verzweigen in die geforderte Funktion entsprechend der CGI-Veriablen PATH_INFO.
HTML-Forms Mit HTML-Forms können HTML-Seiten um Informationen des CIE Systems ergänzt werden. Der WWW-Client erhält so z.B. eine Liste mit den möglichen Themen des CIE Systems.
12 Benutzerhandbuch CIE 3.3 CGI-Server
Installation
Installation Der cgi_srv muss auf dem CIE-Server installiert werden.
Installieren Die Installation des CGI-Servers ist im Setup Contact Center Additional enthalten. Um den CGI-Server zu installieren, gehen Sie wie folgt vor. 1. Die Leitfadeninstallation con CIE ist gestartet. 2. Klicken Sie auf Install. Der Dialog Contact Center Additional erscheint. 3. Klicken Sie auf Next. Der Dialog Choose Setup Type erscheint. 4. Klicken Sie auf Custom. Der Dialog Custom Setup erscheint. 5. Markieren Sie CGI Server.
6. Klicken Sie auf Next. Der Dialog Ready to Install erscheint. 7. Klicken Sie auf Install. Der Dialog Installing Contact Center Additional erscheint. Die Installation dauert etwa eine Minute. Die entsprechenden Dateien werden in den Ordner c:\Program Files\ Avaya\Customer Interaction Express\ContactCenterAdditional kopiert. 8. Um die Installation abzuschließen, klicken Sie auf Finish. Prüfen der Installation Die folgenden Komponente finden Sie unter Start - Programs - Avaya CIE - Contact Center Additional. CGIServer
Version 1.0 22-07-2015
13
Startparameter des Prozesses cgi_srv Folgende Startparameter können Sie für den Prozess cgi_srv angeben. -nsh Rechnername OmniNames -tt Rechnername des TTrace-Hosts
Watchdog-Konfiguration ergänzen In der Watchdog-Konfiguration muss der CGI-Server als neuer Run, am besten in Runlevel Optional hinzugefügt werden.
14 Benutzerhandbuch CIE 3.3 CGI-Server
Konfiguration
Konfiguration Die Konfiguration des Web-Servers ist für IIS und Apache unterschiedlich und wird in den entsprechenden Abschnitten beschrieben.
Voraussetzung Alle Server müssen gegenseitig im Netzwerk über Namen auflösbar sein (ping cieserver, ping WebServer).
Version 1.0 22-07-2015
15
Konfiguration von IIS (Windows 2003 Server) als Web Server Gehen Sie wie folgt vor.
Schritt 1: Vorbereiten 1. Kopieren Sie die Dateien CGICC.exe und CGICC.txt ins Skript-Verzeichnis des Web-Servers. 2. Kopieren Sie die Datei CGICC.exe vom CIE-Additional-Verzeichnis in das Skript-Verzeichnis C:\Inetpub\Scripts.
3. Kopieren Sie die Datei cgicc.txt ins Skript-Verzeichnis des Web-Servers. Die Datei cgicc.txt enthält den Namen des CIE-Servers und den Port 5567.
Fortsetzung nächste Seite
16 Benutzerhandbuch CIE 3.3 CGI-Server
Konfiguration Fortsetzung von vorheriger Seite 4. Stellen Sie sicher, dass Ausführrechte für das Skripts Verzeichnis gesetzt sind.
Version 1.0 22-07-2015
17
Schritt 2: Prüfen Voraussetzung Der Prozess cgi_srv auf dem CIE-Server darf nicht arbeiten. Prüfen Um zu prüfen, ob die Skripte im Verzeichnis Scripts ausführbar sind, gehen Sie wie folgt vor. 1. Im Browser folgende URL aufrufen. Die Dateierweiterung .exe muss angegeben werden. /scripts/cgicc.exe 2. Als Rückmeldung kommt im Erfolgsfall nach Ablauf der Zeitspanne, die als Connection timout konfiguriert ist (120 sec, bei älteren Systemen nach 1 sec): Communucation problem with Call-Center:can't connect socket stulab152:5567 err=10061 Fehlerfall In Fehlerfall können folgende Meldungen erscheinen. Meldung
Ursache
Communucation problem with Call-Center:can't connect socket stulab152:5567 err=10060
Firewall (auf dem CIE-Server) blockiert die Verbindung zum cgi_srv
Communucation problem with Call-Center:can't connect socket :0 err=10049
Es fehlt die Dateierweiterung bei cgicc.exe.
HTTP/1.0 403 Access Forbidden (Read Access Denied - This Virtual Directory does not allow objects to be read.)
Die Ausführrechte für das Skript-Verzeichnis fehlen.
18 Benutzerhandbuch CIE 3.3 CGI-Server
Konfiguration
Schritt 3: Einstellen 1. Kopieren Sie die HTML-Dateien auf den Web-Server. 2. Kopieren Sie alle Dateien, die zur den Webseiten gehören (Beispiele sind in IIS_wwwroot.zip) in das Verzeichnis C:\INETPUB\wwwroot\. 3. In den Eigenschaften im Computer Management für die Web Site müssen die Ausführberechtigungen für Scripts und ausführbare Dateien konfiguriert sein.
Version 1.0 22-07-2015
19
4. Ausführbare Programme (Executables) benötigen eine entsprechende Berechtigung. Stellen Sie die Berechtigung entsprechend ein.
5. Kopieren Sie die HTML-Skript (Forms), z.B Inhalt von cgi_sample_iis.zip auf den CIE-Server in das Verzeichnis: \\cieserver\program files\avaya\customer interaction express\contact center additional 6. Kopieren Sie die HTML-Skripte um die Antworten oder Abfrageergebniss vom CIE zu übertragen (der Inhalt von cgi_sample_iis.zip) in das Verzeichnis, in dem der Prozess cgi_srv arbeitet.
20 Benutzerhandbuch CIE 3.3 CGI-Server
Konfiguration
Schritt 4: Testen 1. Beim Aufruf des Web-Servers erscheint folgende Seite.
2. Klicken Sie auf Simple CIE CallBack. Es muss folgender Dialog erscheinen.
3. Sie können einen Rückrufwunsch eingeben. Mögliche Eingaben sind Rufnummer, Name und Name des Themas im CIE. 4. Der Rückrufwunsch wird als CallJob für den CIE Dialer gespeichert. Der Rückrufwunsch ist im User Interface in der Dialer-Applikation sichtbar und weiter bearbeitbar.
Version 1.0 22-07-2015
21
Konfiguration von Apache 2.0 als Web Server Schritt 1: Vorbereiten 1. Kopieren Sie CGICC.exe und CGICC.txt in das Verzeichnis cgi-bin des Web-Servers . Die Datei cgicc.txt enthält den Namen des CIE-Servers und den Port 5567.
22 Benutzerhandbuch CIE 3.3 CGI-Server
Konfiguration
Schritt 2: Web-Seiten kopieren 1. Kopieren Sie die HTML-Seiten (z.B. der Inhalt von apache_htdocs.zip) in das Verzeichnis: C:\Program Files\Apache Software Foundation\Apache2.2\htdocs
2. Kopieren Sie die HTML-Skripte (Forms), z.B Inhalt von cgi_sample_apache.zip auf den CIE-Server in das Verzeichnis: \\cieserver\program files\avaya\customer interaction express\contact center additional 3. Kopieren Sie die HTML-Skripte um die Antworten oder Abfrageergebniss vom CIE zu übertragen, z.B. cgi_sample_apache.zip, in das Verzeichnis, in dem der Prozess cgi_srv arbeitet.
Version 1.0 22-07-2015
23
Schritt 3: Testen 1. Beim Aufruf des Web-Servers erscheint folgende Seite.
2. Klicken Sie auf Simple CIE CallBack. Es muss folgender Dialog erscheinen.
3. Sie können einen Rückrufwunsch eingeben. Mögliche Eingaben sind Rufnummer, Name und Name des Themas im CIE. 4. Der Rückrufwunsch wird als CallJob für den CIE Dialer gespeichert. Der Rückrufwunsch ist im CCUI in der Dialer-Applikation sichtbar und weiter bearbeitbar.
24 Benutzerhandbuch CIE 3.3 CGI-Server
Konfiguration
Funktionsaufrufe Funktion form Die Funktion form dient dazu, vom CGI-Server HTML-Seiten anzufordern, die vor dem Absenden um Informationen aus dem Call-Center ergänzt werden. PATH_INFO hat hierbei folgende Form: /form/filename Der CGI-Server versucht, in seinem Arbeitsverzeichnis die angegebene Datei zu öffnen, und im Erfolgsfall wird die Datei mit folgenden Ersetzungen an cgicc gesendet: • alle Strings der Form &&NAME werden ersetzt durch den Wert des gleichnamigen CGI-Feldes. Wenn ein solches CGI-Feld nicht definiert ist, dann wird ein Leerstring eingesetzt. Der Prozess cgi_srv stellt zusätzlich zu den vom Browser übertragenen Feldern die Felder TICKET (nur bei request/cj) und RESULT zur Verfügung. TICKET enthält die Callcenter-interne ID (Calljob-Id) des erzeugten Call-Jobs. RESULT enthält im Erfolgsfall den String ok, im Fehlerfall einen Fehlertext. • Zeilen, die mit &AGENT anfangen, werden durch eine Liste mit den in der CC-Datenbank konfigurierten Agenten ersetzt. Die Listenelemente haben die Form: Agentenname Die Listenelemente können zum Aufbau von Dropdown-Listen verwendet werden, die die Agenten des Call-Centers enthalten. • Zeilen, die mit &TOPIC anfangen, werden durch eine Liste mit den in der CC-Datenbank konfigurierten Themen ersetzt. Die Listenelemente haben die Form: Themenname Die Listenemente können zum Aufbau von Dropdown-Listen verwendet werden. • Zeilen, die mit &DTE anfangen, werden durch eine Liste mit den in der CC-Datenbank konfigurierten Endgeräte (DTE’s) ersetzt. Die Listenelemente haben die Form Dtenummer Die Listenelemente können zum Aufbau von Dropdown-Listen verwendet werden.
Version 1.0 22-07-2015
25
Beispiel Das folgende Beispiel ist eine HTML-Seite, die eine entsprechende Form vom CGI-Server anfordert: CIE CGI Testpage CIE CGI Testpage Simple CIE Callback CIE Callback CIE Callback with JavaScript checks Delete CIE Calljob In diesem Beipiel wird die Form „cj.html“ vom CGI-Server angefordert.
26 Benutzerhandbuch CIE 3.3 CGI-Server
Konfiguration
Funktion request/cj Bei der Funktion request/cj werden die CGI-Felder PHONENUMBER, TOPIC, AGENT und RETDOC wie folgt ausgewertet: Die Quelle für den Anruf (Call) wird wie folgt bestimmt: Wenn TOPIC nicht leer ist, dann Thema in Datenbank suchen. Sonst: Wenn AGENT nicht leer ist, dann Agent in Datenbank suchen. Wenn PHONENUMBER und Quelle (s.o.) nicht leer sind: Es wird ein Call-Job in den Datenbanktabellen CJ und CJPeriod erzeugt. Die Einträge in CJPeriod werden aus den CGI-Feldern FROM, TO und DAYS wie folgt ermittelt: FROM und TO enthalten jeweils Angaben der Form hh:mm, z.B. 12:30, und DAYS ist ein String mit Buchstaben 0 bis 6, der Wochentage kodiert. Diese Felder können mehrmals auftauchen und beschreiben jeweils eine Periode. Beispiel Die folgende Tabelle zeigt Beispiel-Einträge für die CGI-Felder FROM, TO und DAYS. Einträge
Erläuterung
FROM 15:00 TO 16:30 DAYS 12345
Montag bis Freitag jeweils 1500-1600
FROM 08:00 TO 12:00 DAYS 6
Samstags 800-1200
FROM 12:00 TO 13:00 DAYS 0
Sonntag 1200-1300
Es wird jeweils vom Eintragszeitpunkt der nächste passende Tag bestimmt. Zusätzlich werden alle CGI-Felder als Call-Tags in die Tabelle CJTag eingetragen, wobei den Feldnamen der String CGI_ vorangestellt wird. Anschließend wird das mit RETDOC angeforderte Ergebnis-Dokument (HTML-Seite) zurückgesendet. Das Ergebnis-Dokument wird dabei dem Ersetzungsalgorithmus wie bie der Funktion Form beschrieben unterworfen. Hierbei steht zusätzlich das Feld TICKET bereit, das benötigt wird, wenn die Funktion request/cjcancel ausgeführt wird.
Version 1.0 22-07-2015
27
Funktion request/cjcancel Bei der Funktion request/cjcancel werden die CGI-Felder PHONENUMBER und TICKET wie folgt ausgewertet. Wenn PHONENUMBER und TICKET nicht leer sind, dann wird iIn der Datenbank-Tabelle CJ (Call-Jobs) nach Call-Job gesucht, dessen Call-Center-Id mit der in TICKET angegebenen übereinstimmt. Wenn gefunden und die anzurufende Telefonnummer mit PHONENUMBER übereinstimmt, dann wird diese CallJob wieder aus der Datenbank gelöscht. Anschließend wird das mit RETDOC angeforderte Ergebnis-Dokument (HTML-Seite) zurückgeliefert. Das Ergebnis-Dokument wird dabei dem Ersetzungsalgorithmus wie bei der Funktion Form beschrieben unterworfen. Sie haben mit dieser Funktion jederzeit die Möglichkeit, Kunden das Löschen seines Rückrufwunsches anzubieten. Beachten Um den Rückrufwunsch zu löschen, müssen Sie dem Kunden bei Eintrag des Rückrufes eine entsprechende Auftragsnummer (Ticket) rückmelden. Er kann nur mit der Auftragsnummer den Rückrufwunsch löschen.
28 Benutzerhandbuch CIE 3.3 CGI-Server
Konfiguration
Verwendete CGI-Feldnamen Die folgende Tabelle zeigt die verwendeten CGI-Feldnamen. Feldname
verwendet von
Inhalt
Beispiel
AGENT
request/cj form/*
Name eines Agenten
Agent007
DAYS
request/cj
Wochentage, kodiert mit Ziffern
oder
form/*
Sonntag = 0 Montag = 1 Dienstag = 2 usw.
023 (d.h. Sonntag Dienstag Mittwoch
request/cj form/*
Start-Tageszeit
TAGE
FROM oder
15:30
VON PATH_INFO
Auszuführender Request. Dieses Feld braucht und kann nicht in der HTML-Form gesetzt werden, sondern wird automatisch durch den nach dem Skriptnamen im ACTION-Feld der Form angegebenen Pfad gesetzt, also z.B.