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