Installationsanleitung

Installation
©
Copyright 2014 cobra – computer’s brainware GmbH
®
®
®
®
cobra Web CRM , cobra Adress PLUS , cobra CRM PLUS , cobra CRM PRO und cobra CRM
®
BI sind eingetragene Warenzeichen der cobra – computer’s brainware GmbH. Andere Begriffe
können Warenzeichen oder anderweitig geschützt sein und werden hier ohne jegliche Gewährleistung der freien Verwendbarkeit benutzt.
Alle Rechte vorbehalten. Nachdruck, auch auszugsweise, verboten. Kein Teil dieses Werkes darf
ohne schriftliche Einwilligung der cobra GmbH in irgendeiner Form (Fotokopie, Mikrofilm, Scan oder ein anderes Verfahren) – auch nicht für Zwecke der Unterrichtsgestaltung – reproduziert oder
unter Verwendung elektronischer Systeme verarbeitet, vervielfältigt oder verbreitet werden.
Änderungen, Irrtümer und Druckfehler vorbehalten.
Bearbeitet von Harald Borges.
Stand April 2014
www.cobra.de
cobra Web CRM
Inhalt
Technische Voraussetzungen .............................................................................. 3
Web CRM einrichten ............................................................................................. 4
Installation WebCRM ............................................................................................. 6
Anwendungsverzeichnis .......................................................................................... 6
Berechtigungen ................................................................................................... 6
Verbindung zur Datenbank ...................................................................................... 7
Active Directory-Anmeldung verwenden ................................................................. 9
E-Mailversand ....................................................................................................... 10
Website im IIS anlegen und einrichten .............................................................. 12
IIS 7 auf Windows Server 2008 ............................................................................. 12
Start .................................................................................................................. 12
Anwendungspool anlegen ................................................................................. 13
Identität des Anwendungspools ........................................................................ 14
Eine Website für WebCRM anlegen.................................................................. 15
Alternative – das Web CRM als Unterweb anlegen .......................................... 17
Einstellungen der Website oder des virtuellen Verzeichnisses ......................... 19
IIS 8 auf Windows Server 2012 ............................................................................. 19
Demo einrichten und starten .............................................................................. 20
Web CRM-Programmdateien kopieren ................................................................. 20
Zugriffsrechte auf das Web CRM-Verzeichnis vergeben ....................................... 20
Demo-Datenbanken auf dem SQL Server einbinden ............................................ 20
Datei Web.Config anpassen .................................................................................. 21
Website anlegen.................................................................................................... 21
Jetzt können Sie starten ........................................................................................ 22
Zugangsdaten der Demo ....................................................................................... 22
Die Bausteine des Web CRM .............................................................................. 23
Konfiguration in der web.config ........................................................................ 28
2
cobra Web CRM
Technische Voraussetzungen
Allgemein
Für den Einsatz von cobra Web CRM benötigen Sie:

Gute Kenntnisse zur Administration von IIS 7 bzw. IIS 8.

Gute Kenntnisse zur Administration des SQL Servers, auf dem cobra läuft.

Installierte Desktop-Versionen von cobra.

MS SQL Server (ab MS SQL Server 2005).

Web-Server:
 Produktiv: Windows Server 2008 R2 mit IIS 7.0 (dann kann Web CRM als eigene Website angelegt werden). Siehe Seite 12 ff.
 .Net Framework 4.0.
 Zugriff auf den SQL Server (ab MS SQL Server 2005).
Informationen zur Installationsumgebung und zur Sicherheit finden Sie in den entsprechenden Kapiteln dieses Dokuments.
In den Desktop-Versionen CRM PLUS, CRM PRO bzw. CRM BI
cobra Web CRM erwartet, dass …

mindestens ein Benutzer Systemverwalter-Rechte besitzt

und jeder Benutzer, der auf Web CRM zugreifen soll, im Fat Client eingetragen
ist und über ein eigenes Kennwort verfügt bzw. über das Active Directory konfiguriert ist.

