=====casavi=====
Interne Informationen zur erweiterten technischen Möglichkeiten zur Analyse der Funktionsweise der [[schnittstellen:serviceportalschnittstelle_casavi:start|Mieterportalschnittstelle casavi]].
====Allgemein====
++++|
Stammdaten-führendes System ist immer iX-Haus. Es muss nichts im casavi Portal für die Schnittstelle konfiguriert werden. Besonderes Augenmerk liegt hier auf die Konfiguration der ''Meldungsarten'', bei casavi ''Vorgangstyp'' genannt. Diese werden immer in iX-Haus plus konfiguriert und für das Serviceportal freigegeben. Man erkennt diese Vorgangstypen, welche aus iX-Haus stammen, im casavi Portal an dem Schloss-Symbol vor dem Namen. <wrap important>Diese dürfen unter keinen Umständen im Portal angepasst werden. Sollte der Kunde also bestätigen, dass der Vorgangstyp in casavi angelegt oder geändert wurde, ist keine Meldungsübertragung für diese Meldungsart/Vorgangstyp möglich.</wrap>

Eine [[schnittstellen:serviceportalschnittstelle_casavi:start#technische_informationen|technische Beschreibung]] findet sich nach Anmeldung in iX-Wiki in der casavi-Doku - sie ist für nicht angemeldete iX-Wiki-User ausgeblendet, da nicht unbedingt für jeden Endanwender geeignet.
++++

==== Häufige Probleme / Fragestellungen vom Kunden ====
++++|
===Es werden keine Meldungen aus oder an casavi übertragen ===
Fehleranalyse via iX-Haus-Menu ''Dienstprogramme –> Schnittstellen -> Serviceportalschnittstelle (casavi)'' –> Register ''Protokoll''

  -Prüfen, wann die letzte Synchronisation gelaufen ist. Ist die letzte Synchronisation < als aktuelles Datum steht der Synchronisationstask. Dies bitte im Windows Taskplaner prüfen (''casavi – Datasync'' heißt die Aufgabe) oder bei eingerichteten Scheduler die Scheduler-Logs prüfen. Läuft der Scheduler-Dienst ''iX-Haus Scheduler Watchdog'' auf dem Server? 
  -Prüfen, ob Startzeit und Endzeit angezeigt werden. Sollte keine Endzeit angezeigt werden, muss das Fehlerlog ausgewertet werden. Meist fehlt die „Fertigmeldung“ eines Synchronisations Task seitens casavi. iX-Haus versucht dann immer wieder die Daten neu zu übertragen, bis die „Fertigmeldung“ kommt. Thema ist dann bei casavi zu platzieren. 

===Neue Objekte / Personen / Dokumente werden nicht an casavi übertragen===
Fehleranalyse via iX-Haus-Menu ''Dienstprogramme –> Schnittstellen -> Serviceportalschnittstelle (casavi)'' – Register ''Einstellungen''
{{ :playground:casvai_register_einstellungen.png?400 |}}
  * Bei Problemen mit Objekten prüfen, ob alle gewünschten Objekte freigegeben sind. {{ :playground:casavi_objektfreigabe.png?direct&200|}}
  * Bei Problemen mit Personen prüfen, ob alle gewünschten Personentypen freigegeben sind. {{ :playground:casavi_auswahl_personentyp.png?direct&200|}}
  * Bei Problemen mit Dokumenten prüfen, ob alle gewünschten Dokumententypen freigegeben sind. {{ :playground:casavi_dokumenttypfreigabe.png?direct&200|}}

Hier bitte besonders auf das Dokumentendatum achten. Es werden standardmäßig nur Dokumente aus dem vorherigen und aktuellen Geschäftsjahr übertragen. Um Dokumente ohne Zeitraumbeschränkung zu übertragen, muss der Dokumenttyp im Menu ''Dokumententypen ohne Zeitfilter'' freigegeben sein.
 
===Teilweise werden Meldungen nicht übertragen===
Kunden fragen wie die Meldungsart heißt und prüfen, ob diese in iX-Haus plus ''Meldungen – Katalog'' für das Serviceportal freigegeben ist:
{{ :playground:casavi_meldungsartzuordnung.png?200 |}}
Sollte die Meldungsart in iX-Haus nicht vorhanden sein, wird der Kunde diese höchstwahrscheinlich im casavi Portal als Vorgangstyp manuell angelegt haben. Diese kann dann nicht zu iX-Haus übertragen werden.
++++

===== Fehleranalyse =====
++++|
=== Protokoll der Synchronisationsläufe ===
erste Checks:
  * Läuft der geplante Task oder nicht? 
  * Gibt es bereits hier aussagekräftige Fehlermeldungen?
  * Werden erforderliche Dokumente nach PDf gewandelt und in DW bereitgestellt? 
  * Haben diese den Status 'In DMS' und weisen eine DocID auf? 
  * Ist verwendeter Dokumenttyp freigegeben für casavi-Übermittlung?
{{ :playground:casavi_mp_protokoll_synchronisationslaeufe.png?400 |}}
 
===Zuständigkeit casavi===
Folgende Meldungen liegen zu mit ziemlich großer Wahrscheinlichkeit unter der Zuständigkeit von casavi:
  * Mieterportalmeldungen senden
  * Meldungen an das Serviceportal senden
  * Stammdaten an das Serviceportal senden
  * Serviceportalmeldungen abholen:
{{ :playground:casavi_mp_protokoll_fehler_in_protokoll_senden_empfangen_.png?400 |}} 

===Ausführliches Log===
Standort der Log-Datei: ''tmp\Log\mplog.log''
{{ :playground:casavi_mplog.png?200 |}}
Die Testoptionen werden ebenfalls unter tmp\Log konfiguriert. Details zu MP-Log siehe Kapitel [[playground:ixhaus_knowledge_intern#loggings_in_ix-haus|Logging]].
Um die entsprechende Option einzuschalten, legt folgende Dateien unter tmp\Log an:
  * @mpSave -> gesendete und empfangene XML-Daten unter tmp\Log abzulegen	
  * @EMailMask -> Mailadressen (z.B. der Mieter) zusätzlich mit dem String casavi-crem-test-crem maskieren, um die Kommunikation zu den Mietern zusätzlich abzusichern
  * @noDwSync -> DocuWare Synchronisation abschalten
  * @noSendDwFiles -> DocuWare Synchronisation wird normal durchgeführt, es werden jedoch keine Dateien gesendet
  * @DwSyncImmer -> Es wird jede Minute nach Änderungen in DocuWare
  * @mpsaveOkResults -> OK-Response von casavi unter tmp\Log speichern
  * @dwTmplog -> extra DocuWare Sync Log
  * @LogEx -> erweitertes Log einschalten
++++
=====Dateimanagement=====
++++|
===XML-Dateien===
Neben den Logfiles liefern die xml-Dateien Informationen zu Störungen oder den Programmablauf im Allgemeinen.
  * Meldungen_from_Mieterportal-Zeitstempel.xml
  * Mieterportal_Meldungen-Zeitstempel.xml
  * Mieterportal_Stammdaten-Zeitstempel.xml

===Meldungsmultimedia-Dateien===
Diese Dateien liegen unter: ''data\mieterportal\''.

===DocuWare=== 
Bitte Folgendes beachten:
  * Dokumententypen müssen freigegeben werden.
  * Dokumententypen ‚Externer DMS Dokumententyp‘ werden automatisch in den Katalog eingetragen, müssen aber auch freigegeben werden.
  * Feld ''Dokumentname'' soll zugeordnet und in DocuWare mit dem Namen des Dokumentes gefüllt werden, ansonsten wird der Dateiname der Datei in casavi angezeigt – teilweise unschön.
++++

===== FAQ =====
++++|
===Wie werden mehrfache Adressangaben berücksichtigt=== 
Zu unterscheiden ist zwischen iX-Haus-Adresse Name 1 und Name 2 (ohne Partnerverwaltung) oder iX-Haus Adressdaten aus der Partnerverwaltung. Im ersten Fall werden die Namensfelder  mit einem ''und'' als ein Datenfeld übertragen.  Aus Name 1 ''Martina Mustermann'' Name2 ''Martin Mustermann'' wird: ''Martina Mustermann und Martin Mustermann''.  Bei aktiver Partnerverwaltung können die Ehe- oder Geschäftspartner als getrennte Personen adressiert werden. Hier besteht generell ggf. noch Entwicklungsbedarf, um die unterschiedlichen Anforderungen und Konstellationen auch zusammen mit casavi abdecken zu können. s. Sybille 20220829010

===Wann werden Daten in casavi gelöscht, welche zuvor übermittelt wurden?===
Bei Objektende, Vertragsende, Anonymisierung, Rekonfiguration Personentypenfreischaltung\\ 
Für die für casavi freigegebenen Objekte werden alle aktiven Personen – die Personen mit einem gültigen Vertrag - an casavi gesendet. Die über die Personentypen nicht freigeschalteten Personen werden mit dem Kenner PortalUserFalse 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 Tagen an casavi als gelöscht gemeldet, damit dieser ebenfalls entfernt werden kann. Sollten die Mieterdaten davor in iX-Haus anonymisiert worden sein, wird das ebenfalls mit dem Serviceportal synchronisiert.\\ 
Wenn ein Datensatz in iX-Haus gelöscht wird, dann wird der Datensatz mit einem ''Delete''-Flag und anonymisierten Daten an casavi übertragen. Generell gilt: wird ein Datensatz gelöscht, so werden automatisch auch alle untergeordneten Daten gelöscht. Für die untergeordnete Daten werden keine separate Delete-Flags übertragen. Bsp.: Sollte ein Prop gelöscht werden, so sind alle Units, Leases, Docs etc. des Props ebenfalls zu löschen.

===Gibt es eine Liste der Anpassungen einer Übertragung (wird gesendetes XML temporär archiviert)?===
Wenn die Datei ''@mpSave'' im Verzeichnis tmp\Log hinterlegt ist, sollten gesendete und empfangene XML-Dateien unter ''tmp\Log'' abgelegt werden.

===Können Objekt+Personennummer als WE-Nummer nach casavi in das Feld ‚Einheitsnummer‘ übertragen werden?===
Derzeit wird das casavi-Feld ''Einheitsnummer'' von iX-Haus nicht bedient. Objektnummer und Personennummer liegen casavi bzgl. Verträgen separat vor, es gibt dort aber keine konfigurierbare Bildungsregel für das Feld ''Einheitsnummer''. Es liegen hierzu jedoch schon Anwenderanfragen vor. Unklar wäre z. B. eine Person:Objekt-Beziehung 1:n -> hätte ein Mieter für eindeutige Zuordnung dann pro Objekt einen separaten casavi-Account? Eine potentielle Anpassung wäre seitens iX-Haus zu planen (Sybille hierzu existiert).

===Nach Ändern von Personenstammdatensätzen werden in Einzelfällen keine entsprechenden Personen in casavi angelegt. Wie kann man auslesen, ob eine Änderung casavi-relevant ist, Trigger?==
Mit Adressanpassung konnte die Aktualisierung erzwungen werden, da dies aber bei vielen anderen Eingentümern klappte, stellt sich die Frage was hier die Ursache war bzw. wo man es auslesen kann, wenn eine solche Aktualisierung nicht zur Personendatensatzbildung in casavi führt. Ggf. Kontrolle der XML-Dateien: Mieterportal_Stammdaten-Zeitstempel.xml, die erzeugt werden sollten, wenn die Datei @mpSave-Datei im Verzeichnis tmp\log vorhanden ist. (SF00162256)

===Prozessfehler 502 Bad Gateway: Wer konfiguriert die Einstellung der/des benötigten Gateways?===
Das ist ein Thema für Casavi-Support (die stellen das Gateway ein?!)\\ 
<code>- Stammdaten an das Serviceportal senden: Serverfehler aufgetreten: Der Remoteserver hat einen Fehler zurückgegeben: (502) Ungültiges Gateway. <html>
<head><title>502 Bad Gateway</title></head>
<body bgcolorhite">
<center><h1>502 Bad Gateway</h1></center>
<hr><center>nginx/1.12.1</center>
</body>
</html>
</code>

===Wie sind die daten technisch verknüpft?===
Interne IDs und Verweise: Die interne IDs der Datensätze werden mittels der Felder ''hash'', ''ObjectIdSender'' und ''ObjectIdReceiver'' ausgetauscht. Dabei beinhaltet das ObjekctIdSender Felder immer das iX-Haus Id und das ObjekctIdReceiver die interne casavi ID. Im Feld ''hash'' wird generell die iX-Haus ID geschrieben, es sei denn, die ID ist mit der Prefix ‚fremd_id_‘ eingetragen. Dann handelt es sich um die casavi id.

Verweise auf bestimmte Datensätze erfolgen über die interne IDs. Diese werden über einen Datensatz mit einem hash oder ObjectIdSender Attribut abgebildet. Bsp: <Prop objectIdSender044"/> stellt den Verweis auf das Prop mit Id 1044 dar, <Unit hash4767"/> den Verweis auf die Unit mit Id 14767.
++++