Handbuch zum OpenEstate-ImmoTool - Index of

Transcription

Handbuch zum OpenEstate-ImmoTool - Index of
Handbuch zum OpenEstate-ImmoTool
Walter Wagner
Andreas Rudolph
Handbuch zum OpenEstate-ImmoTool
von Walter Wagner und Andreas Rudolph
Inhaltsverzeichnis
Vorwort ......................................................................................................................... xiii
1. Erste Schritte ................................................................................................................. 1
1.1. Java installieren ................................................................................................... 3
Hinweise zur Java-Installation ............................................................................... 3
Test der Java-Installation ..................................................................................... 4
1.2. Dateien herunterladen ............................................................................................ 6
Add-Ons / Erweiterungen ..................................................................................... 6
Geodaten im XML-Format ................................................................................... 7
1.3. ImmoTool in Betrieb nehmen ................................................................................. 8
ImmoTool installieren ......................................................................................... 8
EXE-Installation ......................................................................................... 8
PKG.ZIP-Installation ................................................................................... 9
JAR-Installation ......................................................................................... 9
ZIP-Archiv .............................................................................................. 10
TAR.GZ-Archiv ........................................................................................ 10
ImmoTool starten .............................................................................................. 10
ImmoTool unter Windows starten ................................................................ 10
ImmoTool unter MacOS X starten ............................................................... 11
ImmoTool unter Linux/Unix starten ............................................................. 11
Der erste Programmstart des ImmoTools ............................................................... 12
1.4. Server in Betrieb nehmen ..................................................................................... 13
Server installieren ............................................................................................. 13
Server starten ................................................................................................... 13
Server mit start.exe starten ......................................................................... 14
Server mit start.app starten ......................................................................... 14
Server mit start.sh starten ........................................................................... 15
Server durch direkten Aufruf von Java starten ................................................ 15
Verbindungsaufbau via AdminTool ....................................................................... 16
AdminTool unter Windows starten. .............................................................. 16
AdminTool unter Mac OS X starten. ............................................................ 16
AdminTool unter Linux/Unix starten. ........................................................... 16
AdminTool am Server anmelden ................................................................. 17
Erste Einstellungen im Projekt .................................................................... 19
Verbindungsaufbau via ImmoTool ........................................................................ 19
Verbindung zu einem Mehrplatz-Projekt erzeugen ........................................... 19
Verbindung zu einem Mehrplatz-Projekt öffnen .............................................. 20
2. Anwenderhandbuch ....................................................................................................... 22
2.1. Allgemein .......................................................................................................... 26
Benutzeroberfläche ............................................................................................ 26
Das Programmfenster ................................................................................ 26
Verwendung von Tabellen .......................................................................... 27
Verwendung von Formularen ...................................................................... 28
Projekte ........................................................................................................... 28
Unternehmensprofil ................................................................................... 28
Benutzerprofil .......................................................................................... 30
Einstellungen ........................................................................................... 30
Fragen & Antworten ................................................................................. 30
Projektassistent ................................................................................................. 31
Ein neues Projekt erzeugen ......................................................................... 31
Ein existierendes Projekt öffnen .................................................................. 33
Zuletzt verwendetes Projekt öffnen .............................................................. 33
iii
Handbuch zum OpenEstate-ImmoTool
Einstellungen ...................................................................................................
Netzwerk-Einstellungen ..............................................................................
Datenbank-Einstellungen ............................................................................
Speichern ................................................................................................
Add-Ons / Module ............................................................................................
Add-Ons installieren / deinstallieren .............................................................
Add-Ons aktualisieren ...............................................................................
Add-Ons aktivieren / deaktivieren ................................................................
Aktualisierungen ...............................................................................................
automatische Aktualisierung .......................................................................
manuelle Aktualisierung .............................................................................
Datenbank .......................................................................................................
Automatische Datenbanksicherung ...............................................................
Manuelle Datenbanksicherung .....................................................................
Datenbank wiederherstellen ........................................................................
Zertifikate ........................................................................................................
Prüfung eines SSL-Zertifikates ....................................................................
Verwaltung der SSL-Zertifikate ...................................................................
Protokolle ........................................................................................................
Protokoll speichern ....................................................................................
Nutzungslizenz .................................................................................................
OpenEstate-Lizenz ....................................................................................
Fremde Modul-Lizenzen ............................................................................
2.2. Immobilien ........................................................................................................
Immobilien verwalten ........................................................................................
Filterkriterien verwenden ............................................................................
Aktionen ausführen ...................................................................................
Immobilien durchsuchen ............................................................................
Immobilie bearbeiten .........................................................................................
Allgemeine Eckdaten .................................................................................
Spezifikation der Immobilie ........................................................................
Freitexte & Beschreibungen ........................................................................
Fotos und Dateien .....................................................................................
Kontaktperson ..........................................................................................
Exporte ...................................................................................................
Adressen .................................................................................................
Kalender ..................................................................................................
Notizen ...................................................................................................
Änderungen Speichern ...............................................................................
Immobilien exportieren ......................................................................................
Exportvorgang ..........................................................................................
Schnittstelle anlegen ..................................................................................
Schnittstellenkonfiguration importieren .........................................................
Schnittstelle bearbeiten ..............................................................................
Schnittstelle (de)aktivieren ..........................................................................
Schnittstelle löschen ..................................................................................
Immobilien importieren ......................................................................................
Immobilien aus einer Datei importieren ........................................................
Immobilien aus einer vorhandenen Maklersoftware importieren .........................
Ansprechpartner verwalten .................................................................................
Filterkriterien verwenden ............................................................................
Aktionen ausführen ...................................................................................
Ansprechpartner bearbeiten .................................................................................
Personendaten ..........................................................................................
iv
33
34
34
34
35
35
36
37
37
37
37
37
38
38
38
39
39
40
41
41
41
42
42
43
44
44
44
45
46
46
48
50
50
51
52
53
55
57
57
58
58
59
63
64
64
64
64
65
66
67
68
68
68
69
Handbuch zum OpenEstate-ImmoTool
Betreute Immobilien ..................................................................................
Notizen ...................................................................................................
Änderungen speichern ................................................................................
Suchanfragen verwalten .....................................................................................
Aktionen ausführen ...................................................................................
Suchanfrage bearbeiten ......................................................................................
Eckdaten bearbeiten ..................................................................................
Kriterien bearbeiten ...................................................................................
Adressen zuweisen ....................................................................................
Einstellungen ...................................................................................................
Agentur ...................................................................................................
Sprachen .................................................................................................
PDF-Langexposé (Standardvorlage) ..............................................................
PDF-Kurzexposé (Standardvorlage) ..............................................................
Fragen & Antworten .........................................................................................
2.3. Adressbuch ........................................................................................................
Adressen verwalten ...........................................................................................
Adresse erzeugen ......................................................................................
Adresse bearbeiten ....................................................................................
Adresse löschen ........................................................................................
Adressformular .................................................................................................
Allgemeine Angaben zur Adresse (Reiter Anschrift) ........................................
Weitere Angaben zur Adresse (Reiter Details) ................................................
Verknüpfte Immobilien (Reiter Immobilien) ..................................................
Verknüpfte Kalendereinträge (Reiter Kalender) ..............................................
Bemerkungen zur Adresse (Reiter Notizen) ...................................................
Speichern ................................................................................................
Adressgruppen ..................................................................................................
Adressgruppe anlegen ................................................................................
Adressgruppe bearbeiten ............................................................................
Adressgruppe löschen ................................................................................
Adressgruppenformular ......................................................................................
Allgemeine Angaben .................................................................................
Speichern ................................................................................................
2.4. Kalender ...........................................................................................................
Kalendereinträge ...............................................................................................
Kalendereintrag anlegen .............................................................................
Kalendereintrag bearbeiten .........................................................................
Kalendereintrag löschen .............................................................................
Kalendereintragsformular Termin .........................................................................
Termin anlegen / bearbeiten ........................................................................
Einstellungen ...................................................................................................
2.5. E-Mails .............................................................................................................
E-Mailkonten ...................................................................................................
Allgemeine Angaben .................................................................................
Empfang via IMAP ...................................................................................
Empfang via POP3 ...................................................................................
Versand via SMTP ....................................................................................
Mailordner zuweisen .................................................................................
Erweiterte Einstellungen .............................................................................
E-Mails lesen ...................................................................................................
Ordner-Ansicht .........................................................................................
Nachrichten-Ansicht ..................................................................................
E-Mails senden .................................................................................................
v
69
69
70
70
70
71
71
72
73
74
74
75
75
76
77
79
80
80
80
80
81
81
81
81
82
82
82
83
83
83
84
84
84
84
85
86
86
86
87
87
87
87
88
89
89
90
91
92
93
94
95
95
96
97
Handbuch zum OpenEstate-ImmoTool
Empfänger bearbeiten ................................................................................ 98
Nachrichtentext eingeben ........................................................................... 99
Anhänge verwalten .................................................................................. 101
Nachricht senden ..................................................................................... 101
Entwurf speichern ................................................................................... 101
Adressen verknüpfen ....................................................................................... 101
Mailversand via Adressbuch ...................................................................... 102
Adressauswahl beim Mailversand ............................................................... 103
Adressen mit E-Mail verknüpfen ................................................................ 103
Fragen & Antworten ........................................................................................ 104
2.6. Nachrichten ...................................................................................................... 106
Nachrichtenquellen .......................................................................................... 106
3. Administratorhandbuch ................................................................................................. 107
3.1. Hinweise zum AdminTool .................................................................................. 110
Allgemein ...................................................................................................... 110
Programmstart ........................................................................................ 110
Verbindungsaufbau .................................................................................. 110
Werkzeugleiste ....................................................................................... 111
Firmendaten bearbeiten .................................................................................... 111
Add-Ons bearbeiten ......................................................................................... 112
Installierte Add-Ons ................................................................................. 112
Aktualisierungen ..................................................................................... 113
Benutzer verwalten .......................................................................................... 114
Eckdaten des Benutzers bearbeiten ............................................................. 115
Personendaten bearbeiten .......................................................................... 116
Gruppen zuweisen ................................................................................... 117
Berechtigungen erteilen ............................................................................ 117
Gruppen verwalten .......................................................................................... 118
Eckdaten der Gruppe bearbeiten ................................................................. 119
Benutzer zuweisen ................................................................................... 119
Berechtigungen erteilen ............................................................................ 120
Roh-Inhalte der Datenbank anzeigen ................................................................... 120
SQL-Befehle auf der Datenbank ausführen .......................................................... 120
3.2. Hinweise zum ImmoTool ................................................................................... 122
Programmstart ................................................................................................ 122
Startdateien ............................................................................................ 122
Parameter ............................................................................................... 122
3.3. Hinweise zum Server ......................................................................................... 123
Programmstart ................................................................................................ 123
Startdateien ............................................................................................ 123
Konfiguration ......................................................................................... 124
Windows-Dienst einrichten ............................................................................... 125
Dienst im Betriebssystem (de)installieren ..................................................... 125
Dienst automatisch starten & stoppen .......................................................... 125
Dienst mit Hilfsskripten starten/stoppen ....................................................... 128
Mac-Dienst einrichten ...................................................................................... 128
Dienst im Betriebssystem registrieren ......................................................... 129
Dienst aus dem Betriebssystem entfernen .................................................... 129
Dienst via Terminal starten ....................................................................... 130
Dienst via Terminal stoppen ...................................................................... 130
Unix-Dienst einrichten ..................................................................................... 131
Einrichtung des Dienstes vorbereiten .......................................................... 131
Dienst im Betriebssystem registrieren ......................................................... 131
Dienst aus dem Betriebssystem entfernen .................................................... 131
vi
Handbuch zum OpenEstate-ImmoTool
Dienst via Konsole starten ........................................................................
Dienst via Konsole stoppen .......................................................................
SSL-Verschlüsselung .......................................................................................
Erzeugung eines SSL-Zertifikates ...............................................................
Konfiguration der SSL-Verschlüsselung ......................................................
SSL-Verschlüsselung im ImmoTool / AdminTool aktivieren ............................
Datenbank sichern & wiederherstellen .................................................................
Datensicherung eines inaktiven ImmoTool-Servers ........................................
Datensicherung eines laufenden ImmoTool-Servers .......................................
Wiederherstellung der gesicherten Daten .....................................................
Aktualisierungen durchführen ............................................................................
Einzelplatz-Projekt importieren ..........................................................................
Einzelplatz-Projekt exportieren ..........................................................................
Mehrere Datenbanken einrichten ........................................................................
Administrator-Passwort zurücksetzen ..................................................................
4. Anhang ......................................................................................................................
4.A. Übernahme eines alten Projektes in ImmoTool 1.0 ..................................................
4.B. E-Mailanbieter .................................................................................................
E-Mailempfang via IMAP .................................................................................
E-Mailempfang via POP3 .................................................................................
E-Mailversand via SMTP .................................................................................
4.C. Support ...........................................................................................................
Supportfälle ....................................................................................................
Supportwege ...................................................................................................
Forum ...................................................................................................
Ticketsystem ..........................................................................................
4.D. Nutzungslizenz .................................................................................................
14. Systemanforderungen ..................................................................................................
Glossar ..........................................................................................................................
vii
132
132
133
133
135
136
138
138
138
139
139
140
141
142
142
144
146
149
149
149
150
151
151
151
151
151
152
154
155
Abbildungsverzeichnis
1.1.1. Ausgabe der Java-Version auf der Kommandozeile .......................................................... 4
1.1.2. Java-Symbol in der Windows-Systemsteuerung ............................................................... 4
1.1.3. Das Java-Control-Panel unter Windows ......................................................................... 5
1.1.4. Information zur Java-Version unter Windows .................................................................. 5
1.3.1. Verknüpfung auf dem Desktop ................................................................................... 10
1.3.2. Verknüpfung im Startmenü ........................................................................................ 10
1.3.3. ImmoTool unter Mac OS X starten ............................................................................. 11
1.4.1. ImmoTool-Server unter Windows starten (Schritt 1) ....................................................... 14
1.4.2. ImmoTool-Server unter Windows starten (Schritt 2) ....................................................... 14
1.4.3. ImmoTool-Server unter Mac OS X starten (Schritt 1) ...................................................... 15
1.4.4. ImmoTool-Server unter Mac OS X starten (Schritt 2) ...................................................... 15
1.4.5. Anmeldung am ImmoTool-Server via AdminTool .......................................................... 17
1.4.6. Administrator-Passwort bei der ersten Anmeldung am ImmoTool-Server angeben ................. 18
1.4.7. Installation der Datenbank bei der ersten Anmeldung am ImmoTool-Server ......................... 18
1.4.8. Firmendaten im AdminTool bearbeiten ......................................................................... 19
1.4.9. ImmoTool mit Mehrplatz-Projekt verbinden (Schritt 1) ................................................... 19
1.4.10. ImmoTool mit Mehrplatz-Projekt verbinden (Schritt 2) .................................................. 20
1.4.11. Mehrplatz-Projekt öffnen (Variante 1) ........................................................................ 21
1.4.12. Mehrplatz-Projekt öffnen (Variante 2) ........................................................................ 21
1.4.13. Anmeldung am Mehrplatz-Projekt ............................................................................. 21
2.1.1. Programmfenster des ImmoTools ................................................................................ 26
2.1.2. Firmenprofil ............................................................................................................ 29
2.1.3. Projekt-Asssistent / Eigenschaften des Projektes ............................................................. 32
2.1.4. Projekt-Asssistent / Firmendaten des Projektes ............................................................... 32
2.1.5. Projekt-Asssistent / Aktivierte Add-Ons ........................................................................ 33
2.1.6. Allgemeine-Einstellungen .......................................................................................... 34
2.1.7. Add-On-Verwaltung aufrufen ..................................................................................... 35
2.1.8. Add-Ons-Verwaltung ................................................................................................ 35
2.1.9. Aktualisierungen aufrufen .......................................................................................... 37
2.1.10. Menü Datenbank .................................................................................................... 38
2.1.11. Details eines SSL-Zertifikates ................................................................................... 39
2.1.12. Verwaltung der SSL-Zertifikate ................................................................................. 40
2.1.13. Einstellungen ......................................................................................................... 41
2.1.14. Lizenz verwalten .................................................................................................... 42
2.1.15. Eingabe des Lizenzschlüssels .................................................................................... 42
2.2.1. Menüeintrag der Immobilienverwaltung ........................................................................ 43
2.2.2. Untermenü zum Erzeugen neuer Einträge in der Immobilienverwaltung .............................. 43
2.2.3. Ansichtsbereich der Immobilienverwaltung ................................................................... 44
2.2.4. Immobilienübersicht ................................................................................................. 44
2.2.5. Aktionsmenü in der Immobilienübersicht ...................................................................... 45
2.2.6. Immobilienbestand durchsuchen .................................................................................. 46
2.2.7. Immobilienformular Eckdaten ..................................................................................... 48
2.2.8. Immobilientyp definieren ........................................................................................... 49
2.2.9. Attribute eingeben .................................................................................................... 49
2.2.10. Attribute mit Mehrfachauswahl ................................................................................. 49
2.2.11. Bilder zur Immobilie importieren ............................................................................... 51
2.2.12. Kontaktperson angeben ............................................................................................ 52
2.2.13. Exporthistorie zu dieser Immobilie ............................................................................. 53
2.2.14. Exportschnittstellen verknüpfen ................................................................................. 53
2.2.15. Zugeordnete Adressen zu dieser Immobilie .................................................................. 54
2.2.16. Neue Adresse zu dieser Immobilie ............................................................................. 54
viii
Handbuch zum OpenEstate-ImmoTool
2.2.17. Vorhandene Adresse mit dieser Immobilie verknüpfen ................................................... 55
2.2.18. Zugeordnete Termine dieser Immobilie ....................................................................... 56
2.2.19. Neue Aufgabe zu dieser Immobilie ............................................................................ 56
2.2.20. Neuer Termine zu dieser Immobilie ........................................................................... 56
2.2.21. Vorhandene Termine mit dieser Immobilie verknüpfen .................................................. 57
2.2.22. Vorhandene Termine mit dieser Immobilie verknüpfen .................................................. 57
2.2.23. Schnittstellenübersicht ............................................................................................. 58
2.2.24. Exportübersicht ...................................................................................................... 59
2.2.25. allgemeine Einstellungen .......................................................................................... 60
2.2.26. FTP-Schnittstelle einrichten ...................................................................................... 61
2.2.27. HTTP-Schnittstelle einrichten ................................................................................... 62
2.2.28. Format-Optionen .................................................................................................... 63
2.2.29. Menü Immobilien importieren ................................................................................... 65
2.2.30. Menü Immobilien importieren ................................................................................... 66
2.2.31. Ansprechpartnerübersicht ......................................................................................... 68
2.2.32. Aktionsmenü in der Ansprechpartnerübersicht .............................................................. 68
2.2.33. Personendaten der Kontaktperson .............................................................................. 69
2.2.34. Betreute Immobilien der Kontaktpersonen ................................................................... 69
2.2.35. Notizen (Reiter Notizen) .......................................................................................... 70
2.2.36. Suchanfrageübersicht ............................................................................................... 70
2.2.37. Aktionsmenü in der Suchanfrageübersicht ................................................................... 71
2.2.38. Eckdaten einer Suchanfrage bearbeiten ....................................................................... 72
2.2.39. Als Favorit markierte Suchanfrage ............................................................................. 72
2.2.40. Kriterien einer Suchanfrage bearbeiten ....................................................................... 73
2.2.41. Auswahl eines Suchkriteriums .................................................................................. 73
2.2.42. Kriterien einer Suchanfrage bearbeiten ....................................................................... 74
2.3.1. Menüeintrag des Adressbuches ................................................................................... 79
2.3.2. Untermenü zum Erzeugen neuer Einträge im Adressbuch ................................................. 79
2.3.3. Ansichtsbereich des Adressbuches ............................................................................... 79
2.3.4. Adressenübersicht ..................................................................................................... 80
2.3.5. Adressenübersicht ..................................................................................................... 81
2.3.6. Verknüpfte Immobilien ............................................................................................. 82
2.3.7. Verknüpfter Kalendereintrag ...................................................................................... 82
2.3.8. Adressgruppenübersicht ............................................................................................. 83
2.3.9. Adressgruppenformular ............................................................................................. 84
2.4.1. Menüeintrag des Kalenders ........................................................................................ 85
2.4.2. Untermenü zum Erzeugen neuer Einträge im Kalender .................................................... 85
2.4.3. Ansichtsbereich des Kalenders .................................................................................... 86
2.5.1. Menüeintrag der Mailverwaltung ................................................................................. 88
2.5.2. Ansichtsbereich der Mailverwaltung ............................................................................ 88
2.5.3. Dialogfenster zur Verwaltung der E-Mailkonten ............................................................. 89
2.5.4. Allgemeine Einstellungen eines E-Mailkontos ............................................................... 90
2.5.5. IMAP-Einstellungen eines E-Mailkontos ...................................................................... 91
2.5.6. POP3-Einstellungen eines E-Mailkontos ....................................................................... 92
2.5.7. SMTP-Einstellungen eines E-Mailkontos ...................................................................... 93
2.5.8. Ordner-Einstellungen eines E-Mailkontos ..................................................................... 94
2.5.9. Erweiterte Einstellungen eines E-Mailkontos ................................................................. 95
2.5.10. Inhalt eines E-Mailordners anzeigen ........................................................................... 96
2.5.11. E-Mail in HTML-Ansicht ........................................................................................ 97
2.5.12. Formular zum Verfassen einer E-Mail-Nachricht .......................................................... 98
2.5.13. E-Mail als Text-Nachricht erstellen ............................................................................ 99
2.5.14. E-Mail als HTML-Nachricht erstellen ....................................................................... 100
2.5.15. Verfahrensweisen zum E-Mailversand ...................................................................... 100
2.5.16. Übersicht zugewiesener E-Mails im Adressformular .................................................... 102
ix
Handbuch zum OpenEstate-ImmoTool
2.5.17. E-Mail aus dem Adressbestand verfassen ..................................................................
2.5.18. Adressen beim Verfassen einer E-Mail verknüpfen ......................................................
2.5.19. Adressen mit einer bestehenden E-Mail verknüpfen .....................................................
2.6.1. Ansichtsbereich der Nachrichtenverwaltung .................................................................
3.1.1. Verbindungsaufbau via AdminTool ............................................................................
3.1.2. Verbindungsaufbau via AdminTool durch Auswahl eines Projektes ..................................
3.1.3. Verbindungsaufbau via AdminTool durch direkte Eingabe der Serverdaten ........................
3.1.4. Werkzeugleiste im AdminTool ..................................................................................
3.1.5. Firmendaten im AdminTool bearbeiten .......................................................................
3.1.6. Installierte Add-Ons im AdminTool bearbeiten ............................................................
3.1.7. Aktualisierungen der Add-Ons im AdminTool bearbeiten ...............................................
3.1.8. Benutzerkonten im AdminTool bearbeiten ...................................................................
3.1.9. Benutzerkonto im AdminTool bearbeiten (Eckdaten) .....................................................
3.1.10. Benutzerkonto im AdminTool bearbeiten (Personendaten) ............................................
3.1.11. Benutzerkonto im AdminTool bearbeiten (Gruppen zuweisen) .......................................
3.1.12. Benutzerkonto im AdminTool bearbeiten (Berechtigungen zuweisen) ..............................
3.1.13. Benutzergruppen im AdminTool bearbeiten ...............................................................
3.1.14. Benutzergruppe im AdminTool bearbeiten (Eckdaten) ..................................................
3.1.15. Benutzergruppe im AdminTool bearbeiten (Mitglieder zuweisen) ...................................
3.1.16. Benutzergruppe im AdminTool bearbeiten (Berechtigungen zuweisen) ............................
3.1.17. Roh-Inhalte der Datenbank im AdminTool anzeigen ....................................................
3.1.18. SQL-Befehle im AdminTool ausführen .....................................................................
3.3.1. Server als Windows-Dienst verwalten (Schritt 1) ..........................................................
3.3.2. Server als Windows-Dienst verwalten (Schritt 2) ..........................................................
3.3.3. Server als Windows-Dienst verwalten (Schritt 3) ..........................................................
3.3.4. Server als Windows-Dienst verwalten (Schritt 4) ..........................................................
3.3.5. Systembenutzer für den Windows-Dienst auswählen .....................................................
3.3.6. Passwort zur Absicherung der SSL-Schlüssel wählen ....................................................
3.3.7. Name des abzusichernden Servers angeben („Common Name“) .......................................
3.3.8. Weitere Details zum SSL-Schlüssel angeben ................................................................
3.3.9. Passwort zur Absicherung der SSL-Schlüssels angeben ..................................................
3.3.10. Zertifikat zum SSL-Schlüssel exportieren ..................................................................
3.3.11. Verschlüsselung beim Erzeugen eines Projektes aktivieren ............................................
3.3.12. Verschlüsselung beim Öffnen eines Projektes aktivieren ...............................................
3.3.13. Verschlüsselung im AdminTool aktivieren .................................................................
4.A.1. Automatische Aktualisierung vor Durchführung der Datensicherung ................................
4.A.2. Sicherung aus dem alten ImmoTool erzeugen ..............................................................
4.A.3. Datensicherung als Einzelplatz-Projekt importieren (Schritt 1) ........................................
4.A.4. Datensicherung als Einzelplatz-Projekt importieren (Schritt 2) ........................................
4.A.5. Datensicherung als Mehrplatz-Projekt importieren (Variante 1) .......................................
4.A.6. Datensicherung als Mehrplatz-Projekt importieren (Variante 2) .......................................
147. IP-Adresse unter Windows ermitteln (Schritt 1) .............................................................
148. IP-Adresse unter Windows ermitteln (Schritt 2) .............................................................
149. IP-Adresse unter Windows ermitteln (Schritt 3) .............................................................
150. IP-Adresse unter Mac/Linux/Unix ermitteln ..................................................................
151. Kommandozeile unter Windows starten (Schritt 1) .........................................................
152. Kommandozeile unter Windows starten (Schritt 2) .........................................................
153. Kommandozeile unter Windows starten (Schritt 3) .........................................................
154. Kommandozeile unter Mac OS X starten (Schritt 1) ........................................................
155. Kommandozeile unter Mac OS X starten (Schritt 2) ........................................................
156. TAR.GZ-Archiv unter Mac OS X entpacken .................................................................
157. ZIP-Archiv unter Mac OS X entpacken ........................................................................
x
102
103
104
106
110
111
111
111
112
113
114
115
116
117
117
118
118
119
119
120
120
121
126
126
127
127
128
133
134
134
134
135
137
137
137
146
146
147
147
148
148
156
156
157
157
158
158
159
159
159
161
163
Tabellenverzeichnis
1.2.1. Add-Ons mit Programmfunktionen ................................................................................ 6
1.2.2. Add-Ons mit Übersetzungen ........................................................................................ 6
1.4.1. Einrichtung einer Verbindung zum ImmoTool-Server via AdminTool ................................. 17
1.4.2. Einrichtung einer Verbindung zum ImmoTool-Server via ImmoTool .................................. 20
2.5.1. Häufig verwendete Ports für IMAP-Verbindungen .......................................................... 91
2.5.2. Häufig verwendete Ports für POP3-Verbindungen .......................................................... 92
2.5.3. Häufig verwendete Ports für SMTP-Verbindungen ......................................................... 93
2.5.4. Arten von E-Mailansichten ........................................................................................ 96
2.5.5. Arten von E-Mailempfängern ..................................................................................... 98
2.5.6. Verfahrensweisen zum E-Mailversand ........................................................................ 100
3.2.1. Parameter zum ImmoTool-Programmstart ................................................................... 122
3.3.1. Startdateien des ImmoTool-Servers ............................................................................ 123
3.3.2. Konfigurationsdateien des ImmoTool-Servers .............................................................. 124
4.B.1. IMAP-Serverdaten verschiedener E-Mailanbieter ......................................................... 149
4.B.2. POP3-Serverdaten verschiedener E-Mailanbieter .......................................................... 149
4.B.3. SMTP-Serverdaten verschiedener E-Mailanbieter ......................................................... 150
14.1. Systemanforderungen des ImmoTools ......................................................................... 154
14.2. Systemanforderungen des ImmoTool-Servers ................................................................ 154
xi
Liste der Beispiele
3.3.1.
3.3.2.
3.3.3.
3.3.4.
3.3.5.
Unix-Dienst in /etc/init.d speichern ............................................................................
Unix-Dienst in /etc/rc.d speichern ..............................................................................
Befehl zur Erzeugung des SSL-Schlüsselpaares ............................................................
Befehl zur Erzeugung der SSL-Zertifikates ..................................................................
Konfiguration der SSL-Verschlüsselung ......................................................................
xii
131
131
135
135
136
Vorwort
Wir bedanken uns bei allen am OpenEstate-Projekt beteiligten Personen sowie allen OpenSourceEntwicklern.
Anmerkung
Wenn Sie Anmerkungen, Hinweise oder Verbesserungsvorschläge zum Handbuch haben,
können Sie diese gern via Forum [http://board.openestate.org/] oder Ticketsystem [http://
dev.openestate.org/tickets/] einbringen.
Wichtig
Bitte beachten Sie, dass dieses Anwenderhandbuch noch nicht vollständig und auf dem
aktuellsten Stand ist. Einige Anleitungen & Screenshots stammen noch aus ImmoTool 0.9.x.
Bis zur Veröffentlichung des finalen ImmoTool 1.0 soll das Handbuch auf einen aktuellen
Stand gebracht werden.
xiii
Teil 1. Erste Schritte
Dokumentationen zur
Installation & Inbetriebnahme
Inhaltsverzeichnis
1.1. Java installieren ........................................................................................................... 3
Hinweise zur Java-Installation ...................................................................................... 3
Test der Java-Installation ............................................................................................. 4
1.2. Dateien herunterladen .................................................................................................... 6
Add-Ons / Erweiterungen ............................................................................................. 6
Geodaten im XML-Format ........................................................................................... 7
1.3. ImmoTool in Betrieb nehmen ......................................................................................... 8
ImmoTool installieren ................................................................................................. 8
EXE-Installation ................................................................................................. 8
PKG.ZIP-Installation ........................................................................................... 9
JAR-Installation ................................................................................................. 9
ZIP-Archiv ...................................................................................................... 10
TAR.GZ-Archiv ................................................................................................ 10
ImmoTool starten ..................................................................................................... 10
ImmoTool unter Windows starten ........................................................................ 10
ImmoTool unter MacOS X starten ....................................................................... 11
ImmoTool unter Linux/Unix starten ..................................................................... 11
Der erste Programmstart des ImmoTools ....................................................................... 12
1.4. Server in Betrieb nehmen ............................................................................................. 13
Server installieren ..................................................................................................... 13
Server starten ........................................................................................................... 13
Server mit start.exe starten ................................................................................. 14
Server mit start.app starten ................................................................................. 14
Server mit start.sh starten ................................................................................... 15
Server durch direkten Aufruf von Java starten ........................................................ 15
Verbindungsaufbau via AdminTool ............................................................................... 16
AdminTool unter Windows starten. ...................................................................... 16
AdminTool unter Mac OS X starten. .................................................................... 16
AdminTool unter Linux/Unix starten. ................................................................... 16
AdminTool am Server anmelden ......................................................................... 17
Erste Einstellungen im Projekt ............................................................................ 19
Verbindungsaufbau via ImmoTool ................................................................................ 19
Verbindung zu einem Mehrplatz-Projekt erzeugen .................................................. 19
Verbindung zu einem Mehrplatz-Projekt öffnen ...................................................... 20
2
Kapitel 1.1. Java installieren
Java wird sowohl für das ImmoTool als auch für den ImmoTool-Server benötigt und muss vorab auf allen
verwendeten Rechnern installiert werden.
Anmerkung
Die Programme ImmoTool & ImmoTool-Server können entweder mit Oracle Java
oder OpenJDK betrieben werden. Wir raten von der Verwendung anderer JavaLaufzeitumgebungen ab.
Hinweise zur Java-Installation
Abhängig vom Betriebssystem sind unterschiedliche Vorgehensweisen nötig, um Java zu installieren.
Java bei Sun/Oracle herunterladen
Für die Betriebssysteme Windows, Linux und Solaris kann bei bei java.com [http://www.java.com/
de/download/manual.jsp] eine fertig installierbare Java-Laufzeitumgebung kostenlos heruntergeladen
werden.
Java ist in Mac OS X bereits enthalten
In der Versionen 10.4, 10.5 und 10.6 von Mac OS X ist die benötigte Java-Laufzeitumgebung bereits
enthalten. Verwenden Sie die Funktion für die Softwareaktualisierung (im Apple-Menü) um zu überprüfen,
ob die aktuellste Version von Java installiert ist. Weitere Informationen finden Sie bei apple.com [http://
support.apple.com/kb/HT1338?viewlocale=de_DE].
Linux-Distributionen bieten meist eigene Java-Pakete an
In der Regel stellen die Distributoren eigene Sun-Java-Pakete zur Verfügung. Es ist ratsam diese Pakete
zu installieren, da sich Java dadurch besser in das Betriebssystem integriert.
Debian GNU/Linux
Installieren Sie das Paket sun-java6-jre aus dem non-free Repository. Siehe
packages.debian.org [http://packages.debian.org/stable/sun-java6-jre].
Ubuntu
Installieren Sie das Paket sun-java6-jre aus dem multiverse Repository. Siehe
packages.ubuntu.com [http://packages.ubuntu.com/search?keywords=sun-java6-jre].
Arch Linux
Installieren Sie das Paket jre aus dem Community Repository. Siehe archlinux.org/
packages/ [http://archlinux.org/packages/community/i686/jre/].
SUSE / openSUSE
Hinweise zur Installation finden Sie in diesem Artikel bei opensuse.org [http://
de.opensuse.org/Sun_Java].
3
Java installieren
Test der Java-Installation
Folgende Schritte können Sie durchführen um sicherzustellen, dass Java korrekt auf Ihrem Rechner
installiert ist.
Aufruf von Java via Kommandozeile
Öffnen Sie eine Kommandozeile und tragen Sie den folgenden Befehl ein:
java -version
Abbildung 1.1.1. Ausgabe der Java-Version auf der Kommandozeile
Nach Ausführung des Befehls java -version sollte die Version der Java-Installation dargestellt werden.
Eintrag in der Systemsteuerung von Windows
Abbildung 1.1.2. Java-Symbol in der Windows-Systemsteuerung
Nachdem Java auf Ihrem Windows-System installiert wurde, finden Sie in der Systemsteuerung dieses
zusätzliche Symbol.
4
Java installieren
Abbildung 1.1.3. Das Java-Control-Panel unter Windows
In diesem Fenster werden Informationen zur Java-Installation dargestellt. Klicken Sie auf
Anwendungsinfo... um Informationen zur installierten Java-Version dargestellt zu bekommen.
Abbildung 1.1.4. Information zur Java-Version unter Windows
In diesem Fenster wird die Version der aktuellen Java-Installation dargestellt.
5
Kapitel 1.2. Dateien herunterladen
Das OpenEstate-ImmoTool sowie weitere Add-Ons können nach erfolgter Registrierung und Anmeldung
im Anwenderbereich [http://dev.openestate.org/applications/] herunterladen.
Das ImmoTool-Programm stellt das Grundgerüst (Framework) dar. Die eigentlichen Programmfunktionen
(z.B. Immobilien verwalten) werden über installierbare Programm-Module (sog. Add-Ons) zur Verfügung
gestellt.
Add-Ons / Erweiterungen
Das OpenEstate-ImmoTool kann durch Zusatzmodule (Add-Ons) erweitert werden. Die
aktuell verfügbaren Add-Ons können im Anwenderbereich [http://dev.openestate.org/applications/]
heruntergeladen werden.
Add-Ons mit Programmfunktionen
Folgende Add-Ons integrieren spezielle Funktionen in das Programm und können nach Bedarf aktiviert /
deaktiviert werden.
Tabelle 1.2.1. Add-Ons mit Programmfunktionen
Name
Funktion
OpenEstate-Tool-Agency
Verwaltung von Immobiliendaten
OpenEstate-Tool-Calendar
Verwaltung von Kalenderdaten
OpenEstate-Tool-Contacts
Verwaltung von Adressdaten
OpenEstate-Tool-Manual
Darstellung des Handbuches
OpenEstate-Tool-Mail
Empfang & Versand von E-Mails
OpenEstate-Tool-News
Verwaltung von Nachrichten
Anmerkung
Diese Add-Ons sind in den Installationspaketen des Programmes bereits enthalten.
Add-Ons mit Übersetzungen
Übersetzungen des Programmes werden ebenfalls als Add-On bereitgestellt und können nach Bedarf
aktiviert / deaktiviert werden.
Tabelle 1.2.2. Add-Ons mit Übersetzungen
Name
Funktion
OpenEstate-Tool-I18N-BG
Übersetzung auf bulgarisch
OpenEstate-Tool-I18N-EN
Übersetzung auf englisch
OpenEstate-Tool-I18N-ES
Übersetzung auf spanisch
Anmerkung
Diese Add-Ons sind in den Installationspaketen des Programmes bereits enthalten.
6
Dateien herunterladen
Add-Ons von externen Anbietern
Jedem Entwickler ist es gestattet, eigene Add-Ons für das OpenEstate-ImmoTool zu entwickeln und (ggf.
kostenpflichtig) zu veröffentlichen. Interessierte Entwicklern finden weitere Informationen finden in der
OpenEstate-API [http://media.openestate.org/OpenEstate-API/].
Anmerkung
Bitte beachten Sie, dass wir nur eingeschränkte technische Unterstützung für die Add-Ons
externer Anbieter leisten können.
Geodaten im XML-Format
Für den Export von Immobilien zu bestimmten Portalen können die regionalen Vorgaben des
Portalbetreibers im Programm hinterlegt werden.
Die aktuell verfügbaren Geodaten können im Anwenderbereich [http://dev.openestate.org/applications/]
heruntergeladen werden.
7
Kapitel 1.3. ImmoTool in Betrieb
nehmen
ImmoTool installieren
Zur Installation des ImmoTools werden verschiedene Pakete angeboten, die je nach Betriebssystem
verwendet werden können.
Installation unter Windows
Installation via EXE-Programm
Dies ist der empfohlene Weg zur Installation unter Windows. Weitere Informationen finden Sie in diesem
Abschnitt.
Installation via JAR-Programm
Das Installationsprogramm kann alternativ direkt aus der JAR-Datei gestartet werden. Weitere
Informationen finden Sie in diesem Abschnitt.
Installation via ZIP-Archiv
Ohne dass eine weitere Installation nötig ist, kann das Programm aus dem ZIP-Archiv entpackt werden.
Installation unter MacOS X
Installation via PKG.ZIP-Programm
Dies ist der empfohlene Weg zur Installation unter Mac OS X. Weitere Informationen finden Sie in diesem
Abschnitt.
Installation via TAR.GZ-Archiv
Ohne dass eine weitere Installation nötig ist, kann das Programm aus dem TAR.GZ-Archiv entpackt
werden.
Installation unter Unix/Linux
Installation via JAR-Programm
Das Installationsprogramm kann direkt aus der JAR-Datei gestartet werden. Weitere Informationen finden
Sie in diesem Abschnitt.
Installation via TAR.GZ-Archiv
Ohne dass eine weitere Installation nötig ist, kann das Programm aus dem TAR.GZ-Archiv entpackt
werden.
EXE-Installation
Der empfohlene Weg zur Installation unter Windows
8
ImmoTool in Betrieb nehmen
Starten Sie den Installationsvorgang durch Ausführung der EXE-Datei. Das Installationsprogramm sollte
starten und Sie durch den weiteren Installationsvorgang leiten.
Tipp
Sollte das Installationsprogramm nicht starten, ist Java vermutlich nicht korrekt installiert.
Im Handbuch-Abschnitt Java installieren finden Sie weitere Hinweise.
Besonderheiten bei Windows Vista & Windows 7
Installationen unter Windows Vista & Windows 7, die in das Programmverzeichnis (C:
\Programme) durchgeführt werden, ordnet das Betriebssystem dem AdministratorBenutzer zu.
Um Probleme bei der Nutzung des Programmes zu vermeiden, sollte der normale Anwender
des Betriebssystems Lese- & Schreibrechte auf dem Programmverzeichnis (z.B. C:
\Programme\OpenEstate-ImmoTool) haben.
Um das Problem zu umgehen, kann die Installation auch in ein anderes Verzeichnis (z.B.
„Desktop“ oder „Eigene Dateien“) durchgeführt werden.
PKG.ZIP-Installation
Der empfohlene Weg zur Installation unter Mac OS X
Nach dem Herunterladen, wird das Installationsprogramm in der Regel automatisch entpackt und gestartet.
Sollte keine automatischer Start stattfinden, genügt ein Doppelklick auf die heruntergeladene Datei um
mit der Installation zu beginnen.
JAR-Installation
gilt für alle Betriebssysteme
Dieses Installationsprogramm kann plattformübergreifend auf allen unterstützten Betriebssystemen
verwendet werden. Das Programm führt Sie automatisch durch die nötigen Schritte der Installation.
In vielen Fällen kann das Installationsprogramm durch Doppelklick auf die JAR-Datei gestartet werden.
Sollte der Start per Doppelklick nicht funktionieren, öffnen Sie eine Sie eine Kommandozeile und wechseln
Sie ggf. in das Verzeichnis, in welchem sich die heruntergeladene JAR-Datei befindet, z.B:
cd c:\downloads
Zum Start des Installationsprogrammes von der Kommandozeile geben Sie folgenden Befehl ein:
java -jar OpenEstate-ImmoTool-0.9-Setup.jar
Sollte es Probleme mit der Darstellung von Sonderzeichen geben, können Sie das Installationsprogramm
mit folgendem Befehl starten:
java -Dfile.encoding=ISO-8859-1 -jar OpenEstate-ImmoTool-0.9-Setup.jar
Anmerkung
Sollte der genannte Befehl nicht funktionieren oder das Installationsprogramm nicht starten,
ist unter Umständen Java nicht korrekt installiert. Im Handbuch-Abschnitt Java installieren
finden Sie weitere Hinweise.
9
ImmoTool in Betrieb nehmen
ZIP-Archiv
gilt für alle Betriebssysteme
Das Programm kann aus dem ZIP-Archiv heraus entpackt und direkt gestartet werden. Weitere Schritte
zur Installation sind in diesem Falle nicht nötig.
TAR.GZ-Archiv
gilt für alle Betriebssysteme
Das Programm kann aus dem TAR.GZ-Archiv heraus entpackt und direkt gestartet werden. Weitere Schritte
zur Installation sind in diesem Falle nicht nötig.
ImmoTool starten
ImmoTool unter Windows starten
Start via Verknüpfung
nur bei durchgeführter EXE-Installation
Während der EXE-Installation werden Sie gefragt, ob das Programm Verknüpfungen im Startmenü und /
oder auf dem Desktop erzeugen soll.
Abbildung 1.3.1. Verknüpfung auf dem Desktop
Ein Doppelklick auf die Verknüpfung startet das Programm.
Abbildung 1.3.2. Verknüpfung im Startmenü
Ein Klick auf den Startmenü-Eintrag startet das Programm.
Start via EXE-Datei
gilt für Windows
10
ImmoTool in Betrieb nehmen
Im Unterverzeichnis bin des Programmverzeichnisses finden Sie die Datei ImmoTool.exe, welche mit
einem Doppelklick oder von der Kommandozeile gestartet werden kann.
Start via BAT-Datei
gilt für Windows
Im Unterverzeichnis bin des Programmverzeichnisses finden Sie die Datei ImmoTool.bat, welche mit
einem Doppelklick oder von der Kommandozeile gestartet werden kann.
ImmoTool unter MacOS X starten
Start via APP-Datei
nur bei durchgeführter PKG.ZIP-Installation
Öffnen Sie das Programmverzeichnis im Finder und starten Sie das Programm durch Doppelklick auf den
ausführbaren Ordner ImmoTool.
Abbildung 1.3.3. ImmoTool unter Mac OS X starten
Programmverzeichnis mit dem ausführbaren ImmoTool-Ordner
Start via SH-Datei
Öffnen Sie eine Kommandozeile und wechseln Sie in das bin-Unterverzeichnis der ImmoToolInstallation. Das Programm kann gestartet werden mit:
./ImmoTool.sh
oder
sh ImmoTool.sh
ImmoTool unter Linux/Unix starten
Start via SH-Datei
Öffnen Sie eine Kommandozeile und wechseln Sie in das bin-Unterverzeichnis der ImmoToolInstallation. Das Programm kann gestartet werden mit:
./ImmoTool.sh
oder
sh ImmoTool.sh
11
ImmoTool in Betrieb nehmen
Der erste Programmstart des ImmoTools
Beim ersten Programmstart des ImmoTools sind verschiedene Schritte nötig.
Anmerkung
Wenn das ImmoTool im Netzwerk betrieben werden sollen, sollte vorab der ImmoToolServer installiert sein, bevor das ImmoTool in Betrieb genommen werden kann.
Sprache wählen. Wählen Sie eine Sprache, die im Programm standardmäßig verwendet werden soll.
Lizenzbedingungen akzeptieren. Bestätigen Sie die Lizenzbedingungen und registrieren Sie Ihre
ImmoTool-Installation mit Hilfe des Lizenz-Schlüssels.
Neues Projekt erzeugen. Der Projektassistent wird geöffnet und Sie können eine erste
Projektdatenbank mit dem ImmoTool erzeugen.
12
Kapitel 1.4. Server in Betrieb nehmen
Der ImmoTool-Server kann in einem Netzwerk installiert werden, um von mehreren Arbeitsplätzen
gemeinsam an einem ImmoTool-Projekt zu arbeiten.
Anmerkung
Wenn das ImmoTool nicht im Netzwerk betrieben werden soll, muss kein ImmoTool-Server
installiert werden.
Anmerkung
Um mit dem ImmoTool-Server über das Netzwerk kommunizieren zu können, muss
eventuell eine Zugriffsregel in der Firewall hinterlegt werden. Benötigt wird eine Freigabe
für Verbindungen auf Port-Nr 9001.
Server installieren
Server aus ZIP-Archiv installieren
Im ZIP-Archiv befindet sich die Programmdateien des ImmoTool-Servers. Es wird ein vorkonfigurierter
HSQLDB-Server ausgeliefert, der ohne weitere Einstellungen sofort gestartet werden kann. Die
Vorgehensweise wird im Glossar-Eintrag zum ZIP-Archiv allgemein beschrieben.
Zur Installation des ImmoTool-Servers genügt es, das ZIP-Archiv an einer beliebigen Stelle auf der
Festplatte zu entpacken.
Anmerkung
ZIP ist das empfohlene Dateiformat für Windows-Betriebssysteme.
Server aus TAR.GZ-Archiv installieren
Im TAR.GZ-Archiv befindet sich die Programmdateien des ImmoTool-Servers. Es wird ein
vorkonfigurierter HSQLDB-Server ausgeliefert, der ohne weitere Einstellungen sofort gestartet werden
kann.
Zur Installation des ImmoTool-Servers genügt es, das TAR.GZ-Archiv an einer beliebigen Stelle auf der
Festplatte zu entpacken. Die Vorgehensweise wird im Glossar-Eintrag zum TAR.GZ-Archiv allgemein
beschrieben.
Anmerkung
TAR.GZ ist das empfohlene Dateiformat für Unix-Betriebssysteme (Linux, Mac OS X,
BSD).
Server starten
Die Standard-Installation des ImmoTool-Servers kann auf verschiedenen gestartet werden. Zur ersten
Inbetriebnahme wird an dieser Stelle die einfachste Art des Serverstarts beschrieben.
13
Server in Betrieb nehmen
Server mit start.exe starten
funktioniert unter Windows
Öffnen Sie das Programmverzeichnis des Servers im Windows Explorer (z.B. C:\Programme
\OpenEstate-ImmoServer) und öffnen Sie das Unterverzeichnis bin. Durch Doppelklick auf die
start.exe (oder start.bat) startet der ImmoTool-Server und es öffnet sich eine Kommandozeile,
auf der die Ausgaben des Servers dargestellt werden.
Anmerkung
Wenn Sie das geöffnete Fenster schließen, wird der ImmoTool-Server beendet und ist damit
nicht mehr im Netzwerk verfügbar. Um den Server im Hintergrund betreiben zu können,
muss ein Dienst im Betriebssystem installiert werden. Weitere Informationen finden Sie im
Administratorhandbuch.
Abbildung 1.4.1. ImmoTool-Server unter Windows starten (Schritt 1)
Starten Sie den ImmoTool-Server durch Doppelklick auf die Datei start.exe oder start.bat.
Abbildung 1.4.2. ImmoTool-Server unter Windows starten (Schritt 2)
Es öffnet sich ein Fenster mit den laufenden Ausgaben des Servers.
Server mit start.app starten
funktioniert unter Mac OS X
Öffnen Sie das Programmverzeichnis im Finder und wählen Sie das Unterverzeichnis bin aus. Darin
finden Sie den ausführbaren Ordner start, der mit einem Doppelklick gestartet werden kann.
14
Server in Betrieb nehmen
Abbildung 1.4.3. ImmoTool-Server unter Mac OS X starten (Schritt 1)
Programmverzeichnis mit dem ausführbaren start-Ordner
Abbildung 1.4.4. ImmoTool-Server unter Mac OS X starten (Schritt 2)
Es öffnet sich ein Fenster mit den laufenden Ausgaben des Servers.
Klicken Sie auf Cancel um den gestarteten ImmoTool-Server zu beenden.
Achtung
Wenn Sie das geöffnete Fenster schließen, wird der ImmoTool-Server beendet und ist damit
nicht mehr im Netzwerk verfügbar. Um den Server im Hintergrund betreiben zu können,
muss ein Dienst im Betriebssystem installiert werden. Weitere Informationen finden Sie im
Administratorhandbuch.
Server mit start.sh starten
funktioniert unter Mac/Linux/Unix
Öffnen Sie eine Kommandozeile und wechseln Sie in das Unterverzeichnis bin im Programmverzeichnis
des ImmoTool-Servers, z.B.:
cd /home/mustermann/OpenEstate-ImmoServer/bin
Folgender Befehl startet den ImmoTool-Server:
./start.sh
oder
sh start.sh
Server durch direkten Aufruf von Java starten
funktioniert unter allen Betriebssystemen
15
Server in Betrieb nehmen
Sollten die zuvor genannten Start-Varianten nicht funktionieren, kann der Server auch direkt durch Aufruf
des java-Befehles über die Kommandozeile gestartet werden. Diese Lösung bietet sich bei eventuellen
technischen Problemen an.
Öffnen Sie eine Kommandozeile und wechseln Sie in das Programmverzeichnis des ImmoTool-Servers,
z.B.:
cd /home/mustermann/OpenEstate-ImmoServer
Folgender Befehl startet den ImmoTool-Server unter Windows:
java
-cp
".\etc;.\lib\hsqldb.jar;.\lib\log4j.jar"
\server.properties
org.hsqldb.server.Server
--props
.\etc
--props
./etc/
Folgender Befehl startet den ImmoTool-Server unter Unix / Linux / Mac:
java
-cp
"./etc:./lib/hsqldb.jar:./lib/log4j.jar"
server.properties
org.hsqldb.server.Server
Verbindungsaufbau via AdminTool
Das AdminTool ist ein externes Hilfsprogramm für Administratoren zur Verwaltung von ImmoToolDatenbanken. Das Programm wird gemeinsam mit dem ImmoTool installiert.
Anmerkung
Sollten Sie das ImmoTool noch nicht installiert haben, befolgen Sie vorher die
Installationshinweise.
Nachdem der ImmoTool-Server wie in diesem Kapitel beschrieben gestartet wurde, können Sie das
AdminTool verwenden um ein Projekt auf dem ImmoTool-Server einzurichten.
AdminTool unter Windows starten.
Öffnen Sie im Windows Explorer das Unterverzeichnis bin der ImmoTool-Installation, z.B.:
C:\Programme\OpenEstate-ImmoTool\bin
Starten Sie das AdminTool durch Doppelklick auf die Datei AdminTool.exe (oder AdminTool.bat).
AdminTool unter Mac OS X starten.
Öffnen Sie das Programmverzeichnis im Finder und starten Sie das Programm durch Doppelklick auf den
ausführbaren Ordner AdminTool.
Alternativ kann der beschriebene Weg für Linux/Unix verwendet werden.
AdminTool unter Linux/Unix starten.
Öffnen Sie in der Kommandozeile das Unterverzeichnis bin der ImmoTool-Installation, z.B.:
cd /home/tester/OpenEstate-ImmoTool/bin
Starten Sie das AdminTool durch Eingabe von:
./AdminTool.sh
16
Server in Betrieb nehmen
oder
sh AdminTool.sh
AdminTool am Server anmelden
Nach dem Start des AdminTools muss eine Verbindung zu einer ImmoTool-Datenbank aufgebaut werden.
Es wird dafür ein Fenster angezeigt, in welchem die Zugangsdaten eingetragen werden können.
Da eine Verbindung zu einem entfernten Server hergestellt werden soll, aktivieren Sie die Option
Entfernte Datenbank / auf einem Server gespeichert. Darauf können Sie in den folgenden Felder die
Verbindungsdaten des ImmoTool-Servers hinterlegen:
Abbildung 1.4.5. Anmeldung am ImmoTool-Server via AdminTool
Tragen Sie die Verbindungsdaten des ImmoTool-Servers ein. Der Benutzername des Administators lautet
SA. Beim ersten Start muss kein Passwort eingegeben werden.
Tabelle 1.4.1. Einrichtung einer Verbindung zum ImmoTool-Server via AdminTool
Eingabefeld
Beschreibung
Datenbank
In diesem Feld kann ausgewählt werden, mit welcher Art von
Datenbank eine Verbindung hergestellt werden soll. In der
Standard-Installation ist hier die Option HSQL.remote zu wählen.
Protokoll
In diesem Feld kann ausgewählt werden, über welches Protokoll
die Kommunikation mit der Datenbank erfolgen soll. Bei einer
unverschlüsselten Verbindung zum ImmoTool-Server ist hier die
Option hsql zu wählen.
Hostname
Tragen Sie hier die IP-Adresse oder den Hostnamen des Rechners
ein, auf dem der ImmoTool-Server installiert wurde. Wird das
AdminTool vom gleichen Rechner wie der ImmoTool-Server
gestartet, kann „localhost“ oder „127.0.0.1“ eingegeben werden.
Port-Nr
Tragen Sie hier die vom ImmoTool-Server verwendete Port-Nr ein.
Wenn nichts anderes im ImmoTool-Server konfiguriert wurde, ist
hier die Port-Nr 9001 zu verwenden.
DB-Name
Tragen Sie hier den Namen der Datenbank ein, in welcher der
ImmoTool-Server die Daten abgelegt hat. Wenn nichts anderes
eingestellt wurde, ist der Datenbank-Name immotool zu verwenden.
17
Server in Betrieb nehmen
Eingabefeld
Beschreibung
Benutzer
Geben Sie den Namen eines Benutzers ein, der administrative
Rechte auf der Datenbank besitzt. In der Standard-Installation mit
HSQL ist SA als Benutzer zu verwenden.
Passwort
Tragen Sie hier das Passwort des Administrator-Benutzers ein.
Beim ersten Verbindungsaufbau zum ImmoTool-Server kann das
Passwort leer gelassen werden.
Klicken Sie auf Datenbank öffnen um die Verbindung zum ImmoTool-Server herzustellen.
Sollten Sie noch kein Passwort für den Administrator in der Datenbank hinterlegt haben, werden Sie
im folgenden Schritt gebeten ein solches Passwort zu wählen. Dieses muss aus Sicherheitsgründen aus
mindestens 8 Zeichen (Buchstaben & Zahlen) bestehen.
Abbildung 1.4.6. Administrator-Passwort bei der ersten Anmeldung am
ImmoTool-Server angeben
Bei der ersten Anmeldung am ImmoTool-Server muss ein Administrator-Passwort eingegeben werden.
Achtung
Merken Sie sich das Administrator-Passwort gut. Ein administrativer Zugriff auf die
Datenbank ist ohne dieses Passwort nicht möglich!
Damit das ImmoTool auf der Datenbank arbeiten kann, müssen verschiedene Datenstrukturen installiert
sein. Sollten diese noch nicht vorhanden sein, wird folgendes beim Verbindungsaufbau angezeigt:
Abbildung 1.4.7. Installation der Datenbank bei der ersten Anmeldung am
ImmoTool-Server
Wählen Sie die zu installierenden Add-Ons / Module aus und klicken Sie auf Projekt erzeugen.
18
Server in Betrieb nehmen
Nachdem auf Projekt erzeugen geklickt wurde werden die Datenstrukturen und die ausgewählten AddOns in die Datenbank installiert.
Erste Einstellungen im Projekt
Nach einer erfolgreichen Anmeldung am ImmoTool-Server können die Eckdaten des Projektes
eingerichtet werden. Tragen Sie an dieser Stelle z.B. Ihre Firmendaten ein und registrieren Sie ggf. weitere
Benutzer.
Abbildung 1.4.8. Firmendaten im AdminTool bearbeiten
Nach erfolgter Anmeldung im AdminTool können unter Anderem die Firmendaten in der Datenbank
hinterlegt werden.
Verbindungsaufbau via ImmoTool
Nachdem ein das Mehrplatz-Projekt auf dem ImmoTool-Server erzeugt wurde, kann mit dem ImmoTool
eine Verbindung zu diesem Projekt hergestellt werden.
Beim Start des ImmoTool wird das Fenster des Projektassistenten geöffnet. Alternativ können Sie im
Hauptmenü auf Programm → Neues Projekt klicken.
Verbindung zu einem Mehrplatz-Projekt erzeugen
Abbildung 1.4.9. ImmoTool mit Mehrplatz-Projekt verbinden (Schritt 1)
Tragen Sie im Projektassistenten die Verbindungsdaten zum ImmoTool-Server ein und klicken Sie auf
Anmeldung um einen ersten Verbindungstest durchzuführen.
Tragen Sie im Feld Bezeichnung einen passenden Namen für das Projekt ein. Verwenden Sie dabei keine
Sonderzeichen, Umlaute oder Leerzeichen.
Wählen Sie im Feld Art des Projektes die Option Neue Verbindung zu einem Mehrplatz-Projekt erzeugen
aus.
19
Server in Betrieb nehmen
Daraufhin werden weitere Eingabefelder angezeigt, um die Verbindung zum ImmoTool-Server zu
konfigurieren.
Tabelle 1.4.2. Einrichtung einer Verbindung zum ImmoTool-Server via ImmoTool
Eingabefeld
Beschreibung
Datenbank
In diesem Feld kann ausgewählt werden, mit welcher Art von
Datenbank eine Verbindung hergestellt werden soll. In der
Standard-Installation ist hier die Option HSQL.remote zu wählen.
Protokoll
In diesem Feld kann ausgewählt werden, über welches Protokoll
die Kommunikation mit der Datenbank erfolgen soll. Bei einer
unverschlüsselten Verbindung zum ImmoTool-Server ist hier die
Option hsql zu wählen.
Hostname
Tragen Sie hier die IP-Adresse oder den Hostnamen des Rechners
ein, auf dem der ImmoTool-Server installiert wurde. Wird das
AdminTool vom gleichen Rechner wie der ImmoTool-Server
gestartet, kann „localhost“ oder „127.0.0.1“ eingegeben werden.
Port-Nr
Tragen Sie hier die vom ImmoTool-Server verwendete Port-Nr ein.
Wenn nichts anderes im ImmoTool-Server konfiguriert wurde, ist
hier die Port-Nr 9001 zu verwenden.
DB-Name
Tragen Sie hier den Namen der Datenbank ein, in welcher der
ImmoTool-Server die Daten abgelegt hat. Wenn nichts anderes
eingestellt wurde, ist der Datenbank-Name immotool zu verwenden.
Benutzer
Geben Sie den Namen eines Benutzers ein, der administrative
Rechte auf der Datenbank besitzt. In der Standard-Installation mit
HSQL ist SA als Benutzer zu verwenden.
Passwort
Tragen Sie hier das Passwort des Administrator-Benutzers ein.
Beim ersten Verbindungsaufbau zum ImmoTool-Server kann das
Passwort leer gelassen werden.
Nachdem die Verbindungsdaten eingetragen wurden, klicken Sie auf Anmeldung um einen ersten
Verbindungstest durchzuführen. Bei erfolgreicher Anmeldung werden erste Daten vom Server
heruntergeladen.
Tragen Sie in den weiteren Reitern ggf. weitere Angaben zum Benutzer ein und aktivieren / deaktivieren
Sie die zu verwendenden Add-Ons.
Abbildung 1.4.10. ImmoTool mit Mehrplatz-Projekt verbinden (Schritt 2)
Klicken Sie abschließend auf Projekt erzeugen um die Einstellungen dauerhaft zu speichern und das
Projekt im ImmoTool zu öffnen.
Verbindung zu einem Mehrplatz-Projekt öffnen
Nachdem die Anbindung an ein Mehrplatz-Projekt erstmals erzeugt wurde, kann das erzeugte Projekt bei
einem späteren Programmstart direkt geöffnet werden.
20
Server in Betrieb nehmen
Abbildung 1.4.11. Mehrplatz-Projekt öffnen (Variante 1)
Klicken Sie im Projektassistenten oben auf Projekt öffnen und wählen Sie das Verzeichnis des zu
öffnenden Projektes aus.
Abbildung 1.4.12. Mehrplatz-Projekt öffnen (Variante 2)
Klicken Sie im Projektassistenten oben auf Zuletzt verwendet und wählen Sie das zu öffnende Projekt aus
der Liste der zuletzt verwendeten Projekte aus.
Abbildung 1.4.13. Anmeldung am Mehrplatz-Projekt
Beim Öffnen eines Mehrplatz-Projektes muss Benutzername & Passwort eingegeben werden um auf die
Datenbank zugreifen zu können.
21
Teil 2. Anwenderhandbuch
Dokumentationen zur alltäglichen
Verwendung des ImmoTools
Inhaltsverzeichnis
2.1. Allgemein ..................................................................................................................
Benutzeroberfläche ....................................................................................................
Das Programmfenster ........................................................................................
Verwendung von Tabellen ..................................................................................
Verwendung von Formularen ..............................................................................
Projekte ...................................................................................................................
Unternehmensprofil ...........................................................................................
Benutzerprofil ..................................................................................................
Einstellungen ...................................................................................................
Fragen & Antworten .........................................................................................
Projektassistent .........................................................................................................
Ein neues Projekt erzeugen .................................................................................
Ein existierendes Projekt öffnen ..........................................................................
Zuletzt verwendetes Projekt öffnen ......................................................................
Einstellungen ...........................................................................................................
Netzwerk-Einstellungen .....................................................................................
Datenbank-Einstellungen ....................................................................................
Speichern ........................................................................................................
Add-Ons / Module ....................................................................................................
Add-Ons installieren / deinstallieren .....................................................................
Add-Ons aktualisieren .......................................................................................
Add-Ons aktivieren / deaktivieren ........................................................................
Aktualisierungen .......................................................................................................
automatische Aktualisierung ...............................................................................
manuelle Aktualisierung .....................................................................................
Datenbank ...............................................................................................................
Automatische Datenbanksicherung .......................................................................
Manuelle Datenbanksicherung .............................................................................
Datenbank wiederherstellen ................................................................................
Zertifikate ................................................................................................................
Prüfung eines SSL-Zertifikates ............................................................................
Verwaltung der SSL-Zertifikate ...........................................................................
Protokolle ................................................................................................................
Protokoll speichern ............................................................................................
Nutzungslizenz .........................................................................................................
OpenEstate-Lizenz ............................................................................................
Fremde Modul-Lizenzen ....................................................................................
2.2. Immobilien ................................................................................................................
Immobilien verwalten ................................................................................................
Filterkriterien verwenden ....................................................................................
Aktionen ausführen ...........................................................................................
Immobilien durchsuchen ....................................................................................
Immobilie bearbeiten .................................................................................................
Allgemeine Eckdaten .........................................................................................
Spezifikation der Immobilie ................................................................................
Freitexte & Beschreibungen ................................................................................
Fotos und Dateien .............................................................................................
Kontaktperson ..................................................................................................
Exporte ...........................................................................................................
Adressen .........................................................................................................
Kalender ..........................................................................................................
23
26
26
26
27
28
28
28
30
30
30
31
31
33
33
33
34
34
34
35
35
36
37
37
37
37
37
38
38
38
39
39
40
41
41
41
42
42
43
44
44
44
45
46
46
48
50
50
51
52
53
55
Anwenderhandbuch
Notizen ...........................................................................................................
Änderungen Speichern .......................................................................................
Immobilien exportieren ..............................................................................................
Exportvorgang ..................................................................................................
Schnittstelle anlegen ..........................................................................................
Schnittstellenkonfiguration importieren .................................................................
Schnittstelle bearbeiten ......................................................................................
Schnittstelle (de)aktivieren ..................................................................................
Schnittstelle löschen ..........................................................................................
Immobilien importieren ..............................................................................................
Immobilien aus einer Datei importieren ................................................................
Immobilien aus einer vorhandenen Maklersoftware importieren .................................
Ansprechpartner verwalten .........................................................................................
Filterkriterien verwenden ....................................................................................
Aktionen ausführen ...........................................................................................
Ansprechpartner bearbeiten .........................................................................................
Personendaten ..................................................................................................
Betreute Immobilien ..........................................................................................
Notizen ...........................................................................................................
Änderungen speichern .......................................................................................
Suchanfragen verwalten .............................................................................................
Aktionen ausführen ...........................................................................................
Suchanfrage bearbeiten ..............................................................................................
Eckdaten bearbeiten ..........................................................................................
Kriterien bearbeiten ...........................................................................................
Adressen zuweisen ............................................................................................
Einstellungen ...........................................................................................................
Agentur ...........................................................................................................
Sprachen .........................................................................................................
PDF-Langexposé (Standardvorlage) ......................................................................
PDF-Kurzexposé (Standardvorlage) ......................................................................
Fragen & Antworten .................................................................................................
2.3. Adressbuch ................................................................................................................
Adressen verwalten ...................................................................................................
Adresse erzeugen ..............................................................................................
Adresse bearbeiten ............................................................................................
Adresse löschen ................................................................................................
Adressformular .........................................................................................................
Allgemeine Angaben zur Adresse (Reiter Anschrift) ................................................
Weitere Angaben zur Adresse (Reiter Details) ........................................................
Verknüpfte Immobilien (Reiter Immobilien) ..........................................................
Verknüpfte Kalendereinträge (Reiter Kalender) ......................................................
Bemerkungen zur Adresse (Reiter Notizen) ...........................................................
Speichern ........................................................................................................
Adressgruppen ..........................................................................................................
Adressgruppe anlegen ........................................................................................
Adressgruppe bearbeiten ....................................................................................
Adressgruppe löschen ........................................................................................
Adressgruppenformular ..............................................................................................
Allgemeine Angaben .........................................................................................
Speichern ........................................................................................................
2.4. Kalender ...................................................................................................................
Kalendereinträge .......................................................................................................
Kalendereintrag anlegen .....................................................................................
24
57
57
58
58
59
63
64
64
64
64
65
66
67
68
68
68
69
69
69
70
70
70
71
71
72
73
74
74
75
75
76
77
79
80
80
80
80
81
81
81
81
82
82
82
83
83
83
84
84
84
84
85
86
86
Anwenderhandbuch
Kalendereintrag bearbeiten ................................................................................. 86
Kalendereintrag löschen ..................................................................................... 87
Kalendereintragsformular Termin ................................................................................. 87
Termin anlegen / bearbeiten ................................................................................ 87
Einstellungen ........................................................................................................... 87
2.5. E-Mails ..................................................................................................................... 88
E-Mailkonten ........................................................................................................... 89
Allgemeine Angaben ......................................................................................... 89
Empfang via IMAP ........................................................................................... 90
Empfang via POP3 ........................................................................................... 91
Versand via SMTP ............................................................................................ 92
Mailordner zuweisen ......................................................................................... 93
Erweiterte Einstellungen ..................................................................................... 94
E-Mails lesen ........................................................................................................... 95
Ordner-Ansicht ................................................................................................. 95
Nachrichten-Ansicht .......................................................................................... 96
E-Mails senden ......................................................................................................... 97
Empfänger bearbeiten ........................................................................................ 98
Nachrichtentext eingeben ................................................................................... 99
Anhänge verwalten .......................................................................................... 101
Nachricht senden ............................................................................................. 101
Entwurf speichern ........................................................................................... 101
Adressen verknüpfen ............................................................................................... 101
Mailversand via Adressbuch .............................................................................. 102
Adressauswahl beim Mailversand ....................................................................... 103
Adressen mit E-Mail verknüpfen ........................................................................ 103
Fragen & Antworten ................................................................................................ 104
2.6. Nachrichten .............................................................................................................. 106
Nachrichtenquellen .................................................................................................. 106
25
Kapitel 2.1. Allgemein
In diesem Kapitel werden allgemeine Funktionen & Konzepte
des ImmoTools dokumentiert.
Benutzeroberfläche
In diesem Abschnitt werden verschiedene Konzepte der grafischen Benutzeroberfläche (GUI)
dokumentiert.
Das Programmfenster
Das Programmfenster des ImmoTools wird in verschiedene Bereiche aufgeteilt.
Abbildung 2.1.1. Programmfenster des ImmoTools
1. Hauptmenü. Über das Hauptmenü können die Funktionen des Programmes direkt aufgerufen
werden.
Die installierten / aktivierten Add-Ons können bei Bedarf Einträge in das Hauptmenü einfügen.
2. Ansichtsauswahl. Die verschiedenen Ansichten können in dieser Auswahlbox gewählt werden.
Beim Wechsel der Ansicht werden im Ansichtsbereich (4) weitere Einträge in einer Baumansicht
dargestellt.
3. Ansichtsmenü. Für die in (2) gewählte Ansicht wird ein Menü mit weiteren Aktionen dargestellt,
wenn Sie auf diesen Button klicken.
26
Allgemein
Die Einträge im erzeugten Menü hängen davon ab, welche Auswahl im Ansichtsbereich (4) getätigt
wurde. Alternativ kann das Ansichtsmenü durch Klick mit rechter Maustaste in den Ansichtsbereich
(4) geöffnet werden.
4. Ansichtsbereich. Für die in (2) gewählte Ansicht werden in diesem Bereich verschiedene
Informationen zur weiteren Bearbeitung dargestellt.
5. Hauptbereich. In diesem Bereich werden die Informationen aus der Datenbank dargestellt und
bearbeitet.
Es können beliebig viele Reiter / Tabs im Hauptbereich dargestellt werden. Durch Klick auf das
rote X (oder via Hauptmenü Programm → Tab schließen (F8)) kann ein geöffneter Reiter / Tab im
Hauptbereich geschlossen werden.
6. Kalenderbereich. Der aktuelle Kalender wird dargestellt.
Aktuelle Termine werden farblich im Kalender hervorgehoben und können durch Doppelklick geöffnet
werden.
7. Statusmeldung. Wenn eine Aufgabe im Hintergrund ausgeführt wird, werden an dieser Stelle
Status-Meldungen dargestellt.
Wenn keine Prozesse im Hintergrund arbeiten (oder keine Status-Meldungen gesendet werden) wird
der Firmen-Name des aktuellen Projektes dargestellt.
8. Fortschrittsbalken. Während eine Aufgabe im Hintergrund ausgeführt wird, findet an dieser eine
optische Rückmeldung statt.
9. Infomeldung / Balloon-Message. Eine ausgeführte Aufgabe kann Rückmeldungen liefern, die im
Programm als Infomeldung dargestellt werden.
Nach einer Zeitspanne von 30 Sekunden wird die Infomeldung automatisch ausgeblendet. Es werden
die letzten fünf Infomeldungen angezeigt. Wenn man die Infomeldung explizit schließt (durch Klick
auf das rote X), werden die fünf zuletzt dargestellten Infomeldungen geleert.
Verwendung von Tabellen
An verschiedenen Stellen werden Tabellen innerhalb des Programmes dargestellt. Verschiedene
Standardfunktionen sind in den Tabellen enthalten.
Zeilen umsortieren. Durch einen Klick mit der linken Maustaste auf einen Spaltentitel in der Tabelle,
kann nach dieser Spalte auf- oder absteigend sortiert werden. Ein kleiner Pfeil neben dem Spaltemntitel
zeigt die aktuelle Sortierungsrichtung an.
Spalten umsortieren. Wenn mit der linken Maustaste auf einen Spaltentitel in der Tabelle geklickt
und die Taste gehalten wird, kann die Spalte innerhalb der Tabelle verschoben werden (Drag & Drop).
Spalten ein- & ausblenden. Zum Ein- oder Ausblenden einer Spalte klicken Sie rechts von den
Spaltentiteln auf das Tabellensymbol um das Tabellenmenü zu öffnen. Aktivieren oder deaktivieren Sie
die entsprechende Spalte durch Klick auf den gewünschten Spaltentitel.
Anmerkung
Die beschriebenen Standard-Tabellenfunktionen werden eventuell nicht in jeder Tabelle
unterstützt.
27
Allgemein
Verwendung von Formularen
Um Eingaben zu tätigen, werden an verschiedenen Stellen im Programm Formulare dargestellt. Die
folgenden Standardfunktionen werden dabei verwendet.
Pflichtfelder. Eingaben, die für eine weitere Verarbeitung zwingend notwendig sind, werden gelb
hervorgehoben.
Ungültige Eingaben. Ungültige Eingaben in einem Pflichtfeld werden rot hervorgehoben.
Gültige Eingaben. Gültige Eingaben in einem Pflichtfeld werden grün hervorgehoben.
Projekte
Unternehmensprofil
Unternehmensprofil verwalten
In der Datenbank werden grundlegende Unternehmensdaten sowie ein Firmenlogo gespeichert. Zur
Verwaltung des hinterlegten Unternehmensprofil gelangen Sie auf zweierlei Wegen:
• Klicken Sie im Menü auf den Eintrag Immobilien → Anbieterprofil.
• Klicken Sie in der Sidebar auf den Eintrag Anbieterprofil.
Im sich öffnenden Fenster finden Sie alle Unternehmensdaten übersichtlich zusammengefasst.
Firmenprofil bearbeiten
Die hinerlegten Firmendaten werden an verschiedenen Stellen innerhalb des Programmes dargestellt und
u.A. beim Immobilienexport verwendet.
Öffnen Sie ggf. das Unternehmensprofil und aktivieren Sie den Karteireiter Firma um die hinterlegten
Unternehmensdaten einzusehen oder zu ändern.
Anmerkung
Nach einer Änderung der Firmendaten, muss abschließend auf Übernehmen geklickt werden,
um diese dauerhaft in die Datenbank zu speichern.
28
Allgemein
Abbildung 2.1.2. Firmenprofil
Firmendetails bearbeiten
Die hinterlegten Firmendaten werden an verschiedenen Stellen in der Software dargestellt und können
ggf. bei der Generierung von Exposés berücksichtigt werden.
• Öffnen Sie ggf. das Anbieterprofil und aktivieren Sie den Karteireiter Details um die Detaildaten
einzusehen oder zu ändern.
• Ihre AGB können Sie in den Sprachen anlegen, welche in den Spracheinstellungen aktiviert wurden.
Anmerkung
Nach einer Änderung der Detaildaten, muss abschließend auf Übernehmen geklickt werden,
um diese dauerhaft in die Datenbank zu speichern.
Firmenlogo bearbeiten
Das hinterlegte Firmenlogo wird an verschiedenen Stellen in der Software dargestellt und kann ggf. bei
der Generierung von Exposés berücksichtigt werden.
• Öffnen Sie ggf. das Anbieterprofil und aktivieren Sie den Karteireiter Logo um das hinterlegte
Unternehmenslogo einzusehen oder zu ändern.
Ein neues Logo laden. Um ein Logo in die Datenbank zu laden, klicken Sie auf den Button Logo
ändern. Im sich öffnenden Dialogfenster wählen Sie das gewünschte Logo von Ihrer Festplatte. Klicken
Sie abschließend auf Logo auswählen, um das Logo ins Programm zu laden.
Ein bestehendes Logo ändern. Um das Firmenlogo zu ändern, verfahren Sie wie beim Laden eines
neuen Logos. Das alte Logo wird dabei überschrieben.
Ein bestehendes Logo löschen. Um ein gespeichertes Logo zu löschen, klicken Sie auf den Button
Logo entfernen.
29
Allgemein
Anmerkung
• Nach einer Änderung des Logos, muss abschließend auf Übernehmen geklickt werden,
um diese dauerhaft in die Datenbank zu speichern.
• Es werden die gängigen Bildformate (JPG, PNG, GIF, TIF) unterstützt.
Benutzerprofil
Benutzerprofil verwalten
...
Einstellungen
Programm- / AddOns-Aktualiserung
Deaktivieren Sie bei Bedarf die automatische Aktualisierung des Programms und der Add-Ons bei
Programmstart. Sind diese Otionen aktiviert wird beim Start des Programms in einem Hintergrundprozess
nach Aktualisierungen gesucht. Werden Aktualisierungen gefunden, so werden Sie darauf hingewiesen
und können selbst entscheiden, ob diese installiert werden sollen.
Anmerkung
• Standardmäßig ist das Programm so eingestellt, dass beim Start vorhandene
Aktualisierungen gesucht und zum herunterladen angeboten werden!
• Diese Funktion sucht ausschließlich nach aktuelleren Versionen des ImmoTools und
der bereits installierten Add-Ons. Weitere zur Installation verfügbare Add-Ons werden
hier nicht angezeigt. Diese finden Sie ggf. in Ihrem Logginbereich unter http://
dev.openestate.org, oder bei einem externen Anbieter.
Browser
Der bevorzugte Web-Browser kann hier eingetragen werden. Im ImmoTool angezeigte URL's werden im
hinterlegten Web-Browser geöffnet. Wenn kein Web-Browser eingetragen wurde, versucht das Programm
den Standard-Browser des Betriebssystems zu starten.
PDF-Reader
Der bevorzugte PDF-Reader kann hier eingetragen werden. Erzeugte PDF-Dokumente können aus dem
ImmoTool heraus mit der hinterlegten Anwendung geöffnet werden.
Fragen & Antworten
F:
Was ist ein Projekt und warum ist es sinnvoll?
A:
Im ImmoTool können mehrere Projekte parallel verwaltet werden. Jedes verwaltete Projekt
besitzt eine eigenständige Datenbank und wird in separaten Verzeichnissen auf der Festplatte
abgespeichert.
Abhängig vom Anwendungsfall kann es sinnvoll sein, die Immobilien nach Tätigkeit (Makler und /
oder Vermittler) oder nach Kunden in getrennten Projekten zu verwalten. In diesen Fällen könnten
30
Allgemein
mehrere Projekte parallel, z.B. ein Projekt als Verwalter und eines als Makler, eingerichtet werden.
Mindestens ein Projekt muss angelegt werden, um mit dem Programm zu arbeiten.
F:
Wo wird mein Projekt gespeichert?
A:
Der Speicherort des Projektes kann im Projektassistenten gewählt werden (siehe Projektdaten
bearbeiten). Wenn nichts Anderes eingestellt wurde, wird das Projekt im Unterordner projects
des Programmverzeichnisses abgelegt.
Wenn das Programm z.B. in Windows unter C:\Programme\OpenEstate-ImmoTool
installiert ist, wird ein Projekt mit dem Namen test standardmäßig im Ordner C:\Programme
\OpenEstate-ImmoTool\projects\test abgelegt.
F:
Wie kann ich mein Projekt an eine andere Stelle verschieben?
A:
• Verschieben (oder kopieren) Sie das Projektverzeichnis mit dem Betriebssystem (z.B. Windows
Explorer) an eine andere Stelle, z.B. auf einen USB-Stick.
• Wenn das alte Projektverzeichnis nicht mehr existiert, sollte das Programm beim nächsten Start
einen Fehler feststellen (ungefährer Wortlaut: „letztes Projekt nicht gefunden“).
• Die Frage, ob ein neues Projekt erzeugt werden soll, kann mit Ja beantwortet werden. Darauf
öffnet sich der Projektassistent.
• Klicken Sie im Projektassistenten unten rechts auf Projekt öffnen und wählen Sie das ProjektVerzeichnis aus, z.B. auf dem USB-Stick.
• Beim nächsten Programmstart wird das Projekt automatisch vom neuen Speicherort geöffnet.
Projektassistent
Der Projektassistent hilft Ihnen bei der Erstellung eines neuen Projektes.
Erster Start. Beim ersten Start des Programmes öffnet sich der Projektassistent, und Sie werden
aufgefordert ein Projekt anzulegen.
Ein neues Projekt erzeugen. Wenn Sie die Angaben in allen Karteireitern vorgenommen haben,
speichern Sie Ihr Projekt mit dem Button Projekt erzeugen. Das erzeugte Projekt wird daraufhin
automatisch geöffnet.
Folgende Starts. Bei folgenden Starts wird das zuletzt verwendete Projekt automatisch geladen.
Ein neues Projekt erzeugen
Projektdaten bearbeiten
Projekt-Name. Tragen Sie hier den Namen Ihres Projektes ein. Verwenden Sie möglichst keine
Umlaute oder Sonderzeichen.
Verzeichnis. Es ist standardmäßig ein Pfad voreingestellt. Diesen können Sie im Regelfall einfach
beibehalten. Bei Bedarf kann ein anderer Pfad gewählt werden, z.B. eine externe Datenquelle in Ihrem
System.
Lizenz bestätigen. Bitte bestätigen Sie die Nutzungslizenz des ImmoTools, bevor Sie Ihr Projekt
erzeugen.
31
Allgemein
Abbildung 2.1.3. Projekt-Asssistent / Eigenschaften des Projektes
Firmendaten bearbeiten
Tragen Sie hier Ihre Unternehmensdaten ein. Die installierten Add-Ons greifen an verschiedenen Stellen
auf diese Eingaben zurück. Farblich hinterlegte Felder sind Pflichtangaben.
Abbildung 2.1.4. Projekt-Asssistent / Firmendaten des Projektes
32
Allgemein
Add-Ons auswählen
Abbildung 2.1.5. Projekt-Asssistent / Aktivierte Add-Ons
Hier befindet sich die Übersicht der aktuell verfügbaren Add-Ons. Standardmäßig sind alle bei der
Installation verfügbare Add-Ons aktiviert. Deaktivieren Sie die Add-Ons, welche Sie nicht in Ihrem Projekt
verwenden möchten.
Anmerkung
Eine nachträgliche Änderung dieser Einstellungen ist jederzeit möglich, siehe Add-Ons /
Module.
Das neue Projekt speichern & öffnen
Speichern Sie das neu angelegte Projekt mit dem Button Projekt erzeugen.
Ein existierendes Projekt öffnen
...
Zuletzt verwendetes Projekt öffnen
...
Einstellungen
Um Einstellungen am Programm vorzunehmen, klicken Sie im Hauptmenü auf Extras → Einstellungen.
33
Allgemein
Abbildung 2.1.6. Allgemeine-Einstellungen
Netzwerk-Einstellungen
• Wenn Sie für HTTP- und / oder FTP-Verbindungen ins Internet einen Proxyserver verwenden, können
Sie dies hier der Software mitteilen.
• Sollte dies der Fall sein, entfernen Sie den Haken bei „Keinen HTTP/FTP-Proxy verwenden“ und tragen
Sie Hostname / IP-Adresse sowie die Port-Nr des Proxy-Servers ein.
Anmerkung
Auf der Webseite der Entwickler können Sie ggf. weitere Informationen zur Konfiguration
der aktiven FTP-Übertragung erhalten.
Datenbank-Einstellungen
Automatische Sicherung
• Hier können Sie festlegen, wo und wann die automatische Datensicherung vollzogen wird.
Standardmäßig ist bereits ein Verzeichnis eingetragen, welches Sie bei Bedarf ändern können, z.B. bei
Sicherung auf einer externen Festplatte oder einem USB-Stick.
• Für den Zeitpunkt der Datensicherung werden Ihnen mehrere Optionen angeboten. Markieren Sie ein
gewünschtes Intervall, und speichern die Einstellung mit dem Button Übernehmen.
Manuelle Sicherung
Um eine sofortige Datenbanksicherung durchzuführen, z.B. nach umfangreichen Eingaben neuer
Immobilien, finden Sie im Kapitel Datenbank weitere Hinweise.
Speichern
Jede Änderung im Formular muss durch Klick auf Übernehmen dauerhaft gespeichert werden. Wird das
Fenster einfach geschlossen, gehen ungespeicherte Eingaben verloren!
Anmerkung
Das Speichern ist zu jedem Zeitpunkt der Bearbeitung möglich. Sollten relevante Eingaben
fehlen, so weist dass System Sie darauf hin.
34
Allgemein
Add-Ons / Module
Über die Add-On-Verwaltung können Sie Add-Ons installieren / deinstallieren, aktivieren / deaktivieren
und aktualisieren. Zur Add-On-Verwaltung gelangen Sie über den Menüpunkt Extras → Add-Ons.
Abbildung 2.1.7. Add-On-Verwaltung aufrufen
Abbildung 2.1.8. Add-Ons-Verwaltung
Add-Ons installieren / deinstallieren
Installation
• Zum Installieren eines Add-Ons muss dessen Installationsdatei bereits auf Ihrer Festplatte gespeichert
sein.
• Klicken Sie zur Installation auf dem Button Add-On hinzufügen.
• Es öffent sich ein Dialogfenster, in welchem Sie den Pfad zum zu installierenden Add-Ons auswählen,
mit der Maus die Insatallationsdatei markieren und die Auswahl übernehmen.
• Wenn die Installation des Add-Ons gaklappt hat wird dieses in der Übersicht eingefügt. Im Fehlerfall
wird Ihnen in einem weiteren Fenster das Fehlerprotokoll angezeigt. Dieses können Sie ggf. speichern
und uns z.B. via Ticketsystem zur Fehelranalyse zusenden.
35
Allgemein
• Native ImmoTool-Add-Ons sind nach der Installation bereits aktiviert.
Anmerkung
Sie erhalten die Installationsdateien von den jeweiligen Add-On-Entwicklern.
Deinstallation
Ein installiertes Add-On kann jederzeit wieder deinstalliert werden.
Achtung
Die damit verbunden Funktionen stehen Ihnen dann nicht mehr zur Verfügung.
Anmerkung
Wenn Sie sich nicht sicher sein sollten, ob Sie das Add-On ggf. doch noch einmal benötigen
sollten Sie es nur deaktivieren.
• Markieren Sie das zu deinstallierende Add-On mit der Maus. Dieses wird farbig hinterlegt und die
Optionen werden angezeigt.
• Klicken Sie in den Optionen auf Deinstallieren um das gewählte Add-On zu entfernen. Sie werden mit
einer Sicherheitsabfrage gebeten die Löschung zu bestätigen.
Add-Ons aktualisieren
Die verfügbaren Add-Ons können automatisch und manuell auf den neuesten Stand gebracht werden,
sollten die Entwickler zwischenzeitlich Aktualisierungen veröffentlicht haben.
automatische Aktualisierung
Bei Bedarf kann das ImmoTool automatisch beim Programmstart in einem Hintergrundprozess nach
Updates suchen.
Anmerkung
Eine automatische Suche nach Aktualisierungen beim Programmstart können Sie in den
Programmeinstellungen einrichten.
manuelle Aktualisierung
• Klicken Sie im Menü Extras auf den Menüpunkt Add-Ons.
• Um nach Aktualisierungen der Add-Ons zu suchen, klicken Sie auf den Button Neue Versionen suchen.
• Sind Aktualisieren für die Add-Ons vorhanden, so werden Ihnen diese zur automatischen Installation
angeboten. Andernfalls bekommen Sie die Meldung angezeigt, dass Keine Aktualisierungen gefunden
wurden.
• Nach einer Aktualisierung muss das Programm neu gestartet werden, damit diese wirksam wird.
Anmerkung
Zur Aktualiesierung der Add-Ons benötigen Sie eine offene Internetverbindung!
36
Allgemein
Add-Ons aktivieren / deaktivieren
Sollten Sie ein Add-On nicht benötigen, müssen Sie es nicht komplett löschen. Sie können es auch
deaktivieren, dann wird es im Projekt nicht weiter verwendet, bleibt aber noch vorhanden.
• Klicken Sie im Menü Extras auf den Menüpunkt Add-Ons.
• Markieren Sie ein zu bearbeitendes Add-On mit der Maus. Dieses wird farbig hinterlegt und dessen
Optionen werden angezeigt.
• Zum Aktivieren / Deaktivieren setzen / entfernen Sie die Option Aktivieren.
Aktualisierungen
Zur Programmaktualisierung gelangen Sie über den Menüpunkt Extras → Aktualisierung.
Abbildung 2.1.9. Aktualisierungen aufrufen
automatische Aktualisierung
Bei Bedarf kann die Software automatisch beim Programmstart in einem Hintergrundprozess nach Updates
suchen.
Anmerkung
Die automatische Aktualisierung können Sie in den Programmeinstellungen konfigurieren.
manuelle Aktualisierung
• Um manuell nach Aktualisierungen des Programms (und der Add-Ons) zu suchen klicken Sie im ExtrasMenü auf Aktualisierung.
• Während der Suche nach Updates wird Ihnen ein Protokollfenster angezeigt, welches Sie über den
Fortschritt informiert.
• Wenn Aktualisierungen gefunden wurden, werden Sie gefragt, ob die gefundenen Dateien installiert
werden sollen. Wenn Sie auf Ja klicken, werden die Aktualisierungen heruntergeladen und installiert.
• Nach erfolgter Aktualisierung schließt sich das Programm selbstständig. Erst durch einem Neustart
werden die Änderungen wirksam.
Datenbank
Zu den Datenbankfunktionen gelangen Sie über den Menüpunkt Extras → Datenbank. Hier können Sie
die Datenbank sichern, wieder herstellen, reorganisieren und neu aufbauen.
37
Allgemein
Abbildung 2.1.10. Menü Datenbank
Automatische Datenbanksicherung
Die automatische Datenbanksicherung kann in den Programmeinstellungen konfiguriert werden.
Manuelle Datenbanksicherung
Sie können aber jederzeit eine eine manuelle Sicherung der aktuellen Projektdatenbank als
Sicherungspunkt und ZIP-Archiv erzeugen.
• Klicken Sie im Menü auf Extras → Datenbank → Sicherung.
• Es wird daraufhin automatisch eine Sicherung Ihrer Datenbank erzeugt. Dieser Vorgang kann je nach
Umfang Ihrer Datenbank mehrere Minuten dauern.
• Sobald die Sicherungsdatei (Backup) erstellt wurde, werden Sie von der Software mit einem
Hinweisfenster informiert.
Anmerkung
Die Sicherungsdateien werden standardmäßig im Unterverzeichnis backup des
Projektverzeichnisses gespeichert. In den Programm-Einstellungen können Sie dieses
Verzeichnis ändern.
Datenbank wiederherstellen
Sie können jederzeit eine existierende Sicherungsdatei in die Projektdatenbank und das Projekt damit in
den Zustand zur damaligen Sicherung zurücksetzen.
Achtung
Bevor Sie eine Sicherungsdatei einspielen, sollten Sie in jedem Falle den aktuellen Zustand
sichern.
• Klicken Sie im Datenbank-Menü (siehe oben) auf den Menüpunkt Wiederherstellung.
• Wählen Sie im folgenden Dialogfenster eine Sicherungsdatei aus und klicken Sie auf Sicherungsdatei
öffnen.
• Sicherheitshalber werden Sie nochmal gewarnt, dass eine Wiederherstellung zu Datenverlusten führen
kann. Bestätigen Sie diese Warnung mit Ja um die gewählte Datei einzulesen.
Anmerkung
Um Ihnen das Auffinden einer bestimmten Sicherungsdatei zu erleichtern ist der Dateiname
wie folgt aufgebaut:
38
Allgemein
db_[Jahr]-[Monat]-[Tag]_[Stunde][Minute].zip.
Zertifikate
Sobald an einer Stelle im Programm eine SSL-Verschlüsselung stattfindet, wird beim erstmaligen
Verbindungsaufbau das SSL-Zertifikat von der Gegenstelle heruntergeladen und Ihnen zur Prüfung
vorgelegt.
Anmerkung
Ein SSL-Zertifikat besitzt immer eine bestimmte Lebensdauer. Sobald diese „Lebenszeit“
abgelaufen ist, muss die Gegenstelle ein neues SSL-Zertifikat bereitstellen. Das neue SSLZertifikat wird dann erneut beim erstmaligen Verbindungsaufbau heruntergeladen und Ihnen
zur Prüfung vorgelegt.
Wichtig
Es ist Vorsicht geboten, wenn sich das SSL-Zertifikat einer Gegenstelle ändert und Sie dieses
erneut bestätigen / prüfen sollen. Um sich vor sogenannten Man-in-the-middle-Angriffen
[http://de.wikipedia.org/wiki/Man-in-the-middle-Angriff] zu schützen, sollten Sie sich im
Zweifelsfall von der jeweiligen Gegenstelle die Korrektheit des neuen SSL-Zertifikates
bestätigen lassen.
Prüfung eines SSL-Zertifikates
Sobald erstmals eine SSL-verschlüsselte Kommunikation stattfindet, wird das folgende Fenster mit den
Details des SSL-Zertifikates der Gegenstelle dargestellt.
Abbildung 2.1.11. Details eines SSL-Zertifikates
SSL-Zertifikat von „google.com“
39
Allgemein
Verwaltung der SSL-Zertifikate
Klicken Sie im Hauptmenü auf Extras → Zertifikate um die bereits bestätigten SSL-Zertifikate einsehen
und bearbeiten zu können.
Abbildung 2.1.12. Verwaltung der SSL-Zertifikate
Auf der linken Seite wird eine Liste der bereits erfassten SSL-Zertifikate dargestellt. Wählen Sie einen
der Einträge in der Liste aus, um auf der rechten Seite weitere Details über das gewählte SSL-Zertifikat
dargestellt zu bekommen.
Aktionen in der Zertifikate-Verwaltung
Zertifikat importieren
Klicken Sie auf den Button Einfügen. Es erscheint daraufhin ein
Untermenü mit folgenden Einträgen:
Zertifikat aus Datei laden. Verwenden Sie diese Option, um das
SSL-Zertifikat aus einer Datei zu importieren, die auf Ihrem Rechner
abgelegt ist.
Zertifikat von Server herunterladen. Verwenden Sie diese
Option, um das SSL-Zertifikat von einem Server herunterzuladen.
Dabei muss Hostname / IP-Adresse des Servers sowie dessen Port-Nr
angegeben werden.
Zertifikat entfernen
Markieren Sie das zu entfernende SSL-Zertifikat in der Liste und
klicken Sie auf Entfernen um den gewählten Eintrag aus dem
Programm zu entfernen.
Zertifikat exportieren
Markieren Sie das zu entfernende SSL-Zertifikat in der Liste und
klicken Sie auf Export um den gewählten Eintrag als separate Datei
auf Ihrem Rechner zu speichern.
Um die Änderungen an den vertrauenswürdigen SSL-Zertifikaten dauerhaft zu speichern, muss auf
Übernehmen geklickt werden. Wenn die Änderungen nicht gespeichert werden sollen, kann auf Abbrechen
geklickt werden.
40
Allgemein
Protokolle
Während des Programmverlaufes auftretende Warnungen, Probleme oder Fehler werden im Hintergrund
automatisch protokolliert. Die Protokolldateien werden im Unterverzeichnis logs des Programmes
tageweise abgelegt.
Klicken Sie im Hauptmenü auf Extras → Protokolle um die derzeit vorliegenden Protokolle einzusehen.
Abbildung 2.1.13. Einstellungen
Es werden verschiedene Arten von Protokolldateien erstellt.
Arten von Protokollen
System-Protokolle
Das Protokoll system.log speichert die Systemmeldungen des
ImmoTools.
Datenbank-Protokolle
Das Protokoll exist.log speichert Warnungen & Fehler der
ImmoTool-Datenbank.
Anmerkung
Die Protokolldateien des aktuellen Tages haben kein Datum im Namen (z.B.
system.log). Ältere Dateien tragen im Namen das jeweilige Datum der Erstellung (z.B.
system.log.2012-01-20).
Protokoll speichern
Auf Anfrage der Supportmitarbeiter kann es nötig werden die Protokolle zu übermitteln. Wählen Sie in der
Auswahlbox die zu speichernde Protokolldatei und klicken Sie auf Speichern. Es erscheint ein Untermenü
mit zwei Optionen.
Speichern als Datei. Das Protokoll wird in einer separaten Datei gespeichert und kann z.B. als Anhang
einer E-Mail verschickt werden.
Speichern in die Zwischenablage. Das Protokoll wird in die Zwischenablage gespeichert und kann
z.B. in den Text einer E-Mail kopiert werden.
Nutzungslizenz
Lizensieren Sie Ihre ImmoTool-Installation und nehmen Sie aktiv an der Weiterentwicklung teil!
41
Allgemein
Abbildung 2.1.14. Lizenz verwalten
OpenEstate-Lizenz
Zum Download und Betrieb der Software ist kein Lizenzschlüssel nötig. Jedoch erhalten nur jene
Anwender Support, welche einen Lizenzschlüssel beantragt haben. Die Beantragung der Schlüssel erfolgt
im Anwenderbereich.
• Klicken Sie im Extras-Menü (siehe oben) auf den Menüpunkt Lizenz verwalten.
• Tragen Sie Ihren Lizenzschlüssel in das Eingabefeld ein.
• Klicken Sie auf Überprüfen um den Lizenzschlüssel auf Gültigkeit zu überprüfen. Sollte der
Lizenzschlüssel ungültig sein, so überprüfen Sie Ihre Eingabe auf Tippfehler.
• Um den Lizenzschlüssel dauerhaft zu speichern, klicken Sie auf Übernehmen.
Abbildung 2.1.15. Eingabe des Lizenzschlüssels
Fremde Modul-Lizenzen
Module anderer Anbieter sind noch nicht vorhanden. Bei Interesse ein eigenes Modul zu entwickeln,
wenden Sie sich an die OpenEstate-Entwickler. Wir helfen Ihnen gern weiter.
42
Kapitel 2.2. Immobilien
In
diesem
Kapitel
werden
die
Immobilienverwaltung dokumentiert.
Funktionen
der
Mit diesem Modul können Immobilien verwaltet werden. Die folgenden Bestandteile werden in das
Programm integriert, wenn die Komponente OpenEstate-Tool-Agency installiert und aktiviert wurde:
Abbildung 2.2.1. Menüeintrag der Immobilienverwaltung
Abbildung 2.2.2. Untermenü
Immobilienverwaltung
zum
43
Erzeugen
neuer
Einträge
in
der
Immobilien
Abbildung 2.2.3. Ansichtsbereich der Immobilienverwaltung
Immobilien verwalten
Innerhalb eines Projektes können beliebig viele Immobilien verwaltet werden. Die Übersicht der
gepseicherten Immobilien kann auf zweierlei Wegen geöffnet werden:
1. Klicken Sie im Hauptmenü auf den Eintrag Immobilien → Immobilien anzeigen um die
Immobilienübersicht zu öffnen.
2. Öffnen Sie die Immobilienansicht und klicken Sie im Ansichtsbereich auf den Eintrag Immobilien.
Abbildung 2.2.4. Immobilienübersicht
Filterkriterien verwenden
Oberhalb der Tabelle werden verschiedene Eingabefelder dargestellt, um den Immobilienbestand
eingrenzen zu können. Die Ansicht der Tabelle wird automatisch aktualisiert, sobald ein Kriterium
geändert wurde.
Aktionen ausführen
Markieren Sie in der Tabelle eine oder mehrere Immobilien. Klicken Sie danach auf den Button Aktionen,
um das Aktionsmenü darzustellen.
44
Immobilien
Abbildung 2.2.5. Aktionsmenü in der Immobilienübersicht
Folgende Aktionen stehen zur Verfügung:
• Immobilie öffnen. Wählen Sie diese Aktion, um die markierten Immobilien zur Bearbeitung zu
öffnen.
• Immobilie duplizieren. Wählen Sie diese Aktion, um eine Kopie der markierten Immobilien zu
erzeugen.
• Immobilie löschen. Wählen Sie diese Aktion, um die markierten Immobilien dauerhaft aus der
Datenbank zu löschen.
• Status ändern. Ändern Sie den Status der markierten Immobilien, ohne das Immobilienformular
dafür öffnen zu müssen.
• Mitarbeiter zuordnen. Ändern Sie den Ansprechpartner der markierten Immobilien, ohne das
Immobilienformular dafür öffnen zu müssen.
• PDF-Exposé erzeugen. Erzeugen Sie ein Exposé im PDF-Format für die markierten Immobilien.
• Export durchführen. Starten Sie einen Immobilienexport für die markierten Immobilien.
• Sicherung auf Festplatte. Speichern Sie die markierten Immobilien als XML-Datei auf der
Festplatte unter Verwendung einer Export-Schnitttelle.
Tipp
Wenn mehrere Zeilen in der Tabelle markiert wurden (z.B. mit gedrückter STRG- / ShiftTaste), wird die Aktion auf mehreren Immobilien durchgeführt.
Immobilien durchsuchen
Alle bereits gespeicherten und aktiven Suchanfragen werden im Auswahlfeld Suche dargestellt. Wählen
Sie eine der Suchanfragen aus, um die Suche auf dem Immobilienbestand durchzuführen.
Um eine neue Suchanfrage zu erzeugen, klicken Sie auf den Button mit der Lupe neben dem Auswahlfeld
für die Suchanfragen. Es öffnet sich daraufhin ein Dialogfenster zur Erstellung einer Suchanfrage.
45
Immobilien
Abbildung 2.2.6. Immobilienbestand durchsuchen
Folgende Angaben können im Suchformular hinterlegt werden:
• Bezeichnung. Wenn die Suchanfrage dauerhaft gespeichert werden soll, wählen Sie eine möglichst
passende Bezeichnung um diese später leicht wieder erkennen zu können.
• Suchanfrage dauerhaft seichern. Aktivieren Sie diese Option, wenn die Suchanfrage dauerhaft
gespeichert werden soll. Andernfalls wird die Suchanfrage beim Schließen der Immobilienübersicht
verworfen.
• Suchkriterien bearbeiten. Wählen Sie eines oder mehrere Kriterien zur Immobiliensuche aus.
Klicken Sie abschließend auf Übernehmen um die Suchanfrage auf dem Immobilienbestand auszuführen.
Das Resultat der Suche wird in der geöffneten Immobilienübersicht dargestellt.
Immobilie bearbeiten
Allgemeine Eckdaten
Reiter "Allgemein"
In den Eckdaten sind allgemein gültige Eigenschaften einer Immobilie zusammengefasst.
Titel. Hinterlegen Sie einen aussagekräftigen und nicht zu langen Titel für diese Immobilie. Das erhöht
ggf. die Wahrscheinlichkeit einer besseren Googleindizierung, wenn Portale diesen auch als Titel für ihr
HTML-Exposé verwenden.
46
Immobilien
Anmerkung
Der Titel wird in allen Sprachen angezeigt, welche in den Spracheinstellungen aktiviert
wurden. Durch einen Mausklick auf die Checkbox neben der Landesflagge können Sie für
diese Immobilie eine oder mehrere Sprachen aktivieren. Eine Sprache ist Pflicht. Derzeit sind
die uns bekannten deutschen Portale nicht in der Lage mehrsprachige Inserate zu importieren.
Für den Website-Export können Sie aber die Mehrsprachigkeit bereits verwenden.
Objekt-Nr: Dieses Feld ist für Ihre von Ihnen selbst vergebene intern Objektnummer vorgesehen. Von
einigen Portalen wird diese zur Indentifikation Ihrer Inserate benötigt.
Anmerkung
Nach dem Versand der Immobilie an Portale sollten Sie diese Nummer nicht mehr ändern, da
dieses Inserat sonst in den Portalen ggf. neu angelegt wird, und dann doppelt vorhanden sein
kann. Sollte eine neue Vergabe der Nummer notwendig sein, so löschen Sie diese Immobilie
zuerst in den Portalen.
Währung. EUR ist voreingestellt, und sollte nur geändert werden, wenn Schnittstellen zu Portalen mit
anderen Währungen verfügbar sind.
Objekt-ID. Die Objekt-ID wird beim Speichern von System vergeben, und dient internen Zwecken.
Import-ID. Die Import-ID wird ggf. beim Import von Immobilien verwendet.
Status. Wählen Sie einen Status für diese Immobilie.
Anmerkung
Der Status muss auf "2. in Vermittlung" gesetzt sein, damit die Immobilie bei den Exporten
berücksichtigt wird.
gültig von / gültig bis. Wählen Sie ggf. je ein Datum für den Beginn und das Ende des
Vermittlungszeitraumes dieser Immobilie.
Gruppennummer. Vergeben Sie ggf. eine Gruppennummer damit diese Immobilie mit anderen
Immobilien ihres Bestands z.B. bei IS24 gruppiert dargestellt wird.
Adresseingabe. Manche Portale, wie z.B. Immobiliare.it und IS24, benötigen spezifische regionale
Angaben bei Auslandsobjekten. Wenn Sie an ein solches Portal ausländische Inseratsdaten senden, so
wählen Sie in der Selectbox das jeweilige Portal und ordnen Sie es der entsprechenden Region zu bis keine
weitere Zuordnung in den Unterregionen mehr möglich ist.
Anmerkung
Um diese spezifischen Regionen verfügbar zu haben müssen Sie die jeweilige
Datenbankerweiterung instalieren. Diese finden Sie unter dev.openestate.org [http://
dev.openestate.org/applications/1/#download] im Abschnitt Geodaten.
Anschrift / Adresseingabe. Geben Sie die Adressdaten zur Immobilie ein.
Geokoordinaten. Geben Sie, wenn verfügbar, die Geokoordinaten der Immobilie ein. Die Option
Geokoordinaten sollten Sie nur dann aktivieren, wenn mindestens ein von Ihnen beliefertes Portal diese
verwendet.
47
Immobilien
Abbildung 2.2.7. Immobilienformular Eckdaten
Spezifikation der Immobilie
Reiter "Immobilie"
In diesem Bereich wird die Immobilie mit ihren Eigenschaften beschrieben.
1. Spezifizieren Sie zuerst die Immobilienart so genau wie es ihnen möglich ist. Z.B. Wohnimmobilie /
Haus / Doppelhaus / Doppelhaushälfte.
2. Wählen Sie danach die passende Vermarktungsart.
3. Nach der Eingabe dieser Informationen wird die Attributtabelle ermittelt und dargestellt.
4. Füllen Sie die Attributtabelle mit den ihnen bekannten Daten aus. Rechts des Eingabefeldes werden die
zugelassenen Datentypen angezeigt.
5. Attribute mit freier Texteingabe befinden sich unter den Reitern mit den Länderflaggen.
Anmerkung
Ist ein Feld vom Typ Auswahl (mehrfach), so öffnet sich ein drop-down Menü. Wählen Sie
den gewünschten Eintrag per Mausklick aus. Sollten mehrere Einträge gewünscht werden
wiederholen Sie den Vorgang. Wenn Sie einen Wert entfernen wollen klicken Sie erneut
darauf.
48
Immobilien
Abbildung 2.2.8. Immobilientyp definieren
Abbildung 2.2.9. Attribute eingeben
Abbildung 2.2.10. Attribute mit Mehrfachauswahl
49
Immobilien
Freitexte & Beschreibungen
Nachdem eine Immobilien- & Vermarktungsart gewählt wurde (siehe oben), können zusätzliche
Beschreibungstexte zur Immobilie hinterlegt werden.
1. Aktivieren Sie hier die Reiter mit den verfügbaren Sprachen, und füllen die gewünschten Felder mit
den entsprechenden Inhalten aus.
Anmerkung
Die Freitexte und frei belegbaren Attribute werden in allen Sprachen angezeigt, welche in
den Spracheinstellungen aktiviert wurden.
Achtung
HTML-Sonderzeichen sind nicht erlaubt und werden beim Speichern automatisch entfernt.
Fotos und Dateien
Reiter "Medien"
Zu jeder Immobilie können beliebig viele Bilder und Dateien hinterlegt werden. Eine verkleinerte
Vorschau der verfügbaren Bilder wird rechts dargestellt.
Fotos und Dateien hinzufügen. Klicken Sie auf den Button importieren, um eine Grafik- oder andere
Datei von Ihrer Festplatte der Immobilie zuzuordnen. In dem folgenden Dialogfenster können Sie ein
(Mausklick) oder mehrere Bilder und Dateien (STRG + Mausklick) markieren. Mit den Button Foto(s)
importieren übernehmen Sie diese ausgewählten dateien in die Software und verknüpfen diese mit der
gewählten Immobilie.
Anmerkung
Beim Import der Dateien erkennt das ImmoTool automatisch Bilder und sonstigen Dateien,
und ordnet diese der Fotogalerie oder dem Dateiarchiv zu.
Fotos bearbeiten. Nach dem Import können Sie jedes Foto einzeln durch Anklicken in der Übersicht
aufrufen und weiter bearbeiten.
1. Geben Sie zum Bild einen kurzen Beschreibungstext in den gewünschten Sprachen ein. Verfügbar sind
alle Sprachen, welche in den Spracheinstellungen aktiviert, bzw. unter dem Reiter Allgemein nicht
deaktiviert wurden.
2. Wählen Sie unter Bildart eine Gruppe, z.B. Innenansicht, aus.
3. Wählen Sie ein Format, in welchem das Bild in der Datenbank gespeichert werden soll. Zugelassen
sind JPG und PNG. Aufgrund der geringeren Dateigröße ist JPG zu bevorzugen.
4. Legen Sie unter Bild veröffentlichen fest, ob das jeweilige Bild in den Portalexporten und Exposés
verfügbar sein soll.
5. Mit den rötlichen Pfeil-Buttons können Sie das gewählte Bild horizontal bzw. vertikal Spiegel, und
nach rechts oder links in 90 Grad-Schritten drehen.
Fotos entfernen. Wählen Sie das zu entfernende Foto in der Vorschau aus und klicken Sie auf
Entfernen. Das Bild wird ohne weitere Rückfrage unwiderruflich gelöscht.
Fotos sortieren. Sie können die Sortierung der Fotos jederzeit ändern. Hierfür markieren Sie ein Foto
in der rechten Übersicht mit der Maus und verschieben es mit den blauen Pfeil-Buttons nach oben oder
50
Immobilien
nach unten bis die gewünschte Position erreicht ist. Sie können ein Foto auch mittels Drag and Drop an
die gewünschte Postion setzen.
Fotos exportieren. Sollten Sie ein Bilder für eine andere Anwendung benötigen, so klicken Sie auf
Exportieren, wählen im erscheinenden Dialogfenster das Ziel und geben den gewünschten Dateinamen an.
Anmerkung
1. Es werden die gängigen Bildformate (JPG, PNG, GIF, TIF) unterstützt.
2. Importierte Fotos werden in der Datenbank gespeichert und müssen nicht dauerhaft auf
der Festplatte verfügbar bleiben.
Abbildung 2.2.11. Bilder zur Immobilie importieren
Dateien bearbeiten. Nach dem Import können Sie jedes Foto einzeln durch Anklicken in der Übersicht
aufrufen und weiter bearbeiten.
1. Geben Sie zur Datei einen kurzen Beschreibungstext in den gewünschten Sprachen ein. Verfügbar sind
alle Sprachen, welche in den Spracheinstellungen aktiviert, bzw. unter dem Reiter Allgemein nicht
deaktiviert wurden.
2. Wählen Sie unter Dateiart eine Gruppe, z.B. Innenansicht, aus.
3. Legen Sie unter Datei veröffentlichen fest, ob die jeweilige Datei in den Portalexporten und Exposés
verfügbar sein soll.
Dateien entfernen. Wählen Sie die zu entfernende Datei in der Vorschau aus und klicken Sie auf
Entfernen. Die Datei wird ohne weitere Rückfrage unwiderruflich gelöscht.
Dateien exportieren. Sollten Sie eine Datei für eine andere Anwendung benötigen, so klicken Sie
auf Exportieren, und wählen im erscheinenden Dialogfenster das Ziel, und geben den gewünschten
Dateinamen an.
Kontaktperson
Reiter "Mitarbeiter"
51
Immobilien
Zu jeder Immobilie kann eine Kontaktperson hinterlegt werden. Diese wird beim Export an
Immobilienportale bzw. bei Exposé-Darstellungen als Ansprechpartner dargestellt. Sollte keine
Kontaktperson ausgewählt werden, wird auf die Firmendaten zurückgegriffen.
Eine Ansprechpartner als Kontaktperson auswählen.
Markieren Sie das Optionsfeld
Ansprechpartner auswählen. Im deneben stehenden Auswahlfeld kann der gewünschte Ansprechpartner
ausgewählt werden. Die Daten des gewählten Ansprechpartners werden im darunter stehenden Formular
angezeigt, können hier aber nicht bearbeitet werden.
Einen neuen Ansprechpartner zur Kontaktperson machen. Markieren Sie das Optionsfeld Neuen
Ansprechpartner erzeugen. Im darunter stehenden Formular können die Daten des neuen Ansprechpartners
eingegeben werden.
Keine Kontaktperson angeben. Markieren Sie das Optionsfeld Keinen Ansprechpartner verwenden.
Abbildung 2.2.12. Kontaktperson angeben
Exporte
Reiter "Exporte"
Schnittstellen. Hier können Sie diese Immobilie den vorhandenen Schnittstelle zuordnen. Wählen Sie
zwischen NIE, IMMER oder AUSGEWÄHLTEN SCHNITTSTELLEN.
1. NIE. Diese Immobilie wird bei keinem Export berücksichtigt.
2. IMMER. Diese Immobilie wird bei jedem Export an alle eingerichtete / aktive Portale gesendet.
3. AUSGEWÄHLTEN SCHNITTSTELLEN. Diese Immobilie wird an die ausgewählten Portale
gesendet. Um eine Schnittstelle zuzuordnen markieren Sie diese mit der Maus.
Exporthistorie. Hier können Sie die Exporthistorie dieser Immobilie einsehen, wenn diese exportiert
wurde.
52
Immobilien
Abbildung 2.2.13. Exporthistorie zu dieser Immobilie
Abbildung 2.2.14. Exportschnittstellen verknüpfen
Adressen
Reiter "Adressen"
Zu jeder Immobilie können beliebig viele Kontaktperson hinterlegt werden.
Bestehende Adresse zuordnen (verknüpfen). Sollte die gewünschte Adresse bereits im Adressbuch
verfügbar sein klicken Sie auf Neue Zuordnung und wählen im sich öffnenden Fenster die Adressgruppe,
in welcher sich die Adresse befindet, und anschließend die Adresse selbst. Im Feld Zuordnung wählen
Sie unter Eigentümer | Interessent | Käufer / Mieter. Nach Betätigung des Button Übernehmen wird diese
Adresse der Immobilie zugeordnet, und erscheint nun im Fenster Bereits zugeordnete Adressen.
Adresse anlegen. Ist die gewünschte Adresse noch nicht vorhanden, so klicken Sie auf den Reiter neue
Adresse, und belegen die gewünschten Felder mit Einträgen. Danach klicken Sie auf den Button Adresse
zuordnen & speichern um die Adresse zu speichern und der Immobilie zuzuordnen.
Adressverknüpfung bearbeiten. Um die Verknüpfung zu bearbeiten markieren Sie den Eintrag in der
Liste mit der rechten Maustaste und wählen Zuordnung bearbeiten. Bearbeiten Sie nun die Verknüpfung
und speichern Sie diese mit dem Button Übernehmen. Alternativ markieren Sie den entsprechenden
Eintrag mit der Maus und klicken auf den Button Aktionen und Zuordnung bearbeiten.
53
Immobilien
Adressverknüpfung löschen. Um die Verknüpfung zu löschen markieren Sie den Eintrag in der Liste
mit der rechten Maustaste und wählen Zuordnung entfernen. Alternativ markieren Sie den entsprechenden
Eintrag mit der Maus und klicken auf den Button Aktionen und Zuordnung entfernen.
Abbildung 2.2.15. Zugeordnete Adressen zu dieser Immobilie
Abbildung 2.2.16. Neue Adresse zu dieser Immobilie
54
Immobilien
Abbildung 2.2.17. Vorhandene Adresse mit dieser Immobilie verknüpfen
Kalender
Reiter "Kalender"
Zu jeder Immobilie können beliebig viele Kalendereinträge hinterlegt werden.
Bestehenden Kalendereintrag zuordnen (verknüpfen). Sollte der gewünschte Kalendereintrag
bereits im Kalender verfügbar sein klicken Sie auf Neue Zuordnung und wählen im sich öffnenden Fenster
die Kalendergruppe, in welcher sich der Kalendereintrag befindet, und anschließend den Eintrag selbst.
Nach Betätigung des Button Übernehmen wird dieser Kalendereintrag der Immobilie zugeordnet, und
erscheint nun im Fenster zugeordnete Kalendereinträge.
Kalendereintrag anlegen. Ist der gewünschte Kalendereintrag (Aufgabe / Termin) noch nicht
vorhanden, so klicken Sie auf den Reiter neue Aufgabe oder neuen Termin, und belegen die gewünschten
Felder mit Einträgen. Danach klicken Sie auf den Button Aufgabe speichern & zuordnen oder Termin
speichern & zuordnen um den Kalendereintrag zu speichern und der Immobilie zuzuordnen.
Kalendereintrag bearbeiten. Um die Verknüpfung zu bearbeiten markieren Sie den Eintrag in der
Liste mit der rechten Maustaste und wählen Zuordnung bearbeiten. Bearbeiten Sie nun die Verknüpfung
und speichern Sie diese mit dem Button Übernehmen. Alternativ markieren Sie den entsprechenden
Eintrag mit der Maus und klicken auf den Button Aktionen und Zuordnung bearbeiten.
Kalendereintrag löschen. Um die Verknüpfung zu löschen markieren Sie den Eintrag in der Liste
mit der rechten Maustaste und wählen Zuordnung entfernen. Alternativ markieren Sie den entsprechenden
Eintrag mit der Maus und klicken auf den Button Aktionen und Zuordnung entfernen.
55
Immobilien
Abbildung 2.2.18. Zugeordnete Termine dieser Immobilie
Abbildung 2.2.19. Neue Aufgabe zu dieser Immobilie
Abbildung 2.2.20. Neuer Termine zu dieser Immobilie
56
Immobilien
Abbildung 2.2.21. Vorhandene Termine mit dieser Immobilie verknüpfen
Notizen
Reiter "Notizen"
Hier können Sie beliebige Notizen zu dieser Immobilie hinterlegen, welche an keiner anderen Stelle
Verwendung finden. Also auch nicht bei den Exporten berücksichtigt wird.
Abbildung 2.2.22. Vorhandene Termine mit dieser Immobilie verknüpfen
Änderungen Speichern
Um die Änderungen im Immobilienformular dauerhaft zu speichern, klicken Sie oben rechts auf den
Button Speichern.
Anmerkung
Das Speichern ist zu jedem Zeitpunkt der Bearbeitung möglich. Sollten relevante Eingaben
fehlen, so weist dass System darauf hin.
Achtung
Jede Änderung im Immobilienformular muss mindestens am Ende der Bearbeitung durch
Klick auf Speichern dauerhaft gespeichert werden. Wird das Fenster einfach geschlossen,
werden Sie darauf hingewiesen, dass nicht gespeicherte Änderungen vorliegen. Bestätigen
Sie die Sicherheitsabfrage mit ja, wird die Immobilie geschlossen, und die ungespeicherte
Eingaben gehen verloren! Bestätigen Sie die Sicherheitsabfrage mit nein, können Sie die
Änderungen speichern bevor Sie die Immobilie schließen.
57
Immobilien
Immobilien exportieren
Mit dem ImmoTool können gespeicherte Immobiliendaten zusammengestellt und an externe Partner (z.B.
Immmobilienportale) versendet werden. Zur Schnittstellenverwaltung gelangen Sie auf zweierlei Wegen:
• Klicken Sie im Menü Immobilien auf den Eintrag Immobilien exportieren.
• Klicken Sie in der Sidebar auf den Eintrag Immobilien.
Es öffnet sich ein Fenster mit den registrierten Export-Schnittstellen.
Abbildung 2.2.23. Schnittstellenübersicht
Exportvorgang
Button "Export starten"
1. Öffnen Sie die Exportübersicht. (siehe oben).
2. Aktivieren bzw. deaktivieren Sie ggf. in der Tabelle die Export-Schnittstellen, welche Sie für diesen
Export verwenden / nicht verwenden möchten, und klicken Sie auf Export starten.
3. Die Immobilien werden zum Export zusammengestellt. Es öffnet sich ein Übersichtsfenster, in welchem
alle zu versendenden Immobilien aufgelistet werden. Nach Bedarf können Sie einzelne Immobilien
vom Export ausgeschlossen werden.
4. Klicken Sie abschließend auf Export starten um den Exportvorgang mit den gewählten Immobilien /
Schnittstellen zu beginnen.
58
Immobilien
Abbildung 2.2.24. Exportübersicht
Schnittstelle anlegen
1.
2.
3.
4.
Öffnen Sie die Exportübersicht (siehe oben) um die hinterlegten Schnittstellen einzusehen.
Klicken Sie in der Exportübersicht oben rechts auf Neu.
Es öffnet sich das Schnittstellenformular zur Erzeugung einer neuen Schnittstelle.
Zu den von uns getesteten Portalschnittstellen finden Sie im Wiki-Kapitel ImmoTool Portalexport
[http://wiki.openestate.org/Kategorie:ImmoTool_Portalexport] eine Hilfestellung zur Einrichtung.
Berücksichtigt sind hier Portale, weche von uns getestet wurden, oder zu welchen ImmoTool-Benutzer
erfolgreich senden konnten.
Allgemeine Einstellungen
Oberer Bereich im Schnittstellenformular
1. Bezeichnung: Tragen Sie hier einen Namen zu dieser Schnittstelle ein (z.B. IS24 XML).
2. Transport: Wählen Sie die geforderte Transportart aus, welche Ihnen der Datenempfänger benannt hat.
Die gebräuchlichste ist extern auf einen FTP-Server.
3. Format: Wählen Sie das geforderte Format aus, welches Ihnen der Datenempfänger benannt hat. Das
gebräuchlichste ist OpenImmo-XML.
4. Limitierung: Sie können hier einstellen, wie viele Inserate maximal gesendet werden. Tragen Sie hierfür
die gewünschte Anzahl ein, und entfernen den Haken auf Keine Limitierung verwenden.
Achtung
Diese Option schützt Sie nicht zwangsläufig vor der Überschreitung Ihres
Inseratskontingents.
Fragen Sie ggf. nach, wie die einzelnen Portale mit einer Überschreitung umgehen. Manche
veröffentlichen nicht mehr als gebucht. Andere berechnen Ihnen auch bei kurzfristiger Überschreitung
den entsprechenden Paketpreis. Das kann recht teuer werden.
59
Immobilien
5. Schnittstelle aktivieren: Standartmäßig ist diese Option auf aktiv gesetzt. Wenn Sie diese Schnittstelle
noch nicht aktivieren möchten, so entfernen Sie den Haken. Sie können diese Schnittstelle ggf. auch in
der Schnittstellenübersicht temporär für einen Export aktivieren.
Abbildung 2.2.25. allgemeine Einstellungen
Transport via FTP
Reiter "Transport"
1. Adresse: Tragen Sie hier die Adresse des FTP-Servers ein. (z.B.: „import.openindex.de“) Manchmal
wird auch der Begriff „Host“ statt „Adresse“ verwendet.
2. Port: Standardmäßig ist Port 21 zu verwenden. Dies ist auch voreingestellt, und sollte nur auf
ausdrückliche Aufforderung geändert werden.
3. Login: Tragen Sie hier Ihren FTP-Benutzernamen ein.
4. Passwort: Tragen Sie hier Ihr FTP-Passwort ein.
5. Serverpfad: Standardmäßig ist / voreingestellt, was in den meisten Fällen auch nicht geändert werden
muss.
6. Passive FTP-Verbindung: e nach dem, wie Ihr lokales Netzwerk eingerichtet und konfiguriert ist
kann es notwendig sein diese Option zu deaktivieren. Sollte es beim Export zu Problemen kommen,
deaktivieren Sie diese Option und versuchen es erneut.
7. Testen: Wenn Sie die FTP-Zugangsdaten eingetragen habe, können Sie mit diesem Button die
Verbindung testen. Sollte der Test negativ verlaufen, überprüfen Sie Ihre Eingaben, bevor Sie den
Support in Anspruch nehmen.
60
Immobilien
Abbildung 2.2.26. FTP-Schnittstelle einrichten
Transport via HTTP
Reiter "Transport"
1.
2.
3.
4.
HTTP-Adresse: Tragen Sie hier die URL ein.
Login: Tragen Sie hier Ihren Benutzernamen ein.
Passwort:Tragen Sie hier Ihr Passwort ein.
Übertragung HTTP-Request-Methoden:
• via PUT-Anfrage: Dient dazu eine Ressource (z. B. eine Datei) unter Angabe des Ziel-URIs auf einen
Webserver hochzuladen.
• via POST-Anfrage: Schickt Daten zur weiteren Verarbeitung zum Server, diese werden als Inhalt
der Nachricht übertragen und können beispielsweise aus Name-Wert-Paaren bestehen.
• via POST-Anfrage, als Formular (multipart/form-data): Diese Anfrage erlaubt dem Anwender eine
Datei zusammen mit einem Formular zu übertragen.
5. Form-Variable: Diese ist fest vorgegeben, und kann nicht überschrieben werden, da diese Schnittstelle
ausschließlich von Immonet verwendet wird.
61
Immobilien
Abbildung 2.2.27. HTTP-Schnittstelle einrichten
Transport auf die Festplatte
Reiter "Transport"
Zielverzeichnis: Geben Sie hier das lokale Verzeichnis ein, in welches die Datei auf Ihrem Rechner
übertragen werden soll.
Format-Optionen
Reiter "Format"
1. Anbieter-Nr: Tragen Sie hier die Anbieter- / Kundennummer des jeweiligen Portals ein.
2. OpenImmo-Nr: Diese Angabe wird meist nicht benötigt. Wenn doch, tragen Sie hier ebenfalls die
Anbieter- / Kundennummer des jeweiligen Portals ein.
3. Technik Mail: Tragen Sie hier die E-Mailadresse der Person ein, welche ggf. die Importmeldungen
erhält.
4. Modus: Wählen Sie zwischen Voll- und Teilabgleich.
• Vollabgleich: Der gesamte dieser Schnittstelle zugeordnete Inseratsbestand wird transferiert.
• Teilabgleich: Nur geänderte und neu Datensätze werden transferiert.
5. Zeilenumbruch: Wählen Sie die Methode des Zeilenumbruchs. Im Zweifelsfall belassen Sie die
Standardeinstellung und überprüfen die Darstellung in jeweiligen Portal.
6. Anhänge: Wenn nicht anders benannt belassen Sie die Standardeinstellung.
7. Markierung: Wenn nicht anders benannt belassen Sie die Standardeinstellung. Sollten keine Bilder auf
dem Portal dargestellt werden, so ändern Sie die Einstellung.
8. Sonstiges: Wenn nicht anders benannt belassen Sie die Standardeinstellung.
62
Immobilien
Abbildung 2.2.28. Format-Optionen
Bild-Optionen
Reiter "Bilder"
1. Aktivieren Sie im unteren Bereich des Formulares ggf. den Karteireiter Bilder.
2. Zur Immobilie können Bilder gespeichert werden, welche nicht auf den Portalen veröffentlicht werden
sollen, weil z.B. eine Begrenzung der Anzahl der Bilder vorgegeben ist. Wenn Sie diese aber auf Ihrer
Website darstellen wollen, so aktivieren Sie die Option Allgemein.
3. Es kann sinnvoll sein die Bilder für den Websiteexport zu verkleinern. Wenn Sie dies wünschen, so
aktivieren Sie die Option Skalierung, und geben die Maße für die Breite und Höhe an.
4. Wenn Sie Ihr Logo als Wasserzeichen in die Bilder einfügen möchten, so aktivieren Sie die Option
Wasserzeichen, geben die Größe des Wasserzeichens ein, wählen die Position und die Transparenz.
5. Klicken Sie abschließend auf Übernehmen, um die Export-Schnittstelle dauerhaft zu speichern.
Schnittstellenkonfiguration importieren
Um Ihnen das Einrichten der Schnittstelle zu erleichtern unterstützt das Programm den Import von
Schnittstellenkonfigurationen. Sie können von teilnehmenden Partnern eine entsprechende XML-Datei
beziehen, die Sie direkt ins Programm importieren können. Dadurch werden eventuelle Fehleingaben
vermieden.
Der Export der hierfür benötigten XML-Datei wird derzeit nur vom Immobilienportal www.iHanse.de der
ImmobilienHanse eG angeboten.
1. Inserenten von iHanse.de loggen sich in Ihrem Anbieterbereich ein und klicken auf Meine
Maklersoftware.
2. Ggf. muss noch eine Schnittstelle für das ImmoTool eingerichtet werden. Beachten Sie dafür die
Hinweise auf der Website.
3. Nach der Einrichtung der ImmoTool-Schnittstelle bekommen Sie Ihre FTP-Zugangsdaten angezeigt.
Unterhalb der Datenausgabe befindet sich ein Link Schnittstellendaten im XML-Format herunterladen.
Klicken Sie auf diesen Link, und speichern Sie die Datei an einer beliebigen Stelle auf Ihrem Computer.
4. Öffnen Sie ggf. die Exportübersicht.
5. Klicken Sie auf den Button Import und wählen Sie im folgenden Dialogfenster die heruntergeladene
XML-Datei aus.
63
Immobilien
6. Die Exportschnittstelle wird daraufhin automatisch angelegt und auf die Bedürfnisse des iHanse-Portals
hin vorkonfiguriert.
Anmerkung
Die iHanse-Schnittstelle wurde ohne Objekt-Limitierung erstellt und wird aktiviert.
Schnittstelle bearbeiten
1. Öffnen Sie die Exportübersicht (siehe oben) um die hinterlegten Schnittstellen einzusehen.
2. Die zu bearbeitende Schnittstelle kann auf folgende Arten geöffnet werden:
• Doppelklick auf den Tabelleneintrag.
• Rechtsklick auf den Tabelleneintrag und im erscheinenden Menü auf Schnittstelle bearbeiten
auswählen.
• Den Tabelleneintrag mit Linksklick markieren, auf den Button Aktionen klicken und im
erscheinenden Menü auf Schnittstelle bearbeiten auswählen.
3. Es öffnet sich das Schnittstellenformular zur Bearbeitung der gewählten Schnittstelle.
Schnittstelle (de)aktivieren
1. Öffnen Sie die Exportübersicht (siehe oben) um die hinterlegten Schnittstellen einzusehen.
2. Permanent aktivieren / deaktivieren
• Öffnen Sie die zu aktivierende Schnittstelle zur Bearbeitung.
• Aktivieren oder deaktivieren Sie die Option Die Export-Schnittstelle aktivieren.
• Speichern Sie Ihre Eingaben durch Klick auf den Button Übernehmen.
3. Temporär aktivieren / deaktivieren
• Links in der Schnittstellenübersicht können Sie eine oder mehrere Schnittstelle(n) für einen Transfer
aktivieren oder deaktivieren.
• Diese Einstellung wird nicht dauerhaft gespeichert, sondern gilt nur solange die
Schnittstellenübersicht geöffnet ist.
Schnittstelle löschen
1. Öffnen Sie die Exportübersicht um die hinterlegten Schnittstellen einzusehen.
2. Wählen Sie die zu löschende Schnittstelle aus der Tabelle aus:
• Rechtsklick auf den Tabelleneintrag und im erscheinenden Menü auf entfernen auswählen.
• Den Tabelleneintrag mit Linksklick markieren, auf den Button Aktionen klicken und im
erscheinenden Menü auf entfernen auswählen.
• Sicherheitshalber werden Sie gefragt, ob wirklich gelöscht werden soll. Bestätigen Sie diese Frage
mit Ja um die gewählte Schnittstelle endgültig aus der Datenbank zu entfernen.
Anmerkung
Eine Löschung kann ohne vorherige Datensicherung nicht wieder rückgängig gemacht
werden!
Immobilien importieren
Das ImmoTool kann externe Immobiliendaten in verschiedenen Formaten einlesen und in die Datenbenk
speichern. Im Menü Immobilien finden Sie den Eintrag Immobilien importieren.
64
Immobilien
Anmerkung
Derzeit können folgende Formate importiert werden:
1.
2.
3.
4.
5.
6.
OpenEstate-XML
Openimmo-XML 1.1 & 1.2
ImmoXML
IS24-XML (rev67445)
IS24-CSV (v1.4.0.4)
via Maklersoftware-Export
Abbildung 2.2.29. Menü Immobilien importieren
Immobilien aus einer Datei importieren
1. Starten Sie den Import (Hauptmenü Immobilien → Immobilie importieren) und klicken auf den zu
verwendenden Standard.
2. Es öffnet sich ein Dialogfenster, in welchem Sie die zu importierende Datei auswählen können. Wählen
Sie die zu importierende Datei. Diese kann eine XML- oder CSV-Datei sein, aber auch ein ZIP-Archiv,
welches eine XML- oder CSV-Datei enthält. Mit einem Klick auf Datei importieren starten Sie den
Importvorgang.
3. Es öffnet sich ein Infofenster, in welchem Ausgaben zum Importvorgang zu sehen sind. Sollte die zu
importierende Datei einen Fehler auslösen, so wird dies hier protokolliert. Wenn bei der Innitialisierung
des Imports kein Fehler auftritt öffnet sich ein weiteres Dialogfenster, in welchem Sie aufgefordert
werden den Status der zu importierenden Immobilien zu wählen. Treffen Sie eine Auswahl, und
betätigen Sie den Button Übernehmen. Nach erfolgtem Import wird Ihnen dieser mitgeteilt. Ist der
Import fehlgeschlagen, so bleibt das Infofenster geöffnet, und Sie können ggf. das Protokoll speichern
und an uns.
Anmerkung
Prüfen Sie nach erfolgtem Datenimport Ihren Immobilienbestand auf Korrektheit und
nehmen Sie ggf. nachträgliche Korrekturen vor.
Tipp
Jeder Anbieter im Portal www.ihanse.de kann sich beliebig oft kostenlos eine Sicherung
seiner Daten im OpenEstate-XML oder OpenImmo-XML beantragen. Für den Import ins
65
Immobilien
ImmoTool ist OpenEstate-XML zu bevorzugen, da die iHanse und das ImmoTool auf dem
gleichen Standard arbeiten, und so keine Datenverluste auftreten sollten.
1. Inserenten von iHanse.de loggen sich in Ihrem persönlichen Anbieterbereich ein und
klicken auf Meine Anbieterprofil.
2. Unter dem Reiter Datensicherung wählen Sie als Exportformat OpenEstate-XML, und
senden das Formular ab. Wenn die Daten zum Download bereitstehen werden Sie per
Mail informiert.
3. Laden Sie die Daten auf Ihren PC und starten den Importvorgang, wie oben beschrieben.
Immobilien aus einer vorhandenen Maklersoftware
importieren
Abbildung 2.2.30. Menü Immobilien importieren
Anmerkung
Diese Programmfunktion befindet sich noch in einem experimentellen Status! Bitte teilen
Sie uns Ihre Erfahrungen mit.
Anmerkung
Dieses Verfahren funktioniert nicht, wenn Sie eine Online-Software verwenden. Sowohl das
ImmoTool als auch die andere Software müssen sich innerhalb Ihres lokalen Netzwerkes
befinden.
66
Immobilien
Moderne Softwarelösungen für Makler bieten eine Funktion zum Datenexport, meist im OpenImmo-XML,
via FTP. In der Regel wird diese Funktion genutzt, um Immobilien an verschiedene Portale zu versenden.
Aus diesem Grund liefert das ImmoTool einen eigenen minimalen FTP-Server mit. Eine externe
Maklersoftware kann mit diesem FTP-Server kommunizieren und somit seine Exporte direkt zum
ImmoTool senden - als wäre das ImmoTool ein Immobilienportal.
1. Installieren Sie vorab in Ihrer externen Maklersoftware eine Export-Schnittstelle. Beachten Sie dabei:
• Der Export kann als Openimmo-XML, OpenImmo-XML, IS24-XML und IS24-CSV stattfinden.
• Die Adresse des FTP-Servers entspricht in der Regel „127.0.0.1“ bzw. Ihrer IP-Adresse im Netzwerk.
• Der Port des FTP-Servers kann selbst gewählt werden. Standardmäßig wird „2121“ verwendet.
• Zugangsdaten für den FTP-Server können frei gewählt werden.
2. Öffnen Sie das Importmenü (siehe oben) und klicken Sie auf via Maklersoftware-Export. Es öffnet sich
ein Fenster zur Steuerung des lokalen FTP-Servers.
3. Wählen Sie ggf. eine Port-Nr und klicken Sie auf FTP-Server starten um den lokalen FTP-Server auf
dem gewählten Port zu starten. Die Standardeinstellung sollte aber funktionieren.
4. Exportieren Sie nun mit Ihrer externen Maklersoftware Ihre Inserate. Sobald Aktivitäten stattfinden
werden diese im Textfeld protokolliert.
5. Nachdem Sie Ihre Daten aus der externen Maklersoftware übertragen haben, klicken Sie auf FTP-Server
stoppen. Das Programm ermittelt daraufhin, ob es während der FTP-Sitzung zu Dateiübertragungen
kam.
6. Sollten importierbare Dateien (XML-Datei oder ZIP-Archiv) empfangen worden sein, werden Sie
gefragt, ob diese nun importiert werden sollen. Beantworten Sie diese Frage mit Ja, und das Programm
wird versuchen die übertragenen Dateien zu importieren.
Anmerkung
a. Beim Schließen des FTP-Fensters werden nicht importierte Dateien gelöscht!
b. Um eine Port-Nr kleiner als 1000 verwenden zu können, muss das Programm
mit Administratorrechten gestartet werden. Dabei handelt es sich um eine
Sicherheitsbeschränkung von Java.
c. Prüfen Sie nach erfolgtem Datenimport Ihren Immobilienbestand auf Korrektheit und
nehmen Sie ggf. nachträgliche Korrekturen vor.
Ansprechpartner verwalten
Innerhalb eines Projektes können beliebig viele Ansprechpartner verwaltet werden. Die Übersicht der
gespeicherten Ansprechpartner kann auf zweierlei Wegen geöffnet werden:
1. Klicken Sie im Hauptmenü auf den Eintrag Immobilien → Ansprechpartner anzeigen um die Übersicht
der Ansprechpartner zu öffnen.
2. Öffnen Sie die Immobilienansicht und klicken Sie im Ansichtsbereich auf den Eintrag Ansprechpartner.
67
Immobilien
Abbildung 2.2.31. Ansprechpartnerübersicht
Filterkriterien verwenden
Oberhalb der Tabelle werden verschiedene Eingabefelder dargestellt, um den Bestand eingrenzen zu
können. Die Ansicht der Tabelle wird automatisch aktualisiert, sobald ein Kriterium geändert wurde.
Aktionen ausführen
Markieren Sie in der Tabelle eine oder mehrere Ansprechpartner. Klicken Sie danach auf den Button
Aktionen, um das Aktionsmenü darzustellen.
Abbildung 2.2.32. Aktionsmenü in der Ansprechpartnerübersicht
Folgende Aktionen stehen zur Verfügung:
• Ansprechpartner öffnen. Wählen Sie diese Aktion, um den markierten Ansprechpartner zur
Bearbeitung zu öffnen.
• Ansprechpartner löschen. Wählen Sie diese Aktion, um die markierten Ansprechpartner dauerhaft
aus der Datenbank zu löschen.
Tipp
Wenn mehrere Zeilen in der Tabelle markiert wurden (z.B. mit gedrückter STRG- / ShiftTaste), wird die Aktion auf mehreren Ansprechpartnern durchgeführt.
Ansprechpartner bearbeiten
Innerhalb eines Projektes können beliebig viele Ansprechpartner gespeichert werden. Zur Verwaltung der
hinterlegten Ansprechpartner gelangen Sie auf zweierlei Wegen:
68
Immobilien
1. Klicken Sie im Menü Immobilien auf den Eintrag Mitarbeiter.
2. Klicken Sie in der Sidebar auf den Eintrag Mitarbeiter.
Im sich öffnenden Fenster finden Sie eine tabellarische Übersicht der gespeicherten Ansprechpartner.
Personendaten
Reiter "Person"
In den Personendaten sind die allgemeinen Daten des Ansprechpartners hinterlegt.
1. Füllen Sie die relevanten Eingabefelder aus und klicken Sie abschließend auf Speichern.
Abbildung 2.2.33. Personendaten der Kontaktperson
Betreute Immobilien
Reiter "Inserate"
Hier finden Sie eine tabellarische Übersicht aller Immobilien, die vom gewählten Ansprechpartner betreut
werden.
1. Der Bereich ist erst verfügbar, wenn der Ansprechpartner bereits in die Datenbank gespeichert wurde.
Abbildung 2.2.34. Betreute Immobilien der Kontaktpersonen
Notizen
Reiter "Notizen"
69
Immobilien
An dieser Stelle kann bei Bedarf ein Notiztext zum Ansprechpartner hinterlegt werden. Dieser Text wird
an keiner Stelle veröffentlicht.
Abbildung 2.2.35. Notizen (Reiter Notizen)
Änderungen speichern
Um die Änderungen im Ansprechpartnerformular dauerhaft zu speichern, klicken Sie oben rechts auf den
Button Speichern.
Anmerkung
Das Speichern ist zu jedem Zeitpunkt der Bearbeitung möglich. Sollten relevante Eingaben
fehlen, werden Sie vom Programm darauf hingewiesen.
Achtung
Jede Änderung im Ansprechpartnerformular muss durch Klick auf den Button Speichern
bestätigt werden. Wird das Formular einfach geschlossen, gehen ungespeicherte Eingaben
verloren!
Suchanfragen verwalten
Innerhalb eines Projektes können beliebig viele Suchanfragen verwaltet werden. Klicken Sie im
Hauptmenü auf den Eintrag Immobilien → Suchanfragen anzeigen um die Übersicht der Suchanfragen
zu öffnen.
Abbildung 2.2.36. Suchanfrageübersicht
Aktionen ausführen
Markieren Sie in der Tabelle eine oder mehrere Suchanfragen. Klicken Sie danach auf den Button
Aktionen, um das Aktionsmenü darzustellen.
70
Immobilien
Abbildung 2.2.37. Aktionsmenü in der Suchanfrageübersicht
Folgende Aktionen stehen zur Verfügung:
• Suche bearbeiten. Wählen Sie diese Aktion, um die markierten Suchanfrage zur Bearbeitung zu
öffnen.
• Suche ausführen. Wählen Sie diese Aktion, um die markierte Suchanfrage auszuführen und das
Resultat in einer neuen Immobilienübersicht darzustellen.
• Suche löschen. Wählen Sie diese Aktion, um die markierten Suchanfragen dauerhaft aus der
Datenbank zu löschen.
Tipp
Wenn mehrere Zeilen in der Tabelle markiert wurden (z.B. mit gedrückter STRG- / ShiftTaste), wird die Aktion auf mehreren Suchanfragen durchgeführt.
Suchanfrage bearbeiten
Eckdaten bearbeiten
Reiter "Eckdaten"
Verschiedene allgemeine Eckdaten können zur Suchanfrage erfasst werden.
71
Immobilien
Abbildung 2.2.38. Eckdaten einer Suchanfrage bearbeiten
• Bezeichnung. Wählen Sie eine passende Bezeichnung für die Suchanfrage, um diese später leicht
wiederfinden zu können.
• Gesuch aktivieren. Eine aktivierte Suchanfrage wird im Programm an verschiedenen Stellen
verwendet, z.B. in der Immobilienübersicht.
• Als Favorit markieren. Eine Suchanfrage, die als Favorit markiert wurde, wird permanent im
Ansichtsbereich dargestellt und kann mit einem Klick ausgeführt werden.
• Notizen. Hinterlegen Sie bei Bedarf einen beliebigen Notiztext zur Suchanfrage.
Abbildung 2.2.39. Als Favorit markierte Suchanfrage
Kriterien bearbeiten
Reiter "Kriterien"
Zu einer Suchanfrage können beliebig viele Suchkriterien definiert werden.
72
Immobilien
Abbildung 2.2.40. Kriterien einer Suchanfrage bearbeiten
• Klicken Sie oben rechts auf den Button Kriterium hinzufügen um ein neues Kritierium hinzuzufügen.
• Durch Klick auf den Button Kriterium auswählen öffnet sich ein Menü zur Auswahl der Kriteriumsart.
• Abhängig von der gewählten Kriteriumsart wird ein Formular dargestellt. Weitere Nebenbedingungen
können durch Klick auf den Button + hinzugefügt werden.
• Durch Klick auf den Button - werden die Nebenbedingungen (und zuletzt das Kriterium selbst) wieder
entfernt.
Abbildung 2.2.41. Auswahl eines Suchkriteriums
Adressen zuweisen
Reiter "Adressen"
Eine Suchanfrage kann mit dem Adressbestand verknüpft werden. So kann z.B. der Suchwunsch für einen
Interessenten und mit diesem verknüpft werden.
73
Immobilien
Abbildung 2.2.42. Kriterien einer Suchanfrage bearbeiten
• Klicken Sie auf den Reiter Neue Adresse. um eine neue Adresse zu erzeugen und mit der Suchanfrage
zu verknüpfen.
• Klicken Sie auf den Button Neue Zuordnung. um eine neue Zuordnung für eine bestehende Adresse
zu erzeugen.
• Durch einen Doppelklick mit der linken Maustaste auf eine Zeile in der Tabelle, wird die jeweilige
Adresse in einem neuen Fenster geöffnet.
• Markieren Sie eine der zugeordneten Adressen in der Tabelle und klicken Sie auf den Button Aktionen,
um die Zuordnung wieder zu löschen.
• Bei Auswahl eines Eintrages in der Tabelle, wird unterhalb der Tabelle ein Textfeld mit den Notizen
zur Zuordnung dargestellt. Eine Änderung im Notizfeld muss durch Klick auf Übernehmen gespeichert
werden.
Achtung
Wenn eine Adresszuordnung geändert wurde, muss abschließend oben rechts auf den Button
Speichern geklickt werden, um diese Änderungen dauerhaft zu speichern.
Einstellungen
Agentur
Um Ressourcen zu schonen sollten die Immobilienbilder so größ wie nötig in der Datenbank gespeichert
werden. Bei der Erstinstallation ist hier eine Breite von 800px und Höhe von 600px eingetragen. Diese
Werte können Sie nach Bedarf ändern.
74
Immobilien
Anmerkung
Empfehlenswert ist die größte Darstellung auf den von Ihnen belieferten Immobilienportalen.
Einige Beispiele für die Bildbreite bei verschiedenen Portalen:
• IS24 Breite ca. 540px
• Immonet Breite ca. 800px
• Immowelt Breite ca. 500px
Sprachen
In diesem Fenster werden alle Sprachen aufgeführt, welche Sie intern in Ihrem ImmoTool verfügbar haben.
Aktivieren oder deaktivieren Sie die Sprachen, in denen Sie ggf. Exposés erstellen wollen.
Anmerkung
Hierbei handelt es sich nicht um die Sprachen, welche Sie ggf. als Add-On installiert haben,
sondern um die Übersetzungen des im ImmoTool intern verwendeten XML-Standards,
welche über das ImmoTool aktualisiert werden. So ist es derzeit möglich Immobilien in
italienisch anzulegen, aber nicht das ImmoTool in italienisch auszuführen.
PDF-Langexposé (Standardvorlage)
Derzeit ist im ImmoTool eine Standardvorlage (Langexposé) zur Exposéerstellung enthalten. Die
Exposévorlage kann gemäß Ihrer Corporate Identity angepasst werden.
Allgemein
Name: Der Name ist vorgegeben, kann aber bei Bedarf von ihnen geändert werden.
Sprache: Wählen Sie die Sprache, in welcher mit dieser Vorlage Langexposés erzeugt werden sollen.
Anmerkung
Hierbei handelt es sich nicht um die Sprachen, welche Sie ggf. als Add-On installiert haben,
und in wecher Sie Freitexte anlegen, sondern um die Übersetzungen des im ImmoTool intern
verwendeten XML-Standards, aus welchem die Attributübersetzung generiert wird.
Format: Wählen Sie zwischen Hoch- und Querformat.
Auflösung: Wählen Sie die Auflösung, in welcher die erzeugten Exposés geöffnet oder gespeichert
werden. Für eine Darstellung im Web sind 72 oder 144 dpi ausreichend. Wenn Sie die Exposés ausdrucken
möchten ist je nach Qualität des Druckers eine Auflösung von 300 bis 600 dpi empfehlenswert.
AGB darstellen: Wenn am Ende des Exposés die AGB angehängt werden sollen, so aktivieren Sie die
Option und wählen die Schriftgröße.
Eigene Vorlage verwenden. Wenn Sie eine eigene Vorlage verwenden möchten, so verfahren Sie
gemäß dieser Anleitung.
Kopf- & Fußbereich
Kopfbereich: Optionen. Nehmen Sie ihren Wünschen entsprechende Einstellungen vor. Bei
deaktivierter Option Kopfbereich anzeigen bleibt der Bereich leer. Diese Einstellung vergrößert nicht den
Inhaltsbereich.
75
Immobilien
Kopfbereich: Textzeilen 1-3. Bei aktivierten Optionen Kopfbereich anzeigen und eigenen Text im
Kopfbereich anzeigen werden die folgenden Textzeilen 1-3, wenn ausgefüllt, eingeblendet.
Kopfbereich: Farben. Wählen Sie die Schriftfarbe des Kopfbereiches.
Fußbereich: Optionen. Nehmen Sie ihren Wünschen entsprechende Einstellungen vor. Bei
deaktivierter Option Fußbereich anzeigen bleibt der Bereich leer. Diese Einstellung vergrößert nicht den
Inhaltsbereich.
Fußbereich: Farben. Wählen Sie die Schriftfarbe des Fußbereiches.
Inhaltsbereich
Hier können Sie diverse Text-, Hintergrund- und Rahmenfarben einstellen.
PDF-Kurzexposé (Standardvorlage)
Derzeit ist im ImmoTool eine Standardvorlage (Kurzexposé) zur Exposéerstellung enthalten. Die
Exposévorlage kann gemäß Ihrer Corporate Identity angepasst werden.
Allgemein
Name: Der Name ist vorgegeben, kann aber bei Bedarf von ihnen geändert werden.
Sprache: Wählen Sie die Sprache, in welcher mit dieser Vorlage Langexposés erzeugt werden sollen.
Anmerkung
Hierbei handelt es sich nicht um die Sprachen, welche Sie ggf. als Add-On installiert haben,
und in wecher Sie Freitexte anlegen, sondern um die Übersetzungen des im ImmoTool intern
verwendeten XML-Standards, aus welchem die Attributübersetzung generiert wird.
Auflösung: Wählen Sie die Auflösung, in welcher die erzeugten Exposés geöffnet oder gespeichert
werden. Für eine Darstellung im Web sind 72 oder 144 dpi ausreichend. Wenn Sie die Exposés ausdrucken
möchten ist je nach Qualität des Druckers eine Auflösung von 300 bis 600 dpi empfehlenswert.
Eigene Vorlage verwenden: Wenn Sie eine eigene Vorlage verwenden möchten, so verfahren Sie
gemäß dieser Anleitung.
Kopf- & Fußbereich
Kopfbereich: Optionen. Nehmen Sie ihren Wünschen entsprechende Einstellungen vor. Bei
deaktivierter Option Kopfbereich anzeigen bleibt der Bereich leer. Diese Einstellung vergrößert nicht den
Inhaltsbereich.
Kopfbereich: Textzeilen 1-3. Bei aktivierten Optionen Kopfbereich anzeigen und eigenen Text im
Kopfbereich anzeigen werden die folgenden Textzeilen 1-3, wenn ausgefüllt, eingeblendet.
Kopfbereich: Farben. Wählen Sie die Schriftfarbe des Kopfbereiches.
Fußbereich: Optionen. Nehmen Sie ihren Wünschen entsprechende Einstellungen vor. Bei
deaktivierter Option Fußbereich anzeigen bleibt der Bereich leer. Diese Einstellung vergrößert nicht den
Inhaltsbereich.
76
Immobilien
Fußbereich: Farben. Wählen Sie die Schriftfarbe des Fußbereiches.
Inhaltsbereich
Hier können Sie diverse Text-, Hintergrund- und Rahmenfarben einstellen.
Fragen & Antworten
Häufig gestellte Fragen zur Immobilienverwaltung
F:
Wie kann eine neue Immobilie erzeugt werden?
A:
Das Immobilienformular zur Erzeugung einer neuen Immobilie kann auf folgenden Wegen geöffnet
werden:
1. Klicken Sie im Hauptmenü auf Immobilien+Neu+Immobilie.
2. Öffnen Sie die Immobilienübersicht und klicken Sie oben rechts auf Neu.
3. Nehmen Sie die gewünschten Einträge im Immobilienformular vor und klicken Sie abschließend
auf Speichern.
F:
Wie kann eine bestehende Immobilie bearbeitet werden?
A:
1. Öffnen Sie die Immobilienübersicht um die hinterlegten Immobiliendaten einzusehen.
2. Wenn Sie die zu bearbeitende Immobilie in der Übersicht gefunden haben, kann diese durch
einem Doppelklick mit der linken Maustaste geöffnet werden.
3. Nehmen Sie die gewünschten Änderungen im Immobilienformular vor und klicken Sie
abschließend auf Speichern.
F:
Wie kann eine Immobilie kopiert / dupliziert werden?
A:
1. Öffnen Sie die Immobilienübersicht um die hinterlegten Immobiliendaten einzusehen.
2. Wenn Sie die zu kopierende Immobilie in der Übersicht gefunden haben, markieren Sie den
Tabelleneintrag durch einen Klick mit der linken Maustaste.
3. Klicken Sie anschließend oben rechts auf Aktionen → Immobilie duplizieren um eine Kopie der
markierten Immobilie zu erzeugen.
Anmerkung
Die Originalimmobilie bleibt bei dieser Verfahrensweise unangetastet!
F:
Wie kann eine Immobilie gelöscht werden?
A:
1. Öffnen Sie die Immobilienübersicht um die hinterlegten Immobiliendaten einzusehen.
2. Wenn Sie die zu löschende Immobilie in der Übersicht gefunden haben, markieren Sie den
Tabelleneintrag durch einen Klick mit der linken Maustaste.
3. Klicken Sie anschließend oben rechts auf Aktionen → Immobilie löschen um die markierte
Immobilie aus der Datenbank zu entfernen.
77
Immobilien
Achtung
Eine Löschung kann ohne vorherige Datensicherung nicht wieder rückgängig gemacht
werden!
F:
Wie kann ein neuer Ansprechpartner erzeugt werden?
A:
Das Ansprechpartnerformular zur Erzeugung eines neuen Ansprechpartners kann auf folgenden
Wegen geöffnet werden:
1. Klicken Sie im Hauptmenü auf Immobilien+Neu+Ansprechpartner.
2. Öffnen Sie die Ansprechpartnernübersicht und klicken Sie oben rechts auf Neu.
3. Nehmen Sie die gewünschten Einträge im Ansprechpartnerformular vor und klicken Sie
abschließend auf Speichern.
F:
Wie kann ein bestehender Ansprechpartner bearbeitet werden?
A:
1. Öffnen Sie die Ansprechpartnerübersicht um die hinterlegten Ansprechpartner einzusehen.
2. Wenn Sie den zu bearbeitenden Ansprechpartner in der Übersicht gefunden haben, kann dieser
durch einem Doppelklick mit der linken Maustaste geöffnet werden.
3. Nehmen Sie die gewünschten Änderungen im Ansprechpartnerformular vor und klicken Sie
abschließend auf Speichern.
F:
Wie kann ein Ansprechpartner gelöscht werden?
A:
1. Öffnen Sie die Ansprechpartnerübersicht um die hinterlegten Ansprechpartner einzusehen.
2. Wenn Sie den zu löschenden Ansprechpartner in der Übersicht gefunden haben, markieren Sie
den Tabelleneintrag durch einen Klick mit der linken Maustaste.
3. Klicken Sie anschließend oben rechts auf Aktionen → Ansprechpartner löschen um die
markierten Ansprechpartner aus der Datenbank zu entfernen.
Achtung
Eine Löschung kann ohne vorherige Datensicherung nicht wieder rückgängig gemacht
werden!
78
Kapitel 2.3. Adressbuch
In
diesem
Kapitel
werden
Adressverwaltung dokumentiert.
die
Funktionen
der
Das Adressbuch-Modul stellt Funktionen zur Verwaltung von Adressen zur Verfügung. Die folgenden
Bestandteile werden in das Programm integriert, wenn die Komponente OpenEstate-Tool-Contacts
installiert und aktiviert wurde:
Abbildung 2.3.1. Menüeintrag des Adressbuches
Abbildung 2.3.2. Untermenü zum Erzeugen neuer Einträge im Adressbuch
Abbildung 2.3.3. Ansichtsbereich des Adressbuches
79
Adressbuch
Adressen verwalten
Innerhalb eines Projektes können beliebig viele Immobilien gespeichert werden. Zur Verwaltung der
hinterlegten Immobilien gelangen Sie auf zweierlei Wegen:
1. Klicken Sie im Menü Adressbuch auf den Eintrag Adressen.
2. Klicken Sie in der Sidebar Adressbuch auf den Eintrag Adressen.
Im sich öffnenden Fenster finden Sie eine tabellarische Übersicht der gespeicherten Adressen.
Abbildung 2.3.4. Adressenübersicht
Adresse erzeugen
1. Öffnen Sie ggf. die Adresstabelle um die hinterlegten Adressen einzusehen.
2. Klicken Sie in der Adresstabelle oben rechts auf Neu.
3. Es öffnet sich das Adressformular zur Erzeugung einer Adresse.
Adresse bearbeiten
1. Öffnen Sie ggf. die Adresstabelle (siehe oben) um die hinterlegten Adressen einzusehen.
2. Eine Adresse in der Tabelle kann wie folgt bearbeitet werden:
• Doppelklick auf den Tabelleneintrag.
• Rechtsklick auf den Tabelleneintrag und im erscheinenden Menü auf Adresse öffnen auswählen.
• Den Tabelleneintrag mit Linksklick markieren, auf den Button Aktionen klicken und im
erscheinenden Menü auf Adresse öffnen auswählen.
3. Es öffnet sich das Adressformular zur Bearbeitung der gewählten Adresse.
Adresse löschen
1. Öffnen Sie ggf. die Adresstabelle um die hinterlegten Adressen einzusehen.
2. Eine Adresse kann wie folgt aus der Tabelle gelöscht werden:
• Rechtsklick auf den Tabelleneintrag und im erscheinenden Menü Adresse entfernen auswählen.
• Den Tabelleneintrag mit Linksklick markieren, auf den Button Aktionen klicken und im
erscheinenden Menü Adresse löschen auswählen.
3. Sicherheitshalber werden Sie gefragt, ob wirklich gelöscht werden soll. Bestätigen Sie diese Frage mit
Ja um die gewählte Adresse endgültig aus der Datenbank zu entfernen.
Achtung
Eine Löschung kann ohne vorherige Datensicherung nicht wieder rückgängig gemacht
werden!
80
Adressbuch
Adressformular
Im Adressformular werden alle Details einer Adresse übersichtlich zusammengefasst. Sie gelangen auf
zweierlei Art zum Adressformular:
1. Über das Anlegen einer neuen Adresse.
2. Über das Bearbeiten einer Adresse.
Abbildung 2.3.5. Adressenübersicht
Allgemeine Angaben zur Adresse (Reiter Anschrift)
1. Weisen Sie der Adresse eine Gruppe zu.
2. Füllen Sie die Felder nach Bedarf aus.
Weitere Angaben zur Adresse (Reiter Details)
Hier können Sie weitere Angaben wie z.B. Steuernummern oder eine Bankverbindung ablegen.
Verknüpfte Immobilien (Reiter Immobilien)
Jeder Adressdatensatz kann mit einer oder mehreren Immobilien verknüpft werden.
1. Klicken Sie hierfür auf Neu. Es öffnet sich ein neues Fenster. Wählen Sie in der Auswahlbox Immobilie
eine zu verknüpfende Immobilie aus.
2. Unter Zuordnung geben Sie ggf. an, ob es sich bei dieser Adresse um einen Eigentümer | Interessent
| Käufer / Mieter handelt.
3. Wiederholen Sie den Vorgang bei Bedarf um dem Adressdatensatz weitere Immobilien zuzuordnen.
4. Um eine Immobilienverknüpfung zu löschen / bearbeiten, markieren Sie die entsprechende Immobilie
mit der Maus. Der Eintrag ist nun blau hinterlegt. Klicken Sie auf Aktionen und den Unterpunkt
Zuordnung bearbeiten bzw. Zuordnung löschen.
81
Adressbuch
Abbildung 2.3.6. Verknüpfte Immobilien
Verknüpfte Kalendereinträge (Reiter Kalender)
Jeder Adressdatensatz kann mit einer oder mehreren Kalendereinträgen verknüpft werden. Verfahren Sie
dafür genauso, wie beim Verknüpfen einer Immobilie.
1. Klicken Sie hierfür auf Neu. Es öffnet sich ein neues Fenster. Wählen Sie in der Auswahlbox Gruppe
einen Eintrag aus.
2. Unter Zuordnung wählen Sie den entsprechenden Kalendeereintrag aus.
3. Wiederholen Sie den Vorgang bei Bedarf um dem Adressdatensatz weitere Kalendereinträge
zuzuordnen.
4. Um eine Kalenderverknüpfung zu löschen / bearbeiten, markieren Sie die entsprechende Immobilie mit
der Maus. Der Eintrag ist nun blau hinterlegt. Klicken Sie auf Aktionen und den Unterpunkt Zuordnung
bearbeiten bzw. Zuordnung löschen.
Abbildung 2.3.7. Verknüpfter Kalendereintrag
Bemerkungen zur Adresse (Reiter Notizen)
Hier können Sie Bemerkungen / Notizen zur Adresse ablegen.
Speichern
Um die Änderungen im Adressformular dauerhaft zu speichern, klicken Sie oben rechts auf den Button
Speichern.
82
Adressbuch
Anmerkung
Das Speichern ist zu jedem Zeitpunkt der Bearbeitung möglich. Sollten relevante Eingaben
fehlen, so weist dass System Sie darauf hin.
Achtung
Jede Änderung im Adressformular muss durch Klick auf Speichern dauerhaft gespeichert
werden. Wird das Fenster einfach geschlossen, gehen ungespeicherte Eingaben verloren!
Adressgruppen
Eine Adressgruppe dient der thematischen Zusammenfassung von Adressen. So ist z.B. eine
Unterscheidung zwischen privaten und geschäftlichen Adressen möglich.
Sie gelangen auf zweierlei Art zur Gruppenübersicht:
1. Klicken Sie im Menü Adressen auf den Eintrag Gruppen.
2. Klicken Sie in der Sidebar auf den Eintrag Gruppen.
Anmerkung
Im sich öffnenden Fenster finden Sie eine tabellarische Übersicht der gespeicherten
Adressgruppen.
Anmerkung
Beim Erzeugen eines Projektes werden standardmäßig die Gruppen geschäftlich und privat
erzeugt. Diese können Sie bei Bedarf jederzeit entfernen oder umbenennen.
Abbildung 2.3.8. Adressgruppenübersicht
Adressgruppe anlegen
1. Öffnen Sie ggf. die Gruppentabelle (siehe oben) um die hinterlegten Adressgruppen einzusehen.
2. Klicken Sie in der Gruppentabelle oben rechts auf Neu.
3. Es öffnet sich das Gruppenformular zur Erzeugung einer Adressgruppe.
Adressgruppe bearbeiten
1. Öffnen Sie ggf. die Gruppentabelle (siehe oben) um die hinterlegten Adressgruppen einzusehen.
2. Eine Adressgruppe in der Tabelle kann wie folgt bearbeitet werden:
• Doppelklick auf den Tabelleneintrag.
• Rechtsklick auf den Tabelleneintrag und im erscheinenden Menü auf Gruppe öffnen auswählen.
83
Adressbuch
• Den Tabelleneintrag mit Linksklick markieren, auf den Button Aktionen klicken und im
erscheinenden Menü auf Gruppe öffnen auswählen.
3. Es öffnet sich das Gruppenformular zur Bearbeitung der gewählten Adressgruppe.
Adressgruppe löschen
1. Öffnen Sie die Gruppentabelle (siehe oben) um die hinterlegten Adressgruppen einzusehen.
2. Eine Adressgruppe kann wie folgt aus der Tabelle gelöscht werden:
• Rechtsklick auf den Tabelleneintrag und im erscheinenden Menü auf Gruppe löschen auswählen.
• Den Tabelleneintrag mit Linksklick markieren, auf den Button Aktionen klicken und im
erscheinenden Menü Gruppe löschen auswählen.
3. Sicherheitshalber werden Sie gefragt, ob wirklich gelöscht werden soll. Bestätigen Sie diese Frage mit
Ja um die gewählte Adressgruppe endgültig aus der Datenbank zu entfernen.
Achtung
Eine Löschung kann ohne vorherige Datensicherung nicht wieder rückgängig gemacht
werden!
Adressgruppenformular
Im Adressgruppen-Formular werden alle Details einer Adressgruppe zusammengefasst. Sie gelangen auf
zweierlei Art zum Adressgruppen-Formular:
1. Über das Anlegen einer neuen Adressgruppe.
2. Über das Bearbeiten einer Adressgruppe.
Abbildung 2.3.9. Adressgruppenformular
Allgemeine Angaben
Tragen Sie eine Bezeichnung für die Gruppe ein, und ggf. einen Beschreibungstext.
Speichern
Das Speichern ist zu jedem Zeitpunkt der Bearbeitung möglich. Sollten relevante Eingaben fehlen, so
weist dass Programm Sie darauf hin.
Achtung
Jede Änderung im Adressgruppen-Formular muss durch Klick auf Speichern dauerhaft
gespeichert werden. Wird das Fenster einfach geschlossen, gehen ungespeicherte Eingaben
verloren!
84
Kapitel 2.4. Kalender
In
diesem
Kapitel
werden
Kalenderverwaltung dokumentiert.
die
Funktionen
der
Das Kalender-Modul stellt Funktionen zur Verwaltung Terminen & Aufgaben in einem Kalender zur
Verfügung. Die folgenden Bestandteile werden in das Programm integriert, wenn die Komponente
OpenEstate-Tool-Calendar installiert und aktiviert wurde:
Abbildung 2.4.1. Menüeintrag des Kalenders
Abbildung 2.4.2. Untermenü zum Erzeugen neuer Einträge im Kalender
85
Kalender
Abbildung 2.4.3. Ansichtsbereich des Kalenders
Kalendereinträge
Ein Kalendereintrag kann ein Termin, eine Aufgabe oder ein Journal sein. Die gespeicherten Einträge
können in verschiedenen Ansichten dargestellt werden.
1. Klicken Sie im Menü Kalender auf den Eintrag Monatsansicht / Wochenansicht / Tagesansicht.
2. Klicken Sie in der Sidebar auf den Eintrag Monatsansicht / Wochenansicht / Tagesansicht.
Im sich öffnenden Fenster finden Sie eine Übersicht der Kalendereinträge.
Anmerkung
Journal-Einträge können grundsätzlich nicht bearbeitet, sondern nur gelesen werden.
Kalendereintrag anlegen
1. Öffnen Sie ggf. eine Monatsansicht / Wochenansicht / Tagesansicht um die hinterlegten
Kalendereinträge einzusehen.
2. Klicken Sie in der Monatsansicht / Wochenansicht / Tagesansicht oben rechts auf Neu und wählen Sie
im folgenden Fenster aus, ob eine Aufgabe oder ein Termin erzeugt werden soll.
3. Es öffnet sich das Eintragsformular zur Erzeugung eines Kalendereintrages.
Kalendereintrag bearbeiten
1. Öffnen Sie ggf. eine Monatsansicht / Wochenansicht / Tagesansicht siehe oben um die hinterlegten
Kalendereinträge einzusehen.
2. Ein Kalendereintrag kann wie folgt bearbeitet werden:
• Doppelklick in die jeweilige Kalenderansicht.
• Rechtsklick auf den Eintrag in der Kalenderansicht und im erscheinenden Menü Eintrag öffnen
auswählen.
86
Kalender
• Den Tabelleneintrag mit Linksklick markieren, auf den Button Aktionen klicken und im
erscheinenden Menü Eintrag öffnen auswählen.
Kalendereintrag löschen
1. Öffnen Sie ggf. eine Monatsansicht / Wochenansicht / Tagesansicht um die hinterlegten
Kalendereinträge einzusehen.
2. Ein Kalendereintrag kann wie folgt entfernt werden:
• Rechtsklick auf den Eintrag in der Kalenderansicht und im erscheinenden Menü auf Eintrag löschen
klicken.
• Den Tabelleneintrag mit Linksklick markieren, auf den Button Aktionen klicken und im
erscheinenden Menü auf Eintrag löschen klicken.
Anmerkung
Einträge von externen Kalenderquellen können nicht gelöscht werden!
Achtung
Eine Löschung kann ohne vorherige Datensicherung nicht wieder rückgängig gemacht
werden!
Kalendereintragsformular Termin
Im Eintragsformular werden alle Details eines Kalender-Eintrages übersichtlich zusammengefasst. Sie
gelangen auf zweierlei Art zum Eintragsformular:
a. Über das Anlegen eines neuen Kalendereintrages.
b. Über das Bearbeiten eines Kalendereintrages.
Termin anlegen / bearbeiten
Jeder Kalendereintrag hat verschiedene allgemeine Eigenschaften.
a. Tragen Sie nun einen zum Termin passenden Titel ein.
b. Wählen Sie einen Kalender, in welchem der Eintrag gespeichert werden soll. Hier werden Ihnen nur
interne Kalender zur Auswahl gestellt.
c. Zu jedem Kalendereintrag können weitere Notizen gespeichert werden. Dafür steht im Reiter Notizen
ein Textfeld zur Verfügung.
d. Jeder Kalendereintrag kann ggf. mit Adressen und / oder Immobilien aus Ihrem Bestand verknüpft
werden.
Einstellungen
...
87
Kapitel 2.5. E-Mails
In diesem Kapitel werden die Funktionen der E-Mailverwaltung
dokumentiert.
Das Mail-Modul stellt Funktionen zum Zugriff auf externe E-Mailkonten zur Verfügung. Die folgenden
Bestandteile werden in das Programm integriert, wenn die Komponente OpenEstate-Tool-Mail installiert
und aktiviert wurde:
Abbildung 2.5.1. Menüeintrag der Mailverwaltung
Abbildung 2.5.2. Ansichtsbereich der Mailverwaltung
Anmerkung
Um das Mail-Modul verwenden zu können, benötigen Sie eine E-Mailadresse, die einen
Zugriff über die Mailprotokolle POP3, IMAP und/oder SMTP ermöglicht. Dies ist bei den
meisten E-Mailanbietern der Fall.
Anmerkung
Im Anhang finden Sie weitere Informationen zu diversen E-Mailanbietern.
88
E-Mails
E-Mailkonten
Um E-Mails mit dem ImmoTool empfangen und versenden zu können, muss dem Programm mitgeteilt
werden über welchen Mailserver dies stattfinden soll. Der Mailserver wird in der Regel von Ihrem EMailanbieter bereitgestellt (z.B. GMX / GMail / Hotmail).
Es können beliebig E-Mailadressen im Programm erfasst werden. Für jede E-Mailadresse kann ein
separates E-Mailkonto im Programm eingerichtet werden.
Anmerkung
Die nötigen Einstellungen zur Einrichtung des E-Mailkontos erfahren Sie von Ihrem EMailanbieter.
Abbildung 2.5.3. Dialogfenster zur Verwaltung der E-Mailkonten
Allgemeine Angaben
Auswahl des Mailkontos
Die folgenden Angaben können allgemein zu jedem E-Mailkonto hinterlegt werden.
89
E-Mails
1. Bezeichnung. Die Bezeichng wird innerhalb des Programmes an verschiedenen Stellen verwendet.
Wählen Sie hier einen möglichst prägnanten und kurzen Namen aus.
2. Ihr Name. Dieser Name wird bei versendeten E-Mails als Absender übermittelt.
3. E-Mail. Diese E-Mailadresse wird bei versendeten E-Mails als Absender übermittelt. Einige EMailanbieter schreiben hier eine bestimmten Adresse vor, bei anderen E-Mailanbietern kann die
Adresse frei gewählt werden.
4. Antwort an. Wenn hier eine E-Mailadresse angegeben wurde, werden ausgehende Mails mit dem
Vermerk versehen, dass eine Antwort möglichst an diese Adresse zurück zu senden ist.
5. Signatur. Der hier eingetragene Text wird beim Verfassen einer neuen E-Mail automatisch unterhalb
des Mail-Textes angefügt.
Abbildung 2.5.4. Allgemeine Einstellungen eines E-Mailkontos
Empfang via IMAP
Bereich "Empfang"
Um eingehende Mails über das IMAP-Protokoll vom Mailserver abholen zu können, öffnen Sie den
Bereich Empfang und wählen Sie IMAP als Protokoll aus. Daraufhin wird ein Formular dargestellt, über
welches die Anbindung des IMAP-Mailservers eingestellt werden kann.
1. Server. Tragen Sie hier die IP-Adresse oder den Hostnamen des IMAP-Mailservers ein.
2. Port. Tragen Sie hier die Port-Nummer des IMAP-Mailservers ein.
3. Anmeldung. Tragen Sie hier die Art der Anmeldung am IMAP-Mailserver ein.
4. Benutzer. Tragen Sie hier Ihren IMAP-Benutzernamen ein, wenn eine Anmeldung am IMAPMailserver stattfindet.
5. Paswort. Tragen Sie hier Ihr IMAP-Passwort ein, wenn eine Anmeldung am IMAP-Mailserver
stattfindet.
90
E-Mails
6. Krypto. Wählen Sie aus, ob die Kommunikation mit dem IMAP-Mailserver verschlüsselt stattfindet.
Anmerkung
Die nötigen Einstellungen erfahren Sie von Ihrem E-Mailanbieter. Im Anhang finden Sie
eine Tabelle mit IMAP-Einstellungen für verschiedene E-Mailanbieter.
Abbildung 2.5.5. IMAP-Einstellungen eines E-Mailkontos
Tabelle 2.5.1. Häufig verwendete Ports für IMAP-Verbindungen
Verschlüsselung
Port-Nr
unverschlüsselt
143
STARTTLS
143
IMAPS
993
Empfang via POP3
Bereich "Empfang"
Um eingehende Mails über das POP3-Protokoll vom Mailserver abholen zu können, öffnen Sie den
Bereich Empfang und wählen Sie POP3 als Protokoll aus. Daraufhin wird ein Formular dargestellt, über
welches die Anbindung des POP3-Mailservers eingestellt werden kann.
1. Server. Tragen Sie hier die IP-Adresse oder den Hostnamen des POP3-Mailservers ein.
2. Port. Tragen Sie hier die Port-Nummer des POP3-Mailservers ein.
3. Anmeldung. Tragen Sie hier die Art der Anmeldung am POP3-Mailserver ein.
4. Benutzer. Tragen Sie hier Ihren POP3-Benutzernamen ein, wenn eine Anmeldung am POP3Mailserver stattfindet.
91
E-Mails
5. Paswort. Tragen Sie hier Ihr POP3-Passwort ein, wenn eine Anmeldung am POP3-Mailserver
stattfindet.
6. Krypto. Wählen Sie aus, ob die Kommunikation mit dem POP3-Mailserver verschlüsselt stattfindet.
Anmerkung
Die nötigen Einstellungen erfahren Sie von Ihrem E-Mailanbieter. Im Anhang finden Sie
eine Tabelle mit POP3-Einstellungen für verschiedene E-Mailanbieter.
Abbildung 2.5.6. POP3-Einstellungen eines E-Mailkontos
Tabelle 2.5.2. Häufig verwendete Ports für POP3-Verbindungen
Verschlüsselung
Port-Nr
unverschlüsselt
110
STARTTLS
110
IMAPS
995
Versand via SMTP
Bereich "Versand"
Um ausgehende Mails über das SMTP-Protokoll versenden zu können, öffnen Sie den Bereich Versand
und wählen Sie SMTP als Protokoll aus. Daraufhin wird ein Formular dargestellt, über welches die
Anbindung des SMTP-Mailservers eingestellt werden kann.
1. Server. Tragen Sie hier die IP-Adresse oder den Hostnamen des SMTP-Mailservers ein.
2. Port. Tragen Sie hier die Port-Nummer des SMTP-Mailservers ein.
3. Anmeldung. Tragen Sie hier die Art der Anmeldung am SMTP-Mailserver ein.
92
E-Mails
4. Benutzer. Tragen Sie hier Ihren SMTP-Benutzernamen ein, wenn eine Anmeldung am SMTPMailserver stattfindet.
5. Paswort. Tragen Sie hier Ihr SMTP-Passwort ein, wenn eine Anmeldung am SMTP-Mailserver
stattfindet.
6. Krypto. Wählen Sie aus, ob die Kommunikation mit dem SMTP-Mailserver verschlüsselt
stattfindet.
Anmerkung
Die nötigen Einstellungen erfahren Sie von Ihrem E-Mailanbieter. Im Anhang finden Sie
eine Tabelle mit SMTP-Einstellungen für verschiedene E-Mailanbieter.
Abbildung 2.5.7. SMTP-Einstellungen eines E-Mailkontos
Tabelle 2.5.3. Häufig verwendete Ports für SMTP-Verbindungen
Verschlüsselung
Port-Nr
unverschlüsselt
25
STARTTLS
25 & 587
SMTPS
465 & 587
Mailordner zuweisen
Bereich "Ordner"
Die Standard-Ordner eines Mailkontos werden bei Aktionen verwendet, die innerhalb des Mailkontos
stattfinden.
93
E-Mails
1. Postausgang. Wenn eine E-Mail über das Mailkonto versendet wird, speichert das Programm eine
Kopie der versendeten Nachricht in diesem Ordner ab.
2. Entwürfe. Wenn eine E-Mail während der Bearbeitung gespeichert wird, speichert das Programm
die ungesendete Nachricht in diesem Ordner ab.
3. Papierkorb. Wenn eine E-Mail aus dem Mailkonto gelöscht wird, verschiebt das Programm die
Nachricht in diesen Ordner statt diese sofort zu löschen.
Um einen anderen Mailordner zu wählen, klicken Sie auf den jeweiligen Button. Es öffnet sich daraufhin
ein Fenster, über welches der Zielordner ausgewählt werden kann.
Wenn für eine der Aktionen kein Mailordner verwendet werden soll, kann rechts neben dem jeweiligen
Button auf inaktiv geklickt werden.
Abbildung 2.5.8. Ordner-Einstellungen eines E-Mailkontos
Erweiterte Einstellungen
Bereich "Erweitert"
Abhängig vom E-Mailanbieter können weitere Einstellungen hinterlegt werden. Im Regelfall ist dies nicht
nötig.
Klicken Sie oberhalb der Tabelle auf das + um einen leeren Eintrag in die Tabelle einzufügen. Um einen
markierten Eintrag zu entfernen, klicken Sie auf -.
Die möglichen Einstellungen sind in der Javamail-API dokumentiert:
• Javamail-Einstellungen für IMAP [http://javamail.kenai.com/nonav/javadocs/com/sun/mail/imap/
package-summary.html]
• Javamail-Einstellungen für POP3 [http://javamail.kenai.com/nonav/javadocs/com/sun/mail/pop3/
package-summary.html]
• Javamail-Einstellungen für SMTP [http://javamail.kenai.com/nonav/javadocs/com/sun/mail/smtp/
package-summary.html]
94
E-Mails
Abbildung 2.5.9. Erweiterte Einstellungen eines E-Mailkontos
E-Mails lesen
Nachdem ein E-Mailkonto mit Mailempfang eingerichtet wurde, kann auf den Inhalt der E-Mailkonten
zugegriffen werden. Klicken Sie dafür im Hauptmenü auf E-Mails → E-Mailansicht öffnen.
Alle E-Mailkonten, für die ein Mailempfang eingerichtet wurde, werden im Ansichtsbereich auf der linken
Seite dargestellt.
Ordner-Ansicht
Klicken Sie auf einen der E-Mailordner im Ansichtsbereich um dessen Inhalt dargestellt zu bekommen.
Bei jedem Klick werden automatisch die Mails vom Mailkonto heruntergeladen und in der Datenbank
gespeichert.
95
E-Mails
Abbildung 2.5.10. Inhalt eines E-Mailordners anzeigen
Nachrichten-Ansicht
Klicken Sie in der Ordner-Ansicht mit der linken Maustaste auf eine Mitteilung in der Tabelle. Unterhalb
der Tabelle wird die angeklickte Nachricht dargestellt.
Alternativ kann die Mitteilung durch einen Doppelklick mit der linken Maustaste in der Ordner-Ansicht
als neues Fenster geöffnet werden.
Abhängig vom Inhalt der E-Mail stehen verschiedene Ansichten zur Verfügung.
Tabelle 2.5.4. Arten von E-Mailansichten
Art
Beschreibung
Text-Ansicht
Die Text-Ansicht stellt den Nachrichtentext ohne weitere
Formatierungen dar.
HTML-Ansicht
Die HTML-Ansicht stellt den Nachrichtentext mit zusätzlichen
Formatierungen dar - z.B. Fettschrift, Bilder, etc.
XML-Ansicht
Die XML-Ansicht stellt die Nachricht inkl. Kopfzeilendar, wie sie
empfangen wurde und aktuell in der Datenbank gespeichert ist.
96
E-Mails
Abbildung 2.5.11. E-Mail in HTML-Ansicht
E-Mails senden
Nachdem ein E-Mailkonto mit Mailversand eingerichtet wurde, können E-Mailnachrichten erstellt und
versendet werden. Klicken Sie im Hauptmenü auf E-Mails → E-Mail verfassen um das E-Mailformular
zu öffnen.
97
E-Mails
Abbildung 2.5.12. Formular zum Verfassen einer E-Mail-Nachricht
Empfänger bearbeiten
In der oben dargestellten Tabelle können beliebig viele Empfänger für die Nachricht eingetragen werden.
Klicken Sie auf Hinzufügen um einen weitere Empfängerzeile in die Tabelle einzufügen. Durch Klick auf
Entfernen werden die aktuell markierten Zeilen aus der Empfängertabelle entfernt.
Tabelle 2.5.5. Arten von E-Mailempfängern
Art
Beschreibung
TO
Eine oder mehrere durch Kommata getrennte E-Mail-Adressen, an die die EMail primär gesendet wird. Jedem Adressaten werden auch alle anderen EMail-Adressen mitgeteilt.
CC
Eine oder mehrere durch Kommata getrennte E-Mail-Adressen, an die
eine Kopie der E-Mail gesendet wird. Jedem Adressaten werden auch alle
anderen E-Mail-Adressen mitgeteilt.
98
E-Mails
Art
Beschreibung
BCC
Das BCC-Feld enthält eine oder mehrere durch Kommata getrennte E-MailAdressen, an die eine Kopie der E-Mail gesendet wird, ohne dass dies jedoch
für die anderen angegebenen Empfänger sichtbar sein soll ("Blindkopie").
REPLY_TO
Eine oder mehrere durch Kommata getrennte E-Mail-Adressen, an die ein
mögliche Antwort zurück gesendet werden soll.
Nachrichtentext eingeben
In der Mitte des Formulares wird ein Textfeld dargestellt, in welches der eigentliche Nachrichtentext
eingetragen werden kann. Zusätzlich muss ein Betreff oberhalb des Nachrichtenfeldes eingegeben werden.
Im Auswahleld Absender werden alle E-Mailkonten dargestellt, für die ein Mailversand eingerichtet
wurde. Wählen Sie hier ein E-Mailkonto aus, über welches der Nachrichtenversand stattfinden soll.
Eine E-Mailnachricht kann in verschiedenen Formaten verfasst werden.
1. Text-Modus. Im Text-Modus kann nur einfacher Text eingegeben werden. Diese Darstellung ist
barrierefrei und sollte mit jedem E-Mailprogramm funktionieren.
Abbildung 2.5.13. E-Mail als Text-Nachricht erstellen
2. HTML-Modus. Im HTML-Modus können verschiedenste Formatierungen in der Nachricht
eingefügt werden (Schriftarten, Aufzählungen, etc). Diese Darstellung kann beim Empfänger zu
Problemen in der Darstellung führen.
99
E-Mails
Abbildung 2.5.14. E-Mail als HTML-Nachricht erstellen
Beim Verfassen einer Mitteilung kann man zwischen folgenden Vorgehensweisen im Umgang mit Text& HTML-Modus wählen.
Tabelle 2.5.6. Verfahrensweisen zum E-Mailversand
Art
Beschreibung
nur HTML
Die E-Mail wird als HTML-formatierte Mitteilung eingegeben. Beim
Versand wird automatisch eine alternative Textvariante ohne Formatierungen
für Empfänger beigefügt, die keine HTML-Mitteilungen lesen können.
nur Text
Die E-Mail wird als unformatierte Mitteilung eingegeben und als solche
versendet.
Text & HTML
Beim Verfassen kann die HTML- & Textvariante der Nachricht getrennt
voneinander eingegeben werden.
Klicken Sie rechts oberhalb des Nachrichtenfeldes auf den Button Optionen und wählen Sie im darauf
angezeigten Menü Versand als um eine der Verfahrensweisen zu wählen.
Abbildung 2.5.15. Verfahrensweisen zum E-Mailversand
100
E-Mails
Anhänge verwalten
An die Nachricht können beliebig viele Dateien als Anhang beigefügt werden. Klicken Sie dafür unten
rechts auf den Button Hinzufügen und wählen Sie eine oder mehrere Dateien von der Festplatte aus.
Jede angehangende Datei wird unterhalb des Textbereiches als Symbol dargestellt. Um den Anhang
nachträglich wieder zu entfernen, markieren Sie das jeweilige Symbol und klicken Sie auf Entfernen.
Anmerkung
Abhängig vom E-Mailanbieter dürfen Anhänge nicht beliebig groß sein. In der Regel wird
eine maximale Gesamtgröße für Anhänge vorgegeben. In der Regel liegt dieses Maximum
bei 5 bis 10MB.
Nachricht senden
Nachdem die Eingaben im Formular vervollständigt wurden, klicken Sie oben rechts auf Senden um die
Mitteilung zur verschicken.
Entwurf speichern
Nachdem die Eingaben im Formular vervollständigt wurden, klicken Sie oben rechts auf Speichern um
die Mitteilung als Entwurf zu speichern.
Es findet in diesem Falle kein Versand statt. Die Nachricht wird stattdessen im Entwurfsordner des
gewählten Absender-Mailkontos abgespeichert. Wenn kein Entwurfsordner ermittelt werden kann, wird
alternativ der Ordner DRAFTS im Benutzerkonto verwendet.
Die als Entwurf gespeicherte Nachricht kann zu einem späteren Zeitpunkt aus dem jeweiligen Ordner
wieder geöffnet, weiter bearbeitet und versendet werden.
Adressen verknüpfen
Die im Programm verwalteten E-Mails können mit Adressbuch-Einträgen verknüpft werden. Damit kann
im alltäglichen Arbeitsablauf schneller nachvollzogen werden, welche Nachrichten mit welchen Personen
ausgetauscht wurden.
Anmerkung
Die Funktionen zur Verknüpfung von E-Mails mit Adressen stehen nur zur Verfügung, wenn
das Adressbuch-Modul im Programm installiert und aktiviert wurde.
101
E-Mails
Abbildung 2.5.16. Übersicht zugewiesener E-Mails im Adressformular
Mailversand via Adressbuch
In der Adressübersicht und im Adressformular kann über das Aktionsmenü die Erzeugung eine neuen EMail gestartet werden.
Auf diesem Wege erzeugt E-Mails werden beim Versand automatisch mit der gewählten Adresse
verknüpft.
Abbildung 2.5.17. E-Mail aus dem Adressbestand verfassen
102
E-Mails
Adressauswahl beim Mailversand
Beim Verfassen einer E-Mail kann in der Empfängertabelle auf das Symbol geklickt werden, um einen
Empfänger aus dem Adressbuch zu übernehmen.
Auf diesem Wege erzeugt E-Mails werden beim Versand automatisch mit den gewählten Adressen
verknüpft.
Abbildung 2.5.18. Adressen beim Verfassen einer E-Mail verknüpfen
Adressen mit E-Mail verknüpfen
In der E-Mailansicht steht ein Formular zur Verknüpfung von Adressen mit der gewählten E-Mail zur
Verfügung.
103
E-Mails
Abbildung 2.5.19. Adressen mit einer bestehenden E-Mail verknüpfen
• Auf der linken Seite werden die im Adressbuch verfügbaren Adressen dargestellt. Über das Textfeld
Eingrenzung kann die Tabelle entsprechend eingegrenzt werden.
• Auf der rechten Seite werden Adressen angezeigt, die der E-Mail zugewiesen wurden.
• Mit Hilfe der Pfeil-Buttons in der Mitte können Zuweisungen vorgenommen werden. Alternativ findet
durch Klick auf Finden eine automatische Übernahme der Adressen statt, deren E-Mailadressen mit den
Empfängern und Absendern der E-Mail übereinstimmen.
Klicken Sie auf Übernehmen um Änderungen in der Zuweisung dauerhaft zu speichern.
Fragen & Antworten
Häufig gestellte Fragen zur E-Mailverwaltung
F:
Wie wird ein E-Mailkonto eingerichtet?
A:
1. Klicken Sie im Hauptmenü auf E-Mails → E-Mailkonten verwalten.
2. Es öffnet sich ein Fenster zur Verwaltung der E-Mailkonten. Klicken Sie darin unten links auf
Aktionen → Mailkonto hinzufügen.
3. Daraufhin wird auf der linken Seite des Fensters ein Eintrag zur Bearbeitung des neuen
Mailkontos dargestellt. Tragen Sie in den verschiedenen Formularen die nötigen Informationen
und klicken Sie abschließend auf Übernehmen um die Änderungen zu speichern.
104
E-Mails
4. Nach erfolgter Speicherung wird das neue E-Mailkonto in der E-Mailansicht des ImmoTools auf
der linken Seite dargestellt.
F:
Wie wird ein E-Mailkonto bearbeitet?
A:
1. Klicken Sie im Hauptmenü auf E-Mails → E-Mailkonten verwalten.
2. Es öffnet sich ein Fenster zur Verwaltung der E-Mailkonten. Wählen Sie in diesem Fenster auf
der linken Seite das zu verwaltende E-Mailkonto aus um die aktuellen Einstellungen einzusehen.
3. Sollten Sie eine Änderung vorgenommen haben, klicken Sie abschließend auf Übernehmen um
diese dauerhaft zu speichern.
F:
Wie wird ein E-Mailkonto gelöscht?
A:
1. Klicken Sie im Hauptmenü auf E-Mails → E-Mailkonten verwalten.
2. Es öffnet sich ein Fenster zur Verwaltung der E-Mailkonten. Markieren Sie auf der linken Seite
das zu löschende E-Mailkonto mit der linken Maustaste. Klicken Sie unten links auf Aktionen
um das Aktionsmenü für das markierte E-Mailkonto zu öffnen.
3. Klicken Sie im dargestellten Aktionsmenü auf Mailkonto entfernen.
4. Um die Änderung dauerhaft zu speichern, muss abschließend unten rechts auf Übernehmen
geklickt werden.
F:
Soll ich IMAP oder POP3 für den Mailempfang verwenden?
A:
• Wenn Sie die Wahl haben, empfiehlt es sich das IMAP-Protokoll zu verwenden. Dieses Protokoll
ermöglicht die Verwendung von Ordnern im Mailkonto und macht weniger Probleme bei der
gleichzeitigen Verwendung unterschiedlicher Mailprogramme.
• Das POP3-Protokoll untertstützt nur die wichtigsten Grundfunktionen - insbesondere das
Abholen & Löschen von Nachrichten aus dem E-Mailkonto. Mit POP3-Mailkonten können
deshalb nicht alle Funktionen des ImmoTools verwendet werden (z.B. keine Ordnerverwaltung).
105
Kapitel 2.6. Nachrichten
In
diesem
Kapitel
werden
die
Nachrichtenverwaltung dokumentiert.
Funktionen
der
Mit diesem Add-On können Nachrichten von externen Lieferanten im RSS- & Atom-Format verwaltet
werden. Die folgenden Bestandteile werden in das Programm integriert, wenn das Add-On OpenEstateTool-News installiert und aktiviert wurde:
Abbildung 2.6.1. Ansichtsbereich der Nachrichtenverwaltung
Nachrichtenquellen
In der Standardinstallation sind bereits verschiedene Nachrichtenquellen vorkonfiguriert.
•
•
•
•
Nachrichten von Tagesschau.de [http://www.tagesschau.de/]
Nachrichten vom OpenEstate-Blog [http://openestate.org/]
Aktuelle Diskussionen im OpenEstate-Forum [http://board.openestate.org/]
sowie Immobilien-Nachrichten von verschiedenen weiteren Lieferanten
Die gespeicherten Nachrichtenquellen können nach Bedarf geändert oder gelöscht werden.
Nachrichtenquelle einrichten. Um einen neuen RSS-Feed hinzuzufügen, klicken Sie bitte auf den
Button Neu. Es öffent sich ein neues Fenster. Tragen Sie in der ersten Zeile eine Bezeichnung für die
Nachrichtenquelle und in der zweiten Zeile die Adresse (URL) der Nachrichtenquelle ein.
Nachrichtenquelle bearbeiten. Um einen bereits eingerichteten RSS-Feed zu bearbeiten, markieren
Sie diesen in der Liste mit der Maus. Der Feed wird nun farbig hervor gehoben. Nun klicken Sie auf den
Button Bearbeiten.
Nachrichtenquelle löschen. Um einen bereits eingerichteten RSS-Feed zu löschen, markieren Sie
diesen in der Liste mit der Maus. Der Feed wird nun farbig hervor gehoben. Nun klicken Sie auf den
Button Löschen.
106
Teil 3. Administratorhandbuch
Dokumentationen für Administratoren
Inhaltsverzeichnis
3.1. Hinweise zum AdminTool ..........................................................................................
Allgemein ..............................................................................................................
Programmstart ................................................................................................
Verbindungsaufbau ..........................................................................................
Werkzeugleiste ...............................................................................................
Firmendaten bearbeiten ............................................................................................
Add-Ons bearbeiten .................................................................................................
Installierte Add-Ons .........................................................................................
Aktualisierungen .............................................................................................
Benutzer verwalten ..................................................................................................
Eckdaten des Benutzers bearbeiten .....................................................................
Personendaten bearbeiten ..................................................................................
Gruppen zuweisen ...........................................................................................
Berechtigungen erteilen ....................................................................................
Gruppen verwalten ..................................................................................................
Eckdaten der Gruppe bearbeiten .........................................................................
Benutzer zuweisen ...........................................................................................
Berechtigungen erteilen ....................................................................................
Roh-Inhalte der Datenbank anzeigen ...........................................................................
SQL-Befehle auf der Datenbank ausführen ..................................................................
3.2. Hinweise zum ImmoTool ...........................................................................................
Programmstart ........................................................................................................
Startdateien ....................................................................................................
Parameter .......................................................................................................
3.3. Hinweise zum Server .................................................................................................
Programmstart ........................................................................................................
Startdateien ....................................................................................................
Konfiguration .................................................................................................
Windows-Dienst einrichten .......................................................................................
Dienst im Betriebssystem (de)installieren ............................................................
Dienst automatisch starten & stoppen .................................................................
Dienst mit Hilfsskripten starten/stoppen ..............................................................
Mac-Dienst einrichten ..............................................................................................
Dienst im Betriebssystem registrieren .................................................................
Dienst aus dem Betriebssystem entfernen ............................................................
Dienst via Terminal starten ...............................................................................
Dienst via Terminal stoppen ..............................................................................
Unix-Dienst einrichten .............................................................................................
Einrichtung des Dienstes vorbereiten ..................................................................
Dienst im Betriebssystem registrieren .................................................................
Dienst aus dem Betriebssystem entfernen ............................................................
Dienst via Konsole starten ................................................................................
Dienst via Konsole stoppen ...............................................................................
SSL-Verschlüsselung ...............................................................................................
Erzeugung eines SSL-Zertifikates .......................................................................
Konfiguration der SSL-Verschlüsselung ..............................................................
SSL-Verschlüsselung im ImmoTool / AdminTool aktivieren ...................................
Datenbank sichern & wiederherstellen ........................................................................
Datensicherung eines inaktiven ImmoTool-Servers ................................................
Datensicherung eines laufenden ImmoTool-Servers ...............................................
Wiederherstellung der gesicherten Daten .............................................................
108
110
110
110
110
111
111
112
112
113
114
115
116
117
117
118
119
119
120
120
120
122
122
122
122
123
123
123
124
125
125
125
128
128
129
129
130
130
131
131
131
131
132
132
133
133
135
136
138
138
138
139
Administratorhandbuch
Aktualisierungen durchführen ....................................................................................
Einzelplatz-Projekt importieren ..................................................................................
Einzelplatz-Projekt exportieren ..................................................................................
Mehrere Datenbanken einrichten ................................................................................
Administrator-Passwort zurücksetzen ..........................................................................
109
139
140
141
142
142
Kapitel 3.1. Hinweise zum AdminTool
Das AdminTool ist ein Hilfsprogramm zur Administration einer ImmoTool-Datenbank.
Das Programm ist Bestandteil der ImmoTool-Installation und kann im bin-Verzeichnis durch Ausführung
der Dateien AdminTool.exe / AdminTool.bat / AdminTool.sh gestartet werden.
Allgemein
In diesem Kapitel werden allgemeine Funktionen & Konzepte des AdminTools dokumentiert.
Programmstart
Die Startdateien des AdminTools sind im Unterverzeichnis bin des Programmes abgelegt, z.B.: C:
\Programme\OpenEstate-ImmoTool\bin.
• Start unter Windows. Die Dateien AdminTool.exe und AdminTool.bat können zum Starten
des AdminTools verwendet werden.
• Start unter Mac/Linux/Unix. Das Skript AdminTool.sh kann zum Start des AdminTools
verwendet werden.
Verbindungsaufbau
Um eine Verbindung mit einer ImmoTool-Datenbank herzustellen, wird zum Start des AdminTools das
folgende Fenster dargestellt.
Abbildung 3.1.1. Verbindungsaufbau via AdminTool
Verbindung zu einer Datenbank mit dem AdminTool herstellen
Es gibt zwei Möglichkeiten, eine Datenbankverbindung mit dem AdminTool herzustellen.
1. Die Datenbank eines bestehenden Projektes (Einzelplatz oder Mehrplatz) kann geöffnet werden. Dafür
muss dem Programm lediglich das Projektverzeichnis auf der Festplatte mitgeteilt werden. Klicken Sie
dafür auf den Button Auswahl.
110
Hinweise zum AdminTool
Sollte es sich um ein Mehrplatz-Projekt handeln, muss zusätzlich Benutzer und Passwort des
Administrators eingegeben werden.
Abbildung 3.1.2. Verbindungsaufbau via AdminTool durch Auswahl eines
Projektes
2. Es kann eine direkte Verbindung mit einem ImmoTool-Server hergestellt werden, indem dessen
Verbindungsdaten sowie die Zugangsdaten des Administrators eingegeben werden.
Abbildung 3.1.3. Verbindungsaufbau via AdminTool durch direkte Eingabe der
Serverdaten
Werkzeugleiste
Das AdminTool stellt folgende Funktionen in der Werkzeugleiste zur Verfügung:
• DB öffnen. Öffnet eine Verbindung zu einer Datenbank. Eine eventuell bereits geöffnete DatenbankVerbindung wird geschlossen.
• DB schließen. Wenn eine Datenbank-Verbindung geöffnet ist, wird diese geschlossen.
• Aktualisieren. Alle dargestellten Reiter werden aktualisiert.
Abbildung 3.1.4. Werkzeugleiste im AdminTool
Firmendaten bearbeiten
Reiter Anbieter
111
Hinweise zum AdminTool
Im Reiter Anbieter können die Firmendaten und das Firmenlogo des Projektes eingesehen und bearbeitet
werden.
Abbildung 3.1.5. Firmendaten im AdminTool bearbeiten
Klicken Sie im Reiter auf Aktualisieren um die Firmendaten aus der Datenbank erneut zu ermitteln.
Klicken Sie im Reiter auf Übernehmen um geänderte Firmendaten dauerhaft in der Datenbank zu
speichern.
Add-Ons bearbeiten
Reiter Add-Ons
Im Reiter Add-Ons können die verfügbaren und im Projekt installierten Add-Ons eingesehen und bearbeitet
werden.
Klicken Sie im Reiter auf Aktualisieren um die Add-Ons aus der Datenbank erneut zu ermitteln.
Installierte Add-Ons
Im Reiter Installierte Add-Ons finden Sie eine tabellarische Übersicht der aktuell installierten Add-Ons.
• Spalte Add-On. stellt den Namen des jeweiligen Add-Ons dar.
• Spalte Version. stellt die aktuell installierte Version des Add-Ons in der Datenbank dar.
• Spalte Aktiv. stellt dar, ob das jeweilige Add-On in der Datenbank zur Verwendung aktiviert /
freigegeben wurde.
112
Hinweise zum AdminTool
Abbildung 3.1.6. Installierte Add-Ons im AdminTool bearbeiten
Add-Ons aktivieren / deaktivieren
Um ein Add-On im Projekt verwenden zu können, muss dieses durch die Administration aktiviert worden
sein.
Klicken Sie in der Tabellenspalte Aktiv auf die jeweilige Zeile um ein Add-On zu aktivieren. Eine
Änderung muss durch Klick auf Speichern bestätigt werden.
Add-Ons deinstallieren
Markieren Sie ein Add-On in der Tabelle und klicken Sie auf Deinstallieren um das gewählte Add-On
komplett aus der Datenbank zu entfernen.
Achtung
Bei der Deinstallation gehen sämtliche Daten verloren, die eventuell bereits mit dem AddOn erfasst worden sind!
Aktualisierungen
Im Reiter Aktualisierungen finden Sie eine tabellarische Übersicht der aktualisierbaren Add-Ons.
113
Hinweise zum AdminTool
Abbildung 3.1.7. Aktualisierungen der Add-Ons im AdminTool bearbeiten
• Spalte Add-On. stellt den Namen des jeweiligen Add-Ons dar.
• Spalte installierte Version. stellt die aktuell installierte Version des Add-Ons in der Datenbank dar
- wenn es bereits installiert wurde.
• Spalte neue Version. stellt die lokal verfügbare Version des Add-Ons dar.
• Spalte Installation. kann aktiviert werden, um die Installation / Aktualisierung des jeweiligen AddOns durchzuführen.
Hier werden Add-Ons dargestellt,
• die vom AdminTool beim Programmstart gefunden wurden aber noch nicht in der Datenbank installiert
sind.
• die vom AdminTool beim Programmstart gefunden wurden und in der Datenbank in einer früheren
Version installiert sind.
Klicken Sie in der Tabellenspalte Installieren auf die jeweilige Zeile um ein Add-On zu installieren /
aktualisieren. Der Vorgang wirde durch Klick auf Installation gestartet.
Anmerkung
Ein Add-On kann im ImmoTool nur verwendet werden, wenn die in der Datenbank
installierte Version mit der lokal verfügbaren Version übereinstimmt.
Benutzer verwalten
Reiter Benutzer
Beliebig viele Benutzer können auf den ImmoTool-Server zugreifen und gemeinsam an einem Projekt
arbeiten.
114
Hinweise zum AdminTool
Abbildung 3.1.8. Benutzerkonten im AdminTool bearbeiten
In der Benutzeransicht wird auf der linken Seite eine Liste der aktuell vorhandenen Benutzer dargestellt.
Klicken Sie auf einen der Benutzer um diesen zur Bearbeitung auszuwählen.
Auf der rechten Seite der Benutzeransicht werden Informationen zu dem aktuell ausgewählten Benutzer
dargestellt.
Folgende Aktionen können über die Buttons oberhalb der Benutzeransicht ausgeführt werden:
• Aktualisieren. Die aktuelle Ansicht aktualisieren.
• Neuer Benutzer. Einen neues Benutzer erzeugen.
• Entfernen. Den aktuell gewählten Benutzer entfernen.
• Übernehmen. Die vorgenommenen Änderungen in der Benutzeransicht dauerhaft speichern.
Achtung
Bitte beachten Sie, dass Sie nach jeder Änderung abschließend auf Übernehmen klicken
sollten. Andernfalls wird die zwischenzeitige Änderung nicht gespeichert und geht verloren.
Eckdaten des Benutzers bearbeiten
Reiter Benutzer
Wenn ein Benutzer zur Bearbeitung ausgewählt wurde, werden dessen Eckdaten im Reiter Benutzer
dargestellt.
115
Hinweise zum AdminTool
Abbildung 3.1.9. Benutzerkonto im AdminTool bearbeiten (Eckdaten)
• Login des Benutzers. Mit diesem Namen meldet sich der Benutzer an der Datenbank an. Der
gewöhlte Name darf nicht doppelt vergeben werden.
• Passwort des Benutzers. Mit diesem Passwort meldet sich der Benutzer beim Start des ImmoTools
auf der Datenbank an. Markieren Sie das Feld ändern, um nachträglich ein neues Passwort zuzuordnen.
• Benutzer ist freigeschaltet. Mit dieser Option kann dem Benutzer die Berechtigung zur Anmeldung
auf der Datenbank erteilt oder entzogen werden.
• Benutzer ist Administrator. Mit dieser Option werden dem Benutzer sämtliche Zugriffsrechte in
dem Projekt erteilt. Der Benutzer darf damit auf alle Daten zugreifen, weitere Benutzer anlegen, AddOns installieren etc.
• Notizen zum Benutzer. An dieser Stelle können bei Bedarf Anmerkungen und Notizen zu einem
Benutzerkonto hinterlegt werden.
• Effektive Berechtigungen. In der Tabelle werden die Berechtigungen des Benutzers dargestellt, die
ihm direkt zugewiesen wurden oder die er durch Zuweisung von Gruppen geerbt hat.
Personendaten bearbeiten
Reiter Person
Wenn ein Benutzer zur Bearbeitung ausgewählt wurde, werden dessen Personendaten im Reiter Person
dargestellt.
116
Hinweise zum AdminTool
Abbildung 3.1.10. Benutzerkonto im AdminTool bearbeiten (Personendaten)
Anmerkung
Die hier hinterlegten Personendaten kann der Benutzer nachträglich via ImmoTool
bearbeiten (wenn die nötigen Rechte vorhanden sind).
Gruppen zuweisen
Reiter Gruppen
Wenn ein Benutzer zur Bearbeitung ausgewählt wurde, werden dessen Gruppen-Mitgliedschaften im
Reiter Gruppen dargestellt.
Abbildung 3.1.11. Benutzerkonto im AdminTool bearbeiten (Gruppen zuweisen)
In der Tabelle werden die aktuell in der Datenbank registrierten Gruppen dargestellt. Durch Klick in die
Spalte Zuweisung können dem Benutzer eine oder mehrere Gruppen zugewiesen werden.
Anmerkung
Ein Benutzer erbt die Berechtigungen aus den ihm zugewiesenen Gruppen.
Berechtigungen erteilen
Reiter Berechtigungen
Wenn ein Benutzer zur Bearbeitung ausgewählt wurde, werden dessen Berechtigungen im Reiter
Berechtigungen dargestellt.
117
Hinweise zum AdminTool
Abbildung 3.1.12. Benutzerkonto im AdminTool bearbeiten (Berechtigungen
zuweisen)
In der Tabelle werden die von den Add-Ons bereitgestellten Berechtigungen dargestellt. Durch Klick in
die Spalte Aktiv können dem Benutzer eine oder mehrere Berechtigungen zugewiesen werden.
Anmerkung
Ein Benutzer erbt die Berechtigungen aus den ihm zugewiesenen Gruppen.
Gruppen verwalten
Reiter Gruppen
Die Benutzer können in mehrere Gruppen zusammengefasst werden. Durch die Mitgliedschaft eines
Benutzers in einer Gruppe erbt diese die in der Gruppe hinterlegten Berechtigungen.
Abbildung 3.1.13. Benutzergruppen im AdminTool bearbeiten
In der Gruppenansicht wird auf der linken Seite eine Liste der aktuell vorhandenen Gruppen dargestellt.
Klicken Sie auf eine der Gruppen um diese zur Bearbeitung auszuwählen.
Auf der rechten Seite der Gruppenansicht werden Informationen zu der aktuell ausgewählten Gruppe
dargestellt.
Folgende Aktionen können über die Buttons oberhalb der Gruppenansicht ausgeführt werden:
• Aktualisieren. Die aktuelle Ansicht aktualisieren.
• Neue Gruppe. Eine neue Gruppe erzeugen.
• Gruppe entfernen. Die aktuell gewählte Gruppe entfernen.
• Übernehmen. Die vorgenommenen Änderungen in der Gruppenansicht dauerhaft speichern.
118
Hinweise zum AdminTool
Achtung
Bitte beachten Sie, dass Sie nach jeder Änderung abschließend auf Übernehmen klicken
sollten. Andernfalls wird die zwischenzeitige Änderung nicht gespeichert und geht verloren.
Eckdaten der Gruppe bearbeiten
Reiter Gruppe
Wenn eine Gruppe zur Bearbeitung ausgewählt wurde, werden deren Eckdaten im Reiter Gruppe
dargestellt.
Abbildung 3.1.14. Benutzergruppe im AdminTool bearbeiten (Eckdaten)
• Name der Gruppe. Tragen Sie eine Bezeichnung für die Gruppe ein, sodass Sie diese später besser
wiedererkennen.
• Notizen zur Gruppe. An dieser Stelle können bei Bedarf Anmerkungen und Notizen zu einer Gruppe
hinterlegt werden.
Benutzer zuweisen
Reiter Mitglieder
Wenn eine Gruppe zur Bearbeitung ausgewählt wurde, werden die zugewiesenen Benutzer im Reiter
Mitglieder dargestellt.
Abbildung 3.1.15. Benutzergruppe im AdminTool bearbeiten (Mitglieder zuweisen)
In der Tabelle werden die aktuell in der Datenbank registrierten Benutzer dargestellt. Durch Klick in die
Spalte Zuweisung können der Gruppe eine oder mehrere Benutzer als Mitglied zugewiesen werden.
Anmerkung
Jedes Mitglied einer Gruppe erbt deren Berechtigungen.
119
Hinweise zum AdminTool
Berechtigungen erteilen
Reiter Berechtigungen
Wenn eine Gruppe zur Bearbeitung ausgewählt wurde, werden deren zugewiesene Berechtigungen im
Reiter Berechtigungen dargestellt.
Abbildung 3.1.16. Benutzergruppe im AdminTool bearbeiten (Berechtigungen
zuweisen)
In der Tabelle werden die von den Add-Ons bereitgestellten Berechtigungen dargestellt. Durch Klick in
die Spalte Aktiv können der Gruppe eine oder mehrere Berechtigungen zugewiesen werden.
Anmerkung
Jedes Mitglied einer Gruppe erbt deren Berechtigungen.
Roh-Inhalte der Datenbank anzeigen
Reiter SQL-Browser
Im SQL-Browser können die rohen Inhalte der Datenbank angezeigt werden (Tabellen, Views & Stored
Procedures).
Abbildung 3.1.17. Roh-Inhalte der Datenbank im AdminTool anzeigen
SQL-Befehle auf der Datenbank ausführen
Reiter SQL-Konsole
In der SQL-Konsole können beliebige SQL-Anfragen auf der Datenbank ausgeführt werden.
120
Hinweise zum AdminTool
Abbildung 3.1.18. SQL-Befehle im AdminTool ausführen
Achtung
Verwenden Sie diese Funktion mit Bedacht. Ein falscher Eingriff kann die Datenbank
beschädigen.
121
Kapitel 3.2. Hinweise zum ImmoTool
Programmstart
Startdateien
Die Startdateien des ImmoTools sind im Unterverzeichnis bin des Programmes abgelegt, z.B.: C:
\Programme\OpenEstate-ImmoTool\bin.
Start unter Windows
Die Dateien ImmoTool.exe und ImmoTool.bat können zum Starten des ImmoTools verwendet
werden.
Start unter Mac/Linux
Das Shell-Skript ImmoTool.sh kann zum Start des ImmoTools verwendet werden.
Parameter
Der Programmstart des ImmoTools kann durch die folgenden Parameter beeinflusst werden.
Tabelle 3.2.1. Parameter zum ImmoTool-Programmstart
Parameter
Funktion
-defaultLookAndFeel
Startet das Programm mit dem Standard Look & Feel [http://
de.wikipedia.org/wiki/Aussehen_und_Handhabung] des
Betriebssystems.
-help
Stellt eine Übersicht aller Parameter auf der Kommandozeile dar und
beendet das Programm.
-noProject
Startet das Programm ohne automatisch ein Projekt zu öffnen. Statt
dessen wird der Projektassistent dargestellt.
-noUpdate
Deaktiviert die Funktion zur automatischen Aktualisierung im
Programm.
-project arg
Das bei arg angegebene Projektverzeichnis wird beim
Programmstart automatisch geöffnet.
122
Kapitel 3.3. Hinweise zum Server
In diesem Kapitel werden Hinweise zur Administration des ImmoTool-Servers zusammengefasst.
Anmerkung
Um mit dem ImmoTool-Server über das Netzwerk kommunizieren zu können, muss
eventuell eine Zugriffsregel in der Firewall hinterlegt werden. Benötigt wird in der
Standardeinstellung eine Freigabe für Verbindungen auf Port-Nr 9001.
Programmstart
Startdateien
Die Startdateien des Servers sind im Unterverzeichnis bin des Programmes abgelegt, z.B.:
C:\Programme\OpenEstate-ImmoServer\bin
Tabelle 3.3.1. Startdateien des ImmoTool-Servers
Datei
Betriebssystem Beschreibung
manager-backup.app
Mac
manager-backup.bat
Windows
manager-backup.sh
Mac / Linux
manager-console.bat
Windows
manager-console.exe
Windows
manager-console.sh
Mac / Linux
manager-gui.app
Mac
manager-gui.bat
Windows
manager-gui.exe
Windows
manager-gui.sh
Mac / Linux
manager-shutdown.app
Mac
manager-shutdown.bat
Windows
manager-shutdown.sh
Mac / Linux
server-console.bat
Windows
server-console.sh
Mac / Linux
server-daemoninstall.bat
Windows
server-daemoninstall.sh
Mac / Linux
server-daemonquery.bat
Windows
123
Öffnet eine Verbindung zu einem gestarteten
ImmoTool-Server und führt einen Befehl zur
Datensicherung aus. Die erzeugte Sicherungsdatei
wird standardmäßig im Verzeichnis var/
backup abgelegt.
Öffnet eine Administrator-Konsole, die
Steuerbefehle oder SQL-Anfragen auf der
Datenbank ausführen kann.
Öffnet eine grafische AdministratrationsAnwendung, die Steuerbefehle oder SQLAnfragen auf der Datenbank ausführen kann.
Öffnet eine Verbindung zu einem gestarteten
ImmoTool-Server und führt einen Befehl zum
Herunterfahren der Datenbank aus.
ImmoTool-Server im Vordergrund ausführen.
ImmoTool-Server als Dienst im Betriebssystem
installieren.
Überprüfung ob der ImmoTool-Server-Dienst
installiert und/oder gestartet ist.
Hinweise zum Server
Datei
Betriebssystem Beschreibung
server-daemon-query.sh Mac / Linux
Windows
server-daemonstart.bat
Installierten ImmoTool-Server als Dienst im
Hintergrund starten.
server-daemon-start.sh Mac / Linux
server-daemon-stop.bat Windows
Gestarteten ImmoTool-Server-Dienst beenden.
server-daemon-stop.sh
Mac / Linux
server-daemonuninstall.bat
Windows
server-daemonuninstall.sh
Mac / Linux
server-setenv.bat
Windows
server-setenv.sh
Mac / Linux
server-wrapper.bat
Windows
server-wrapper.sh
Mac / Linux
Diese Datei wird von den server-*-Skripten
verwendet um den ImmoTool-Server auszuführen
und kann nicht direkt gestartet werden.
start.app
Mac
ImmoTool-Server im Vordergrund ausführen.
start.bat
Windows
start.exe
Windows
start.sh
Mac / Linux
Installierten ImmoTool-Server-Dienst aus dem
Betriebssystem entfernen.
Diese Datei konfiguriert verschiedene
Umgebungsvariablen für die server-*-Skripte und
kann nicht direkt gestartet werden.
Anmerkung
Die Skripte beginnend mit server-* werden mit Hilfe des Projektes YAJSW bereitgestellt.
Weitere Informationen zur Konfiguration dieser Skripte finden Sie bei yajsw.sourceforge.net
[http://yajsw.sourceforge.net/].
Konfiguration
Die Konfigurationen des Servers sind im Unterverzeichnis etc des Programmes abgelegt, z.B.:
C:\Programme\OpenEstate-ImmoServer\etc
Im Einzelfall kann es hilfreich sein, die Konfiguration des ImmoTool-Servers auf die eigenen Bedürfnisse
hin anzupassen. Für die meisten Fälle sollte die ausgelieferte Standard-Konfiguration jedoch ausreichend
sein.
Tabelle 3.3.2. Konfigurationsdateien des ImmoTool-Servers
Datei
Beschreibung
log4j.properties Konfiguration des Verhaltens zur Erzeugung von Protokolldateien.
Standardmäßig werden die log-Dateien des ImmoTool-Servers
im Verzeichnis var/log als hsqldb.log.* abgelegt.
Weitere Informationen zur Konfiguration von log4j finden Sie bei
logging.apache.org [http://logging.apache.org/log4j/1.2/manual.html].
manager.conf
Konfiguration der automatischen Anmeldung am ImmoTool-Server für
die Startskripte beginnend mit manager-*. Weitere Informationen zur
124
Hinweise zum Server
Datei
Beschreibung
Konfiguration dieser Datei finden Sie bei hsqldb.org [http://hsqldb.org/
doc/2.0/util-guide/sqltool-chapt.html#sqltool_auth-sect].
server.properties Konfiguration der Datenbanken im ImmoTool-Server. Weitere
Informationen zur Konfiguration dieser Datei finden Sie bei hsqldb.org
[http://hsqldb.org/doc/2.0/guide/listeners-chapt.html#listeners_server_propssect].
wrapper.conf
Konfiguration von YAJSW, welches von den Startskripten beginnend
mit server-* verwendet wird. Weitere Informationen finden Sie
bei yajsw.sourceforge.net [http://yajsw.sourceforge.net/YAJSW
%20Configuration%20Parameters.html].
Windows-Dienst einrichten
gilt für Windows-Betriebssysteme mit Server-Funktionen
In der alltäglichen Praxis ist es hilfreich, den ImmoTool-Server als Dienst in das Betriebssystem zu
integrieren. Der ImmoTool-Server kann damit automatisch beim Booten des Betriebssystems gestartet
werden. Ebenso kann der Administrator den Dienst von außen unkompliziert steuern (Start / Stopp /
Neustart).
Dienst im Betriebssystem (de)installieren
Via Explorer (de)installieren
• Um den ImmoTool-Server im Betriebssystem als Dienst zu registrieren, kann die Datei serverdaemon-install.bat im Explorer mit einem Doppelklick gestartet werden.
• Um den installierten ImmoTool-Dienst aus Betriebssystem wieder zu entfernen, kann die Datei
server-daemon-uninstall.bat im Explorer mit einem Doppelklick gestartet werden.
Via Kommandozeile (de)installieren
Öffnen Sie dafür die Kommandozeile und wechseln Sie in das bin-Verzeichnis des ImmoTool-Servers,
z.B.:
cd C:\Programme\OpenEstate-ImmoServer\bin
• Geben Sie folgenden Befehl ein, um den ImmoTool-Server als Dienst im Betriebssystem zu registrieren:
server-daemon-install.bat
• Geben Sie folgenden Befehl ein, um den ImmoTool-Dienst wieder aus dem Betriebssystem zu
entfernen: server-daemon-uninstall.bat
Dienst automatisch starten & stoppen
Nachdem der Dienst installiert wurde, finden Sie einen Eintrag in der Dienste-Verwaltung des
Betriebssystems.
125
Hinweise zum Server
Abbildung 3.3.1. Server als Windows-Dienst verwalten (Schritt 1)
Öffnen Sie die Systemsteuerung und klicken Sie auf Verwaltung.
Abbildung 3.3.2. Server als Windows-Dienst verwalten (Schritt 2)
Klicken Sie im Verwaltungs-Fenster auf Dienste.
126
Hinweise zum Server
Abbildung 3.3.3. Server als Windows-Dienst verwalten (Schritt 3)
Den Dienst OpenEstate-ImmoServer starten.
Abbildung 3.3.4. Server als Windows-Dienst verwalten (Schritt 4)
Den Dienst OpenEstate-ImmoServer stoppen / neu starten.
Anmerkung
In der Standardinstallation wird der Dienst OpenEstate-ImmoServer beim Start des
Betriebssystems automatisch gestartet. Wenn kein automatischer Start gewünscht ist, klicken
Sie mit rechter Maustaste auf den Dienst OpenEstate-ImmoServer → Eigenschaften. Im
darauf geöffneten Fenster kann der gewünschte Starttyp festgelegt werden.
Anmerkung
Auf neueren Windows-Systemen muss eventuell muss ein Systembenutzer gewählt werden,
der zum Start des ImmoTool-Servers verwendet werden soll. Klicken Sie dafür mit rechter
Maustaste auf den Dienst OpenEstate-ImmoServer → Eigenschaften und wählen Sie im
folgenden Fenster den Reiter Anmelden aus. Aktivieren Sie die Option Dieses Konto und
tragen Sie Namen und das Passwort des zu verwendenden Systembenutzers ein.
127
Hinweise zum Server
Abbildung 3.3.5. Systembenutzer für den Windows-Dienst auswählen
Dienst mit Hilfsskripten starten/stoppen
Es werden verschiedene Hilfsskripte bereitgestellt, um den installierten ImmoTool-Dienst zu starten /
stoppen.
Via Explorer starten/stoppen
• Um den ImmoTool-Dienst zu starten, kann die Datei server-daemon-start.bat im Explorer
mit einem Doppelklick gestartet werden.
• Um den laufenden ImmoTool-Dienst zu stoppen, kann die Datei server-daemon-stop.bat im
Explorer mit einem Doppelklick gestartet werden.
Via Kommandozeile starten/stoppen
Öffnen Sie dafür die Kommandozeile und wechseln Sie in das bin-Verzeichnis des ImmoTool-Servers,
z.B.:
cd C:\Programme\OpenEstate-ImmoServer\bin
• Der installierte Dienst kann mit folgendem Befehl gestartet werden: server-daemon-start.bat
• Der gestartete Dienst kann mit folgendem Befehl gestoppt werden: server-daemon-stop.bat
Mac-Dienst einrichten
gilt für Mac OS X
In der alltäglichen Praxis ist es hilfreich, den ImmoTool-Server als Dienst in das Betriebssystem zu
integrieren. Der ImmoTool-Server kann damit automatisch beim Booten des Betriebssystems gestartet
128
Hinweise zum Server
werden. Ebenso kann der Administrator den Dienst von außen unkompliziert steuern (Start / Stopp /
Neustart).
Anmerkung
In den folgenden Beispielen wird davon ausgegangen, dass der ImmoTool-Server im
Verzeichnis /Applications/OpenEstate-Server installiert wurde. Sollte Sie ein
anderes Installationsverzeichnis verwenden, müssen die folgenden Befehle entsprechend
angepasst werden.
Anmerkung
Standardmäßig wird der Dienst des ImmoTool-Servers unter Mac OS X im Verzeichnis /
Library/LaunchDaemons registriert. Damit kann der Dienst beim Start von Mac OS
X gestartet werden, ohne dass ein Mac-Benutzer angemeldet sein muss. Dies setzt jedoch
voraus, dass die Befehle von einem Administrator ausgeführt werden. In den folgenden
Beispielen wird deshalb jeder Befehl beginnend mit sudo gestartet. Sollten Sie bereits als
Administrator angemeldet sein, kann auf die Angabe von sudo verzichtet werden.
Tipp
Weitere Informationen zu launchd [http://de.wikipedia.org/wiki/Launchd] finden Sie unter
launchd Daemonverwaltung unter Mac OS X [http://www.apfelwiki.de/Main/Launchd],
Einführung zu launchd [http://www.macosxhints.ch/index.php?page=2&hintid=1759] und
Manual page for „launchctl“ [http://developer.apple.com/library/mac/#documentation/
Darwin/Reference/Manpages/man1/launchctl.1.html].
Dienst im Betriebssystem registrieren
Öffnen Sie das bin-Verzeichnis des ImmoTool-Servers im Terminal, z.B.:
cd /Applications/OpenEstate-Server/bin
Folgender Befehl installiert den Dienst im Betriebssystem:
sudo ./server-daemon-install.sh
Oder alternativ:
sudo sh server-daemon-install.sh
Mit folgendem Befehel können Sie prüfen, ob der Dienst im Betriebssystem installiert wurde:
sudo launchctl list
Es sollte eine Auflistung aller installierten Dienste dargestellt werden. Bei einer korrekten Installation
sollten Sie den Dienst wrapper.OpenEstate-Server vorfinden.
Dienst aus dem Betriebssystem entfernen
Nachdem der Dienst installiert wurde, kann dieser mit dem Hilfsprogramm launchctl aus dem Terminal
heraus wieder deinstalliert werden:
129
Hinweise zum Server
sudo launchctl unload /Library/LaunchDaemons/wrapper.OpenEstate-Server
Alternativ kann der installierte Dienst aus dem Programmverzeichnis des ImmoTool-Servers heraus
deinstalliert werden. Wählen Sie dieses über das Terminal aus:
cd /Applications/OpenEstate-Server/bin
Folgender Befehl entfernt den zuvor installierten Dienst aus dem Betriebssystem:
sudo ./server-daemon-uninstall.sh
Oder alternativ:
sudo sh server-daemon-uninstall.sh
Dienst via Terminal starten
Nachdem der Dienst installiert wurde, kann dieser mit dem Hilfsprogramm launchctl aus dem Terminal
heraus gestartet werden:
sudo launchctl start wrapper.OpenEstate-Server
Alternativ kann der installierte Dienst aus dem Programmverzeichnis des ImmoTool-Servers heraus
gestartet werden. Wählen Sie dieses über das Terminal aus:
cd /Applications/OpenEstate-Server/bin
Und starten Sie den ImmoTool-Server mit folgendem Befehl:
sudo ./server-daemon-start.sh
Oder alternativ:
sudo sh server-daemon-start.sh
Dienst via Terminal stoppen
Nachdem der Dienst installiert wurde, kann dieser mit dem Hilfsprogramm launchctl aus dem Terminal
heraus gestoppt werden:
sudo launchctl start wrapper.OpenEstate-Server
Alternativ kann der installierte Dienst aus dem Programmverzeichnis des ImmoTool-Servers heraus
gestoppt werden. Wählen Sie dieses über das Terminal aus:
cd /Applications/OpenEstate-Server/bin
Und beenden Sie den gestarteten ImmoTool-Server mit folgendem Befehl:
sudo ./server-daemon-stop.sh
Oder alternativ:
sudo sh server-daemon-stop.sh
130
Hinweise zum Server
Unix-Dienst einrichten
gilt für alle Linux/Unix-Betriebssysteme
In der alltäglichen Praxis ist es hilfreich, den ImmoTool-Server als Dienst in das Betriebssystem zu
integrieren. Der ImmoTool-Server kann damit automatisch beim Booten des Betriebssystems gestartet
werden. Ebenso kann der Administrator den Dienst von außen unkompliziert steuern (Start / Stopp /
Neustart).
Anmerkung
In den folgenden Beispielen wird davon ausgegangen, dass der ImmoTool-Server im
Verzeichnis /opt/OpenEstate-Server installiert wurde. Sollte Sie ein anderes
Installationsverzeichnis verwenden, müssen die folgenden Befehle entsprechend angepasst
werden.
Einrichtung des Dienstes vorbereiten
Auf unixoiden Betriebssystemen werden die Dienste in einem zentralen Verzeichnis hinterlegt.
Normalerweise sind diese Skripte unter einem der folgenden Verzeichnissen zu finden:
• /etc/init.d
• /etc/rc.d
Bringen Sie in Erfahrung, an welcher Stelle auf Ihrem Betriebssystem die Dienste hinterlegt werden.
Bearbeiten Sie die Datei etc/wrapper.conf mit einem Editor und tragen Sie darin den Pfad hinter
der Variablen wrapper.daemon.dir ein. Zum Beispiel:
Beispiel 3.3.1. Unix-Dienst in /etc/init.d speichern
wrapper.daemon.dir = /etc/init.d
Beispiel 3.3.2. Unix-Dienst in /etc/rc.d speichern
wrapper.daemon.dir = /etc/rc.d
Dienst im Betriebssystem registrieren
Öffnen Sie das bin-Verzeichnis des ImmoTool-Servers in einer Konsole, z.B.:
cd /opt/OpenEstate-Server/bin
Folgender Befehl installiert den Dienst im zuvor konfigurierten Verzeichnis (z.B. /etc/init.d):
./server-daemon-install.sh
Oder alternativ:
sh server-daemon-install.sh
Dienst aus dem Betriebssystem entfernen
Öffnen Sie das bin-Verzeichnis des ImmoTool-Servers in einer Konsole, z.B.:
131
Hinweise zum Server
cd /opt/OpenEstate-Server/bin
Folgender Befehl entfernt den Dienst aus dem zuvor konfigurierten Verzeichnis (z.B. /etc/init.d):
./server-daemon-uninstall.sh
Oder alternativ:
sh server-daemon-uninstall.sh
Dienst via Konsole starten
Nachdem der Dienst installiert wurde, kann dieser aus dem Dienste-Verzeichnis (z.B. /etc/init.d)
heraus gestartet werden:
/etc/init.d/OpenEstate-Server start
Alternativ kann der Dienst aus dem Programmverzeichnis des ImmoTool-Servers heraus gestartet werden.
Wählen Sie dieses über die Konsole:
cd /opt/OpenEstate-Server/bin
Und starten Sie den ImmoTool-Server mit folgendem Befehl:
./server-daemon-start.sh
Oder alternativ:
sh server-daemon-start.sh
Der Neustart eines bereits gestarteten ImmoTool-Servers kann durchgeführt werden mit:
/etc/init.d/OpenEstate-Server restart
Dienst via Konsole stoppen
Nachdem der Dienst installiert und gestartet wurde, kann dieser aus dem Dienste-Verzeichnis (z.B. /etc/
init.d) heraus gestoppt werden:
/etc/init.d/OpenEstate-Server stop
Alternativ kann der Dienst aus dem Programmverzeichnis des ImmoTool-Servers heraus beendet werden.
Wählen Sie dieses über die Konsole:
cd /opt/OpenEstate-Server/bin
Und beenden Sie den gestarteten ImmoTool-Server mit folgendem Befehl:
./server-daemon-stop.sh
Oder alternativ:
sh server-daemon-stop.sh
132
Hinweise zum Server
SSL-Verschlüsselung
Einrichtung eines SSL-verschlüsselten Zugriffes auf den Server
In diesem Handbuch-Abschnitt werden die nötigen Schritte dokumentiert, um eine verschlüsselte
Kommunikation zwischen ImmoTool & ImmoTool-Server einzurichten.
Wann sollte man verschlüsseln?
Wenn sich der ImmoTool-Server außerhalb des lokalen Firmen-Netzwerkes befindet oder
Verbindungen über das Internet zulässt, empfiehlt es sich die Kommunikation zwischen
ImmoTool & ImmoTool-Server zu verschlüsseln.
Es ist grundsätzlich nicht falsch eine Verschlüsselung durchzuführen, da es hierbei zu
einem Gewinn an Sicherheit und Integrität bei der Datenübertragung kommt. Jedoch ist
damit zu rechen, dass die Kommunikation geringfügig länger als bei einer unverschlüsselten
Verbindung dauern wird.
Wichtig
Der ImmoTool-Server erlaubt keine gleichzeitige Verwendung von verschlüsselten und
unverschlüsselten Verbindungen. Sie müssen sich für einen der beiden Wege entscheiden
und entsprechend alle ImmoTools in Ihrem Netzwerk konfigurieren.
Erzeugung eines SSL-Zertifikates
Um eine verschlüsselte Datenübertragung zu realisieren, muss auf dem ImmoTool-Server ein SSLZertifikat bereit liegen. Dieses stellt die Vertrauenswürdigkeit des ImmoTool-Servers gegenüber den
darauf zugreifenden ImmoTools sicher.
Im Programmverzeichnises des ImmoTool-Servers finden Sie das Verzeichnis etc/ssh. Darin ist
ein Skript init_ssl.bat / init_ssl.sh enthalten. Mit Hilfe dieses Skriptes kann ein SSLSchlüsselpaar und SSL-Zertifikat für den ImmoTool-Server erstellt werden.
Starten Sie das Skript init_ssl.bat (unter Windows) bzw. init_ssl.sh (unter Mac/Linux).
Sollte es nicht möglich sein das Skript durch einen Doppelklick auszuführen, kann alternativ auf die
Kommandozeile zurück gegriffen werden um das Skript zu starten.
Nachdem das Skript (init_ssl.bat / init_ssl.sh) gestartet wurde sind folgende Eingaben
vorzunehmen:
1. Wählen Sie ein Passwort aus, mit welchem das erzeugte SSL-Schlüsselpaar vor unberechtigtem Zugriff
abgesichert werden soll. Das gewählte Passwort wird zu einem späteren Zeitpunkt noch benötigt.
Abbildung 3.3.6. Passwort zur Absicherung der SSL-Schlüssel wählen
2. Tragen Sie als „Vor- und Nachname“ den Hostnamen oder die IP-Adresse Ihres Servers ein.
133
Hinweise zum Server
Abbildung 3.3.7. Name des abzusichernden Servers angeben („Common Name“)
Im SSL-Zertifikat wird diese Angabe als sogenannter „Common Name“ (CN) verwendet.
Wichtig
Der gewählte „Common Name“ muss in Ihrem Netzwerk auf den ImmoTool-Server
verweisen. Beim Aufbau einer verschlüsselten Verbindung über das ImmoTool muss
dieser Name als Hostname verwendet werden.
Anmerkung
Wenn Sie statt eines Hostnamens eine IP-Adresse als „Common Name“ verwenden,
sollten Sie sicherstellen, dass die IP-Adresse in Ihrem Netzwerk permanent gleich bleibt.
Mit jeder Änderung der IP-Adresse muss auch ein neues SSL-Zertifikat erzeugt werden.
3. Verschiedene weitere Angaben werden abgefragt. Hier können beliebige Eingaben vorgenommen
werden - passend zur jeweiligen Firma.
Abbildung 3.3.8. Weitere Details zum SSL-Schlüssel angeben
4. Es sollte kein Schlüsselkennwort eingegeben werden. Bestätigen Sie die Eingabe einfach mit ENTER.
Abbildung 3.3.9. Passwort zur Absicherung der SSL-Schlüssels angeben
5. Damit im letzten Schritt das SSL-Zertifikat zu dem SSL-Schlüsselpaar exportiert werden kann, tragen
Sie nochmals das im ersten Schritt gewählte Passwort ein.
134
Hinweise zum Server
Abbildung 3.3.10. Zertifikat zum SSL-Schlüssel exportieren
Nachdem das Skript erfolgreich ausgeführt wurde finden Sie im Verzeichnis etc/ssl zwei weitere
Dateien.
Erzeugte Dateien im Verzeichnis etc/ssl
OpenEstateImmoServer.jks
Die Datei enthält das erzeugte SSL-Schlüsselpaar des ImmoToolServers.
OpenEstateImmoServer.crt
Die Datei enthält das erzeugte SSL-Zertifikat des ImmoToolServers.
Anmerkung
Sollte das Skript (init_ssl.bat / init_ssl.sh) nicht gestartet werden können, kann
die Erzeugung der SSL-Daten alternativ über die folgenden Befehle auf der Kommandozeile
erfolgen:
Beispiel 3.3.3. Befehl zur Erzeugung des SSL-Schlüsselpaares
keytool -genkey \
-alias OpenEstate-ImmoServer \
-keyalg RSA -validity 999 \
-keystore OpenEstate-ImmoServer.jks \
-storetype JKS
Beispiel 3.3.4. Befehl zur Erzeugung der SSL-Zertifikates
keytool -export \
-alias OpenEstate-ImmoServer \
-keystore OpenEstate-ImmoServer.jks \
-rfc -file OpenEstate-ImmoServer.crt
Anmerkung
Das erzeugte SSL-Zertifikat des ImmoTool-Servers ist für 999 Tage gültig. Nach Ablauf
dieser Zeit muss ein neues SSL-Zertifikat erzeugt werden. Führen Sie das Skript
(init_ssl.bat / init_ssl.sh) erneut aus, um ein neues SSL-Zertifikat für die
nächsten 999 Tage zu erzeugen. Nach der Neu-Erzeugung muss der ImmoTool-Server neu
gestartet werden.
Konfiguration der SSL-Verschlüsselung
Dem Datenbank-Server muss mitgeteilt werden, dass eine verschlüsselte Kommunikation erfolgen soll.
Öffnen Sie dafür die Datei etc/server.properties aus dem Programmverzeichnis des ImmoToolServers mit einem Texteditor. Die folgenden Einträge müssen vorgenommen werden:
135
Hinweise zum Server
Beispiel 3.3.5. Konfiguration der SSL-Verschlüsselung
# TLS/SSL (secure) sockets
server.tls=true
system.javax.net.ssl.keyStore=./etc/ssl/OpenEstate-ImmoServer.jks
system.javax.net.ssl.keyStorePassword=MEIN-SSL-PASSWORT
Einstellungen am Server für SSL-Verschlüsselung
server.tls
Durch den Wert true wird die SSL-Verschlüsselung im ImmoToolServer aktiviert.
system.javax.net.ssl.keyStore
Hier muss der Pfad zur JKS-Datei angegeben werden. Die
Datei wurde zuvor mit dem Hilfsskript (init_ssl.bat /
init_ssl.sh) erstellt und enthält die zur SSL-Verschlüsselung
nötigen Daten.
system.javax.net.ssl.keyStorePasswordHier muss das Passwort eingetragen werden, dass Sie während der
Erzeugung des SSL-Schlüsselpaares gewählt haben.
Damit die Änderungen an der Datei etc/server.properties wirksam werden, muss der
ImmoTool-Server neu gestartet werden.
Anmerkung
Wenn das Betriebssystem es ermöglicht, empfiehlt es sich die Zugriffsrechte auf die Datei
etc/server.properties zu limitieren, sodass andere Benutzer des Betriebssystems
nicht darauf zugreifen können. Unter Linux / Mac entspricht dies:
chmod 600 server.properties
SSL-Verschlüsselung im ImmoTool / AdminTool
aktivieren
Beim Aufbau der Verbindung muss als Protokoll „hsqls“ ausgewählt werden, damit das ImmoTool /
AdminTool eine verschlüsselte Verbindung zum ImmoTool-Server herstellt.
136
Hinweise zum Server
Abbildung 3.3.11. Verschlüsselung beim Erzeugen eines Projektes aktivieren
Beim Erzeugen eines neuen Projektes kann im Projekt-Assistenten das Protokoll „hsqls“ gewählt werden,
um eine verschlüsselte Verbindung zum ImmoTool-Server herzustellen.
Abbildung 3.3.12. Verschlüsselung beim Öffnen eines Projektes aktivieren
Beim Öffnen eines Projektes kann bei der Benutzer-Anmeldung zusätzlich das Protokoll „hsqls“ gewählt
werden, um eine verschlüsselte Verbindung zum ImmoTool-Server herzustellen.
Abbildung 3.3.13. Verschlüsselung im AdminTool aktivieren
Beim Verbindungsaufbau mit dem AdminTool kann das Protokoll „hsqls“ gewählt werden, um eine
verschlüsselte Verbindung zum ImmoTool-Server herzustellen.
137
Hinweise zum Server
Datenbank sichern & wiederherstellen
Über den Umgang mit Datensicherungen für den ImmoTool-Server
Im alltäglichen Betrieb ist es zwingend empfohlen, regelmäßige Sicherungen von der Datenbank des
ImmoTool-Servers zu machen. In diesem Abschnitt werden verschiedene Strategien zur Datensicherung
vorgestellt und die Vorgehensweise zur Wiederherstellung beschrieben.
Datensicherung eines inaktiven ImmoTool-Servers
Datenbank sichern, wenn der ImmoTool-Servers nicht gestartet wurde
Wenn der ImmoTool-Server nicht gestartet ist (oder kurzzeitig beendet wurde), genügt eine Sicherung des
Unter-Ordners var/data im Programmverzeichnis des ImmoTool-Servers. Dort werden standardmäßig
alle Dateien der Datenbank abgelegt.
Wichtig
Es ist davon abzuraten, das var/data-Verzeichnis im laufenden Betrieb des ImmoToolServers zu sichern. Dies kann zu einer fehlerhaften Datensicherung führen, die nicht
wiederhergestellt werden kann.
Datensicherung eines laufenden ImmoTool-Servers
Datenbank sichern, während der ImmoTool-Server in Betrieb ist
Wenn man den ImmoTool-Server nicht beenden will um eine Datensicherung zu erzeugen, kann
das Hilfsprogramm manager-backup.bat (unter Windows), manager-backup.sh (unter Unix/
Linux) oder manager-backup (unter Mac OS X) aus dem bin-Verzeichnis des ImmoTool-Servers
verwendet werden.
Damit das Hilfsprogramm sich mit der Datenbank verbinden kann, sind folgende Konfigurationen
einmalig vorzunehmen:
1. Öffnen Sie die Datei manager.conf im etc-Verzeichnis des ImmoTool-Servers mit einem
Texteditor. Die Datei sieht ungefähr wie folgt aus:
urlid immotool
url jdbc:hsqldb:hsql://localhost/immotool
username SA
password
2. Tragen Sie hinter dem Text „password“ das Passwort des Datenbank-Administrators (Benutzer „SA“)
ein. Nach der Änderung sieht die Datei ungefähr wie folgt aus:
urlid immotool
url jdbc:hsqldb:hsql://localhost/immotool
username SA
password test1234
3. Starten Sie den ImmoTool-Server, wenn dies noch nicht der Fall ist.
4. Starten Sie das Hilfsprogramm manager-backup.bat (unter Windows), manager-backup.sh
(unter Unix/Linux) oder manager-backup (unter Mac OS X) aus dem bin-Verzeichnis des
ImmoTool-Servers.
Nach erfolgreicher Ausführung des Hilfsprogrammes finden Sie im Verzeichnis „var/backup/immotool“
des ImmoTool-Servers ein TAR.GZ-Archiv mit der Sicherung der aktuellen Datenbank.
138
Hinweise zum Server
Tipp
Mit Hilfe des Taskplaners (unter Windows) oder eines Cron-Jobs (unter Unix) kann das
Hilfsprogramm automatisch zu einem beliebigen Zeitpunkt geplant und ausgeführt werden.
Anmerkung
Wenn mehr als eine Datenbank auf dem ImmoTool-Server hinterlegt wurden, müssen
die Skripte manager-backup.bat / manager-backup.sh von Hand entsprechend
angepasst werden.
Wiederherstellung der gesicherten Daten
Eine gesicherte Datenbank in einen ImmoTool-Server importieren
Eine Datensicherung ist grundsätzlich nur eine Kopie der Datenbank-Dateien. Die Wiederherstellung
dieser Daten ist relativ einfach.
1. Beenden Sie den ImmoTool-Server, sollte dieser aktuell in Betrieb sein.
2. Sollte die Sicherung als ZIP-Archiv oder TAR.GZ-Archiv vorliegen, entpacken Sie diese Dateien auf
Ihrem Rechner.
3. Kopieren Sie die gesicherten Datenbank-Dateien db.data, db.lobs, db.properties &
db.script in das Verzeichnis der jeweiligen Datenbank - z.B. in das Unter-Verzeichnis var/
data/immotool des ImmoTool-Servers.
Anmerkung
Stellen Sie sicher, dass das Datenbank-Verzeichnis vor dem Kopieren der DatenbankDateien komplett leer ist.
4. Starten Sie den ImmoTool-Server neu, um mit der wiederhergestellten Datenbank weiterarbeiten zu
können.
Aktualisierungen durchführen
Hinweise zur Aktualisierung des ImmoTool-Servers
Gelegentlich werden Aktualisierungen für den ImmoTool-Server veröffentlicht. Im Unterschied zum
ImmoTool können diese Aktualisierungen jedoch nicht automatisch heruntergeladen und installiert
werden. Im folgenden Abschnitt wird die Vorgehensweise beschrieben, um eine Aktualisierung des
ImmoTool-Servers in Betrieb zu nehmen.
Anmerkung
Um einen Datenverlust im Falle eines Fehlers zu vermeiden, empfehlen wir das
Programmverzeichnis des ImmoTool-Servers vor der Aktualisierung zu sichern.
1. Laden Sie sich die aktuelle Version des ImmoTool-Servers von openestate.org [http://openestate.org]
herunter.
2. Entpacken Sie das heruntergeladene ZIP-Archiv (oder TAR.GZ-Archiv) in ein neues Verzeichnis auf
Ihrem Computer.
3. Beenden Sie den ImmoTool-Server auf Ihrem Rechner, sollte dieser aktuell noch gestartet sein.
139
Hinweise zum Server
Sollte der ImmoTool-Server als Dienst auf Ihrem Rechner installiert worden sein, deinstallieren Sie den
Dienst bevor Sie mit der Aktualisierung fortfahren (siehe Anleitung für Windows, Mac OS X, Linux/
Unix).
4. Kopieren Sie alle Dateien aus dem in Schritt 2 erzeugten bin-Verzeichnis in das gleichnamige
Verzeichnis des aktuell installierten ImmoTool-Servers.
Anmerkung
Bereits vorhandene Dateien im bin-Verzeichnis können dabei überschrieben werden.
5. Kopieren Sie alle Dateien aus dem in Schritt 2 erzeugten etc-Verzeichnis in das gleichnamige
Verzeichnis des aktuell installierten ImmoTool-Servers.
Wichtig
Bereits vorhandene Dateien im etc-Verzeichnis sollten dabei nicht überschrieben
werden.
6. Entfernen Sie alle Dateien und Ordner im lib-Verzeichnis des aktuell installierten ImmoTool-Servers.
Kopieren Sie dorthin alle Dateien aus dem in Schritt 2 erzeugten gleichnamigen Verzeichnis.
7. Entfernen Sie alle Dateien und Ordner im doc-Verzeichnis des aktuell installierten ImmoTool-Servers.
Kopieren Sie dorthin alle Dateien aus dem in Schritt 2 erzeugten gleichnamigen Verzeichnis.
8. Der ImmoTool-Server kann nun wieder neu gestartet werden.
Bei Bedarf kann nun wieder der ImmoTool-Server als Dienst im Betriebssystem installiert werden
(siehe Anleitung für Windows, Mac OS X, Linux/Unix).
Einzelplatz-Projekt importieren
Ein Einzelplatz-Projekt auf einen ImmoTool-Server übernehmen
Im Folgenden wird die Vorgehensweise beschrieben, um ein bestehendes Einzelplatz-Projekt nachträglich
auf einen ImmoTool-Server zu migrieren. Die im Einzelplatz-Projekt erfassten Daten können auf diesem
Wege für mehrere Benutzer im Netzwerk verfügbar gemacht werden.
1. Beenden Sie den ImmoTool-Server, sollte dieser aktuell in Betrieb sein.
2. Erzeugen Sie im Verzeichnis des ImmoTool-Servers den Ordner var/data/immotool, wenn dieser
noch nicht existieren sollte. Sollte das Verzeichnis bereits vorhanden sein, entfernen Sie die darin
enthaltenen Dateien.
3. Im Verzeichnis des Einzelplatz-Projektes sollten Sie ein Verzeichnis data finden. Darin befinden
sich verschiedene Dateien der Einzelplatz-Datenbank: immotool.data, immotool.lobs,
immotool.properties & immotool.script.
4. Kopieren Sie die Dateien aus Schritt 3 ins Verzeichnis var/data/immotool des ImmoToolServers. Benenennen Sie die Dateien jeweils um in db.data, db.lobs, db.properties &
db.script.
5. Starten Sie den ImmoTool-Server neu und melden Sie sich mit dem AdminTool auf dem Server an
(Benutzer „SA“ mit leerem Passwort). Bei der ersten Anmeldung wird das AdminTool Sie bitten ein
Administrator-Passwort festzulegen.
140
Hinweise zum Server
Ab diesem Zeitpunkt kann mit dem ImmoTool & AdminTool auf die Datenbank als Mehrplatz-Projekt
zugegriffen werden.
Anmerkung
Der Verbindungsaufbau zum ImmoTool-Server via AdminTool wird in diesem HandbuchAbschnitt beschrieben.
Der Verbindungsaufbau zum ImmoTool-Server via ImmoTool wird in diesem HandbuchAbschnitt beschrieben.
Einzelplatz-Projekt exportieren
Projekt im ImmoTool-Server in ein Einzelplatz-Projekt umwandeln
Im Folgenden wird die Vorgehensweise beschrieben, um ein bestehendes Mehrplatz-Projekt aus einem
ImmoTool-Server in ein Einzelplatz-Projekt umzuwandeln.
1. Starten Sie das ImmoTool und erstellen Sie ein neues / leeres Einzelplatz-Projekt. In dieses neu erstellte
Projekt wird in den nächsten Schritten die Datenbank vom ImmoTool-Server übernommen.
Anmerkung
Merken Sie sich den Speicherort des Projektes auf Ihrer Festplatte.
2. Beenden Sie das ImmoTool nachdem das neue Projekt erstellt und erstmals geöffnet wurde.
3. Beenden Sie den ImmoTool-Server, sollte dieser aktuell in Betrieb sein.
4. Im Verzeichnis data des zuvor erstellten Einzelplatz-Projektes sollten verschiedene
Dateien vorfinden: immotool.data, immotool.lobs, immotool.properties &
immotool.script. Löschen Sie alle im data-Verzeichnis enthaltenen Dateien und Unterordner.
5. Im Verzeichnis var/data/immotool des ImmoTool-Servers sollten Sie folgende Dateien
vorfinden: db.data, db.lobs, db.properties & db.script. Kopieren Sie diese Dateien ins
data-Verzeichnis des zuvor erstellten Einzelplatz-Projektes. Benenennen Sie die Dateien jeweils um
in immotool.data, immotool.lobs, immotool.properties & immotool.script.
6. Bearbeiten Sie die Datei immotool.script aus dem data-Verzeichnis des Einzelplatz-Projektes
mit einem Texteditor.
Wichtig
Sichern Sie sich die immotool.script-Datei, bevor Sie daran Änderungen
vornehmen. Eventuelle Fehler können zu einer kaputten Datenbank führen.
7. Suchen Sie in der immotool.script-Datei die Zeile, die wie folgt beginnt:
CREATE USER SA PASSWORD DIGEST
Tauschen Sie die gefundene Zeile durch folgende Zeile aus:
CREATE USER SA PASSWORD DIGEST 'd41d8cd98f00b204e9800998ecf8427e'
8. Speichern Sie die geänderte immotool.script-Datei ab.
141
Hinweise zum Server
Ab diesem Zeitpunkt kann das Einzelplatz-Projekt mit ImmoTool geöffnet werden und alle Daten aus dem
Mehrplatz-Projekt stehen zur Verfügung.
Mehrere Datenbanken einrichten
Mehrere Datenbanken über einen ImmoTool-Server bereitstellen
Der ImmoTool-Server stellt in der Grundinstallation eine Datenbank namens „immotool“ zur Verfügung.
Bei Bedarf können beliebig viele weitere Datenbanken von einem ImmoTool-Server bereitgestellt werden.
Im Folgenden wird die Vorgehensweise beschrieben, um eine weitere Datenbank namens „immotool2“
im ImmoTool-Server zu registrieren.
1. Beenden Sie den ImmoTool-Server, sollte dieser aktuell in Betrieb sein.
2. Öffnen Sie die Datei server.properties im etc-Verzeichnis des ImmoTool-Servers mit einem
Texteditor und tragen Sie am Ende der Datei Folgendes ein:
# database #1
server.database.1=file:./var/data/immotool2/db
server.dbname.1=immotool2
Damit wird eine zweite Datenbank mit der Bezeichnung „immotool2“ registriert, deren Daten im UnterVerzeichnis var/data/immotool2 des ImmoTool-Servers abgelegt werden.
3. Speichern Sie die geänderte server.properties-Datei ab und starten Sie den ImmoTool-Server
neu.
4. Via AdminTool & ImmoTool kann man nun eine Verbindung zur zweiten Datenbank herstellen. Beim
Verbindungsaufbau muss dabei der neue Datenbankname „immotool2“ angegeben werden.
Allgemein können in der server.properties-Datei beliebig viele Datenbanken mit frei wählbarem
Namen registriert werden. Für jede weitere Datenbank muss der Zähler erhöht werden - z.B.:
# database #0
server.database.0=file:./var/data/immotool/db
server.dbname.0=immotool
# database #1
server.database.1=file:./var/data/mydb/db
server.dbname.1=mydb
# database #2
server.database.2=file:./var/data/anotherdb/db
server.dbname.2=anotherdb
Administrator-Passwort zurücksetzen
Wenn der Administrator sein Passwort vergessen hat...
Im Falle, dass der Administrator sein Passwort vergessen hat und sich nicht mehr am ImmoTool-Server
anmelden kann, kann auf folgendem Wege ein neues Passwort zugewiesen werden.
1. Beenden Sie den ImmoTool-Server, sollte dieser aktuell in Betrieb sein.
2. Öffnen Sie die Datei db.script aus dem Verzeichnis var/data/immotool des ImmoToolServers mit einem Texteditor.
142
Hinweise zum Server
Wichtig
Sichern Sie sich die db.script-Datei, bevor Sie daran Änderungen vornehmen.
Eventuelle Fehler können zu einer kaputten Datenbank führen.
3. Suchen Sie in der db.script-Datei die Zeile, die wie folgt beginnt:
CREATE USER SA PASSWORD DIGEST
Tauschen Sie die gefundene Zeile durch folgende Zeile aus:
CREATE USER SA PASSWORD DIGEST '16d7a4fca7442dda3ad93c9a726597e4'
4. Speichern Sie die geänderte db.script-Datei ab und starten Sie den ImmoTool-Server neu.
5. Das Passwort des Administrator-Benutzers „SA“ sollte damit geändert worden sein auf „test1234“.
Dieses Passwort kann ab sofort verwendet werden, um sich als Datenbank-Administrator anzumelden.
Wichtig
Das geänderte Administrator-Passwort sollte mit Hilfe der AdminTools wieder auf ein
geheimes Passwort geändert werden (siehe Anleitung).
143
Teil 4. Anhang
Anhänge zum Handbuch
Inhaltsverzeichnis
4.A. Übernahme eines alten Projektes in ImmoTool 1.0 .........................................................
4.B. E-Mailanbieter .........................................................................................................
E-Mailempfang via IMAP ........................................................................................
E-Mailempfang via POP3 .........................................................................................
E-Mailversand via SMTP .........................................................................................
4.C. Support ...................................................................................................................
Supportfälle ............................................................................................................
Supportwege ...........................................................................................................
Forum ...........................................................................................................
Ticketsystem ..................................................................................................
4.D. Nutzungslizenz .........................................................................................................
145
146
149
149
149
150
151
151
151
151
151
152
Anhang 4.A. Übernahme eines alten
Projektes in ImmoTool 1.0
Hinweise zur Übernahme eines alten ImmoTool-Projektes in Version 1.0
Anmerkung
Die alte Installation des ImmoTools bleibt bei der Migration komplett unangetastet. Sollte
die Umstellung auf die neue Version 1.0 Probleme bereiten oder fehlschlagen, kann mit der
alten Version normal weiter gearbeitet werden.
Die folgenden Schritte sind nötig, um ein bestehendes ImmoTool-Projekt aus einer früheren Version (0.9.x
oder 1.0.beta10) in Version 1.0 zu übernehmen.
1. Aktualisieren Sie Ihre bestehende ImmoTool-Installation ggf. auf die aktuellste Version (mindestens
0.9.15 bzw. 1.0-beta10f). Klicken Sie dafür im Hauptmenü auf Extras → Aktualisierung.
Abbildung 4.A.1. Automatische Aktualisierung vor Durchführung der
Datensicherung
2. Öffnen Sie das zu übernehmende Projekt mit der alten ImmoTool-Version und erzeugen Sie eine
Datensicherung, durch Klick im Hauptmenü auf Extras → Datenbank → Sicherung für Version 1.x.
Abbildung 4.A.2. Sicherung aus dem alten ImmoTool erzeugen
Eine Datensicherung für ImmoTool 1.x erzeugen.
Bei diesem Vorgang wird ein ZIP-Archiv mit den Inhalten der Projekt-Datenbank auf der Festplatte
gespeichert, welches Sie unter Schritt (4) noch benötigen werden.
3. Installieren Sie ImmoTool 1.0 zusätzlich zur bereits vorhandenen alten Version des ImmoTools. Die
Installationsschritte sind in diesem Abschitt dokumentiert.
146
Übernahme eines alten
Projektes in ImmoTool 1.0
Wichtig
Überschreiben Sie die alte Installation des ImmoTools unter keinen Umständen! Die neue
und alte Version sollten nebeneinander installiert werden.
4. Die Vorgehensweise zur Übernahme der unter (2) exportierten Daten hängt davon ab, ob das Projekt
in ImmoTool 1.0 als Einzelplatz- oder Mehrplatz-Projekt fortgeführt werden soll.
a. Wenn des Projekt in ImmoTool 1.0 als Einzelplatz-Installation betrieben werden soll, können Sie
ImmoTool 1.0 starten und die gesicherte Datenbank mit Hilfe des Projekt-Assistenten importieren.
Abbildung 4.A.3. Datensicherung als Einzelplatz-Projekt importieren (Schritt
1)
Wählen Sie als Art des Projektes die Option Neues Einzelplatz-Projekt aus ImmoTool 0.9.15
übernehmen. Im daraufhin dargestellten Formular, können Sie die unter Schritt (2) gespeicherte
Sicherungsdatei auswählen, indem sie auf den Button Auswahl klicken. Das ZIP-Archiv wird
daraufhin vom Programm geprüft und die Firmendaten automatisch übernommen.
Abbildung 4.A.4. Datensicherung als Einzelplatz-Projekt importieren (Schritt
2)
Prüfen Sie sicherheitshalber die Firmendaten & Add-Ons und klicken Sie abschließend auf Projekt
erzeugen. Während der Erzeugung des neuen Projektes wird die Sicherungsdatei automatisch in die
Datenbank importiert.
b. Wenn das Projekt in ImmoTool 1.0 als Mehrplatz-Installation betrieben werden soll, muss vorab der
ImmoTool-Server installiert und in Betrieb genommen werden. Die Schritte zur Server-Installation
werden in diesem Abschitt erläutert.
Nachdem der ImmoTool-Server erfolgreich in Betrieb genommen wurde, kann die gesicherte
Datenbank mit Hilfe des AdminTools auf den Server übertragen werden.
Die alte Datensicherung kann im AdminTool auf folgenden Wegen importiert werden:
147
Übernahme eines alten
Projektes in ImmoTool 1.0
• Bei der erstmaligen Anmeldung an einem ImmoTool-Server wird ein Fenster dargestellt, über
welches die Datenbankstrukturen installiert werden können. Dabei kann zusätzlich die in Schritt
(2) erzeugte Sicherungsdatei angegeben werden.
Abbildung 4.A.5. Datensicherung als Mehrplatz-Projekt importieren
(Variante 1)
• Wenn die Datenstrukturen bereits mit dem AdminTool erzeugt wurden, kann die Datensicherung
nachträglich durch Klick ins Hauptmenü auf Werkzeuge → Migration aus früherer Version
importiert werden.
Abbildung 4.A.6. Datensicherung als Mehrplatz-Projekt importieren
(Variante 2)
Nachdem die Datenübernahme ins Mehrplatz-Projekt abgeschlossen wurde, kann die Verbindung
zur Datenbank über das ImmoTool hergestellt werden, wie in diesem Abschitt beschrieben.
148
Anhang 4.B. E-Mailanbieter
Im Folgenden finden Sie die technischen Eckdaten verschiedener E-Mailanbieter, die zur Erzeugung eines
E-Mailkontos im ImmoTool nötig sind.
E-Mailempfang via IMAP
Tabelle 4.B.1. IMAP-Serverdaten verschiedener E-Mailanbieter
Anbieter
Server
Port
GMail [http://
mail.google.com/]
imap.googlemail.com993
Anmeldung
Krypto
LOGIN
IMAPS
mit E-Mailadresse
& Passwort
GMX [http://
www.gmx.net/]
imap.gmx.net
993
LOGIN
IMAPS
mit E-Mailadresse
& Passwort
Web.de [http://
web.de/]
imap.web.de
143 (bei
STARTTLS)
993 (bei IMAPS)
Yahoo.com [http:// imap.mail.yahoo.com993
yahoo.com/]
LOGIN
IMAPS /
STARTTLS
mit E-Mailadresse
& Passwort
LOGIN
IMAPS
mit E-Mailadresse
& Passwort
E-Mailempfang via POP3
Tabelle 4.B.2. POP3-Serverdaten verschiedener E-Mailanbieter
Anbieter
Server
Port
GMail [http://
mail.google.com/]
pop.googlemail.com 995
Anmeldung
Krypto
LOGIN
POP3S
mit E-Mailadresse
& Passwort
GMX [http://
www.gmx.net/]
pop.gmx.net
995
LOGIN
POP3S
mit E-Mailadresse
& Passwort
Web.de [http://
web.de/]
pop3.web.de
110 (bei
STARTTLS)
995 (bei POP3S)
Yahoo.com [http:// pop.mail.yahoo.com 995
yahoo.com/]
LOGIN
mit E-Mailadresse
& Passwort
LOGIN
mit E-Mailadresse
& Passwort
149
POP3S /
STARTTLS
POP3S
E-Mailanbieter
E-Mailversand via SMTP
Tabelle 4.B.3. SMTP-Serverdaten verschiedener E-Mailanbieter
Anbieter
Server
Port
Anmeldung
Krypto
GMail [http://
mail.google.com/]
smtp.gmail.com
465 (bei SMTPS)
LOGIN
SMTPS /
STARTTLS
587 (bei
STARTTLS)
mit E-Mailadresse
& Passwort
25
(unverschlüsselt)
LOGIN
GMX [http://
www.gmx.net/]
mail.gmx.net
465 (bei SMTPS)
Web.de [http://
web.de/]
smtp.web.de
25
(unverschlüsselt)
587 (bei
STARTTLS)
Yahoo.com [http:// smtp.mail.yahoo.com25 / 587
yahoo.com/]
(unverschlüsselt)
465 (bei SMTPS)
150
SMTPS
mit E-Mailadresse
& Passwort
LOGIN
STARTTLS
mit E-Mailadresse
& Passwort
LOGIN
mit E-Mailadresse
& Passwort
SMTPS
Anhang 4.C. Support
Jeder Anwender mit freigeschaltetem Zugang zum Anwenderbereich [http://dev.openestate.org/] kann
einen kostenlosen technischen Support zum OpenEstate-ImmoTool und den weiteren OpenEstateProjekten in Anspruch nehmen.
Supportfälle
Der Support umfasst Hilfestellungen bei:
1.
2.
3.
4.
der Installation des Programms
der Einrichtung des Programms
der Aktualisierung des Programms
Fehlern im Programm
Supportwege
Forum
zur öffentlichen Kontaktaufnahme & Diskussion
Das OpenEstate-Forum [http://board.openestate.org/] ist eine Plattform zur Kommunikation zwischen den
OpenEstate-Anwendern & -Entwicklern. Dies ist das bevorzugte Kommunikationsmedium, da hier auch
andere ImmoTool-Benutzer sich ggf. zu Ihrem Anliegen äußern können.
Eine Teilnahme am Forum ist mit und ohne Anmeldung möglich. Mit einer Anmeldung stehen Ihnen
weitere Komfortfunktionen zur Verfügung.
Achtung
Bitte beachten Sie bei der Veröffentlichung von Protokoll-Dateien, dass diese vertrauliche
Informationen (z.B. FTP-Zugangsdaten) enthalten können. Bitte prüfen Sie die daraufhin,
bevor diese ins Forum hochgeladen werden oder übermitteln Sie das Protokoll als PrivatMitteilung an einen der Moderatoren.
Ticketsystem
zur privaten Kontaktaufnahme & Diskussion
Das Ticketsystem befindet sich im Loginbereich für OpenEstate-Anwender [http://dev.openestate.org/
] unter dem Menüpunkt Ticketsystem. Hier können Sie vertrauliche Probleme oder Wünsche mit den
Entwicklern diskutieren.
151
Anhang 4.D. Nutzungslizenz
OpenEstate Nutzungslizenz (Freeware)
Zwischen den OpenEstate-Entwicklerrn (nachfolgend als Lizenzgeber bezeichnet) und dem Lizenznehmer
wird folgende Nutzungsvereinbarung abgeschlossen.
1. Gegenstand
(a) Gegenstand dieser Lizenz sind Programme und Bibliotheken (nachfolgend als Software bezeichnet),
die im Rahmen des OpenEstate-Projektes erstellt und veröffentlicht wurden. Weitere Informationen zu
den OpenEstate-Projekten finden Sie unter: http://www.openestate.org
(b) Der Lizenznehmer kann sich kostenlos auf der OpenEstate-Website registrieren und einen individuellen
Lizenzschlüssel für die Software beantragen. Die Registrierung erfolgt unter folgender Adresse: http://
dev.openestate.org
2. Rechte des Lizenznehmers
(a) Die Software kann kostenlos heruntergeladen, installiert und unbegrenzt verwendet werden.
(b) Aktualisierungen der Software werden vom Lizenzgeber kostenlos bereitgestellt.
(c) Die Software darf im privaten / persönlichen Umfeld beliebig vervielfältigt und verbreitet werden.
(d) Bei Verbreitung / Vervielfältigung der Software mit kommerziellen Absichten, ist die schriftliche
Genehmigung der Lizenzgeber einzuholen.
(e) Die mit der Software erstellten Dateien sind frei von Rechten seitens der Lizenzgeber und dürfen vom
Lizenznehmer beliebig weiter verwendet werden.
(f) Die Software darf verwendet werden um eigene Erweiterungen (sog. Add-Ons) zu entwickeln und zu
vermarkten.
(g) Jeder registrierte Lizenznehmer hat einen individuellen Zugang zur OpenEstate-Website und kann
darüber mit den Entwicklern in Kontakt treten.
3. Pflichten des Lizenznehmers
(a) Manipulation, Dekompilierung und Disassemblierung der Software ist untersagt.
(b) Bei Vervielfältigung der Software müssen sämtliche Urheberrechtshinweise und Lizenztexte erhalten
bleiben.
(c) Die Lizenzdaten / Lizenzschlüssel sind vertraulich und dürfen nicht an Dritte weiter gegeben werden.
(d) Die Software darf ohne Zustimmung des Lizenzgebers weder vermietet noch verkauft werden.
(e) Bei Vermarktung eigener Erweiterungen (sog. Add-Ons) zur Software müssen die existierenden
Urheberrechtshinweise und Lizenztexte erhalten bleiben. Die Lizenz der entwickelten Erweiterung kann
frei gewählt werden, muss jedoch vereinbar mit der OpenEstate-Nutzungslizenz und den BibliotheksLizenzen sein.
152
Nutzungslizenz
4. Entzug der Nutzungslizenz
(a) Bei Verstoß gegen die Verpflichtungen in (3) ist der Lizenzgeber berechtigt, die Nutzungslizenz zu
entziehen.
5. Keine Gewährleistung
(a) Da die Software ohne jegliche Gebühren lizenziert wird, besteht keinerlei Gewährleistung für die
Software, soweit dies gesetzlich zulässig ist. Sofern nicht anderweitig schriftlich bestätigt, stellen die
Copyright-Inhaber und/oder Dritte die Software „so, wie sie ist“ zur Verfügung, ohne Gewährleistung
irgendeiner Art, weder ausdrücklich noch implizit. Dieser Garantieausschluß gilt auch – ohne darauf
beschränkt zu sein – für Marktreife oder Verwendbarkeit für einen bestimmten Zweck. Das volle Risiko
bezüglich Qualität und Leistungsfähigkeit der Software liegt bei Ihnen. Sollte sich die Software als
fehlerhaft herausstellen, liegen die Kosten für notwendigen Service, Reparatur oder Korrektur sämtlich
bei Ihnen.
(b) In keinem Fall, außer wenn dies durch geltendes Recht gefordert wird oder schriftlich zugesichert
wurde, ist irgendein Copyright-Inhaber oder irgendein Dritter, der die Anwendung wie oben erlaubt
verbreitet hat, Ihnen gegenüber für irgendwelche Schäden haftbar. Dies gilt auch für jegliche allgemeine
oder spezielle Schäden, für Schäden durch Nebenwirkungen oder Folgeschäden, die sich aus der
Benutzung oder der Unbenutzbarkeit der Software ergeben (das gilt insbesondere – ohne darauf beschränkt
zu sein – für Datenverluste, das Hineinbringen von Ungenauigkeiten in irgendwelche Daten, für Verluste,
die Sie oder Dritte erlitten haben, oder für ein Unvermögen der Software, mit irgendeiner anderen
Software zusammenzuarbeiten), und zwar auch dann, wenn ein Copyright-Inhaber oder ein Dritter über
die Möglichkeit solcher Schäden informiert worden ist.
Stand 17.05.2009
153
Kapitel 14. Systemanforderungen
Tabelle 14.1. Systemanforderungen des ImmoTools
Art
Minimum
Empfohlen
Betriebssystem
Windows 7/Vista/XP/2003/2000, Linux, MacOS X (ab 10.4),
FreeBSD (?), Solaris (?)
Java
Oracle Java 6
Oracle Java 7 / OpenJDK 7
Prozessor
800 MHZ
1,5 GHZ
freier Arbeitsspeicher
256 MB
512 MB
freier Festplattenspeicher
50 MB
>=1 GB (abhängig vom
Datenbestand)
Internetzugang
nein
ja
Tabelle 14.2. Systemanforderungen des ImmoTool-Servers
Art
Minimum
Empfohlen
Betriebssystem
Windows 7/Vista/XP/2003/2000, Linux, MacOS X (ab 10.4),
FreeBSD (?), Solaris (?)
Java
Oracle Java 6
Oracle Java 7 / OpenJDK 7
Prozessor
800 MHZ
2 GHZ
freier Arbeitsspeicher
256 MB
1024 MB
freier Festplattenspeicher
100 MB
>=1 GB (abhängig vom
Datenbestand)
Internetzugang
nein
bei Bedarf
Anmerkung
Die Betriebssysteme FreeBSD & Solaris konnten bis dato nicht getestet werden.
Grundsätzlich sollten die Programme aber auch hier funktionieren.
154
Glossar
Fachbegriffe
In diesem Abschnitt werden die im Handbuch verwendeten Fachbegriffe zusammengefasst und kurz erläutert.
Atom (Atom-Feed)
ist ein verbreitetes Format für den Austausch von Nachrichten. Viele Webseiten
stellen ihre Nachrichten als Atom-Feed bereit. Weitere Informationen finden Sie
bei wikipedia.org [http://de.wikipedia.org/wiki/Atom_%28Format%29].
Siehe auch RSS.
Einzelplatz-Projekt
steht exklusiv dem Anwender zur Verfügung, der das Einzelplatz-Projekt im
ImmoTool geöffnet hat. Ein gemeinsamer Zugriff durch andere ImmoToolAnwender ist nicht möglich.
Die Datenbank eines Einzelplatz-Projektes wird direkt im Projektverzeichnis
gespeichert. Ein ImmoTool-Server muss für ein Einzelplatz-Projekt deshalb nicht
installiert werden.
Siehe auch Projekt, Mehrplatz-Projekt.
Hostname (Hostadresse, Host)
ist ein eindeutiger Name für einen Rechner im Netzwerk. Beim Aufruf eines
Hostnamens wird dieser zu einer IP-Adresse übersetzt / aufgelöst. Der Hostname
„openestate.org“ entspricht z.B. der IP-Adresse „188.40.136.84“.
Die Verwendung von Hostnamen hat den Vorteil, dass man diese sich leichter
merken kann als eine IP-Adresse. Ebenso kann ein Administrator bei Verwendung
von Hostnamen die IP-Adresse jederzeit ändern, ohne dass die Teilnehmer im
Netzwerk davon gestört werden.
Weitere Informationen finden Sie bei wikipedia.org [http://de.wikipedia.org/wiki/
Hostname].
Siehe auch IP-Adresse.
HSQLDB (HSQL)
ist eine in Java geschriebene Datenbank. Das ImmoTool verwendet diese
Software zur Speicherung der Projektdaten. Weitere Informationen finden Sie bei
hsqldb.org [http://hsqldb.org/].
Siehe auch ImmoTool-Server, Java.
ImmoTool-Server
ist eine Anwendung, die eine HSQL-Datenbank im Netzwerk zur Verfügung
stellt. Dies ermöglicht den Zugriff mehrerer ImmoTool-Anwender auf einen
gemeinsamen Datenbestand (Mehrplatz-Projekt).
Siehe auch Mehrplatz-Projekt, HSQLDB.
ImmoXML
ist ein Format für den Austausch von Immobiliendaten. Die Spezifikation basiert
auf Version 1.1 von OpenImmo-XML. Weitere Informationen finden Sie bei
immoxml.de [http://immoxml.de/].
Siehe auch OpenImmo-XML.
IP-Adresse (IP)
wird zur Identifikation eines einzelnen Computers im Netzwerk / Internet
verwendet. Weitere Informationen finden Sie bei wikipedia.org [http://
de.wikipedia.org/wiki/IP-Adresse].
155
Glossar
IP-Adresse unter Windows ermitteln
Abbildung 147. IP-Adresse unter Windows ermitteln
(Schritt 1)
Klicken Sie auf Start → Einstellungen → Netzwerkverbindungen.
Abbildung 148. IP-Adresse unter Windows ermitteln
(Schritt 2)
Wählen Sie in der Übersicht die verwendete LAN-Verbindung mit
Doppelklick aus.
156
Glossar
Abbildung 149. IP-Adresse unter Windows ermitteln
(Schritt 3)
Im Reiter Netzwerkunterstützung wird die IP-Adresse der
Netzwerkkarte dargestellt.
IP-Adresse unter Mac/Linux/Unix ermitteln
Abbildung 150. IP-Adresse unter Mac/Linux/Unix
ermitteln
Öffnen Sie eine Kommandozeile und geben Sie den Befehl ifconfig
ein. Darauf werden Informationen zu den installierten NetzwerkSchnittstellen (inkl. der IP-Adressen) dargestellt. In der Regel ist die
verwendete Netzwerkkarte mit eth0 benannt.
Siehe auch Hostname.
IS24-CSV
ist ein Format für den Austausch von Immobiliendaten. Das Format ist veraltet /
obsolet und wird von ImmobilienScout24 nicht mehr gepflegt.
Siehe auch IS24-XML.
IS24-XML
ist ein Format für den Austausch von Immobiliendaten. Das Format
wird hauptsächlich zum Datenaustausch mit ImmobilienScout24 benötigt.
Weitere Informationen finden Sie bei immobilienscout24.de [http://
www.immobilienscout24.de/immobilientransfer/].
Java
ist die Programmiersprache, welche zu Erstellung des ImmoTools verwendet
wurde. Um ein Java-Programm ausführen zu können, muss eine Java-
157
Glossar
Laufzeitumgebung installiert werden. Weitere Informationen finden Sie bei
java.com [http://java.com/].
Siehe auch Java-Laufzeitumgebung, OpenJDK, Oracle Java.
Java-Laufzeitumgebung (JRE)
ist eine Sammlung verschiedener Programme & Bibliotheken, um Anwendungen
ausführen zu können, die in Java programmiert wurden.
Siehe auch Java, OpenJDK, Oracle Java.
Kommandozeile
(Konsole,
Terminal,
Shell,
Eingabeaufforderung)
ist ein Eingabebereich für die Steuerung des Betriebssystems. Weitere
Informationen finden Sie bei wikipedia.org [http://de.wikipedia.org/wiki/
Kommandozeile].
Kommandozeile unter Windows starten
Abbildung 151. Kommandozeile unter Windows
starten (Schritt 1)
Klicken Sie auf Start → Ausführen....
Abbildung 152. Kommandozeile unter Windows
starten (Schritt 2)
Tragen Sie den Befehl cmd ein und klicken Sie auf OK.
158
Glossar
Abbildung 153. Kommandozeile unter Windows
starten (Schritt 3)
Die geöffnete Kommandozeile.
Kommandozeile unter Mac OS X starten
Abbildung 154. Kommandozeile unter Mac OS X
starten (Schritt 1)
Aus dem Finder (Bereich Dienstprogramme) heraus kann das
Programm Terminal gestartet werden.
Abbildung 155. Kommandozeile unter Mac OS X
starten (Schritt 2)
Eine in Mac OS X geöffnete Kommandozeile.
Mehrplatz-Projekt
wird von einem ImmoTool-Server zur Verfügung gestellt, damit mehrere
ImmoTool-Anwender innerhalb des Netzwerkes gemeinsam auf dem gleichen
Datenbestand arbeiten können. Jeder ImmoTool-Anwender kann eigene
Zugriffsrechte in einem Mehrplatz-Projektes besitzen.
159
Glossar
Um auf ein Mehrplatz-Projekt zugreifen zu können, muss ein ImmoTool-Server
in Betrieb genommen werden.
Siehe auch Projekt, Einzelplatz-Projekt, ImmoTool-Server.
OpenEstate-XML
ist das vom ImmoTool verwendete Format um Immobiliendaten zu erfassen.
Weitere Informationen finden Sie bei openestate.org [http://openestate.org/].
OpenImmo-XML (OpenImmo)
ist ein vebreitetes Format für den Austausch von Immobiliendaten. Weitere
Informationen finden Sie bei openimmo.de [http://openimmo.de/].
OpenJDK
ist eine Java-Laufzeitumgebung unter einer „Open Source Lizenz“ auf
deren Grundlage Oracle Java erstellt wird. Diese Variante von Java ist
besonders verbreitet unter Linux und wird von den meisten Distributionen
als Installationspaket bereitgestellt. Weitere Informationen finden Sie bei
openjdk.java.net [http://openjdk.java.net].
Siehe auch Java, Java-Laufzeitumgebung, Oracle Java.
Oracle Java (Oracle JRE, Sun
Java, Sun JRE)
ist eine Java-Laufzeitumgebung, die ursprünglich von Sun Microsystems [http://
de.wikipedia.org/wiki/Sun_Microsystems] entwickelt wurde und mittlerweile von
Oracle [http://www.oracle.com/de/] betreut wird. Die Installationspakete von
Oracle Java können bei java.com [http://www.java.com/de/download/manual.jsp]
heruntergeladen werden.
Siehe auch Java, Java-Laufzeitumgebung, OpenJDK.
PDF-Dokument (PDF)
ist ein verbreitetes Format zur Speicherung und Weitergabe von Dokumenten. Das
ImmoTool kann an verschiedenen Stellen Dateien in diesem Format erzeugen.
Weitere Informationen finden Sie bei wikipedia.org [http://de.wikipedia.org/wiki/
Portable_Document_Format].
PDF-Reader (Acrobat Reader)
ist ein Programm um PDF-Dokumente auf einem Computer betrachten oder
ausdrucken zu können. Eine Übersicht von verschiedenen frei verfügbaren PDFReadern finden Sie bei pdfreaders.org [http://pdfreaders.org/].
Projekt
enthält die Datenbank mit den im ImmoTool erfassten Daten (Firmendaten,
Immobilien, Adressen, etc.). Mit dem ImmoTool können bei Bedarf mehrere
Projekte getrennt voneinander verwaltet werden.
Siehe auch Einzelplatz-Projekt, Mehrplatz-Projekt.
RSS (RSS-Feed)
ist ein verbreitetes Format für den Austausch von Nachrichten. Viele Webseiten
stellen ihre Nachrichten als RSS-Feed bereit. Weitere Informationen finden Sie
bei wikipedia.org [http://de.wikipedia.org/wiki/RSS].
Siehe auch Atom.
SSL
(TLS,
Verschlüsselung)
SSL-
ist eine weit vebreitete Form der Verschlüsselung und wird vom ImmoTool an
verschiedenen Stellen unterstützt:
• Die Kommunikation zwischen ImmoTool & ImmoTool-Server kann bei Bedarf
mit Hilfe von SSL verschlüsselt werden (siehe dieser Handbuch-Abschnitt).
• Der Zugriff auf Internet-Adressen kann bei Bedarf über SSL-Verschlüsselung
erfolgen - zumindest wenn der jeweilige Webseiten-Betreiber auch einen
Zugriff über Adressen mit „https://“ gestattet.
• Der Zugriff auf E-Mailkonten sowie der Versand von E-Mails kann bei
Bedarf über SSL-Verschlüsselung erfolgen - zumindest wenn der jeweilige E-
160
Glossar
Mailanbieter dies unterstützt. Die Aktivierung der Verschlüsselung erfolgt in
der Verwaltung der E-Mailkonten.
Weitere Informationen finden Sie bei Wikipedia [http://de.wikipedia.org/wiki/
Transport_Layer_Security].
Siehe auch SSL-Schlüssel, SSL-Zertifikat, Verschlüsselung.
SSL-Schlüssel
Schlüsselpaar)
(SSL-
wird bei einer SSL-Verschlüsselung benötigt, um versendete Daten zu
verschlüsseln und empfangene Daten zu entschlüsseln.
Bei SSL handelt es sich um eine asymmetrische Verschlüsselung [http://
de.wikipedia.org/wiki/Asymmetrisches_Kryptosystem]. Genau genommen
werden dabei zwei Schlüssel erzeugt (privater und öffentlicher Schlüssel),
weshalb oft auch von einem „Schlüsselpaar“ die Rede ist.
Siehe auch SSL, Verschlüsselung.
SSL-Zertifikat
TAR.GZ-Archiv
Datei, TAR.GZ)
wird bei einer SSL-Verschlüsselung verwendet, um die Authentizität und Integrität
der beiden Kommunikationspartner sicherzustellen. Weitere Informationen finden
Sie bei Wikipedia [http://de.wikipedia.org/wiki/Digitales_Zertifikat].
Siehe auch SSL, Verschlüsselung.
(TAR.GZ-
ist ein Format zur Komprimierung von Dateien. Mehrere Dateien werden dabei
zu einer platzsparenden TAR.GZ-Datei zusammengefasst. Das Format wird
hauptsächlich unter Mac, Linux & Unix verwendet. Weitere Informationen finden
Sie bei wikipedia.org [http://de.wikipedia.org/wiki/Tar].
TAR.GZ unter Windows entpacken
Windows kann TAR.GZ-Dateien nicht direkt entpacken. Hier
sind externe Programme nötig, wie z.B.: 7-Zip [http://www.7zip.de/], WinZIP [http://www.winzip.de/] oder WinRAR [http://
www.winrar.de/].
TAR.GZ unter Mac OS X entpacken
Nachdem ein TAR-GZ-Archiv heruntergeladen wurden, entpackt
Mac OS X dies in der Regel automatisch.
Um eine TAR.GZ-Datei zu entpacken, klicken Sie im Finder mit
der rechten Maustaste auf die Datei und wählen Sie Öffnen mit →
Archivprogramm / BOMArchiveHelper.
Abbildung 156. TAR.GZ-Archiv unter Mac OS X
entpacken
Hilfsprogramm zum Entpacken einer TAR.GZ-Datei starten.
161
Glossar
Alternativ kann auf externe Programme wie The Unarchiver [http://
wakaba.c3.cx/s/apps/unarchiver.html] zurückgegriffen werden.
TAR.GZ unter Linux/Unix entpacken
Die grafischen Oberflächen (KDE, Gnome, etc.) stellen in der
Regel Programme zum Entpacken von TAR.GZ-Dateien bereit.
Meist können die Dateien über das Kontextmenü (rechte Maustaste)
entpackt werden. Alternativ kann ein TAR.GZ-Archiv (z.B.
OpenEstate-ImmoTool-1.0.tar.gz) über die Kommandozeile mit
folgendem Befehl entpackt werden:
tar xfvz OpenEstate-ImmoTool-1.0.tar.gz
Anmerkung
Ältere Version des TAR-Programmes unterstützen aus historischen
Gründen keine Pfadnamen mit mehr als 100 Zeichen. Die
im OpenEstate-Projekt bereitgestellten TAR.GZ-Archive können
dieses Limit jedoch überschreiten. Neuere Versionen des TARProgrammes (z.B. GNU Tar [http://www.gnu.org/software/tar/])
sind nicht von dem Problem betroffen.
Siehe auch ZIP-Archiv.
Teilabgleich
ist ein Exportmodus für Immobiliendaten bei dem nur die zwischenzeitig
geänderten Immobilien exportiert werden. Für zwischenzeitig gelöschte
Immobilien wird ein expliziter Löschauftrag exportiert.
Bei Exporten im Teilabgleich besteht der Vorteil, dass weniger Daten zum
Empfänger gesendet werden müssen. In der Regel sind Exporte im Teilabgleich
deshalb schneller als beim Vollabgleich.
Siehe auch Vollabgleich.
Verschlüsselung
wird bei der Übertragung von Daten zwischen mehreren Computern verwendet
um sicherzustellen,
a. dass die übertragenen Informationen von einem Außenstehenden
nicht mitgelesen oder manipuliert werden können (Integrität [http://
de.wikipedia.org/wiki/Integrit%C3%A4t_%28Informationssicherheit%29]).
b. dass die richtigen Computer miteinander kommunizieren (Schutz vor
Man-in-the-middle-Angriff [http://de.wikipedia.org/wiki/Man-in-the-middleAngriff]).
Das ImmoTool unterstützt die weit verbreitete SSL-Verschlüsselung.
Siehe auch SSL.
Vollabgleich
ist ein Exportmodus für Immobiliendaten bei dem alle aktuell veröffentlichten
Immobilien exportiert werden. Der Empfänger löscht dabei alle Immobiliendaten,
die nicht in der Exportdatei vorhanden sind.
Bei Exporten im Vollabgleich besteht der Vorteil, dass bei jedem Exportvorgang
alle Daten mit dem Empfänger synchronisiert werden. Das Risiko von
162
Glossar
Synchronisationsproblemen zwischen Absender und Empfänger ist bei Exporten
im Vollabgleich geringer, da grundsätzlich alle Daten übermittelt werden.
Siehe auch Teilabgleich.
Web-Browser
Browser, Browser)
(Internet-
ZIP-Archiv (ZIP-Datei, ZIP)
ist ein Programm zur Darstellung von Internetseiten. Auf den meisten
Betriebssystemen sollte bereits ein Web-Browser installiert sein. Verbreitete
Web-Browser sind Mozilla Firefox [http://www.mozilla.com/firefox], Opera
[http://www.opera.com/], Safari [http://www.apple.com/de/safari/], Google
Chrome [http://www.google.com/chrome/] & Internet Explorer [http://
www.microsoft.com/germany/windows/internet-explorer/].
ist ein Format zur Komprimierung von Dateien. Mehrere Dateien werden dabei
zu einer platzsparenden ZIP-Datei zusammengefasst. Das Format wird unter
Windows-Betriebssystemen verwendet. Weitere Informationen finden Sie bei
wikipedia.org [http://de.wikipedia.org/wiki/ZIP_%28Dateiformat%29].
ZIP unter Windows entpacken
Neuere Windows-Versionen liefern bereits Funktionen zum
Entpacken von ZIP-Dateien mit. Alternativ kann auf Programme wie
7-Zip [http://www.7-zip.de/], WinZIP [http://www.winzip.de/] oder
WinRAR [http://www.winrar.de/] zurückgegriffen werden.
ZIP unter Mac OS X entpacken
Nachdem ein ZIP-Archiv heruntergeladen wurden, entpackt Mac OS
X dies in der Regel automatisch.
Um eine ZIP-Datei von Hand zu entpacken, klicken Sie im Finder
mit der rechten Maustaste auf die ZIP-Datei und wählen Sie Öffnen
mit → Archivprogramm / BOMArchiveHelper.
Abbildung 157. ZIP-Archiv unter Mac OS X
entpacken
Hilfsprogramm zum Entpacken einer ZIP-Datei starten.
Alternativ kann auf externe Programme wie The Unarchiver [http://
wakaba.c3.cx/s/apps/unarchiver.html] zurückgegriffen werden.
ZIP unter Linux/Unix entpacken
Die grafischen Oberflächen (KDE, Gnome, etc.) stellen in der
Regel Programme zum Entpacken von ZIP-Dateien bereit. Meist
können die Dateien über das Kontextmenü (rechte Maustaste)
entpackt werden. Alternativ kann ein ZIP-Archiv (z.B. OpenEstateImmoTool-1.0.zip) über die Kommandozeile mit folgendem Befehl
entpackt werden:
163
Glossar
unzip OpenEstate-ImmoTool-1.0.zip
Siehe auch TAR.GZ-Archiv.
164