Außerdem benötigen Sie einen gültigen Lizenzschlüssel für Web CRM.
3
cobra Web CRM
Web CRM einrichten
Das Einrichten des Web CRM gliedert sich in drei Schritte
1. Aufsetzen des IIS
Siehe »Webseite im IIS anlegen und einrichten«, Seite 12.
2. Einrichten der WebSeite auf dem IIS
Siehe »Installation WebCRM -> Anwendungsverzeichnis«, Seite 6.
3. Einspielen und konfigurieren der Webseite
Siehe
»Installation WebCRM -> Verbindung zur Datenbank«, Seite 7,
»Demo einrichten und starten«, Seite 20.
»Konfiguration in der web.config«, Seite 26.
Checkliste
Diese Checkliste gibt Ihnen einen kurzen Überblick über den Ablauf der Installation. Eine ausführliche Beschreibung der einzelnen Schritte folgt im Anschluss.
Kopieren des WebCRM-Anwendungsverzeichnisses
Die Beschreibung finden Sie auf Seite 6.
Rechte am Dateisystem einstellen
Für den Betrieb von cobra Web CRM müssen verschiedene Rechte auf Verzeichnisse erteilt werden. Die Einstellungen erfolgen über Windows.
cobra-Datenbanken bereitstellen
Eine eigene Live-Datenbank oder Demodatenbank wird auf SQL Server bereitgestellt. Das Bereitstellen erfolgt über die Desktop-Version.
Benutzer anlegen
Die Identitäten z.B. Netzwerkdienst für den Betrieb des IIS-Anwendungspools und
den Zugriff auf die SQL-Datenbanken werden eingerichtet. Die Einrichtung erfolgt
über Windows.
4
cobra Web CRM
Zugriffsrechte auf SQL Datenbanken setzen
Die Zugriffsrechte auf die cobra-Datenbanken und die Personalisierungsdatenbank werden für die Identitäten des Anwendungspools festgelegt. Die Einstellungen erfolgen über den IIS.
WebDAV zulassen
Die Einrichtung erfolgt über das Aktivieren und deaktivieren von WindowsFunktionen.
Anwendungspool einrichten
Der Anwendungspool (Isolationsmodus), unter dem die Website betrieben werden
soll, wird eingerichtet. Die Einrichtung erfolgt über die IIS-Verwaltungskonsole.
Website im IIS anlegen und einrichten
Die Website wird aufgesetzt und notwendige Einstellungen vorgenommen. Die
Einstellung erfolgt über die IIS-Verwaltungskonsole.
Ansichten für cobra Web CRM einrichten
Ansichten (Layouts = Seitenaufbau) werden eingerichtet, Widgets hinzugefügt oder geändert. Die Einrichtung erfolgt über cobra Web CRM.
Administration cobra Web CRM
Allgemeine Einstellungen werden vorgenommen, Ansichten zugeordnet, Briefvorlage eingerichtet. Die Einrichtung erfolgt über cobra Web CRM.
5
cobra Web CRM
Installation WebCRM
Anwendungsverzeichnis
Kopieren Sie das Anwendungsverzeichnis an einen beliebigen Ort auf Ihrem
Webserver. Entfernen Sie einen eventuellen Schreibschutz für das gesamte Anwendungsverzeichnis.
Wir empfehlen, das Anwendungsverzeichnis unter …inetpub\WebCRM\Website
anzulegen.
Berechtigungen
Da der Internet Information Server standardmäßig den Benutzer »Netzwerkdienst«
einsetzt, um Webanwendungen auszuführen, müssen im Anwendungsverzeichnis
folgende Berechtigungen gesetzt werden.

Geben sie dem Benutzer »Netzwerkdienst« Leseberechtigung auf das gesamte Anwendungsverzeichnis.

Geben Sie dem Benutzer »Netzwerkdienst« Schreib- und Änderungsberechtigung auf die Verzeichnisse »App_Data« und »Layouts« innerhalb des
Anwendungsverzeichnisses.

Geben Sie dem Benutzer »Netzwerkdienst« Schreib- und Änderungsberechtigung auf die Dateien /web.config, und /Widgets/widget_list.ascx.

Erstellen Sie einen Ordner für die Logdatei mit Lese-, Schreib- und Änderungsberechtigung für den »Netzwerkdienst«. Standardmäßig ist dies der Ordner
Logs parallel zur Website (siehe auch Konfiguration in web.config). Geben Sie
dem Benutzer »Netzwerkdienst« Schreib- und Änderungsberechtigung auf
den Ordner Logs
Ändern Sie in der web.config den Pfad für die Ablage der Logdatei, wenn sie an
einer anderen Stelle abgelegt werden soll, im Bereich
<log4net><param name=“File“ value=“..\Logs\WebCRM.log“/>
Die Standardeinstellung ist ..\Logs\WebCRM.log

Erstellen Sie einen Ordner für die temporäre Ablage von Briefen. Geben Sie
dem Ordner Lese-, Schreib- und Änderungsberechtigung für den »Netzwerkdienst«.
Wenn Sie die Dokumentenverwaltung verwenden, geben Sie dem Ordner, der in
der Desktop-Version von cobra eingetragenen Dokumentenverwaltung Lese-,
Schreib- und Änderungsberechtigung für den »Netzwerkdienst«.

