29
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ährleis- tung 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 o- der 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

Installationsanleitung Web CRM - Cobra CRM Software · 2016-11-17 · WebCRM werden die User des Active Directorys verwendet. Key: AdRootEntry wird das Active Directory-Verzeichnis

  • Upload
    others

  • View
    0

  • Download
    0

Embed Size (px)

Citation preview

Page 1: Installationsanleitung Web CRM - Cobra CRM Software · 2016-11-17 · WebCRM werden die User des Active Directorys verwendet. Key: AdRootEntry wird das Active Directory-Verzeichnis

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ährleis-tung 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 o-der 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

Page 2: Installationsanleitung Web CRM - Cobra CRM Software · 2016-11-17 · WebCRM werden die User des Active Directorys verwendet. Key: AdRootEntry wird das Active Directory-Verzeichnis

cobra Web CRM

2

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

Page 3: Installationsanleitung Web CRM - Cobra CRM Software · 2016-11-17 · WebCRM werden die User des Active Directorys verwendet. Key: AdRootEntry wird das Active Directory-Verzeichnis

cobra Web CRM

3

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 ei-gene 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 ent-sprechenden 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 konfi-guriert ist.

Außerdem benötigen Sie einen gültigen Lizenzschlüssel für Web CRM.

Page 4: Installationsanleitung Web CRM - Cobra CRM Software · 2016-11-17 · WebCRM werden die User des Active Directorys verwendet. Key: AdRootEntry wird das Active Directory-Verzeichnis

cobra Web CRM

4

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 Installati-on. 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 Verzeich-nisse erteilt werden. Die Einstellungen erfolgen über Windows.

cobra-Datenbanken bereitstellen

Eine eigene Live-Datenbank oder Demodatenbank wird auf SQL Server bereitge-stellt. 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.

Page 5: Installationsanleitung Web CRM - Cobra CRM Software · 2016-11-17 · WebCRM werden die User des Active Directorys verwendet. Key: AdRootEntry wird das Active Directory-Verzeichnis

cobra Web CRM

5

Zugriffsrechte auf SQL Datenbanken setzen Die Zugriffsrechte auf die cobra-Datenbanken und die Personalisierungsdaten-bank werden für die Identitäten des Anwendungspools festgelegt. Die Einstellun-gen erfolgen über den IIS.

WebDAV zulassen Die Einrichtung erfolgt über das Aktivieren und deaktivieren von Windows-Funktionen.

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 o-der geändert. Die Einrichtung erfolgt über cobra Web CRM.

Administration cobra Web CRM Allgemeine Einstellungen werden vorgenommen, Ansichten zugeordnet, Briefvor-lage eingerichtet. Die Einrichtung erfolgt über cobra Web CRM.

Page 6: Installationsanleitung Web CRM - Cobra CRM Software · 2016-11-17 · WebCRM werden die User des Active Directorys verwendet. Key: AdRootEntry wird das Active Directory-Verzeichnis

cobra Web CRM

6

Installation WebCRM

Anwendungsverzeichnis Kopieren Sie das Anwendungsverzeichnis an einen beliebigen Ort auf Ihrem Webserver. Entfernen Sie einen eventuellen Schreibschutz für das gesamte An-wendungsverzeichnis.

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 ge-

samte Anwendungsverzeichnis. Geben Sie dem Benutzer »Netzwerkdienst« Schreib- und Änderungsbe-

rechtigung auf die Verzeichnisse »App_Data« und »Layouts« innerhalb des Anwendungsverzeichnisses.

Geben Sie dem Benutzer »Netzwerkdienst« Schreib- und Änderungsbe-rechtigung auf die Dateien /web.config, und /Widgets/widget_list.ascx.

Erstellen Sie einen Ordner für die Logdatei mit Lese-, Schreib- und Änderungs-berechtigung 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 »Netzwerk-dienst«.

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 angeschlos-sen ist.

Page 7: Installationsanleitung Web CRM - Cobra CRM Software · 2016-11-17 · WebCRM werden die User des Active Directorys verwendet. Key: AdRootEntry wird das Active Directory-Verzeichnis

cobra Web CRM

