DebitControl - Verbindung zu Remote Adressen Seite 1 von 8 Inhalt 1. 2. 2.1. 2.2. 3. 3.1. 3.2. Einleitung ..................................................................................................................... 2 Benützung.................................................................................................................... 3 Neue Adressen ......................................................................................................... 3 Adressen updaten..................................................................................................... 5 Konfiguration ............................................................................................................... 6 Einstellungen in DebitControl ................................................................................... 6 technische Voraussetzungen..................................................................................... 8 Maurhofer Informatik AG - Fritz Maurhofer N:\PROJEKTE\debitCtrl_sql\doku\DCExterneAdressen.doc 25.01.2006 Version 1.01.011 DebitControl - Verbindung zu Remote Adressen 1. Seite 2 von 8 Einleitung DebitControl kann nun Verbindung zu einer externen Adressdatenbank (z.B. Einwohnerkontrolle) aufnehmen und an folgenden Stellen benützen: 1. Neue Adresse Auswahl aus externer Adressdatenbank und einfügen in die DebitControl Adressen 2. Adressupdate der vorhandene Adressdatenbestand kann mit den externen Adressen abgeglichen werden Mit dieser neuen Funktionalität wird die Pflege des Adressstammes bedeutend vereinfacht und verbessert. Dieses Dokument beschreibt, wie dieser Zugriff benützt und konfiguriert wird. Voraussetzung: die externe Adressdatenbank muss über ODBC oder OLE-DB erreichbar sein. Maurhofer Informatik AG - Fritz Maurhofer N:\PROJEKTE\debitCtrl_sql\doku\DCExterneAdressen.doc 25.01.2006 Version 1.01.011 DebitControl - Verbindung zu Remote Adressen 2. Benützung 2.1. Neue Adressen Seite 3 von 8 Wird die Funktion „neue Adresse“ aufgerufen, dann erscheint zuerst folgendes Abfrageformular: Es stehen folgende Optionen zur Verfügung: In der externen Datenbank kann nach Suchbegriffen in den Feldern Name und/oder Vorname gesucht werden. Es werden alle Datensätze angezeigt, die mit den Suchbegriffen übereinstimmen. Das Programm setzt automatisch die SQL-Wildcard „%“ ans Ende eines eingegebenen Suchbegriffes. Der Begriff Muster findet als alle Einträge, die mit Muster beginnen. Achtung: wenn Sie keinen Suchbegriff eingeben, werden ALLE Adressen der externen Datenbank geladen. Dies kann eine Weile dauern, ev. lassen die Einstellungen der Datenbank das laden grosser Datenmengen nicht zu. In diesem Modus können Sie die numerische Identifikation (gem. externer Datenbank) als Suchbegriff verwenden (die ID muss exakt wie eingegeben vorhanden sein). Mit dieser Schaltfläche wird die Suche in der externen Datenbank gestartet. Anschliessend werden die gefundenen Einträge zur Auswahl angeboten: Wichtig: je präziser der Suchbegriff definiert wird, desto weniger Adressen müssen geladen werden (= schnellerer Zugriff). Maurhofer Informatik AG - Fritz Maurhofer N:\PROJEKTE\debitCtrl_sql\doku\DCExterneAdressen.doc 25.01.2006 Version 1.01.011 DebitControl - Verbindung zu Remote Adressen Seite 4 von 8 Hier kann in gewohnter Weise ausgewählt werden. Die ausgewählten Daten werden anschliessend in das DebitControl Adressformular übernommen und können vor dem definitiven speichern noch ergänzt werden. Bitte beachten: je nach Format der externen Adressen muss z.B. die Anrede oder der Geschlechtscode eingetragen werden. Mit dieser Schaltfläche kann die Auswahl aus einer externen Datenbank übersprungen und die Adresse in gewohnter Weise manuell erfasst werden (z.B. ein Betreibungsamt). Die Erfassung wird abgebrochen. Maurhofer Informatik AG - Fritz Maurhofer N:\PROJEKTE\debitCtrl_sql\doku\DCExterneAdressen.doc 25.01.2006 Version 1.01.011 DebitControl - Verbindung zu Remote Adressen 2.2. Seite 5 von 8 Adressen updaten Der Adressupdate ist als AddIn implementiert und kann über das Menü Datei / Öffnen aktiviert werden: Folgende Einstellungen sind möglich: Diese Einstellung definiert im Import-Modus „AHV-Nr“ über wie viele Stellen (ohne Punkte) die AHV-Nr. gemäss DebitControl mit der externen Datenbank verglichen werden (mit oder ohne die letzten drei Ziffern). Mit dieser Einstellung definieren Sie, mit welchem Feld die DebitControl Adressen mit der externen Datenbank abgeglichen werden. Ist diese Option markiert, dann werden keine Updates in DebitControl vorgenommen. Im Protokoll sehen dann aber, welche Adressen wie geupdated würden. Mit dieser Schaltfläche wird der Update gemäss obigen Einstellungen gestartet. Im Anschluss daran wird Ihnen das Protokoll angezeigt: Das Protokoll liegt als Textdatei „AdrUpdLog.txt“ im Applikationsverzeichnis und kann mit einem Editor geöffnet werden. Das Formular ohne Update verlassen. Maurhofer Informatik AG - Fritz Maurhofer N:\PROJEKTE\debitCtrl_sql\doku\DCExterneAdressen.doc 25.01.2006 Version 1.01.011 DebitControl - Verbindung zu Remote Adressen 3. Konfiguration 3.1. Einstellungen in DebitControl Seite 6 von 8 Die Einstellungen werden im Datadict vorgenommen (Menü Parametrierung / Datadict) und betreffen folgende Ressourcen: Alias Typ Keyfeld ADRIMPORT_FORM FPW dcAdrImpNest Name des Formulares, das bei AdresseÆNeu aufgerufen wird. Leer = die Funktion ist ausgeschaltete Alias Typ Definition ADRIMPORT_ENABDIS DEF Code, mit dem ggf. Adressfelder vor Änderungen geschützt werden (z.B. wenn bei übernommenen Adressen nur die nicht extern geführten Adressfelder in DebitControl bearbeitet werden dürfen. Anmerkung: z.Zeit nicht verwendet Alias Typ Definition ADRIMPORT_NACHONINSERT DEF Code, der nach der Adressübernahme ausgeführt wird (im Prinzip, welche Felder der externen Adresse in den neuen DebitControl Eintrag übernommen werden). Parameter: <ExpO> Referenz auf Adressform Alias Typ Definition ADRIMPORT_CONNMODUS FPW Modus für die Verbindung zur externen Datenbank 1 = ODBC 2 = OLE-DB Alias Typ Definition ADRIMPORT_CONNSTR DEF Connection-String für die Verbindung zur externen Datenbank Aus Sicherheitsgründen sollte die Verbindung nach Möglichkeit über ein read-only Login (mit Zugriffsrechten auf eine Adressview) erfolgen, da das Passwort hier im Klartext abgelegt wird! Alias Typ Definition ADRIMPORT_QUERY DEF SQL Select Statement von „SELECT...“ bis „FROM...“ (ohne Where Clause). Bitte beachten: in diesem Eintrag dürfen keine Zeilenvorschübe (CR) eingebaut werden! Maurhofer Informatik AG - Fritz Maurhofer N:\PROJEKTE\debitCtrl_sql\doku\DCExterneAdressen.doc 25.01.2006 Version 1.01.011 DebitControl - Verbindung zu Remote Adressen Seite 7 von 8 Alias Typ Definition ADRIMPORT_WHERE DEF Ermittelt die WHERE Clause zum SELECT-Statement * Para's passed: *<ExpO> Ref. auf aufrufendes Form *<ExpN1> Modus: 1 = Name/Vorname, 2 = Ext. ID * Suchbegriffe *<ExpC1> Name *<ExpC2> Vorname *<ExpN2> Ext. ID Alias Typ Definition ADRIMPORT_FLDLIST DEF Liste der Felder (Feldnamen), die im Auswahldialog angezeigt werden sollen Wichtig: diese müssen natürlich mit dem SELECT Statement korrespondieren Alias Typ Definition ADRIMPORT_FLDTITLE DEF Spaltenüberschriften zu den angezeigten Feldern im Auswahldialog (diese Angaben hier müssen mit dem vorstehenden Eintrag korrespondieren) Alias Typ Definition ADRIMPORT_PICKRETEXP DEF <ExpC> für die Definition des Rückgabewertes des Auswahldialoges Alias Typ Definition ADRIMPORT_FLDREPLACE DEF Übernahme der Werte nach dem Auswahldialog Parameters: <ExpO1> Ref. auf aufrufendes Form <ExpO2> Ref. auf Adressform <ExpO3> Ref. auf Pickfieldobjekt Alias Typ Definition ADRIMPORT_PICKCAPTION DEF <Expr> Titel des Auswahldialogs Alias Typ Definition ADRIMPORT_SRCHQUERY DEF SELECT Statement zum ermitteln einer Remote Adresse beim Adressupdate Parameters: * <ExpO> Referenz auf aufrufendes Form * <ExpN> 1 = AHV-Nr., 2 = Ext-ID * <ExpV> Suchwert gem. tnModus Maurhofer Informatik AG - Fritz Maurhofer N:\PROJEKTE\debitCtrl_sql\doku\DCExterneAdressen.doc 25.01.2006 Version 1.01.011 DebitControl - Verbindung zu Remote Adressen Seite 8 von 8 Alias Typ Definition ADRIMPORT_BUILDUPD DEF Code, der das REPLACE Statement für den Adressupdate zusammensetzt Parameters: <ExpO> Ref. auf aufrufendes Formular Alias Typ Definition ADRIMPORT_SCANCOND DEF Suchbegriff zum ermitteln der zu updatenden Adressen in DebitControl (z.B. nur Adressen mit AHV-Nummer oder einer externen ID) Parameters: * <ExpO> Ref. auf aufrufendes Form * <ExpN1> Suchmodus: 1= AHV-Nr., 2 = Ext. ID * <ExpN2> bei Modus 1: Länge der AHV-Nummer * Para's returned: * <ExpC> SCAN Begriff Alias Typ Definition ADRESSIMPORT_DEF DEF Default-Eisntellungen beim Adressimport-Formular Parameters: <ExpO> Ref. auf aufrufendes Formular 3.2. technische Voraussetzungen Damit die Verbindung auf die entfernte Datenbank (SQL-Server, Oracle, etc.) überhaupt aufgebaut werden kann, müssen auf dem Arbeitsplatz PC die notwendigen Treiber (ODBC oder OLE-DB) installiert sein. Bitte beachten Sie, dass hierfür die Lizenzbedingungen der jeweiligen Hersteller gelten. Weiter muss für die entfernte Datenbank ein Login mit Zugriffsrecht auf die Adressdaten (vorzugsweise eine Read/Only View) eingerichtet werden. Loginname und Passwort müssen bei der Installation bekannt sein um den Ressourceneintrag ADRIMPORT_CONNSTR korrekt konfigurieren zu können. Bitte testen Sie die Verbindung vorgängig mit den auf jedem PC vorhandenen Werkzeugen: ODBC: OLE-DB ODBC Data Source Administrator Microsoft Data Link Utility In beiden Werkzeugen finden Sie nach dem Einstellen der Konfiguration eine Schaltfläche „Verbindung testen“, mit der Sie eine grundsätzliche Verbindungskontrolle vornehmen können. Sofern dieser Test positiv verläuft, sollte auch die Verbindung in DebitControl problemlos hergestellt werden können. Maurhofer Informatik AG - Fritz Maurhofer N:\PROJEKTE\debitCtrl_sql\doku\DCExterneAdressen.doc 25.01.2006 Version 1.01.011