Dies gilt auch, wenn die Dokumentenverwaltung über UNC-Pfade angeschlossen ist.
6
cobra Web CRM
Die Dokumentenverwaltung muss für das WebCRM freigeschaltet werden.
Dies geschieht entweder über die Administrationsseite des WebCRM oder
direkt in der web.config (s.u.).
Verbindung zur Datenbank
Für die erste Verbindung zur Datenbank müssen in der Datei /web.config die Verbindungen zur Datenbank eingestellt werden. Öffnen Sie dazu die Datei
/web.config mit dem Windows Text Editor (»Start: Ausführen: Notepad«) oder einem beliebigen anderen Text- bzw. XML-Editor.
Suchen Sie in der Datei nach dem Tag: <connectionStrings>.
Darunter befinden sich Zeilen, die wie folgt aufgebaut sind:
<add
<add
<add
<add
<add
name=”Personalization” connectionString=”[...]” />
name=”Users” connectionString=”[...]” />
name=”System” connectionString=”[...]” />
name=”Appointment” connectionString=”[...]” />
name=”Data” connectionString=”[...]” />
Im Attribut connectionString wird die Verbindungszeichenfolge zu der entsprechenden Datenbank eingetragen.

Personalization (wird in dem Ordner DB der Installatuin mitgeliefert) enthält die
Verbindungs-Zeichenfolge zur ASP.NET Personalisierungs-Datenbank.

Users enthält die Verbindungs-Zeichenfolge zur Benutzer-Datenbank.

System (z.B cobra_Main, bzw. DemoWebcrm_sys) enthält die VerbindungsZeichenfolge zur System-Datenbank.

Data enthält die Verbindungs-Zeichenfolge zur eigentlichen Datenbank, die mit
der Desktop-Version erstellt wurde.
(Alle anderen Einträge können ignoriert werden.)
Die Verbindungszeichenfolgen sind immer wie folgt aufgebaut:
data source=<SQL Servername\Instanzname>;Initial Catalog=<Datenbankname>;
User Id=<Benutzername>;Password=<Passwort>;

Data source enthält den Namen und ggf. die Instanz des SQL Servers.

Initial Catalog enthält den Namen der entsprechenden Datenbank.

User Id enthält den Namen des SQL Server-Benutzers, der auf die Datenbank
zugreifen darf.

Password enthält das Passwort des oben angegebenen SQL Server-Benutzers.
Wir empfehlen, für die Verbindung zum SQL Server die »SQL Server Authentifizierung« zu benutzen und dem neu erstellten Benutzer für die SQL-Datenbank nur
jene Berechtigungen zu erteilen, die für die vom Web CRM benötigten Datenban7
cobra Web CRM
ken notwendig sind. Der Datenbankbenutzer benötigt für die Datenbanken mindestens die Rechte des db_owner. Sie können natürlich auch die WindowsAuthentifizierung einsetzen.
SQL Server-Authentifizierung
Eintrag in der Web.Config in der Form
Data Source=<SQL Servername>;Initial Catalog=<Datenbankname>;
User Id=<SQL-User-Name>;Password=<SQL-User-Password>;
Z. B.: <add name=”System” connectionString=”data source=
DEVSERVER\SQL2000;Initial Catalog=DemoWebCRM_Sys; User
Id=webcrm;Password=webcrm;”/>

Bei <SQL Servername> tragen Sie den Namen Ihres SQL Servers ein. Das ist
in der Regel der Name des Rechners. Bei einer benannten SQL Server Instanz
muss der Instanz-Name angefügt werden. (z. B.: DEVSERVER\SQL2005)

Bei <Datenbankname> tragen Sie den Namen der Datenbank ein.

Bitte achten Sie beim Anlegen des Benutzers im SQL Server darauf, dass der
Benutzer sein Kennwort nicht ändern muss.

Bei der Verwendung des Web CRM Assistenten werden die SQL-Kennwörter in
der Web.Config verschlüsselt abgelegt.
Windows-Authentifizierung
Bei der Windows-Authentifizierung wird beim Zugriff auf die Datenbank das
Windows-Benutzerkonto des Prozesses, d. h. der Web-Anwendung, verwendet.
Eintrag in der Web.Config in der Form
Data Source=<SQL Servername>;Initial Catalog=<Datenbankname>;
Integrated Security=SSPI;
Z. B.: <add name=”System” connectionString=”data source=
DEVSERVER\SQL2005;Initial Catalog=DemoWebCRM_Sys; Integrated
Security=SSPI;”/>

Bei <SQL Servername> tragen Sie den Namen Ihres SQL Servers ein. Das ist
in der Regel der Name des Rechners. Bei einer benannten SQL Server-Instanz
muss der Instanz-Name angefügt werden. (z. B.: DEVSERVER\SQL2000)

Bei <Datenbankname> tragen Sie den Namen der Datenbank ein.
8
cobra Web CRM
Active Directory-Anmeldung verwenden
Von Web CRM 2010 ab PatchQ4 wird eine »einfache« Active Directory-Anmeldung unterstützt:
Bei der Web CRM-Anmeldung wird geprüft,

