1. Voraussetzungen

• Apache Tomcat
• MySql
• Java 1.5
• Apache Ant

2. Installation

• 2.1 Datenbank einrichten

  Um die Datenbank für Opencustomer zu auf dem MySql Server einzurichten steht das script create.sql zur verfügung. Dies importieren sie bitte in ihrer Datenbank. Dies tun sie z.B. mit:
  

  mysql -uUSERNAME -pPASSWORT -h DATENBANKSERVER DATENBANKNAME < create.sql

  oder mit einem Passenden Administrationswerkzeug.
  Danach sollten alle nötigen Tabellen in der Datenbank existieren.
  Jetzt müssen noch einige standart Inhalte in die Datenbank eingetragen werden. Hierfür steht das data.sql script zur Verfügung. Dieses spielen sie genau wie oben mit :

  mysql -uUSERNAME -pPASSWORT -h DATENBANKSERVER DATENBANKNAME < data.sql

  in ihre Datenbank ein.

• 2.2 Tomcat Server einrichten (binary)

  Für die binary Version von OpenCustomer steht zur Zeit noch kein Installationsscript zur Verfügung, so das der Tomcat Server manuell für die Benutzung von OpenCustomer konfiguriert werden muss.
  Als erstes fügen sie in die server.xml im conf Verzeichniss des Tomcat Servers folgende Context Konfiguration ein. (Achten sie darauf das die Context Konfiguration direkt unterhalb des öffnenden <Context< Tags eingefügt wird.)
  Konfiguration:
  

  <Context path="/opencustomer" docBase="opencustomer"
  debug="5" reloadable="true" crossContext="true">
  
  <Realm className="org.apache.catalina.realm.JAASRealm"
  appName="oc_login"
  userClassNames="org.apache.slide.jaas.spi.SlidePrincipal"
  roleClassNames="org.apache.slide.jaas.spi.SlideRole"
  name="OpenCustomer DAV Server"
  useContextClassLoader="false" />
  
  <Resource name="jdbc/opencustomer" auth="Container" type="javax.sql.DataSource"
  maxActive="50" maxIdle="10" maxWait="5000"
  username="DBUSER" password="DBPASSWORD" driverClassName="org.gjt.mm.mysql.Driver"
  url="jdbc:mysql://127.0.0.1:3306/DATENBANK?useUnicode=true&characterEncoding=UTF-8"/>
  </Context>
  

  In dieser Konfiguration wird auch die Konfiguration des Datenbankservers vorgenommen (DBUSER, DBPASSWORD, DATENBANK).
  Jetzt benötigen sie noch das mysql-connector.jar. Dieses wird verwendet um den Datenbankzugriff zu ermöglichen. Kopieren sie dieses jar File nach /common/endorsed in ihrem Tomcat Verzeichniss.
  
  Wenn sie keinen Webdav Kalender Zugriff nutzen möchten so ist die Konfiguration jetzt abgeschlossen. Für den Webdav Zugriff empfehlen wir die Source Version von OpenCustomer da diese Version einen ant task beinhaltet, der die Konfiguration des Tomcat Server für diesen Zweck durchführt.

• 2.3 Opencustomer Einrichten (binary)

  Wenn sie die Dantenbank und die benötigte Software eingerichtet haben kopieren sie bitte die Datei opencustomer.war in ihr webapps verzeichnis des Tomcat Servers. Nun wird der Tomcat Server gestartet, und OpenCustomer steht unter http://ihrserver:8080/opencustomer zur Verfügung. Der Benutzer admin (passwort: admin) ist standartmässig eingerichtet.

• 2.4 Opencustomer Einrichten (source)

  Um OpenCustomer aus den Source Dateien zu installieren, laden sie sich bitte die opencustomer_xx_src.zip herunter. Jetzt müssen sie die build.properties an ihr System anpassen, ändern sie bitte folgende Punkte:
  

  # Tomcat Home
  server.root=PATH_TO_TOMCATHOME
  
  

  Wenn sie dies getan haben, rufen sie in dem Verzeichnis in dem sie OpenCustomer entpackt haben, ant tomcat_install auf. Dieser Task Konfiguriert ihren Tomcat Server für die Benutzung von OpenCustomer. Danach können sie mit ant deploy OpenCustomer installieren.
  Wenn dieser Vorgang beendet ist, starten sie den Tomcat Server. Danach steht OpenCustomer unter http://IHRSERVER:8080/opencustomer zur Verfügung. Der Benutzer admin (passwort: admin) ist standartmässig eingerichtet.

3. Administration

• 3.1 Benutzer anlegen

  Um einen Benutzer für das OpenCustomer anzulegen, melden sie sich als Admin bei OpenCustomer an. Jetzt gehen sie oben in der Menüleiste auf System. Jetzt wählen sie links in dem Menü Benutzerverwaltung. Hier können sie nun einen neuen Beutzer anlegen.
  Sie sollten sich hier einen Benutzer anlegen, und sich hinterher mit diesem Benutzer bei OpenCustomer anmelden.
  
  

• 3.2 Person zuordnen

  Jedem Benutzer kann eine Person zugeordnet werden. Wenn der Benutzer nun einen neuen Kontakt hinzufügt wird automatisch diese Person zu dem Kontakt hinzugefügt. Diese Einstellungen werden auch in der Benutzerverwaltung eingestellt.

