Installationsanleitung CityCall115
Allgemein
CityCall115 beschreibt die Lösung von Sitepark für Call-Center bzw. Call-Center mit erweiterter Serviceleistung sog. Service-Center. Bei einem Service-Center werden Anfragen nicht nur beantwortet, sondern u.U. auch aufgenommen und intern weitergeleitet.
Daraus resultiert, dass die Installation des Produktes CityCall115 mehr oder weniger umfangreich ist.
Grundsätzlich muss der Server so konfiguriert werden, dass der Email-Versand sowohl von PHP, als auch vom IES möglich ist!
System-Voraussetzungen
- IES-2
- Java (JDK)
- MySQL
- Apache inkl. Mod-Proxy
- CityGov3
- Nutch-Crawler (Tomcat wird nicht benötigt)
- PHP
- Korrekt konfigurierte Timezone
- notwendige Module
- ZEND Framework (IES-Module)
- Personalisierung
Installation des IES-2
Die Installation des IES-2 inkl. aller notwendigen Abhängigkeiten wird im Wiki von Sitepark bereits ausführlich beschrieben: Installation des IES
Installation von Nutch
CityCall115 benötigt für performante Volltextsuchen leistungsfähige Indices der Inhalte. Hierzu werden über die generierten Inhalte Lucene-Indices erzeugt. Als Crawler wird Nutch eingesetzt.
Sitepark liefert ein entsprechendes Nutch-Paket, welches über Erweiterungen für alle notwendigen Datentypen (Office2007, PDF-1.5, etc.) verfügt. Weiterhin sind zur Konfiguration Strukturen (sog. Zones) definiert worden, die alle notwendigen Funktionen übersichtlich abbilden.
Für jede Instanz des ServiceCenters wird eine eigene Zone definiert. Anschließend wird der Crawl-Aufruf in einer zentralen Datei (crawl-all-zones.sh
) konfiguriert. Die Konfiguration von Nutch wird in einem separaten Abschnitt beschrieben.
Für die Installation des Crawlers erhalten Sie von Sitepark ein gezippte Datei mit allen benötigten Inhalten: sitepark-nutch-0.8.1.tar.gz
. Diese kann auf dem Zielsystem im $SITEPARK_HOME
entpackt werden. Anschließend wird in $SITEPARK_HOME
ein sog. Symbolischer Link nutch erzeugt.
Für die regelmäßige Aktualisierung aller konfigurierten Indices werden Cron-Jobs benötigt. Dieser Aufruf kann bereits jetzt global konfiguriert werden und lauten etwa wie folgt:
# m h dom mon dow command
# jede Nacht nutch Suchindizes aktualisieren
15 2 * * * /srv/sitepark/nutch/crawl-all-zones.sh 2>/dev/null
Da die Indices vom Nutzer des Webserver gelesen werden müssen, muss diesem stets nach dem Crawlen der entsprechende Verzeichnis übertragen werden. Ist dieser Nutzer wwwrun
in der Gruppe wwwrun
sieht der Aufruf wie folgt aus:
chown -R wwwrun.wwwrun /srv/sitepark/nutch/zones
Idealerweise wird das an das Ende der Date crawl-all-zones.sh
angehängt.
Weiterführende Informationen zur Installation von Nutch finden Sie bei Bedarf auch hier.
Installation von PHP
Da CityCall115 über ein Bedienoberfläche in PHP gesteuert wird, ist auf dem entsprechendem System zusätzlich noch PHP5 inkl. benötigter Module zu installieren.
Zusäzliche php Module: php7-xsl php7-mysql php7-mcrypt php7-json php7-curl
Eine Übersicht über die benötigten Module und weitere Installationshinweise finden Sie hier: Installationsanleitung für PHP.
Weiterhin muss das System so konfiguriert werden, dass der Versand von Emails möglich ist.
Für die Generierung von PDF- bzw. XML-Dokumenten direkt aus CityCall115 heraus, werden folgende Ordner mit Schreibrechten für den Nutzer des Webserver benötigt:
$DOCUMENT_ROOT/pdf
$DOCUMENT_ROOT/xml
Der Wert von $DOCUMENT_ROOT
entspricht dem Verzeichnis, das im IES für den Publisher des ServiceCenters konfiguriert wurde/wird.
Weiterhin werden dort entsprechende PHP-Bibliotheken benötigt, die Sie von Sitepark erhalten.
Ist der Apache, wie in der Installationsanleitung beschrieben, in der Gruppe des IES, so werden diese beiden Ordner inkl. notwendiger Bibliotheken automatisch während der Initialisierung von CityCall115 angelegt.
Die PHP-Bibliothek (TCPDF) für die PDF-Generierung ist manuell zu installieren:
http://www.tecnick.com/public/code/cp_dpage.php?aiocp_dp=tcpdf_installation
Auf einem IES-System (Linux) kann die Installation im $SITEPARK_HOME
unter tcpdf
installiert werden. Alternativ kann man den Ordner parallel zum DocumenRoot
anlegen.
Installation von ZEND
Das ZEND-Framework wird von Sitepark in der benötigten Version bereit gestellt und entsprechend installiert bzw. für PHP konfiguriert. Das Framework steuert primär den Zugriff auf die vom Nutch-Crawler erzeugten Indices.
Auf dem Webserver des ServiceCenters kann das Framework parallel zu den DocumentRoot
-Verzeichnissen ausgepackt werden. Zur einfacheren Konfiguration sollte in Symbolischer Link 'zend' auf die jeweilige Version angelegt werden.
ln -s /var/www/zend-1.9 /var/www/zend
Anschließend muss der PHP include_path
erweitert werden. Dieses kann am besten direkt innerhalb des VirtualHosts-Konfiguration des Apache erfolgen:
...
php_value include_path ".:/srv/www/interntet/WEB-IES/zend/:/srv/www/internet/WEB-IES/citygov/php/:/srv/www/internet/WEB-IES/ies-api/php/"
# Mit Infoticket und Form-Service müssen noch weitere Pfade angehangen werden:
php_value include_path ".:/srv/www/servicecenter/WEB-IES/zend/:/srv/www/servicecenter/WEB-IES/citygov/php/:/srv/www/servicecenter/WEB-IES/ies-api/php/:/srv/www/servicecenter/WEB-IES/formservice/php/:/srv/www/servicecenter/WEB-IES/infoticket/php/"
...
Damit ist die Installation von ZEND auch schon abgeschlossen.
Weitere Details zur Installation von Zend sind auch in diesem Dokument beschrieben.
Installation der Personalisierung
Zur Steuerung der Zugriffe der Agents entsprechend ihrer Rechte wird das Apache-Modul Profile-Plus von Sitepark benötigt.
Sie haben entweder die Möglichkeit das Quellpaket inkl. der entsprechenden MAKE-Files direkt auf dem Zielsystem zu kompilieren um so ein optimal angepasstes Apache-Modul zu erhalten. Oder Sie bekommen von Sitepark direkt ein vorkompiliertes, zu Ihrer Hardware-Architektur kompatibles, Apache Modul (mod_sumpf.so
-Datei).
Die Installation erfolgt dann manuell und unterscheidet ist je nach Linux-Distribution etwas. Informationen hierzu finden Sie beim entsprechenden Distributor.
Allgemeine Informationen zum Modul Profile-Plus und zur Installation finden Sie hier.
Da der Zugriff auf das ServiceCenter für die entsprechende URL einmalig eingerichtet werden muss, kann das bereit hier vorgenommen werden. Bereits an dieser Stelle kann der Zugriff
Der Zugriff auf das ServiceCenter erfolgt über eine zentrale URL. Für diese kann bereits an dieser Stelle die Konfiguration der Personalisierung erfolgen. Es empfiehlt sich daher bereits jetzt die gesamte Apache-Konfiguration für das ServiceCenter vorzunehmen. Im wesentlichen sind hierzu lediglich folgende Aktionen notwendig:
- Verzeichnis für den $DOCUMENT_ROOT wählen, anlegen und dem Nutzer
ies
übertragen (chown -R ies.ies
) - URL und
DocumentRoot
konfigurieren. - Konfiguration der Personalisierung:
- Die Konfiguration erfolgt entweder direkt über die
Directory
-Direktive in der Konfiguration des Apache oder über eine.htaccess
-Datei, die man im $DOCUMENT_ROOT des ServiceCenter-Publishers anlegt. Für eine typische Konfiguration eines ServiceCenters kann der Inhalt wir folgt aussehen:
SumpfFilter on
SumpfContentFilter on
# Datenbankkonfiguration
#SumpfMySQLHost localhost
SumpfMySQLDatabase servicecenterdb
SumpfMySQLUser servicecenteruser
SumpfMySQLPass servicecenterpassword
# Connection ID
SumpfMySQLConnectionID 1
# URL zum CMS-System kann angepasst werden
SumpfAuthURL http://localhost:8080/ies/infosite/templates/gui.login.xml.spml?SYS_handler=com.sitepark.ies.control.jsp.handler.LoginHandler
SumpfAuthServiceOffLineURL /WEB-IES/cc/index.php
SumpfAuthTimeLogging On
SumpfLoginURL /WEB-IES/cc/index.php
SumpfLoginFailedURL /WEB-IES/cc/index.php
#SumpfWelcomeURL /welcome.shtml
SumpfForceSession off
SumpfForceNoCaching on
SumpfAuthMechanism IES
SumpfWantedCharset UTF-8
# Interner Zugang für den Nutch-Crawler
# Das Passwort kann frei hier vergeben werden. Es wird beim der Konfiguration der Zone sangegeben (s.u.).
SumpfAllAreasUser nudge
SumpfAllAreasPass nutchpassword
# Weitere optionale Parameter
# SumpfDirectoryIndex index.php
# SumpfPersonalizedDirectory /save
# SumpfAccessFile .spaccess
# SumpfTryBasicAuth off
# SumpfNoForcedSession on
# SumpfCheckParentDirs on
# SumpfAuthMechanism IES_Tables IES
- Voraussetzung für diese Konfiguration ist natürlich die entsprechende Konfiguration von AllowOverride AuthConfig.
Installation und Konfiguration von CityCall115
Das ServiceCenter besteht aus einem Kern mit Basisfunktionen, die optional über sog. AddOns noch erweitert werden können. Die Installation erfolgt jeweils über ein sog. XIP-Paket, welches direkt Erweiterungen in den entsprechenden Mandanten einspielt. Da das ServiceCenter über eine generierte PHP-Seite bedient wird und es sich nicht um ein direktes IES-Modul handelt, kann auch ohne laufenden IES-Prozeß die Recherche-Funktion voll genutzt werden.
Hinweis
Allgemeine Hinweise zur IES-Modulen erhalten Sie hier.
Details zum Import von XIP-Daten finden Sie unter XIP Import in der Konsole oder unter XIP Import im Browser. Beachten Sie beim Import, dass die Pools und Elemente erstellt, und die Daten in den entsprechenden Publikationsbereichen veröffentlicht werden.
Ein-Mehrmandanten Installation
Im folgenden wird zwischen der sog. einfachen und der Portal-Installation unterschieden. Im einfachen Fall wird CityCall115 zusammen mit den Daten des Mandaten in einer Instanz installiert.
Sollen mehrere Mandanten mit einer CityCall115-Installation bedient werden, so wird ein neuer Mandant mit den entsprechenden Funktionen installiert. Alle Daten werden von weiteren Mandanten geliefert. Jeder Mandant erhält lediglich eine Erweiterung, die die Integration in das zentrale ServiceCenter ermöglicht.
In jedem Fall ist darauf zu achten, dass alle Mandanten über eine Lizenz für CityGov3 und Personalisierung verfügen!
Für die Core-Funktionen des ServiceCenters gibt es ein XIP-Paket, welches alle funktionalen Elemente beinhaltet. Dieses kann später auch durch eine neue Version aktualisiert werden.
Für die Initialisierung wird ein weiteres XIP-Paket bereit gestellt, welches initiale Strukturen bereitstellt, die später den eigenen Wünschen entsprechend angepasst werden können (Layout etc.)
Installation von CityCall115
In der folgenden Beschreibung wird davon ausgegangen, dass es noch keine Daten und Mandanten auf dem System gibt. Alle notwendigen Aktionen zum Betrieb von CityCall115 werden hier vollständig beschrieben.
Folgendes Vorgehen ist notwendig:
- Modul CityGov3 installieren: WAR File von Sitepark im IES-Admin hochloaden
- IES-Datenbank für den neuen Mandaten anlegen
- Mandant anlegen und Anker vergeben (z.B. servicecenter)
DocumentRoot
des ServiceCenters anlegen und dem Nutzeries
übertragen (sofern nicht bereits erfolgt s.o.)- Publisher für das ServiceCenter anlegen (bei Verwendung des Beschwerdenmanagement muss der Publisch als 'Modul' gekennzeichnit werden, Live-Funktionalitäten zu ermöglichen)
- Den Apache so konfigurieren, dass Live-Aufrufe via
mod_proxy
an den IES geleitet werden. Informationen hierzu finden Sie hier. - Den Anker des Publishers setzen (z.B. pub.cc). Dieser wird später für die Konfiguration der Recherche benötigt.
- Personalisierung für diesen Publisher konfigurieren
- Die Metadaten des Publishers entsprechend für CityCall115 setzen (siehe auch Installationsanleitung CityGov3):
sp_vv_mode=service
- Datenbank für Personalisierung initialisieren (siehe Initialisierung der Personalisierungsdatenbank)
- Zugangsdaten der Datenbank für die Personalisierung in Apache konfigurieren:
#SumpfMySQLHost localhost SumpfMySQLDatabase servicecenterdb SumpfMySQLUser servicecenteruser SumpfMySQLPass servicecenterpassword
- Diesen Publisher dem Mandanten sowohl als Publisher(bei Verwendung des Beschwerdenmanagement auch als auch als Modul zuweisen.
- Mail-Publisher im IES konfigurieren und dem Mandanten zuweisen (bei einigen AddOns notwendig)
- Statistik-Datenbank anlegen:
- Für die Statistik-Funktion wird eine weitere Datenbank benötigt. Die Zugangsdaten werden im ServiceCenter konfiguriert und über PHP verwendet. Die Datenbank kann somit entweder
- manuell
- oder über den IES als nicht-IES Datenbank angelegt und dem Mandanten zugewiesen werden.
- Für die Initialisierung der Datenbank werden folgende Statements verwendet:
CREATE TABLE `StatisticEntry` (
`id` int(11) NOT NULL auto_increment,
`articleID_fk` varchar(255) default NULL,
`client_fk` varchar(250) default NULL,
`parentPath_fk` varchar(500) default NULL,
`callID` varchar(255) default NULL,
`userID` varchar(255) default NULL,
`userName` varchar(255) default NULL,
`callDuration` int(11) default NULL,
`flag` int(11) default NULL,
`timestamp` bigint(20) NOT NULL default '0',
PRIMARY KEY (`id`),
KEY `articleID_fk` (`articleID_fk`),
KEY `parentPath_fk` (`parentPath_fk`),
KEY `userID` (`userID`),
KEY `flag` (`flag`),
KEY `timestamp` (`timestamp`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 ;
--
--CREATE TABLE `StatisticEntryKey` (
-- `statistikId_fk` int(11) NOT NULL,
-- `keyName` varchar(255) NOT NULL,
-- `keyValue` varchar(255) default NULL,
-- KEY `statistikId_fk` (`statistikId_fk`),
-- KEY `keyName` (`keyName`)
--) ENGINE=InnoDB DEFAULT CHARSET=utf8 ;
CREATE TABLE `StatisticElement` (
`articleID` varchar(255) NOT NULL default '',
`articleName` varchar(255) NOT NULL default '',
`articleTitle` varchar(255) default NULL,
`articleURL` varchar(255) default NULL,
`articleCreated` bigint(20) default NULL,
`articleChanged` bigint(20) default NULL,
`articleType` varchar(255) default NULL,
`articleDeleted` bigint(20) default NULL,
`parentID` varchar(255) default NULL,
`parentName` varchar(255) default NULL,
`parentPath` varchar(500) default NULL,
`parentOffice` varchar(255) default NULL,
`parentDepartment` varchar(255) default NULL,
`client` varchar(250) default NULL,
`timestamp` bigint(20) NOT NULL default '0',
KEY `articleID` (`articleID`),
KEY `parentID` (`parentID`),
KEY `client` (`client`),
KEY `parentPath` (`parentPath`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 ;
CREATE TABLE `StatisticElementKey` (
`articleID_fk` varchar(255) default NULL,
`client_fk` varchar(25) default NULL,
`parentPath_fk` varchar(255) default NULL,
`keyName` varchar(255) NOT NULL,
`keyValue` varchar(255) default NULL,
KEY `articleID_fk` (`articleID_fk`),
KEY `client_fk` (`client_fk`),
KEY `parentPath_fk` (`parentPath_fk`),
KEY `keyName` (`keyName`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 ;
- XIP-Paket mit den Funktionalen Erweiterungen einspielen:
CityGov.core.stucture.xip
[SOLLTE bereits eingespielt sein]CityCall115-01.core.update.xip
[notwendig]CityCall115.base.configuration.core.xip
[NUR einmalig: notwendig]
- Optionale Pakete, je nach Lizenz:
- CTI
CityCall115-03.cti.base.configuration.xip
[optional]CityCall115-03.cti.[PAKET, JE NACH ANGEBUNDENER SCHNITTSTELLE].xip
[optional]
- Ticketsystem
CityCall115-04.infoticket.update.xip
[optional]
- Bei weiteren Mandaten, die an ein bestehendes CityCall angebunden werden:
CityCall115-02.client.update.xip
[optional]
- Bitte ergänzen Sie für den XIP-Import die Option
ies.xip.import.publishMode
zur Steuerung der Publikation
- Wird diese Installation nicht als Portal betrieben, so ist noch die Konfiguration des Mandanten bzgl. CityGov3 erforderlich: Konfiguration und Administration von CityGov3
Konfiguration der Recherche
Zur Konfiguration des Lucene-Index für eine CityCall115-Instanz kann einfach im Filesystem unter $SITEPARK_HOME/nutch/zones
die Zone localhost
vollständig kopiert und umbenannt werden. Es empfiehlt sich als Namen der Zone den Anker des entsprechenden Publishers zu verwenden (s.o.). Anschließend sind noch zwei Dateien manuell anzupassen:
- urls/url
- Konfiguration der Start-URLs
- Hier sind die URLs für die vollständigen Objekt-Listen anzugeben. Diese werden vom ServiceCenter automatisch im entsprechenden Publisher generiert. Die Datei hat etwa den folgenden Inhalt:
http://SEARCH_HOST/auth.sp?client=CLIENT_ANCHOR&welcome=/WEB-IES/cc/crawl_index.php&password=nudge&user=nutchpassword
- Der Wert SEARCH_HOST muss entsprechend der eigenen URL, der Wert CLIENT_ANCHOR entsprechend dem Anker des Mandanten und nutchpassword auf das im Apache konfigurierten Nutch-Passwort angepasst werden.
- conf/urlfilter.txt
- Konfiguration der globalen URL-Regeln
- Hier muss die mind. die folgende Zeile angepasst werden:
+^http://([a-z0-9]*\.)*SEARCH_HOST/
Für die regelmäßige Aktualisierung des neuen Index muss noch die zentrale Crawl-Datei (ist via Cron konfiguriert) /srv/sitepark/nutch/crawl-all-zones.sh
entsprechend erweitert werden (wobei der Wert SEARCH_ZONE entsprechend der eigenen Zone (i.d.R. Anker des Publishers) angepasst werden muss):
/srv/sitepark/nutch/crawl-zone.sh SEARCH_ZONE -d 5 -vvv -f > /srv/sitepark/nutch/logs/crawl.SEARCH_ZONE.log
Achten Sie bitte darauf, dass der Ordner für die Log-Dateien existiert und beschreibbar ist.
Konfiguration von CityCall115
Die Konfiguration der Installation von CityCall115 und den Modulen erfolgt anschließend über einen speziellen Artikel.
Für die Statistik-Funktion von CityCall115 muss die Datenbankverbindung konfiguriert werden. Für die Recherche ist die Konfiguration des Index notwendig. Für weitere AddOns sind zusätzliche Konfigurationen notwendig. Alle diese Einstellungen werden nach der Initialisierung direkt in InfoSite durchgeführt. Für die Konfiguration wird ein entsprechendes Template mit notwendigen Eingabemasken bereitgestellt.
Der Artikel für die globale Konfiguration ist
/ Artikel Pools/ IES / CityCall 115 / CityCall 115: Administration & Konfiguration / CityCall 115: Konfiguration
Der Anker des Artikels ist
ies.infe.cc.configuration
Je nach Installationsumfang (AddOns) sind mehr oder weniger Konfigurationseingaben notwendig bzw. möglich.
Zunächst wählt man den Mandanten aus für das im ServiceCenter aus. Wird CityCall115 als Portal betrieben, können hier mehrere Mandanten ausgewählt werden. Im ServiceCenter wird dann automatisch ein Auswahlmenü erscheinen. Nachdem man einen Mandanten ausgewählt und gespeichert hat, kann man die Konfiguration folgender Felder noch einmal anpassen:
- angezeigter Name für den Mandanten
- Name der Zone (i.d.R. Anker des Publishers)
- Skill-ID's (nur beim CTI AddOn)
Anschließend muss der Artikel noch einmal gespeichert werden.
Für die Statistik muss weiterhin die entsprechende Datenbank ausgewählt werden. Ist die Statistik-Datenbank nicht über den IES-Admin erstellt worden, können Sie die Verbindungsdaten auch manuell eingeben.
Als letztes können Sie noch die Konfiguration des Live-Nutzers vornehmen. Bitte setzen Sie zunächst das Passwort des entsprechendes Nutzers auf einen neuen Wert. Anschließend geben Sie das neue Passwort in der Konfiguration an.
Konfiguration von Nutzern für das Beschwerdemanagement
Für das erweiterte Formular ist das Template gui.user.template
mit folgendem Inhalt anzulegen
<sp:io type="in">
<sp:include anchor="is5:gui.user.template"/><br>
<sp:include anchor="ies.tple.cc.mod.user.config"/><br>
</sp:io>
oder bei bereits existierendem Template die Zeile <sp:include anchor="ies.tple.cc.mod.user.config"/>
zu ergänzen.
Datenbank-Update der Statistik
Ältere System mit bestehender Statistik müssen nach einem Update angepasst werden. Hier die für die Anpassungen nötigen Statements:
-- Eineindeutigkeite der Einträge nun über ArtikelID, CleintId UND dem OrganisationsPfad:
alter table StatisticEntry add COLUMN client_fk varchar(500) DEFAULT '' AFTER articleID_fk;
alter table StatisticEntry add COLUMN parentPath_fk varchar(500) DEFAULT '' AFTER client_fk;
alter table StatisticEntry add KEY `client_fk` (`client_fk`);
alter table StatisticEntry add KEY `parentPath_fk` (`parentPath_fk`);
alter table StatisticElementKey add COLUMN client_fk varchar(500) DEFAULT '' AFTER articleID_fk;
alter table StatisticElementKey add COLUMN parentPath_fk varchar(500) DEFAULT '' AFTER client_fk;
alter table StatisticElementKey add KEY `client_fk` (`client_fk`);
alter table StatisticElementKey add KEY `parentPath_fk` (`parentPath_fk`);
-- zus. Angabe des Amtes und Dezernates in der Hierarchie
alter table StatisticElement add COLUMN parentOffice varchar(255) DEFAULT NULL AFTER parentPath;
alter table StatisticElement add COLUMN parentDepartment varchar(255) DEFAULT NULL AFTER parentOffice;
alter table StatisticElement drop PRIMARY KEY;
alter table StatisticElement add KEY `articleID` (`articleID`);
alter table StatisticElement add KEY `client` (`client`);
alter table StatisticElement add KEY `parentPath` (`parentPath`);
--
-- Nötige Update-Statements
--
update StatisticElement as elem, StatisticEntry as entry set entry.parentPath_fk = elem.parentPath , entry.client_fk = elem.client where elem.articleID = entry.articleID_fk ;
-- Bei Update von CityCall mit dem XIP-Pakten, nach dem 22.11.2016 MÜSSEN noch folgenden Statements ausgeführt werden.
update StatisticEntry set parentPath_fk = trim(parentPath_fk) ;
update StatisticElement set parentPath = trim(parentPath);
Portal-Installation
CityCall115 kann auch als Portal installiert werden. In dieser Variante ist ein zentrales ServiceCenter für mehrere Mandanten zuständig. Alle Anrufe werden zentral angenommen und entsprechend des jeweiligen Mandanten bearbeitet.
In der folgenden Beschreibung wird davon ausgegangen, dass es noch keine Daten und Mandanten auf dem System gibt. Alle notwendigen Aktionen zum Betrieb von CityCall115 werden hier vollständig beschrieben.
Globale Installation von CityCall115
Es wird ein Mandant für CityCall115 entsprechend der oben beschriebenen Anleitung vollständig installiert. Die Konfiguration des Portals wird weiter unten im Abschnitt Installation und Konfiguration von Mandanten beschrieben. Über die URL des dort konfigurierten DocumentRoot
wird später das ServiceCenter betrieben. Für jeden Mandaten, der über das zentrale ServiceCenter bedient wird, muss ein separater IES-Mandant auf dem gleichen IES eingerichtet werden.
- Die Daten für das ServiceCenter kommen somit stets aus den einzelnen Mandanten
- Über sog. Themen können jedoch zusätzlich auch globale Informationen aufgenommen und über der Recherche durchsucht werden.
- Die Daten aus den Modulen Bürgeranfrage und Beschwerdemanagement werden zentral im ServiceCenter-Mandanten gespeichert. Dort können diese Informationen von den entsprechenden Mitarbeitern weiter bearbeitet werden.
- Alle Zugänge zur Verwendung des ServiceCenters erfolgen ebenfalls in diesem Mandanten.
Installation und Konfiguration von Mandanten
Die eigentlichen Daten einer CityCall115-Portal-Installation werden in unabhängigen Mandaten dezentral vorgenommen. Die Konfiguration des entsprechenden Publishers ermöglicht zusammen mit entsprechenden Templates eine nahtlose Integration. Über weitere Publisher können diese Mandanten auch parallel für den Aufbau eines Intranet, einer Internetpräsenz oder einer D115-XML-Struktur verwendet werden. Für einen neuen Mandanten sind folgende Schritte auszuführen:
- IES-Datenbank für den neuen Mandaten anlegen
- Mandant anlegen und Anker vergeben (z.B. client.abc)
- Publisher für das ServiceCenter mit folgenden Angaben anlegen:
- Als URL wird die URL des ServiceCenters konfiguriert (analog zur Konfiguration des Portal-Publishers).
- Als
DocumentRoot
wird derDocumentRoot
des ServiceCenters gewählt - Über den Parameter Verzeichnis wird später der
DocumentRoot
automatisch erweitert (z.B.ms
für Münster). Auf diese Weise werden alle Daten des Mandanten in ein Unterverzeichnis des ServiceCenters geschrieben. - Die Metadaten des Publishers entsprechend für CityCall115 setzen:
sp_vv_mode=service
- Den Anker des Publishers setzen (z.B. pub.client.abc). Dieser wird später für die Konfiguration der Recherche benötigt.
- Diesen Publisher dem Mandanten zuweisen
- XIP-Paket mit den Funktionalen Erweiterungen einspielen:
PHPlib
[notwendig]CityGov.core.stucture.xip
[notwendig]
- Bitte ergänzen Sie für den XIP-Import die Option
ies.xip.import.publishMode
zur Steuerung der Publikation
- Die Installation der CityCall115-Komponenten ist für die Mandanten nicht notwendig. Damit alle Daten in einem einheitlichen Layout generiert werden müssen noch entsprechende Rahmen-Templates in die einzelnen Mandanten eingespielt werden. Hierfür stellen wir ein entsprechendes XIP-Paket bereit:
CityCall115_06_Client.xip
- Bitte ergänzen Sie für den XIP-Import die Option
ies.xip.import.publishMode
zur Steuerung der Publikation
- Damit die eigentlichen Daten auch für Recherche-Funktionen zur Verfügung stehen muss eine entsprechende Nutch-Zone analog zu dem oben beschriebenen Vorgehen angelegt werden.
- Weiterhin muss unter Attribute in der Mandantenkonfiguration der Anker des ServiceCenter-Mandanten über den Parameter
ccMaster
angegeben werden. Z.B.:
ccMaster=servicecenter
- Konfiguration des Mandanten bzgl. CityGov3: Konfiguration und Administration von CityGov3
Abschließend wird nun in der Konfiguration des ServiceCenters der neue Mandant über einen weiteren Konfigurationsblock (Iterate) für das ServiceCenter aktiviert.
XIP Pakete einspielen
Erweiterungen für CityCall115
Hier werden die möglichen Erweiterungen der Grundinstallation kurz beschrieben.
Die Installation der Erweiterungen erfolgt über sog. XIP-Dateien.
D115 AddOn
Bürgeranfrage AddOn
Bürgeranfrage AddOn CityCall115
Beschwerdemanagement AddOn
Beschwerdemanagement AddOn CityCall115