ob der Windows-Benutzer im Active Directory existiert und

ob er in der eingestellten Active Directory-Gruppe Mitglied ist.
Ist dies der Fall, wird der Active Directory-Benutzer automatisch mit den vordefinierten cobra Benutzergruppen in der cobra Benutzerverwaltung mit einem Standard-Kennwort angelegt. Web CRM liest die Benutzerattribute aus dem Active Directory aus.
Um auf die Active Directory-Anmeldung umzustellen,
sind folgende Änderungen durchzuführen.
1.
in der Web.config
Der Eintrag in der Section appSettings sind folgende Einträge zu machen
<appSettings>
<appSettings>
…
<add key=”AuthenticationMode” value=”SimpleActiveDirectory” />
<add key=”AdRootEntry” value=”LDAP://CN=Users,DC=cobra,DC=local” />
<add key=”RootGroup” value=”cobraAdressPLUS” />
…
</appSettings>
Key: AuthenticationMode
„Default“ ist der Standard-Wert und es wird das übliche cobra-Anmeldung
verwendet.
„SimpleActiveDirectory“: Es wird das Active Directory verwendet. D.h. Im
WebCRM werden die User des Active Directorys verwendet.
Key: AdRootEntry wird das Active Directory-Verzeichnis angegeben, in dem
die User, bzw. die Usergruppe liegen.
Wird nur ausgewertet, wenn AuthenticationMode SimpleActiveDirectory
Key: RootGroup wird die Active Directory-Gruppe eingetragen, deren Mitglieder
als gültige Benutzer betrachtet werden. Es werden auch die Mitglieder der Subdirektories übernommen.
Wird nur ausgewertet wenn AuthenticationMode SimpleActiveDirectory
Wollen Sie überprüfen, welche Mitglieder aus dem Active Directory übernommen
werden, so setzen Sie in der Section
9
cobra Web CRM
<appSettings>
das Testflag auf 1
<add key=“testFlag“ value=“1“ />
schalten den DebugModus in der Section
<log4net>
<level value=“DEBUG“ />
ein und starten die Webseite am IIS neu.
In der Log-Datei werden dann die möglichen User aufgelistet.
2.
in der Web.config
In der Section
<authentication mode=“Forms“>
<forms loginUrl=“Login.aspx“ />
</authentication>
ist der authentication mode auf „windows“ zu setzen
3.
Im IIS
ist die Authentication für die Webseite von »Anonymous Authentication« auf »Basic Authentication«, bzw. auf »Windows Authentication« umzustellen.
Der Microsoft Internet Explorer erkennt bei der Arbeit im Intranet automatisch den
am Rechner angemeldeten Benutzer und verwendet diesen. Bei der Arbeit über
das Intranet erscheint der Anmeldedialog.
Beim Aufruf von WebCRM mit Firefox und anderen Browsern muss man sich mit
dem Domänen-Benutzer anmelden.
Für das Login wird der Benutzer aus dem Active Directory ausgelesen. Gehört der
Benutzer zu der Gruppe, die unter »RootGroup« angegeben ist, wird er eingeloggt.
E-Mailversand
Der E-Mail-Versand an Adressen aus dem Web CRM heraus kann sowohl über
einen lokalen E-Mail-Client als auch über einen vorhandenen Exchange Server erfolgen. Wird der Versand per Exchange Server gewählt, muss sichergestellt sein,
dass auf dem Exchange Server das Outlook Web Access installiert ist. Des Weiteren muss der »Netzwerkdienst« Zugriff auf den Exchange Server haben.
Der Versand per Exchange Server benötigt zwingend das Outlook Web Access auf dem Exchange Server!
10
cobra Web CRM
Soll der E-Mailversand des Web CRM über einen vorhandenen Exchange Server
vorgenommen werden, müssen noch folgende Einstellungen in der web.config getroffen werden. Suchen Sie dafür in der web.config nach dem Tag <appSettings>.
<add key=”Domain” value=”IhreDomaene” />
Tragen Sie hier die Active Directory Domain ein, die vom Exchange Server verwendet wird.
<add key=”EmailSendMethod” value=”Exchange” />
Tragen Sie hier »Exchange« ein, um den Versand per Exchange Server zu aktivieren. Mit dem Standardwert »Default« wird – wie gehabt – der lokale E-MailClient für den E-Mail-Versand verwendet. Mit der Angabe »Smtp« wird versucht,
die Email per SMTP zu versenden.
Achten Sie darauf, dass in den Benutzerdaten eine gültige E-Mail-Adresse als Absender eingetragen ist.
<add key=”ExchangeBasePath”
value=”http://mail.IhreDomaene.de/exchange/”/>
Tragen Sie hier die vollständige Adresse zum Outlook Web Access ein.
Zur Fehlersuche hilft die Einstellung des testFlag auf den Wert 4096 (siehe »Konfiguration in der web.config«, Seite 26).
11
cobra Web CRM
Website im IIS anlegen und einrichten
IIS 7 auf Windows Server 2008
So setzen Sie Web CRM auf einem Windows Server 2008 mit IIS 7.0 auf.
Achtung: Diese Anweisungen setzen eine genaue Kenntnis der Installation
von IIS voraus. In einzelnen Konfigurationen können die Schritte etwas davon abweichen.
Ist schon ein IIS vorhanden, so überprüfen Sie die einzelnen Voraussetzungen (Asp.net, Applicationpool …) genau.
Start