7

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 Ver-bindungen zur Datenbank eingestellt werden. Öffnen Sie dazu die Datei /web.config mit dem Windows Text Editor (»Start: Ausführen: Notepad«) oder ei-nem 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 name=”Personalization” connectionString=”[...]” /> <add name=”Users” connectionString=”[...]” /> <add name=”System” connectionString=”[...]” /> <add name=”Appointment” connectionString=”[...]” /> <add name=”Data” connectionString=”[...]” />

Im Attribut connectionString wird die Verbindungszeichenfolge zu der entspre-chenden 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 Verbindungs-

Zeichenfolge 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-Benut-

zers.

Wir empfehlen, für die Verbindung zum SQL Server die »SQL Server Authentifizie-rung« 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 Datenban-

Page 8: Installationsanleitung Web CRM - Cobra CRM Software · 2016-11-17 · WebCRM werden die User des Active Directorys verwendet. Key: AdRootEntry wird das Active Directory-Verzeichnis

cobra Web CRM

8

ken notwendig sind. Der Datenbankbenutzer benötigt für die Datenbanken min-destens die Rechte des db_owner. Sie können natürlich auch die Windows-Authentifizierung 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.

Page 9: Installationsanleitung Web CRM - Cobra CRM Software · 2016-11-17 · WebCRM werden die User des Active Directorys verwendet. Key: AdRootEntry wird das Active Directory-Verzeichnis

cobra Web CRM

9

Active Directory-Anmeldung verwenden Von Web CRM 2010 ab PatchQ4 wird eine »einfache« Active Directory-Anmel-dung 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 vordefi-nierten cobra Benutzergruppen in der cobra Benutzerverwaltung mit einem Stan-dard-Kennwort angelegt. Web CRM liest die Benutzerattribute aus dem Active Di-rectory 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 Subdi-rektories ü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

Page 10: Installationsanleitung Web CRM - Cobra CRM Software · 2016-11-17 · WebCRM werden die User des Active Directorys verwendet. Key: AdRootEntry wird das Active Directory-Verzeichnis

cobra Web CRM

10

<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 »Ba-sic 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 einge-loggt.

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 er-folgen. Wird der Versand per Exchange Server gewählt, muss sichergestellt sein, dass auf dem Exchange Server das Outlook Web Access installiert ist. Des Weite-ren muss der »Netzwerkdienst« Zugriff auf den Exchange Server haben.

Der Versand per Exchange Server benötigt zwingend das Outlook Web Ac-cess auf dem Exchange Server!

Page 11: Installationsanleitung Web CRM - Cobra CRM Software · 2016-11-17 · WebCRM werden die User des Active Directorys verwendet. Key: AdRootEntry wird das Active Directory-Verzeichnis

cobra Web CRM

11

Soll der E-Mailversand des Web CRM über einen vorhandenen Exchange Server vorgenommen werden, müssen noch folgende Einstellungen in der web.config ge-troffen 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 ver-wendet wird.

<add key=”EmailSendMethod” value=”Exchange” /> Tragen Sie hier »Exchange« ein, um den Versand per Exchange Server zu akti-vieren. Mit dem Standardwert »Default« wird – wie gehabt – der lokale E-Mail-Client 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 Ab-sender 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 »Kon-figuration in der web.config«, Seite 26).

Page 12: Installationsanleitung Web CRM - Cobra CRM Software · 2016-11-17 · WebCRM werden die User des Active Directorys verwendet. Key: AdRootEntry wird das Active Directory-Verzeichnis

cobra Web CRM

12

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 da-von abweichen.

Ist schon ein IIS vorhanden, so überprüfen Sie die einzelnen Voraussetzun-gen (Asp.net, Applicationpool …) genau.

Start Wechseln Sie in die Systemsteuerung von Windows. Klicken Sie dort »Verwal-

tung« 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« mindes-tens die WebDAV-Veröffentlichung gesetzt ist.

Page 13: Installationsanleitung Web CRM - Cobra CRM Software · 2016-11-17 · WebCRM werden die User des Active Directorys verwendet. Key: AdRootEntry wird das Active Directory-Verzeichnis

cobra Web CRM

13

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 Lis-

te durch Klick mit der rechten Maustaste.

