Inhalt
Was brauche ich dazu?
Register Einstellungen
Über das Register Einstellungen werden für die Ersteinrichtung alle serverrelevanten Parameter eingetragen. Die zur Schnittstelle erhaltenen Serverparameter werden in den entsprechenden Feldern der Server-Einstellungen hinterlegt. Diese Einrichtung muss einmalig vorgenommen werden.
Die Konfigurationen und Einstellungen werden für Produktivsystem und Testsystem separat vorgenommen. Im Feld Konfiguration und Einstellungen wählen Sie aus, ob die nachfolgenden Parameter für das Produktivsystem oder das Testsystem gelten.
Die nachfolgenden Parameter sind i. d. R. auch in der Parametermaske erläutert.
| Server-Einstellungen | |
Konfiguration und Einstellungen | Auswahl, Produktivsystem oder Testsystem. Die nachfolgenden Einstellungen gelten daher für das hier ausgewählte System. |
Link Datensynchronisation | Serveradresse zur Anbindung an das Mieterportal casavi. Die URL lautet i. d. R. https://api.mycasavi.com. |
Passwort / Secret (Synchronisation) (zwei Felder) | Passwort / Secret für die Datensynchronisation Das Passwort/Secret muss zur Kontrolle der korrekten Eingabe im zweiten Feld wiederholt eingegeben werden. Die Darstellung erfolgt aus Sicherheitsgründen verdeckt. |
Schlüssel / API-Key (Synchronisation) (zwei Felder) | Schlüssel /API-Key für die Datensynchronisation. Der Schlüssel / API-Key muss zur Kontrolle der korrekten Eingabe im zweiten Feld wiederholt eingegeben werden. Die Darstellung erfolgt aus Sicherheitsgründen verdeckt. |
| Allgemeine Datenkonfiguration | |
Objektbereich | Auswahl, Liste der Objekte, die mit casavi synchronisiert werden sollen. Übertragen werden von Meldungen nur offene seit Beginn des letzten Kalenderjahres. |
Objektbereich - Vollständige Meldungshistorie | Auswahl, Liste der Objekte, die mit casavi synchronisiert werden sollen, wobei die komplette Meldungshistorie berücksichtigt werden soll. Diese Spezialeinstellung wird i. d. R. durch Consulting der CREM SOLUTIONS konfiguriert. |
Personentyp | Auswahl der Personentypen, die mit casavi synchronisiert werden sollen. Nicht gewählte Personentypen, z. B. Interessenten, werden nicht synchronisiert. |
Dokumententyp | Auswahl, der Dokumententypen, deren Anzeige einem Zeitfilter unterliegt. Es werden i. d. R. nur die Dokumente seit Beginn des letzten Kalenderjahres synchronisiert. |
Dokumententypen ohne Zeitfilter | Auswahl, diese Dokumententypen unterliegen jedoch keinem Zeitfilter. |
Benutzerteam | Komfortpaket vorausgesetzt, kann hier eine Zuordnung von Teams konfiguriert werden. Hierüber kann der verantwortliche Benutzer pro Objekt in iX-Haus plus ermittelt werden. |
DocuWare-Filter | Filter, die vom Consultant der CREM SOLUTIONS eingerichtet werden, um spezielle Amnbindung mit DMS-System DocuWare zu konfigurieren. Alternativ muss ein Dokument Empfängertyp (P=Person, K=Kreditor), Objektnummer, EmpfängerHeaderID als Merkmale aufweisen (insbesodere bei externen Dokumenten ist dies relevant). |
Mieterportalaccount … Tage | Zahl, Anzahl der Tage vor Vertragsbeginn, wo das Portal dem Mieter schon zugänglich sein soll. |
| Sonstiges | |
iX-Haus Benutzer | dreistellige Benutzernummer, dieser Benutzer wird in iX-Haus plus bei Meldungen eingetragen, die über das casavi-Mieterportal in iX-Haus plus Meldungen eingetragen werden. Dieser Benutzer muss entsprechende Rechte für iX-Haus plus aufweisen. |
Register Protokoll
Das Register Protokoll ermöglicht die Übersicht über den Datenstrom der casavi-Schnittstelle. Die Protokolle werden nach Datum gefiltert angezeigt. Unabhängig vom Datumsfilter werden für die letzte protokollierte Abfrage Datum, Uhrzeit, Anzahl der gesendete Daten und Anzahl Fehler benannt.
Mit der Schaltfläche Protokolleinträge aktualisieren werden Protokolleinträge erneut eingelesen, um Protokolldaten anzeigen zu können, welche seit Aufruf des Protokollregisters neu hinzugekommen sind.
Übertragene Daten
Personendaten
Für die für casavi freigegebenen Objekte werden die Daten aller aktiven Personen – Personen mit einem gültigen Vertrag - an casavi gesendet. Die Daten der über die Personentypen nicht freigeschalteten Personen werden mit dem Kenner PortalUser=False an casavi übertragen, damit diese gegebenenfalls auch aus casavi entfernt werden können. Nach dem Auszug eines Mieters wird dieser nach Ablauf der in der Konfiguration vorgegebenen Frist an casavi als gelöscht gemeldet, damit dieser ebenfalls entfernt werden kann. Sollten die Mieterdaten davor in iX-Haus anonymisiert worden sein, wird dies ebenfalls mit dem Serviceportal synchronisiert.
Partnerverwaltung
Wenn die Personen in der Partnerverwaltung angelegt/übertragen wurde, werden diese entsprechend übertragen. In diesem Fall werden auch die in der Partnerverwaltung eingegebenen Mitbewohner und Vertragspartner an casavi übertragen.
Es werden die folgenden Daten je Person übertragen:
- Vorname
- Nachname
- Anrede
- E-Mail
- Telefonnummer
- Bankverbindung
Kontostände werden momentan auf casavi Seite nicht gespeichert und werden zukünftig nicht mehr übertragen. Buchungen der letzten 12 Monate werden momentan auf casavi Seite nicht gespeichert und werden zukünftig nicht mehr übertragen.
Dokumente
Die laut der casavi-Konfiguration freigegebenen Dokumente werden an casavi übertragen. Die nicht freigegebenen Dokumente der freigegebenen Objekte werden als gelöscht an casavi gemeldet. Dabei wird der Inhalt des Dokumentes nicht übertragen.
- Dokumentname
- Dokumenttyp oder Dokumentenklasse falls eingerichtet
- Erstellungsdatum
- Inhalt des Dokumentes (nur wenn Dokument freigegeben)
Objekteigentümer
Werden nur dann übertragen, wenn Lizenz Objekteigentümer aktiviert ist.
- Vorname
- Nachname
- E-Mail
- Telefonnummer
- Adresse
- Bankverbindung
Hausmeister
Werden nur dann übertragen, wenn Lizenz Hausmeister aktiviert ist.
- Vorname
- Name
- Anrede
- E-Mail
- Telefonnummer
- Adresse
- Bankverbindung
Benutzerdaten
- Vorname
- Nachname
- E-Mail
- Telefonnummer
Objekte
Es werden nur die freigegebenen Objekte übertragen.
- Objektnummer
- Objektname
- Objektgruppe
- Verwaltungsbeginn
- Objektadresse
- Objektrechte der Benutzer
- Objektverantwortliche
Flächen
- Flächennummer
- Bezeichnung
- Adresse
- Flächenbeginn
- Flächenende
- Beginn des aktuellen Vertrags
- Ende des aktuellen Vertrags
Verträge
- Objektnummer
- Personennummer
- Aktuelle Miete
- Kautionshöhe
- Vertragsbeginn
- Vertragsende
Teams
- Name des Teams
- Zugehörige Benutzer
Meldungen
Beim ersten Export der Daten werden alle offenen (nicht abgeschlossen oder storniert) Meldungen der freigegebenen Objekte mit dem Serviceportal synchronisiert. Sollten nur bestimmte Benutzerteams freigeschaltet sein, so werden nur die Meldungen dieser Teams oder diejenigen ohne Teamzuordnung mit casavi synchronisiert.
- Nummer
- Meldungsart
- Betreff
- Beschreibung
- Hinweis 1
- Hinweis 2
- Melder
- Gewerk
- Meldungsdatum
- Objekt
- Fläche
- Technisches Objekt
- Verantwortlicher
- Verantwortliches Team
- Meldungsdatum
- Erledigen ab
- Erledigen bis
Meldungsarten
- Bezeichnung
Je nach Meldungsart werden synchronisierte Meldungen aus iX-Haus plus in casavi zugeordnet.
Serviceportal-Sperre: keine Synchronisation
Hausmitteilung (Pinnwand): Übertragung ohne Status für die casavi-Pinnwand. Ist der Vorgang in iX-Haus plus abgeschlossen, wird der Eintrag auf der casavi-Pinnwand wieder entfernt.
Serviceportal - Objektmeldung: Meldungen werden in der Regel für Mieter individuell übertragen, eine Objektmeldung geht hingegen an alle im Objekt! Ein Mieter/Eigentümer kann selbst in casavi keine Objektmeldung generieren.
Nicht registrierte Kontakte per E-Mail benachrichtigen: Wenn der Kontakt in iX-Haus plus E-Mail-Daten aufweist, kann er per E-Mail benachrichtigt werden, während der Portalbenutzer via casavi Info bekommt.
Bei Beauftragung Notiz für Serviceportal erzeugen: Eine platzhalterunterstützte Notiz kann bei Beauftragung auf Basis einer Meldung automatisch generiert werden. Der casavi-Anwender kann somit eine Rückmeldung über eine Beauftragung/den Fortschritt bzgl. seiner Meldung bekommen.
Meldungsstatus
- Nummer
- Bezeichnung
- Typ
Meldungsprioritäten
- Nummer
- Bezeichnung
- Typ
Meldungsnotizen
- Erfasser
- Erfassungszeitpunkt
- Inhalt
Interne Notizen aus iX-Haus plus werden nicht nach casavi übertragen. Interne Notizen aus casavi werden nicht nach iX-Haus plus übertragen. Die beiden Notiztypen stellen generell unterschiedliche programmspezifische Datenblöcke dar und werden untereinander nicht sysnchronisiert.
Meldungsdokumente
- Dokumentname
- Dokumenttyp oder Dokumentenklasse falls eingerichtet
- Erstellungsdatum
- Inhalt des Dokumentes (nur wenn das Dokument freigegeben ist)
Technische Informationen
Die nachfolgenden technischen Informationen sind für den normalen Benutzer i. d. R. nicht relevant, helfen aber beim Verständnis, wie mit bestimmten Datenkonstellationen verfahren wird.
Die iX-Haus – casavi Schnittstelle synchronisiert die für casavi-relevanten iX-Haus Daten mit dem casavi-Portal. Diese Synchronisation wird in regelmäßigen Abständen i. d. R. zwischen 1 und 5 Minuten aus iX-Haus (über einen Windows geplanten Task oder den iX-Haus Scheduler) aufgerufen und ruft die notwendigen casavi web services (API) auf. Die Daten werden in XML-Format geliefert und empfangen.
Nach einem einmaligen Vollexport (Übertragung aller Daten) liefert die Schnittstelle i. d .R. nur die Daten, die sich nach dem letzten Lauf verändert haben oder gelöscht wurden. Daten werden in casavi gelöscht, wenn seitens iX-Haus Objektende, Vertragsende, Anonymisierung oder Rekonfiguration der Personentypenfreischaltung vorliegt.