Wechseln Sie in die Systemsteuerung von Windows. Klicken Sie dort »Verwaltung« doppelt an.

Öffnen Sie den Internet-Informationsdienste Manager (IIS) durch Doppelklick.
Achten Sie beim Installieren des IIS darauf, die Anwendungsentwicklungsfeatures
für ASP.NET mitzuinstallieren.
Achten Sie auch darauf, dass unter »Gemeinsam genutzte http-Features« mindestens die WebDAV-Veröffentlichung gesetzt ist.
12
cobra Web CRM
Weitere Dokumentation zum WebDAV finden Sie unter
http://learn.iis.net/page.aspx/350/installing-and-configuring-webdav-on-iis/
Anwendungspool anlegen

Im IIS klicken Sie »Anwendungspools« an und öffnen das Kontextmenü der Liste durch Klick mit der rechten Maustaste.

Im Kontextmenü wählen Sie den Eintrag »Anwendungspool hinzufügen …« oder verwenden den vorhandenen „DefaultApplicationPool“. Ab IIS 7 wird der
Anwendungspool automatisch beim Erstellen der Webseite hinzugefügt. U.U.
müssen die Einstellungen korrigiert werden.
Sie können einen beliebigen Namen eingeben.
Sie tragen den Anwendungspool später unter den
Eigenschaften der Website ein.
Achten Sie darauf, dass der Anwendungspool für
asp.net 4.0 angelegt wird. Unter Umständen müssen Sie asp.net 4.0 herunterladen und installieren.
13
cobra Web CRM
Identität des Anwendungspools
In den »Erweiterten Einstellungen« des Anwendungspools stellen Sie ein, unter
welchem Windows-Konto die Web-Anwendung läuft. Die Vorgabe ist »Netzwerkdienste«. Sie können auch ein beliebiges anderes Konto auswählen.
Wir empfehlen, das voreingestellte »Netzwerkdienste« als Konto zu verwenden!
Das eingestellte Konto wird verwendet:

beim Zugriff auf den SQL Server
(allerdings nur, wenn per Windows
Authentifizierung auf die Datenbanken zugegriffen wird) und

beim Zugriff auf das Dateisystem
(z. B.: temporäre Dokumente anlegen, Dokumentenverwaltung,
Log-Datei und für diverse Einstellungen im Adminbereich).

Bei 64-bit Systemen achten Sie
darauf, dass 32-bit-Anwendungen
in dem Pool erlaubt sind.
14
cobra Web CRM
Eine Website für WebCRM anlegen
Legen Sie eine neue Website an.

Dazu klicken Sie den Ordner »Websites« an und wählen unter »Aktionen« oder
über das Kontextmenü den Befehl »Website hinzufügen …« aus.
Tragen Sie den Namen der neuen Website ein und wählen Sie den Anwendungspool aus. Unter IIS7 wird die Verbindung zum Anwendungspool automatisch eingestellt. Evtl. muss der Anwendungspool noch konfiguriert werden.
15
cobra Web CRM
Geben Sie an, in welchem Verzeichnis die Dateien für die Website liegen und tragen Sie, wenn gewünscht, den Hostheader ein:
Diese Einstellungen können Sie später unter »Grundeinstellungen« oder »Bindungen« ändern.
Die weiteren Einstellungen einer Website entsprechen denen eines virtuellen Verzeichnisses und werden weiter unten erläutert.
16
cobra Web CRM
Alternative – das Web CRM als Unterweb anlegen
Zum Anlegen eines Unterweb klicken Sie die gewünschte Website, zu der Sie das
Unterweb anlegen möchten, mit der rechten Maustaste an und erteilen den abgebildeten Befehl.
Ein Dialog öffnet sich, in dem Sie
das virtuelle Verzeichnis anlegen.
Tragen Sie ein, unter welchem
Namen das virtuelle Verzeichnis
geführt werden soll und geben
Sie an, in welchem Verzeichnis
die Dateien für die Website liegen.
17
cobra Web CRM
Das virtuelle Verzeichnis muss anschließend im IIS als Anwendung eingetragen
sein.
Öffnen Sie dazu das Kontextmenü für das
virtuelle Verzeichnis und wählen Sie den
Befehl »In Anwendung konvertieren«.
In dem Dialog, der sich
jetzt öffnet, geben Sie der
Anwendung einen Namen
und wählen den Anwendungspool aus.
Das Verzeichnis bekommt im IIS das Weltkugel-Symbol .
Sie sehen unter »Aktionen« die Rubrik »Anwendung bearbeiten« mit den Befehlen
»Grundeinstellungen …« und »Erweiterte Einstellungen …«.
18
cobra Web CRM
Einstellungen der Website oder des virtuellen Verzeichnisses
Sie können die Einstellungen für Features einer Website oder eines virtuellen Verzeichnisses bearbeiten, in dem Sie die Website oder das virtuelle Verzeichnis in
der Baum-Darstellung anklicken und in der Mitte die Ansicht »Features« wählen.
Die Einstellungen zu den Features, die unter der Rubrik »ASP.NET« zusammengefasst sind, werden aus der Web.Config des Web CRM ausgelesen. Die Einstellungen der Web.Config können mit dem IIS konfiguriert werden. Einige Einstellungen werden auch über den Administrationsbereich des Web CRM verwaltet.
Die Einstellungen zu den Features unter der Rubrik »IIS« entsprechen den Einstellungen der IIS-Website-Eigenschaften-Dialogs.

Unter »Standarddokument« muss auch die Datei »Default.aspx« eingetragen
sein.

Unter »Authentifizierung« können Sie den anonymen Zugriff ein- oder ausschalten. Siehe weiter oben unter Windows Authentifizierung.
Als »SSL-Einstellungen« können Sie den Zugriff per HTTPS (Port 443) einstellen.
IIS 8 auf Windows Server 2012
Wir verweisen auf http://www.iis.net/learn/get-started/whats-new-in-iis-8/iis-80using-aspnet-35-and-aspnet-45. Dort finden Sie eine genaue Beschreibung, wie
unter Windows 2012 IIS installiert wird. Die für Web CRM spezifischen Einstellungen übernehmen Sie bitte aus der Beschreibung zu IIS auf Windows Server 2008.
19
cobra Web CRM
Demo einrichten und starten
Web CRM-Programmdateien kopieren
Erstellen Sie auf dem Web-Server ein Verzeichnis für das Web CRM (z. B.:
C:\inetpub\WebCRM\website).
Kopieren Sie den Inhalt des »Web CRM«-Verzeichnisses von der CD in das Verzeichnis hinein.
Zugriffsrechte auf das Web CRM-Verzeichnis
vergeben
Das Web CRM auf der CD ist für die beigelegten Demo-Datenbanken eingerichtet.
So können Sie cobra Web CRM schnell und einfach ausprobieren.
Demo-Datenbanken auf dem SQL Server einbinden
Binden Sie die beiliegenden *.bak-Dateien aus dem »DemoDBs«-Verzeichnis von
der CD in den SQL Server ein.
Dazu

kopieren Sie die Dateien in ein Verzeichnis Ihres SQL Servers,

öffnen das SQL Server Management Studio oder den SQL Server Enterprise
Manager,

öffnen das Kontextmenü auf »Datenbanken«

und wählen den Punkt »Datenbank wiederherstellen …« aus.

Tragen Sie im Feld »In Datenbank« einen Namen für die Datenbank ein, z. B:
»DemoWebCRM«.

Wählen Sie unten die Option »von Medium« aus.

Wählen Sie nun rechts daneben die *.bak-Datei aus dem Dateisystem aus.

Setzen Sie nun unten das Häkchen im angezeigten Sicherungssatz.

Vervollständigen Sie den Import mit »OK«
20
cobra Web CRM