• 3.3 Benutzer Sperren

  Über die Benutzerverwalrung können einzelne Benutzer gesperrt werden. Diese benutzer können sich dann nicht mehr bei OpenCustomer anmelden.
  Sie sollten den standart Admin account hier sperren, damit es nicht möglich ist sich mit dem standart benutzer und Passwort anzumelden.
  Achten sie dabei darauf, das es nicht möglich ist sich selbst zu sperren.
  

• 3.4 Rollen

  Jeder Benutzer innerhalb von OpenCustomer bekommt eine Rolle zugewiesen. Diese Rolle bestimmt welche Zugriffsrechte der Benutzer hat.
  Beim Erstellen eines Benutzers können sie dem neuen Benutzer eine Rolle zuweisen.
  Innerhalb der Benutzerverwaltung können sie auch neue Rollen anlegen, und dieser bestimmte Rechte zuweisen. Dafür wählen sie in der Benutzerveraltung oben rechts "Rolle" aus.
  

• 3.5 Gruppen

  Die Benutzer im System können in Gruppen organisiert werden. Jeder Benutzer bekommt dabei eine Hauptgruppe, und evetuell noch weitere Gruppen.
  Anhand dieser Gruppen kann der Zugriff auf die einzelnden Kalender der Benutzer geregelt werden.
  

4. CRM

• 4.1 Personen anlegen/bearbeiten

  Um eine Person anzulegen, begeben sie sich auf die Personen Übersichtsseite, und klicken auf .
  Nun tragen sie die die Personendaten ein.
  Wenn sie in dem Formula auf klicken, können sie die Person einem Unternehmen, das bereits angelegt wurde, zuordnen. Mit einem Klick auf "Speichern" werden die Daten übernommen.
  
  Um die Daten eines Existierenden Benutzers zu bearbeiten, wählen sie auf der Übersichttsseite den entsprechenden Benutzer aus und tragen die neuen Daten ein. Von diesem Menü kommen sie durch direkt zu dem zugeordneten Unternehmen.
  Übernommen werden die Daten wieder mit "Speichern".

• 4.2 Unternehmen

  Um ein Unternehmen anzulegen, begeben sie sich azf die Unternehmen Übersichtsseite, und klicken auf .
  Nun tragen sie die die Unternehmensdaten ein.
  Mit einem Klick auf "Speichern" werden die Daten übernommen.
  
  Um die Daten eines existierenden Unternehmens zu bearbeiten, wählen sie auf der Übersichttsseite das entsprechende Unternehmen aus und tragen die neuen Daten ein. Im Untermenü finden sie alle Personen die diesem Unternehmen zugeordnet sind, und können durch einen klick auf direkt zu der Person gelangen.
  Übernommen werden die Daten wieder mit "Speichern".

• 4.3 Kontakt

  Um einen Kundenkontakt anzulegen und zu verwalten, wählen sie bitte das Unternehmen mit dem sie den Kontakt haben aus, und wählen dann "Kontakt". Hier können sie nun mit die Person des Unternehmens auswählen mit der sie in Kontakt stehen. Nachdem sie die weiteren Daten eingetragen haben können brauche sie die Daten nur noch "Speichern".

• 4.6 Suchen

  Über die Verschiedenen Suchfelder können sie sowohl die Personendaten wie auch die Kundendaten nach Begriffen, Namen, usw. durchsuchen. Dabei ist auch die benutzung von Wildcards wie * möglich.

5. Kalender

• 5.1 Termine anlegen

  Wählen sie als erstes oben im Menü den Kalender aus. Danach können sie mit dem "Plus" oben rechts ¨ber dem Kalender einen Neuen Termin anlegen. Ein Termin kann dabei einem Zeitraum zugeordnet werden, oder dem ganzen Tag zugewiesen werden.

• 5.2. Terminwiederholung

  Termine die sich regelmässig wiederholen können mit der Wiederholfunktion angelegt werden.
  Um eine Terminwiederholung anzulegen, legen sie als erste einen neuen Termin an, und wählen dann den Reiter Wiederholung aus. Hier können sie dann die Wiederholung genau konfigurieren.

• 5.3. Rechte

  Ein Kalender kann von mehreren Benutzern eingesehen, und verändert werden. Hierfür können spezielle Rechte für jeden Kalender vergeben werden. Die Globalen Kalender Zugriffsrechte können sie in den Einstellungen von ihrem Kalender vornehmen.
  Es können Rechte für alle, sowie für eine Benutzergruppe vergeben werden. Es stehen die Rechte "keine", "lesen" und "schreiben" zur Verfügung.
  
  Darüber hinaus können für jeden Kalendereintrag noch extra Rechte vergeben werden. Hierfür legen sie einen neuen Termin an, und finden dann unter dem Reiter "Rechte" die Möglichkeit die Rechte dieses Kalendereintrags zu ändern.
  

• 5.4. Fremde Kalender

  Unterhalb des eigenen Kalenders werden die Kalender der anderen Benutzer angezeigt. Je nachdem wie der Benutzer die Rechte für seinen Kalender gesetzt hat, kann man auf diese Kalender lesend oder schreibend zugreifen.