Im Kontextmenü wählen Sie den Eintrag »Anwendungspool hinzufügen …« o-der 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üs-sen Sie asp.net 4.0 herunterladen und installieren.

Page 14: Installationsanleitung Web CRM - Cobra CRM Software · 2016-11-17 · WebCRM werden die User des Active Directorys verwendet. Key: AdRootEntry wird das Active Directory-Verzeichnis

cobra Web CRM

14

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 »Netzwerk-dienste«. Sie können auch ein beliebiges anderes Konto auswählen.

Wir empfehlen, das voreingestellte »Netzwerkdienste« als Konto zu ver-wenden!

Das eingestellte Konto wird verwen-det:

beim Zugriff auf den SQL Server (allerdings nur, wenn per Windows Authentifizierung auf die Daten-banken zugegriffen wird) und

beim Zugriff auf das Dateisystem (z. B.: temporäre Dokumente an-legen, Dokumentenverwaltung, Log-Datei und für diverse Einstel-lungen im Adminbereich).

Bei 64-bit Systemen achten Sie darauf, dass 32-bit-Anwendungen in dem Pool erlaubt sind.

Page 15: Installationsanleitung Web CRM - Cobra CRM Software · 2016-11-17 · WebCRM werden die User des Active Directorys verwendet. Key: AdRootEntry wird das Active Directory-Verzeichnis

cobra Web CRM

15

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 Anwendungs-pool aus. Unter IIS7 wird die Verbindung zum Anwendungspool automatisch ein-gestellt. Evtl. muss der Anwendungspool noch konfiguriert werden.

Page 16: Installationsanleitung Web CRM - Cobra CRM Software · 2016-11-17 · WebCRM werden die User des Active Directorys verwendet. Key: AdRootEntry wird das Active Directory-Verzeichnis

cobra Web CRM

16

Geben Sie an, in welchem Verzeichnis die Dateien für die Website liegen und tra-gen Sie, wenn gewünscht, den Hostheader ein:

Diese Einstellungen können Sie später unter »Grundeinstellungen« oder »Bindun-gen« ändern.

Die weiteren Einstellungen einer Website entsprechen denen eines virtuellen Ver-zeichnisses und werden weiter unten erläutert.

Page 17: Installationsanleitung Web CRM - Cobra CRM Software · 2016-11-17 · WebCRM werden die User des Active Directorys verwendet. Key: AdRootEntry wird das Active Directory-Verzeichnis

cobra Web CRM

17

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 abge-bildeten 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 lie-gen.

Page 18: Installationsanleitung Web CRM - Cobra CRM Software · 2016-11-17 · WebCRM werden die User des Active Directorys verwendet. Key: AdRootEntry wird das Active Directory-Verzeichnis

cobra Web CRM

18

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 Anwen-dungspool aus.

Das Verzeichnis be-kommt im IIS das Welt-kugel-Symbol .

Sie sehen unter »Aktionen« die Rubrik »Anwendung bearbeiten« mit den Befehlen »Grundeinstellungen …« und »Erweiterte Einstellungen …«.

Page 19: Installationsanleitung Web CRM - Cobra CRM Software · 2016-11-17 · WebCRM werden die User des Active Directorys verwendet. Key: AdRootEntry wird das Active Directory-Verzeichnis

cobra Web CRM

19

Einstellungen der Website oder des virtuellen Verzeich-nisses Sie können die Einstellungen für Features einer Website oder eines virtuellen Ver-zeichnisses 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« zusammen-gefasst sind, werden aus der Web.Config des Web CRM ausgelesen. Die Einstel-lungen der Web.Config können mit dem IIS konfiguriert werden. Einige Einstellun-gen werden auch über den Administrationsbereich des Web CRM verwaltet.

Die Einstellungen zu den Features unter der Rubrik »IIS« entsprechen den Ein-stellungen 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 ausschal-ten. 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-80-using-aspnet-35-and-aspnet-45. Dort finden Sie eine genaue Beschreibung, wie unter Windows 2012 IIS installiert wird. Die für Web CRM spezifischen Einstellun-gen übernehmen Sie bitte aus der Beschreibung zu IIS auf Windows Server 2008.