Geben Sie über das SQL-Management Studio dem Benutzer der in der
„Web.config“ (Connection-Strings) eingetragen wird, auf alle Datenbanken
(DemoWebCRM, DemoWebCRm_Pers, DemoWebCRM_Sys) die SQLBerechtigung „db_owner“.
Analog verfahren Sie für DemoWebCRM_Pers.bak und DemoWebCRM_Sys.bak.
Arbeiten Sie mit einer anderen Systemdatenbank oder Adressdatenbank
als den von uns mitgelieferten, müssen Sie trotzdem die mitgelieferte Datenbank DemoWebCRM_Pers.bak verwenden!
DemoWebCRM.bak
Demo-Datenbank für das Web CRM.
DemoWebCRM_Pers.bak
In der DemoWebCRM_Pers.bak sind die Tabellen für die Personalisierung der
Website enthalten. Die DemoWebCRM_Pers ist eine vordefinierte Datenbank, die
wir erstellt haben. Man muss diese für die korrekte Funktionalität unseres Web
CRMs auf dem SQL Server einspielen und über die Web.config den ASP.NETAnwendungsdienst mitteilen wo sich diese Datenbank befindet. Diese Datenbank
erlaubt u. a. das Ändern bzw. Speichern der Darstellung (Widgets-Anordnung etc)
auf der Webseite. Diese Datenbank enthält, welche Widgets in welchem View
sichtbar sind, sowie die Konfiguration der Widgets.
Bevor Sie Änderungen in den Views bzw. in der Konfiguration der Widgets
machen, sichern Sie bitte zuvor diese Datenbank.
DemoWebCRM_Sys.bak
In der DemoWebCRM_Sys.bak sind die Tabellen der System.db, Benutzer.db,
DocMan.db und Termine.mdb enthalten.
Achten Sie darauf, dass der in den Connection Strings angegebene User die notwendigen Berechtigungen für diese Datenbanken hat.
Datei Web.Config anpassen
Passen sie die SQL-Connection-Strings in der Datei Web.Config an Ihren SQL
Server an. Siehe dazu Seite 7.
Website anlegen
Siehe dazu Kapitel Website im IIS anlegen und einrichten
21
cobra Web CRM
Jetzt können Sie starten
Öffnen Sie den Browser und geben Sie die Adresse Ihres Web CRM ein, z. B.:
http://localhost/WebCRM (das »WebCRM« nach »localhost/« ist der Alias, den Sie
beim Anlegen des Webs eingegeben haben).
Zugangsdaten der Demo
Benutzername: Erwin Schmidt (oder sein Zeichen »es«)
Benutzerkennwort: webCRM
Systemverwalterkennwort: webcrmadmin
Melden Sie sich als Erwin Schmidt an.
22
cobra Web CRM
Die Bausteine des Web CRM
Einzelheiten finden Sie im Systemhandbuch zu Web CRM.
cobra Web CRM kann vom Systemverwalter aus einzelnen Elementen frei gestaltet werden.
Welche Registerkarten zur Verfügung stehen, wird durch die Datei Layout.xml bestimmt. Die Aufteilung der einzelnen Seiten in verschiedene Webpart-Zonen wird
durch die Dateien im Layout-Verzeichnis vorgegeben.

Zum Bearbeiten erteilen Sie den Befehl »Einstellungen: Ansichten einrichten«.

Links oben in der Ansicht erscheinen gelb unterlegt die entsprechenden Links.
23
cobra Web CRM
Widgets
Widgets sind die funktionalen Bausteine des Web CRM. Sie können vom Systemverwalter in beliebige Webpart-Zonen eingefügt werden. Jedes Widget hat eine
Editor-Zone, in der es konfiguriert wird. Die Editor-Zone wird im Modus »Ansichten
einrichten« angezeigt, wenn Sie die Schaltfläche »Bearbeiten«
anklicken.
Das Widget »RSS Reader«.
Je nach Design sind die Begrenzungen eines Widgets mehr oder weniger deutlich
erkennbar. Ein Widget hat oben rechts immer die Schaltfläche »Minimieren« ,
mit der Systemverwalter wie auch Anwender das Widget verkleinern können, so
dass nur noch seine Titelleiste angezeigt wird.
Im Modus »Ansichten einrichten«, der nur Systemverwaltern zugänglich ist, werden zusätzlich die Schaltflächen »Bearbeiten«
und »Löschen«
angezeigt.
Webpart
Webpart ist ein anderer Begriff für »Webpart-Zone«.
Sidebar
Die Sidebar ist für kleinere Widgets gedacht.
Webpart-Zone
Eine Webpart-Zone ist ein Behälter für die verschiedenen Widgets, aus denen sich
das Web CRM zusammensetzt. Die Webpart-Zonen liegen zwischen der BisherListe und über dem unteren Rand. Auch die Sidebar-Zone ist eine Webpart-Zone.
Welche Webpart-Zonen Ihnen in einer Registerkarte zur Verfügung stehen, hängt
davon ab, welche Vorlage Sie für die jeweilige Ansicht verwenden.
24
cobra Web CRM
Einstellungsbereich für Widgets
Hier konfigurieren Sie Widgets.
Der Bearbeitungs- oder Einstellungsbereich hat eine feste Position auf der Seite.
Ist er nicht komplett sichtbar, können Sie die Seite nach unten scrollen.
Widgetkatalog
Der Widgetkatalog wird eingeblendet,
wenn Sie im Modus »Ansichten einrichten« auf »Widgets hinzufügen« klicken.
Ihnen werden alle verfügbaren Widgets
angezeigt.
Der Widgetkatalog hat eine feste Position
auf der Seite. Er lässt sich nicht vergrößern oder verschieben.
Ist der Widgetkatalog nicht komplett sichtbar, müssen Sie in ihm nach unten scrollen.
Sie können Widgets zudem exportieren
und danach über »Importiere Widgets« in
der Ansicht unterbringen.
25
cobra Web CRM
Ein Widget exportieren/importieren
Sie können Widgets auf Ihren lokalen PC exportieren und sie in eine andere Ansicht von Web CRM importieren.
Exportieren
Für den Export findet sich in jedem Widget, das in eine Ansicht eingebunden ist,
eine eigene Schaltfläche.

