Als Erstes muss die Anwendung im cardo-System verfügbar sein, dazu muss das entsprechende Verzeichnis im Projektverzeichnis unter cardo3Apps angelegt werden (siehe Anwendungsverwaltung). Beim nächsten cardo-Update werden dann die nötigen Dateien der Anwendung eingespielt.
Folgende Benutzergruppen müssen angelegt werden bevor die erste Kategorie registriert werden kann:
- SE_LTV_ADMIN: für Administratoren, die neben vollem Zugriff auf die Datenfelder auch Berechtigungen an den Datenfeldern vergeben können
- SE_LTV_DIENST: Mitglied dieser Gruppe muss der Benutzer sein, unter welchem Prodabau den cardo-Dienst aufruft. Diese Gruppe hat alle nötigen Rechte an den über den Dienst änderbaren Feldern.
- SE_LTV_BEARBEITER: Alle LTV-Mitarbeiter, die Daten erfassen/ändern können
- SE_LTV_LESER: LTV-Mitarbeiter, welche nur lesend auf die Daten zugreifen sollen
- SE_FA_BEARBEITER: Alle Benutzer externer Firmen, die Daten erfassen/ändern können
- SE_FA_LESER: Benutzer externer Firmen, welche nur lesend auf die Daten zugreifen sollen
Es wird empfohlen, die Daten der Anwendung in einem eigenen IKX-Store abzulegen. Ein neuer Store kann über den entsprechenden Dienst angelegt werden. Da die Anwendung als Bindeglied zwischen Prodabau und externem cardo dient, könnte der Store die Unique-ID 'PUZZLE_SCHADEN_INTERN' bekommen.
Ist der Store verfügbar, kann die Kategorie 'Vorlagekategorie Schaden' (Kategoriegruppe: LTV Schadenerfassung) in diesem Store registriert werden.
Die Kategorie erwartet als Parameter die Angabe der Unique-Store-Id des Stores auf dem internen und externen cardo. Obigem Beispiel folgend könnte das so aussehen:
Wird zu einem Ereignis ein Datenmodell (Version einer Kategorie) erstellt, dann wird intern eine neue Dll mit den bisherigen und dieser neuen Kategorie-Klasse kompiliert. Diese Dll wird bis zum nächsten Neustart der Webseite aus dem Speicher geladen und über einen Task beim Beenden der Webseite dann physich von
_Projekt_[Projektname ]\CodeGen\Puzzle\Bin
nach
CoreWeb3\IIS\net3\bin
kopiert.
Das funktioniert nur, wenn der User 'Netzwerkdienst' unter welchen überlicherweise die cardo3-Webseite im IIS ausgeführt wird, Schreibberechtigung auf dem Verzeichnis CoreWeb3\net3\bin bekommt.
Wenn die Datei nicht kopiert werden kann (oder ein anderes Problem im Task aufgetreten ist) wird dies protokolliert unter:
_Projekt_[Projektname ]\CodeGen\Puzzle\Bin\copyVersionDll....txt
Damit im Editor später nicht der Reiter 'Basisklasse' sondern stattdessen der Reiter 'Geometrie' angezeigt wird, kann die Basisklasse umbenannt werden. Dies kann im Klasseneditor erfolgen.
Die Schadenserfassung kann nur mit den Puzzle- und IKX-Editoren in der Version 2 erfolgen, da ältere Versionen nicht alle Features des Datenmodells unterstützen. Stellen Sie einmalig die Standardeditoren für die Puzzle-Anwendung ein:
Damit diese Änderung aktiv wird, muss einmalig die Konfiguration neu eingelesen werden:
Als nächstes kann die Anwendung registriert werden. Die Anwendung bringt ein eigenes Datenmodell mit. Zur Installation wird eine Verbindungszeichenfolge zu einer Postgres-Datenbank benötigt. Es wird empfohlen das oben bereits als IKX-Store angelegte Datenbankschema zu verwenden. Für den Zugriff wird empfohlen, einen eigenen Datenbankbenutzer 'schadendb' anzulegen. Dann könnte die in der Konfiguration zu hinterlegende Verbindungszeichenfolge folgendes Format haben:
DATABASE=cardo_developers;SERVER=localhost;PORT=5432;USER ID=schadendb;PASSWORD=xxx;SEARCHPATH=schadenerfassung,public
Analog muss auch die Verbindung zur Prodabau über eine korrekte Verbindungzeichenfolge zu einer MS-SQL-Datenbank angegeben werden. Auch die beiden Store-Unique-Ids werden hier als Parameter erwartet:
Ist die Konfiguration abgeschlossen, kann die Datenbank initial aktualisiert werden (Verwaltung/Datenbank aktualisieren).
Die Bearbeiter der einzelnen Betriebe oder den Betrieben zugeordneten Firmen müssen einen cardo-Zugang und damit eine eigene Anmeldung bekommen. Für jeden Betrieb müssen zwei cardo-Gruppen angelegt werden, in welchen alle Leser, Erfasser des jeweiligen Betriebs aufgenommen werden müssen.
Für jeden Betrieb muss jeweils eine Gruppe im Format
SE_LTV_BETRIEB_[Nummer]_LESER
und
SE_LTV_BETRIEB_[Nummer]_BEARBEITER
angelegt werden, z.B. SE_LTV_BETRIEB_10_LESER, SE_LTV_BETRIEB_10_BEARBEITER
Damit der Gemeindeschlüssel (Pflichtfeld für Prodabau) und optional der Gemeindeteilschlüssel ermittelt werden kann, muss jeweils eine passende Ebene zur Verfügung stehen und in die Konfiguration der Schadensanwendung und der Kategorien eingetragen werden.
Stehen entsprechende Ebenen bereit, sind deren Parameter in den Anwendungseinstellungen einzutragen:
Diese Einstellungen werden verwendet, wenn Prodabau geänderte Daten zu Schäden zurück meldet.
Desweiteren sind diese Parameter auch an den Ereignissen direkt einzutragen. Dabei reicht es, die Werte an der Vorlagenkategorie zu hinterlegen, da die Konfiguration bei der Versionierung dieser Kategorie auch mit übernommen wird:
Entsprechende Einstellungen für das externe cardo werden weiter unten beschrieben.
Steht ein externes cardo in der DMZ zur Verfügung, dann kann dieses für die Erfassung von Schäden durch externe Erfasser (typischerweise beauftragte Firmen) erfolgen.
Folgende Vorbereitungen müssen dafür getroffen werden:
- Neuen IKX-Store anlegen, in welchem die Schadensdaten gespeichert werden sollen
- Nötige Basis-Gruppen anlegen (analog zum internen cardo)
- Nötige Betriebsgruppen anlegen (analog zum internen cardo)
- Berechtigungen an der Basisklasse im Schadens-Store anpassen (siehe unten)
- gegebenenfalls die Anwendung zur Zugangsverwaltung registrieren und einrichten
- Mindestens eine Ebene für Gemeinden und optional für Gemeindeteile verfügbar machen
Wurde IKX auf dem Server noch nicht verwendet, muss gegebenenfalls folgende grundsätzliche Einstellung noch erfolgen (ManagementCenter -> Status und Einstellungen -> Systemparameter):
Berechtigungen an der Basisklasse anpassen
Vergeben Sie im Externen cardo an der Basisklasse des dafür erstellten Stores folgende Rechte:
- SE_FA_BEARBEITER - Read, Write, Delete
- SE_FA_LESER - Read
- SE_LTV_ADMIN - Read, Write, Delete, Admin
- SE_LTV_BEARBEITER - Read, Write, Delete
- SE_LTV_LESER - Read
- SE_LTV_DIENST - Read, Write, Delete
Die Gemeinde- und Gemeindeteilebene müssen auch auf dem externen cardo zur Verfügung stehen, damit die entsprechende Ermittlung bei Erfassung eines Schadens automatisch durchgeführt werden kann.
Dazu wird empfohlen, die entsprechenden Ebenen per c2c vom internen an das externe cardo zu übertragen, damit ein späteres Aktualisieren der Daten komfortabel möglich ist.
Stehen die Ebenen auf dem externen cardo bereit, sind die entsprechenden Parameter noch im internen cardo an der Vorlagenkategorie einzutragen:
