Administration
Voraussetzungen

Um die Export/Import Funktion und die Integration der Karte bei der Erfassung nutzen zu können, muss mindestens die Version 2.95 von WinAKPS installiert sein.
Außerdem muss eine PostgreSQL Datenbank 8.3 oder höher zur Verfügung stehen. Dies ist oft schon durch cardo gegeben.

Installation

Zuerst ist im Ordner "cardoSystem\_Projekt_XYZ/IISVirtualDir/cardo3Apps" ein Ordner namens „IDU_WinAKPS“ anzulegen. Nachfolgend muss der cardo-Updater auf dem Server gestartet und eine Aktualisierung "Aktuelles öffentliches Release" durchgeführt werden.

Anwendung registrieren
  1. cardo3-Management Center öffnen
  2. Unter "Status und Einstellungen" den Bereich "Anwendungen" auswählen.
  3. Auf der linken Seite ist dann eine Schaltfläche "IDU.WINAKPS" zu finden.
    Diese einmal anklicken, um die Registrierung zu starten. Der Eintrag ändert
    sich nach der Registrierung in "WinAKPS Schnittstelle".
  4. Dieser Eintrag muss erneut angeklickt werden.  Anschließend ist der Punkt "Datenbanken aktualisieren" zu wählen.

WINAKPS_REG.png

Berechtigungseinstellungen

Dazu muss im Management Center unter "Status und Einstellungen" in den Bereich "Anwendungen" gewechselt werden. Dort ist der Eintrag „WinAKPS Schnittstelle“ zu wählen.

  • In der Rubrik "Zugriffsrollen" muss anschließend eingestellt werden, welche Benutzer die Anwendung nutzen und/oder verwalten dürfen.
Wichtiger Hinweis: Auch alle Nutzer der Desktopanwendung, die nur das Kartenmodul bei der Erfassung nutzen wollen müssen berechtigt sein die cardo Anwendung zu starten.

WINAKPS_ANWR.png

  •  In der Rubrik "Sicherheitsthemen der Anwendung => Berechtigungen" ist einzustellen, welche Nutzer den Datenimport durchführen dürfen.

WINAKPS_Benutzer.png

Einstellen der Anwendungs- (Parameter)

Dazu muss im Management Center unter "Status und Einstellungen" der Bereich "Anwendungen" geöffnet werden. Anschließend ist durch einfaches Anklicken die "WINAKPS Schnittstelle" und nachfolgend die entsprechende Rubrik "Parameter" zu aktivieren.

WINAKPS_PARAM.png

Tipp: Im Infobereich, dieser befindet sich am unteren Rand des Parameterbereichs, wird jeweils eine Erklärung zum aktivierten Parameter angezeigt.

Datenbanken:
Die Syntax für die einzugebende Verbindungszeichenfolge zur Postgres Datenbank lautet: "database=DATENBANKNAME;server=SERVERNAME;port=5432;user
id=NUTZER;password=KENNWORT;pooling=false;"

Als Schemanamen ist "winakps" einzugeben, wenn dieser nicht vorher explizit in der Datenbank geändert wurde. 

Flurstücksebene:
Zum Abgleich der Flurstücke der Verkaufsfälle wird auf die Ebene Flurstücke zurückgegriffen. Benötigt wird die Information zum Spaltennamen mit dem
Flurstücksschlüssel und der Anwendungsname (TAG) unter dem die Flurstücksebene gefunden werden kann. In der Regel ist der durch die ALB-Anwendung schon vorgegeben und lautet "ALK_FLUR".

Hinweis: Im cardo wird auf einige Ebenen über einen sogenannten Anwendungsnamen Bezug genommen, da die interne Nummer von cardo zu cardo unterschiedlich ist.
Diese Einstellung ist im administrativen Baum im Karteireiter Ebeneneinstellungen zu finden.

WINAKPS_EBENEN.png

MS Access DB: Hier ist der Namen der Tabelle anzugeben, die aus der Export-MDB von WinAKPS importiert werden soll. Im Regelfall ist der Name
"K_INGRADADATEN".

Kartenmodul im WinAKPS: Im Kartenmodul, bei der Erfassung, werden dem Nutzer verschiedene Inhalte zur Auswahl angeboten.

WINAKPS_KARTENMOD.png

Diese Karten müssen im cardo vorbereitet werden. Dazu wird die Funktion "Meine Karten" genutzt. Ein Administrator oder Mitarbeiter des zuständigen Sachgebietes stellt sich im cardo passende Karteninhalte zusammen und speichert diese als
"Meine Karte" ab.

WINAKPS_MEINEKARTEN.png

Anschließend gibt er diese Karte öffentlich frei (Berechtigung dafür muss vorhanden sein) und teilt dem cardo-Administrator die Id der gespeicherten Karte mit (Id wird im Tooltip angezeigt). Der cardo-Administrator muss mindestens eine Id einer gespeicherten Karte bekanntgeben. Sollen mehrere Karten zur Wahl stehen, dann sind die Ids durch Komma getrennt anzugeben. Die Reihenfolge der Eingabe bestimmt die Reihenfolge in der Liste. (weitere Informationen zu "Meine Karten" anzeigen)

optionale Ebenen Nutzungsarten, Richtwertzonen, Adressen: Wenn möglich, werden im Kartenmodul bei der Erfassung noch weitere Informationen zum Verkaufsfall automatisch von cardo bezogen. Dafür können in den jeweiligen Abschnitten die Ebenen mittels eines selbst zu vergebenden Anwendungsnamen bekanntgegeben werden. Außerdem sind die relevanten Sachdatenspalten zu benennen. Zu den geforderten Inhalten ist u. U. Rücksprache mit den WinAKPS Betreuern zu halten (soweit möglich, steht auch IDU beratend zur Seite).

Einstellungen in der Desktopanwendung Kaufpreissammlung

In der INI-Datei der Kaufpreissammlung kaufp.ini" (zu finden im Windows Ordner
oder im Installationsordner der Anwendung) gibt es einen Abschnitt CARDO.

[CARDO]
URL=http://CARDOSERVER/cardo.com.asp?
CRTID=4
SELLAYER=L673|L37
SELFIELD=ALKNR
SELOFFSET=50
SELJOINTYPE=OR
PREVENT_AUTO_CLOSE=true
DATEN_URL=http://CARDOSERVER/net3/project/cardo3Apps/
IDU_WinAKPS/Erfassung/MapControl.aspx

(Zeilenumbruch in der URL nur aus Darstellungsgründen)

Die rot markierten Teile sind entsprechend der Umgebung anzupassen.

SELLAYER: Ebenenname der Ebene der Verkaufsfälle. Ggf. können weitere Ebenen als "Ausweichebene" angegeben werden, falls das Flurstück in der ersten Ebene nicht gefunden wurde.

SELFIELD: Spaltenname in allen Selektionsebenen, der die 21-stellige
Flurstücksnummer enthält.

Einrichten der Adresssuche für das Kartenmodul (optional)

WINAKPS_KARTENMOD.png

Wenn im Kartenmodul bei der Erfassung die Adresssuche zur Verfügung stehen soll, dann muss ein Adressdatenbestand in einer vorgegebenen Struktur in der Datenbank vorliegen (Tabellen oder Views). Der Verweis auf diesen Datenbestand muss in der Datei "web.config" eingetragen werden.

erforderliche Struktur:

adr_adressen
id varchar,
rw double, -- Rechtswert
hw double, -- Hochwert
gm integer, -- Gemeindeschlüssel
strschl varchar, -- Straßenschlüssel
hnr integer, -- Hausnummer
adrzusatz varchar, -- Adresszusatz
adr_id varchar, -- Eindeutiger Adressschlüssel zusammengesetzt aus
Gemeinde, Straße, Hnr und AdrZusatz


adr_nt_strassen
id varchar, -- Straßenschlüssel
strasse varchar, -- Straßenname
gm integer -- Gemeindeschlüssel


adr_nt_gemeinden
id integer, -- Gemeindeschlüssel
gemeinde varchar -- Gemeindename

Konfiguration:

Dazu muss die Datei "web.config" im Ordner „cardoSystem\CoreWeb3\IIS\net3“ in einem Texteditor geöffnet werden. Anschließend sind im Abschnitt „appSettings“ folgende Zeilen,angepasst an die Anwenderumgebung, einzufügen. 

<add key="NxfAdressSearch.Connection"
value="Server=SERVER;DataBase=DBNAME;User Name=NUTZER;Password=KENNWORT;" />
<add key="NxfAdressSearch.BaseSchemaName" value="basisdaten" /> Beispiel: 

WINAKPS_BSP.png

Ebene mit Verkaufsfällen bereitstellen

In der Datenbank steht der View "winakps.vw_cardo" bereit, der eine Sicht auf die Verkaufsfälle verknüpft mit den (kopierten) Flurstücksgeometrien zur Verfügung stellt.
Auf diese Sicht können eine oder mehrere Ebenen (unterschiedlich klassifiziert oder gefiltert) und Beschriftungen im cardo angelegt werden.

 WINAKPS_EBENE.png