Klicken Sie die Schaltfläche an.

Geben Sie an, wo auf Ihrem System das Widget gespeichert werden soll.
Die Datei wird mit der Extension *.WebPart in Ihrem System gespeichert.
Importieren

Um ein Widget zu importieren, erteilen Sie den Befehl »Widgets hinzufügen«.
Damit öffnen Sie den Katalog der vorhandenen Widgets.

Klicken Sie hier den Link »Importiere
Widgets« an.
26
cobra Web CRM
Es öffnet sich ein weiterer Dialog, in dem Sie angeben, welches Widget importiert
werden soll.

Klicken Sie in diesem Dialog die Schaltfläche »Durchsuchen« an.

Wählen Sie das Widget aus.

Betätigen Sie die Schaltfläche »Hochladen«.
Das Widget wird in das System geladen.

Markieren Sie das Widget.

Wählen Sie unten, in welche Zone Ihrer
Ansicht das Widget geladen werden soll.

Betätigen Sie die Schaltfläche »Hinzufügen«.
Das Widget wird in der aktuellen Ansicht in den entsprechenden Bereich der Ansicht importiert. Sie können nun seine Eigenschaft und seine Position ändern.
Widgets positionieren
In den Widget-Eigenschaften bestimmen Sie, an welcher Stelle innerhalb der Ansicht das Widget stehen soll.

Klicken Sie

Die »Position« gibt an, an wievielter Stelle innerhalb des WebParts dieses
Widget steht.
27
cobra Web CRM
Konfiguration in der web.config
Beschreibung der einzelnen für den Benutzer wesentlichen Teile der web.config
•
•
In der Section <log4net>
Einstellungen zum logging
<!-- Level können gesetzt werden auf:
value=“WARN“ (Standard),
value=“DEBUG“ (sehr umfangreiches Protokoll, nur temporär anwenden!)
-->
<level value=“WARN“/>
Soll die Log-Datei nicht parallel zu der Webseite abgelegt werden, so ist die
Einstellung
<param name=“File“ value=“..\Logs \WebCRM.log“/>
zu ändern. Achten Sie auch darauf, dass der »Netzwerkdienst« darauf lesend und schreibend Zugriff hat.
In der Section <appSettings>
<add key=“DocumentsRoot“ value=“c:\WebCRMxxx\WebCRMDocs\“/>
Der key DocumentsRoot wird nicht mehr ausgewertet.
<add key=“TempDocumentsRoot“ value=“c:\WebCRM\WebCRMDocs\TempDocs\“/>
Dieses Directory dient als Temp-Directory zur Zwischenablage von Briefen.
Dieser Key kann auch im WebCRM unter Administration gesetzt werden.
<add key=“CobraDmsActivated“ value=“True“/>
Angabe ob DMS verwendet werden soll.
<add key=“testFlag“ value=“0“/>
Dieser Key dient zur Steuerung des Debugging. Er ist nur wirksam, wenn
logging auf DEBUG (s.o) gestellt ist. Die Werte sprechen Sie jeweils bitte
bei einer eventuellen Fehlersuche mit dem Support ab.
Evtl. sinnvolle Werte
1
64
128
4096
Application Initialisierung
login / default aspx
alle Httprequests
Controlelemente
28
cobra Web CRM
Sollen mehrere Flags gesetzt werden, geschieht dies durch Addition
Also entweder
<add key=“testFlag“ value=“65“/>
Oder
<add key=“testFlag“ value=“1+64“/>
<add key=“ApplicationType“ value=“Plus“/>
<add key=“ApplicationType“ value=“Pro“/>
Defaulteinstellung cobra CRMPlus
Einstellung cobra CRMPro
Dieser Key dient zur Einstellung des SecurityModells und sollte nur nach Rücksprache mit dem Support geändert werden. Ist der Key nicht vorhanden, wird die
Voreinstellung cobra CRMPlus verwendet.
<add key=”AuthenticationMode” value=”SimpleActiveDirectory” />
<add key=”AdRootEntry” value=”LDAP://CN=Users,DC=cobra,DC=local” />
<add key=”RootGroup” value=”cobraAdressPLUS” />
Diese Keys dienen zur Steuerung der User über Active Directory (s. Kapitel Active
Directory Anmeldung)
• In der Section <connectionStrings>
Vergleiche die Beschreibung der Verbindung zur Datenbank.
29