Page 20: Installationsanleitung Web CRM - Cobra CRM Software · 2016-11-17 · WebCRM werden die User des Active Directorys verwendet. Key: AdRootEntry wird das Active Directory-Verzeichnis

cobra Web CRM

20

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 Ver-zeichnis 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 ein-binden 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«

Page 21: Installationsanleitung Web CRM - Cobra CRM Software · 2016-11-17 · WebCRM werden die User des Active Directorys verwendet. Key: AdRootEntry wird das Active Directory-Verzeichnis

cobra Web CRM

21

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 SQL-Berechtigung „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 Da-tenbank 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.NET-Anwendungsdienst 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 not-wendigen 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

Page 22: Installationsanleitung Web CRM - Cobra CRM Software · 2016-11-17 · WebCRM werden die User des Active Directorys verwendet. Key: AdRootEntry wird das Active Directory-Verzeichnis

cobra Web CRM

22

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.

Page 23: Installationsanleitung Web CRM - Cobra CRM Software · 2016-11-17 · WebCRM werden die User des Active Directorys verwendet. Key: AdRootEntry wird das Active Directory-Verzeichnis

cobra Web CRM

23

Die Bausteine des Web CRM

Einzelheiten finden Sie im Systemhandbuch zu Web CRM.

cobra Web CRM kann vom Systemverwalter aus einzelnen Elementen frei gestal-tet werden.

Welche Registerkarten zur Verfügung stehen, wird durch die Datei Layout.xml be-stimmt. 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.

Page 24: Installationsanleitung Web CRM - Cobra CRM Software · 2016-11-17 · WebCRM werden die User des Active Directorys verwendet. Key: AdRootEntry wird das Active Directory-Verzeichnis

cobra Web CRM

24

Widgets Widgets sind die funktionalen Bausteine des Web CRM. Sie können vom System-verwalter 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, wer-den 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 Bisher-Liste 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.

Page 25: Installationsanleitung Web CRM - Cobra CRM Software · 2016-11-17 · WebCRM werden die User des Active Directorys verwendet. Key: AdRootEntry wird das Active Directory-Verzeichnis

cobra Web CRM

25

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 einrich-ten« 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 sicht-bar, müssen Sie in ihm nach unten scrol-len.

Sie können Widgets zudem exportieren und danach über »Importiere Widgets« in der Ansicht unterbringen.

Page 26: Installationsanleitung Web CRM - Cobra CRM Software · 2016-11-17 · WebCRM werden die User des Active Directorys verwendet. Key: AdRootEntry wird das Active Directory-Verzeichnis

cobra Web CRM

26

Ein Widget exportieren/importieren Sie können Widgets auf Ihren lokalen PC exportieren und sie in eine andere An-sicht 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 vor-handenen Widgets.

Klicken Sie hier den Link »Importiere Widgets« an.

Page 27: Installationsanleitung Web CRM - Cobra CRM Software · 2016-11-17 · WebCRM werden die User des Active Directorys verwendet. Key: AdRootEntry wird das Active Directory-Verzeichnis

cobra Web CRM

27

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 »Hochla-den«.

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 An-sicht importiert. Sie können nun seine Eigenschaft und seine Position ändern.

Widgets positionieren

In den Widget-Eigenschaften bestimmen Sie, an welcher Stelle innerhalb der An-sicht das Widget stehen soll.

Klicken Sie

Die »Position« gibt an, an wievielter Stelle innerhalb des WebParts dieses Widget steht.

Page 28: Installationsanleitung Web CRM - Cobra CRM Software · 2016-11-17 · WebCRM werden die User des Active Directorys verwendet. Key: AdRootEntry wird das Active Directory-Verzeichnis

cobra Web CRM

28

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 le-send 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“ val-ue=“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

Page 29: Installationsanleitung Web CRM - Cobra CRM Software · 2016-11-17 · WebCRM werden die User des Active Directorys verwendet. Key: AdRootEntry wird das Active Directory-Verzeichnis

cobra Web CRM

29

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“/> Defaulteinstellung cobra CRMPlus <add key=“ApplicationType“ value=“Pro“/> Einstellung cobra CRMPro Dieser Key dient zur Einstellung des SecurityModells und sollte nur nach Rück-sprache 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.