DOKinform FillUP Dokumentation DE

DOKinform® FILLup 5.0 for ELO®
Dokumentation
Installation, Konfiguration, ELO-Integration
© ARIVATO GmbH
Impressum
Stand:
Version:
28.05.2015
7.0
Copyright
ARIVATO GmbH
Alle Rechte, auch die des Nachdrucks, der Vervielfältigung oder der Verwertung bzw. Mitteilung des Inhalts dieses
Dokuments oder von Teilen daraus behalten wir uns vor. Kein Teil darf ohne schriftliche Genehmigung von ARIVATO
GmbH in irgend einer Form reproduziert, an Dritte weitergegeben oder insbesondere unter Verwendung
elektronischer Systeme verarbeitet, vervielfältigt oder zu öffentlichen Wiedergabe benutzt werden. Wir behalten uns
das Recht vor, Inhalte zu aktualisieren oder zu modifizieren.
Warenzeichen
ELOenterprise, ELOprofessional und ELOoffice sind eingetragene Warenzeichen der ELO Digital Office GmbH.
SAP®, R/2, R/3, ABAP/4, SAP ArchiveLink, SAP Business Workflow, das SAP-Logo und das R/3-Logo sind
eingetragene Marken der SAP AG.
Microsoft Windows, Microsoft Office, Microsoft Word, Microsoft Excel, Microsoft PowerPoint, Microsoft Outlook und
Microsoft SQL Server sind eingetragene Warenzeichen der Microsoft Corporation
Andere Produktnamen werden nur zur Identifikation der Produkte verwendet und können eingetragene
Warenzeichen / Marken der jeweiligen Hersteller sein.
DOKinform® FILLup for ELO
Seite 1/26
Stand: 28.05.2015
Inhaltsverzeichnis
1
2
3
4
5
6
7
8
© ARIVATO GmbH
9
Einleitung .....................................................................................................................3
Installation ...................................................................................................................4
Individuelle Konfiguration...............................................................................................5
Integration in ELO ....................................................................................................... 11
Betrieb und Fehlersuche ................................................................................................ 12
5.1
Interaktiver Filter .................................................................................................. 13
FAQ, Fehlermeldungen, Logfile Analyse ........................................................................... 14
6.1
Falsche Zugangsdaten für die Datenquelle, Berechtigung ............................................ 14
6.2
Falsche Aufrufparameter für Fillup ........................................................................... 15
6.3
Keine bzw. gewünschte Daten nicht gefunden ........................................................... 15
6.4
Daten werden nicht in der gewünschten Form dargestellt ............................................ 16
6.5
Fehlerhafte Konfiguration der Selektion / Anzeige ..................................................... 17
6.6
Daten werden in die falschen Felder in ELO eingefügt ................................................. 18
Aufbau einer Test- und Entwicklungsumgebung (MS Access) ............................................... 19
Aufbau einer Test- und Entwicklungsumgebung (MS SQL Server) ......................................... 20
8.1
Erstellen einer Testdatenbank in MSSQL-Server 2005................................................... 20
8.2
ELO ..................................................................................................................... 23
8.2.1
Importieren der Ablagemaske ........................................................................... 23
8.2.2
ELO Windows Client: Einbinden des Skriptes DOKINFORM.VBS ................................ 24
8.2.3
ELO JavaClient: Einbinden der Skripte................................................................ 24
Beispiel fillup.ini ......................................................................................................... 26
DOKinform® FILLup for ELO
Seite 2/26
Stand: 28.05.2015
1 Einleitung
Diese Dokumentation beschreibt die erforderlichen Einstellungen für den Betrieb mit Ihrem ELOArchiv und einer fast beliebigen Datenquelle.
DOKinform® FILLup arbeitet als Schnittstelle zwischen ELO und einer Datenquelle und
ermöglicht die schnelle, einfache und sichere Verschlagwortung von Dokumenten in der ELOPostbox.
© ARIVATO GmbH
Über eine individuell konfigurierbare Datei (Fillup.ini) kann die Anpassung an Ihre Bedürfnisse
erfolgen.
DOKinform® FILLup for ELO
Seite 3/26
Stand: 28.05.2015
2 Installation
Die Installation erfolgt über das bereitgestellte Setup Programm.
Mit Hilfe des Setup Programms können aller erforderlichen Komponenten sehr schnell in fest
vorgegebene Pfade installiert werden.
Sofern auf Ihrem System bereits andere DOKinform® Programme installiert sind, wird deren
Basisordner (i.d.R. C:\DOKinform) aus der Registrierung ermittelt.
DirectSearch wird dann in ein gleichnamiges Unterverzeichnis installiert.
Ist auf Ihrem System noch kein DOKinform® Programm vorhanden, so wird das Setup den
Ordner C:\DOKinform anlegen und einen entsprechenden Registrierungseintrag erstellen.
Auf Ihrem PC hat das Setup Programm einen Eintrag im Startmenü unter Programme\DOKinform
erstellt. Von dort haben Sie Zugriff auf die Dokumentation. Um das Programm benutzen zu
können, muss erst die Integration mit ELO erfolgen.
Sollten Sie einen individuellen Installationsort (anderes Laufwerk, Verzeichnis oder
Netzwerkpfad) bevorzugen, so können Sie EINEN der folgenden Wege einschlagen:
1. Nach der Installation das Verzeichnis mit allen darin befindlichen Dateien beliebig
verschieben. Bitte setzen Sie in diesem Fall unter
HKEY_LOCAL_MACHINE\SOFTWARE\DOKinform den Registrierungsschlüssel DOKinformDir
Ihrem Wunsch entsprechend neu. Geben Sie hier das DOKinform Basisverzeichnis
(nicht direkt den Programmordner für FILLup) an.
Bitte denken Sie daran, den Eintrag im Startmenü entsprechend umzustellen.
2. Sie erstellen o.g. Eintrag in der Registrierung und starten anschließend das Setup
Programm. Dann erfolgt die Installation in den Ordner.
Bitte denken Sie daran vor der ersten Benutzung Ihre Lizenzdatei (FillUp.lic) in den FILLup
Programmorder zu kopieren. Ohne diese ist das Programm nicht lauffähig.
In Abhängigkeit Ihrer ELO-Umgebung muss ggf. die Konfiguration des Programmes angepasst
werden (siehe nächstes Kapitel).
© ARIVATO GmbH
Erstellen Sie auf Ihrem PC eine ODBC DSN z.B. mit dem Namen DOKINFORM.
DOKinform® FILLup for ELO
Seite 4/26
Stand: 28.05.2015
3 Individuelle Konfiguration
Um die Funktionsweise von DOKinform® FILLup an Ihre individuellen Wünsche anzupassen,
können Sie in der Konfigurationsdatei Fillup.ini entsprechende Einträge vornehmen.
Eine Musterkonfiguration finden Sie in Kapitel 9. Diese ist in Verbindung mit dem in Kapitel 8
befindlichen Skript und der Musterdatenbank (vgl. Kapitel 7) getestet.
© ARIVATO GmbH
ACHTUNG:
Ab Version 3.0 hat die der Aufbau der Konfigurationsdatei grundlegend geändert. Bitte lesen
Sie daher diesen Abschnitt genau. Evtl. vorhandene alte Dateien lassen sich mit geringem
Aufwand manuell konvertieren.
o
Zugriff auf Datenquell e (z.B. SQL-Server)
[Database]
Diese Sektion wird ab FillUp V3.0 nicht mehr benötigt. Bitte übertragen Sie die
Daten in das jeweilige Profil.
o
Allgemeine Programm Parameter
[Prog]
Language =“deutsch“
Angabe der Sprache für Meldungen des
Programms, Logging erfolgt immer in
englischer Sprache.
MaxPostBoxEntriesAllowed="100"
Anzahl der Dateien welche in der
Postbox vorhanden sein dürfen
(Maximalwert = 9998).
LogDir="C:\DOKinform\FillUp\log"
Verzeichnis für logging
FileName="fillup“
Präfix des Dateinamens der Logdatei. Je
User wir täglich eine neue Datei
angelegt.
ELOserver=”Driver={SQL
Server};Server=SRV1;Database=eloam;
Uid=elodb;Pwd=...”
Bei Einsatz mit dem ELO JavaClient ist
dieser Eintrag erforderlich. Die genaue
Syntax ist im Bereich „Profile“ unter
„ConnectionType = DBconn“
beschrieben.
DOKinform® FILLup for ELO
Seite 5/26
Stand: 28.05.2015
o
Profile
In der Datei Fillup.ini können mehrere unterschiedliche Konfigurationen (Profile)
hinterlegt und parallel verwendet werden. Dafür legt man für jede Konfiguration
eine Sektion an und gibt dieser einen Namen, z.B.:
[CUSTOMER]
Die einzelnen Parameter haben folgende Bedeutung:
ProfileName=”Customer data by name”
Sprechender Name / Bezeichnung für ein Profil. Dieser wird in der Statusleiste des
Programms eingeblendet. Ist der Wert leer, so wird der Name des Profils (in
diesem Beispiel CUSTOMER) angezeigt.
MaxHits="100"
Maximale Zahl von Treffern welche dargestellt werden. Bei Überschreiten der
Trefferzahl erfolgt eine entsprechende Meldung, der Vorgang muss mit einem
genaueren Suchbegriff wiederholt werden.
Logging="YES"
Werte: YES / NO
LogLevel="5"
Werte von 1-9
Standardwert = 5, zur Fehlersuche kann es sinnvoll sein den Level auf 9 zu
erhöhen.
ConnectionType = “DBconn” oder “DSN”
Art des Zugriffes auf die Datenquelle. Unterstützte Modi sind DSN oder DBconn.
Betriebsart DBconn: hier kann ein connection string angegeben werden (Details
z.B. unter www.connctionstrings.com). Alternativ kann auch mit „WindowsAuthentifizierung“ (trusted_connection) gearbeitet werden.
Betriebsart DSN setzt eine DSN auf den Rechner voraus.
© ARIVATO GmbH
Passwörter werden bei erster Verwendung verschlüsselt.
DBconn=”Driver={SQL Server} ;Server=SERVERNAME;
DOKinform® FILLup for ELO
Seite 6/26
Stand: 28.05.2015
Database=DOKINFORM;Uid=dokinform;Pwd=dokinform;”
DBconn=”Driver={SQL Server} ;Server=SERVERNAME;
Database=DOKINFORM;Trusted_Connection=yes;”
DSN="DOKINFORM"
user="DOKINFORM"
PW="…hier das Passwort einfügen…"
Name= "10 - Customer"
Name der ELO-Maske
Diese Option ist beim ELO JavaClient nicht erfroderlich.
AppendToFillupField="NO"
System, nicht ändern
SaveRestoreIndexData=“NO“
System, nicht ändern
Diese Option steht beim ELO JavaClient nicht zur Verfügung.
SQL1…SQL4
SQL1="Select * from DOKINFORM.dbo.CUSTOMER "
SQL2 = " WHERE (NAME1 like "
SQL3 = " '%"
…..
SQL4 = "%') "
Hier wird ein aus bis zu 4 Teilen bestehendes SQL-Statement definiert.
Ggf. anpassen an anderen Datenbank-, Tabellen- oder View-Namen
SQL-Statement geeignet anpassen…
Zwischen SQL3 und SQL4 wird der erste Aufrufparameter von Fillup eingefügt und das
SQL-Statement so ergänzt
© ARIVATO GmbH
SQL_xx=ELO-nn
SQL_0="ELO-01"
SQL_1="ELO-01"
SQL_2="ELO-02"
DOKinform® FILLup for ELO
Seite 7/26
Stand: 28.05.2015
SQL_3="ELO-DD"
SQL_4="ELO-xx"
Zuordnung der Felder aus der Datenquelle zu den einzelnen Feldnummer der ELOMaske.Anpassungen hier erfordern spezielles ELO Know-How. Alle Felder werden Null
basierend gezählt.
Sonderfälle:
„ELO-XX“ - Dieser SQL-Wert wird keinem ELO-Feld zugewiesen und somit
verworfen.
„ELO-DD“ – Dieser SQL-Wert wird dem ELO-Datumsfeld zugeordnet. Das Datum
muss immer im Format TT.MM.JJJJ übergeben werden. Andere Formate müssen in
der Datenquelle geeignet konvertiert werden.
Mehrfachzuordnung - Mehrere Spalten der Datenquelle können demselben ELOFeld zugewiesen werden um z.B. Vorname und Nachname in ein einziges
Maskenfeld in ELO zu übernehmen. Zwischen den Feldern fügt FILLup eigenständig
ein Leerzeichen ein.
Title=”Name1|Name2|Nummer|PLZ|Ort|Strasse”
Findet FillUp mehr als nur einen Treffer in der Datenquelle, so werden alle
Datensätze in einer Liste dargestellt. Die Spaltenköpfe können frei beschriftet
werden.
Bitte beachten Sie dass die Liste immer nach der ersten Spalte sortiert wird.
Als Trennzeichen dient ein senkrechter Strich („pipe“) welcher direkt über die
Tastatur eingegeben werden kann (alternativ über Alt+0124).
Für jede per SELECT gelesene Spalte muss zwingend ein Eintrag in Title erfolgen.
Columns=”200|200|60|60|150|150”
Die Breite der einzelnen Spalten der Datentabelle kann entsprechend beeinflusst
werden. Die Angaben sind in Pixel zu verstehen. Übersteigt die Summe der
Spaltenbreiten den Wert von 800 so wird der Datenbereich horizontal scrollbar.
Als Trennzeichen dient ein senkrechter Strich („pipe“) welcher direkt über die
Tastatur eingegeben werden kann (alternativ über Alt+0124).
© ARIVATO GmbH
ShortDef="ELO-05 / ELO-00 / ELO-12 / ELO-01"
ShortSeparator = " / "
Aufbau der ELO-Kurzbezeichnung aus dem Inhalt von Maskenfeldern.
Um dies Funktion zu deaktivieren muss die Zeile ShortDef in der Datei
auskommentiert werden.
DOKinform® FILLup for ELO
Seite 8/26
Stand: 28.05.2015
Trennzeichen zwischen den Feldern (bitte kein Minuszeichen verwenden da dieses
intern eine Sonderfunktion hat.).
DefCountStatic=
Ab Version 2011 können Maskenfelder mit statischen Werten vorbelegt werden.
Um diese Funktion zu deaktivieren wird hier der Wert 0 eingetragen.
Will man statische Werte setzen, so ist hier die Anzahl zu definieren.
Diese Option steht beim ELO JavaClient nicht zur Verfügung.
Static_0=
Definition von Feld und Wert nach dem Schema ELO-nn und durch einen Pipe
getrennt den Wert.
Z.B.:
STATIC_0="ELO-00|Text 0"
STATIC_1="ELO-01|Text 1"
STATIC_2="ELO-DD|12.12.2012"
Diese Option steht beim ELO JavaClient nicht zur Verfügung.
CursorLocation=0
Über diesen Parameter kann der vom DB-Server verwendete Typ des Datensatz
cursors benannt werden.
Diese Option ist z.B. für Zugriff auf eine DB2 Datenbank erforderlich und dann mit
dem Zahlenwert 3 belegt werden.
ProfileType = Report
Dieser Eintrag ist nur erforderlich wenn von Fillup keine Daten gelesen sondern
Daten aus ELO in eine fremde Datenbank geschrieben werden sollen.
In den Feldenr SQL0=…SQL4= ist das entsprechende SQL statement zu
hinterlegen.
isJavaClient = "YES"
© ARIVATO GmbH
Dieser Eintrag ist nur erforderlich in Profilen welche mit dem ELO JavaClient
verwendet werden. Der Parameter hat Auswirkungen auf die Lizenzprüfung und die
Rückgabe der Daten über eine Datei.
DOKinform® FILLup for ELO
Seite 9/26
Stand: 28.05.2015
© ARIVATO GmbH
Ab FillUP Version 3.0 wird das Passwort sowohl bei DSN als auch bei DBCONN Betrieb beim
ersten Programmstart verschlüsselt und dann in der Konfigurationsdatei hinterlegt.
Ein verschlüsseltes Kennwort erkennt man an zwei führenden „@“. Daraus ergibt sich jedoch
eine Einschränkung bei der Wahl des Passwortes: es darf nicht mit „@@“ beginnen.
DOKinform® FILLup for ELO
Seite 10/26
Stand: 28.05.2015
4 Integration in ELO
Die Einbindung in ELO erfolgt per ELOscript (VB bzw. JS), i.d.R. über das Ereignis „Beim
Bearbeiten der Verschlagwortung“ (vgl. Kapitel 8).
Hier kann z.B. beim Verlassen eines bestimmten Feldes in der Verschlagwortung der
entsprechende ELO ActionKey (z.B. 2000 für Feld 0 oder 3000 für den Button (‚Lampe‘) hinter
dem Feld 0) abgefragt werden. Der vom Anwender eingegebene Wert wird als erster Parameter
für den Aufruf von DOKinform® FILLup verwendet.
Ein korrekter Aufruf von Fillup sieht z.B. wie folgt aus:
C:\DOKinform\FillUP\FILLUP.EXE „elo“ „CUSTOMER“ „2000“
Es müssen immer 3 Parameter angegeben werden:
•
•
•
„elo“
„CUSTOMER“
„2000“
Suchbegriff
Konfiguration (Name der Sektion aus Fillup.ini)
2000 + Feldnummer in welcher der Suchbegriff vom Anwender
eingegeben wurde.
In Verbindung mit dem ELO JavaClient ist der Parameter nur mit der
Feldnummer zu belegen.
Über spezielle Rückgabe Werte („exit codes“) kann im aufrufenden Skript gezielt eine weitere
Aktion ausgelöst werden. Folgende Rückgabewerte stehen zur Verfügung:
© ARIVATO GmbH
0 = Erfolg
1 = zu viele Treffer
2 = Benutzer hat mittels „CANCEL“ abgebrochen
3 = Lizenzprüfung u.a. Fehler
4 = Datenbank Verbindung, Anmeldung, Select
5 = Keine Treffer
DOKinform® FILLup for ELO
Seite 11/26
Stand: 28.05.2015
5 Betrieb und Fehlersuche
Wenn DOKinform® FILLup nur einen einzigen Datensatz in der Datenquelle findet, welcher auf
die Suchanfrage passt, werden die Werte sofort in die ELO-Maske übernommen.
Findet DOKinform® FILLup mehrere Datensätze, so werden diese in einer Liste dargestellt und
der Anwender kann einen Datensatz auswählen. Die Liste ist immer nach der ersten Spalte
sortiert. Die Spaltenköpfe und Spaltenbreiten können individuell beeinflusst werden (vgl.
Kapitel 3).
Durch Klick auf OK kann der selektierte Datensatz übernommen werden, mit CANCEL wird der
Vorgang abgebrochen. In beiden Fällen wird das Programm anschließend ordnungsgemäß
beendet.
Sollte es beim Starten des Programms zu einem Fehler kommen, z.B. ungültige
Lizenzdaten, kein ELO installiert, ELO nicht gestartet, kein Anwender in ELO
angemeldet, etc. so wird eine entsprechende Meldung angezeigt. Sofern Sie das
Schreiben einer Logdatei aktiviert haben, finden Sie dort weitere Informationen.
Die Logdatei ist sehr ausführlich und kann somit sehr gut für die Optimierung der Konfiguration
und für die Fehlersuche verwendet werden (vgl. Kapitel 6).
Ab Version 3.0 werden in der Statuszeile des Fensters hilfreiche Parameter angezeigt:
C=
Anzahl der Treffer
S:
Der Suchbegriff (leeres Feld bedeutet Suche nach %)
P:
Name / Bezeichnung des Profils
F:
Filter
© ARIVATO GmbH
Sofern das verwendete Profil für den ELO JavaClient konfiguriert ist wir das links unten
angezeigt:
DOKinform® FILLup for ELO
Seite 12/26
Stand: 28.05.2015
5.1 Interaktiver Filter
Ab Version 4.0 gibt es eine komfortable Filter Funktion. Falls Ihr Suchbegriff eine zu große
Treffermenge ergeben hat, können Sie über eine integrierte Filterfunktion die Daten weiter
reduzieren.
Nach Eingabe eines Filterkriteriums wird über eine Volltext Suche nur noch eine reduzierte
Trefferliste angezeigt. Der Filter wirkt auf alle Spalten der angezeigten Daten.
Zum Aktivieren des Filters geben Sie einen Begriff ein und Klicken auf die Filter
Schaltfläche.
© ARIVATO GmbH
Ab sofort werden nur noch diejenigen Datensätze angezeigt, welche dem Filterkriterium
entsprechen.
Die Anzeigemaske weist auf den aktiven Filter hin (Statuszeile) und bietet die Möglichkeit
über eine Klick auf „Filter entfernen“ zu der ursprünglichen Datenselektion zurückzukehren
und ggf. den Filter neu zu belegen.
DOKinform® FILLup for ELO
Seite 13/26
Stand: 28.05.2015
6 FAQ, Fehlermeldungen, Logfile Analyse
6.1 Falsche Zugangsdaten für die Datenquelle, Berechtigung
Um Daten aus einer Datenquelle (z.B. SQL-Server) Daten übernehmen zu können muss ein
entsprechender Anwender im SQL-Server angelegt werden, dieser muss Rechte in der
entsprechenden Datenbank besitzen (Mindestrecht „Select“).
Die Konfiguration einer solchen Datenbank ist ausführlich in Kapitel 7 erläutert.
Bei fehlerhafter Anmeldung wird DOKinform® FILLup mit einem „Kritischen Systemfehler“
beendet.
Logdatei:
© ARIVATO GmbH
Letzte Programmfunktion war „OpenDB Start“. Details zum Fehler finden sich in err.description
(hier Fehler bei der Anmeldung da Benutzername nicht korrekt).
DOKinform® FILLup for ELO
Seite 14/26
Stand: 28.05.2015
6.2 Falsche Aufrufparameter für Fillup
Aufruf von DOKinform® FILLup wie folgt:
C:\DOKinform\FillUP\FILLUP.EXE „elo“ „xyz“ „2000“
Fehlerhafter oder ungültiger Name für die Konfiguration (2. Parameter), keine entsprechende
Sektion in der Datei Fillup.ini gefunden.
Logdatei:
6.3 Keine bzw. gewünschte Daten nicht gefunden
Logdatei:
Hier kann es hilfreich sein die Zeile mit CompleteSQL näher zu analysieren und evtl. das SQL
Statement direkt in der entsprechenden Datenbank zu testen.
© ARIVATO GmbH
Etwas weiter oben in der Logdatei findet man die einzelnen Bestandteile (aus der Datei
Fillup.ini) des SQL Statements:
DOKinform® FILLup for ELO
Seite 15/26
Stand: 28.05.2015
Aus den Werten SQL1…4 und dem Suchbegriff wird das CompleteSQL zusammengesetzt.
6.4 Daten werden nicht in der gewünschten Form dargestellt
Die Beschriftung der Spaltenköpfe stimmt nicht.
Prüfen Sie hierfür in der Datei Fillup.ini in der entsprechenden Konfiguration (Sektions-Name)
die Einstellungen für Title und ggf. SQL1.
Falls Sie bei SQL1 eine Anweisung der Art
„Select * from ….“
verwenden, stellen Sie um auf
„Select ‚spaltenname1‘, ‚spaltenname2‘, … from…“).
Achten Sie darauf, dass die Reihenfolge der angesprochenen Spalten in der Datenquelle mit der
Reihenfolge der Spaltenköpfe in dem Parameter Title übereinstimmen.
© ARIVATO GmbH
Durch geeignete Konfiguration können „kryptisch“ benannte Spalten aus der Datenquelle in
DOKinform® FILLup mit „sprechenden“ Namen versehen werden.
DOKinform® FILLup for ELO
Seite 16/26
Stand: 28.05.2015
6.5 Fehlerhafte Konfiguration der Selektion / Anzeige
Wenn in der Datei Fillup.ini im Eintrag Title eine größere Anzahl von Namen angegeben ist als
die per SQL selektierte Anzahl von Spalten, dann können die Datensätze nicht dargestellt
werden.
© ARIVATO GmbH
Ist der Wert für kleiner, so werden nicht alle Spalten aus der Datenquelle gelesen. Die restlichen
Spalten sind leer. Diese können Es kommt dadurch jedoch nicht zu einer Fehlermeldung.
DOKinform® FILLup for ELO
Seite 17/26
Stand: 28.05.2015
6.6 Daten werden in die falschen Felder in ELO eingefügt
Wenn die ELO-Maske zwar mit Werten gefüllt wird, diese jedoch in die falschen Indexfelder
geschrieben werden, liegt ein Fehler in der Zuweisungslogik (oder im Aufbau des SQL
Statements, s.o.) vor.
Prüfen Sie dafür in der Datei Fillup.ini die Zuweisungen:
Logdatei:
© ARIVATO GmbH
Hier kann genau verfolgt werden ob das Feld in ELO bereits einen Inhalt hatte, welcher Wert für
dieses Feld aus der Datenquelle gelesen wurde und ob dieser erfolgreich in die ELO Maske
geschrieben wurde.
DOKinform® FILLup for ELO
Seite 18/26
Stand: 28.05.2015
7 Aufbau einer Test- und Entwicklungsumgebung (MS Access)
Für Test, Präsentation, Konfiguration und Entwicklung stellen wir Ihnen eine vereinfachte
Demoumgebung bestehend aus Access-Datenbank, ELO-Maske und ELOscript zur Verfügung.
Erstellen Sie eine System-DSN auf Basis von einer MS-Access Datenbank und verwenden Sie
die Datenbank C:\DOKinform\Fillup\Tools\Fillup.MDB.
Die DSN kann mit Hilfe der mitgelieferten Datei C:\DOKinform\Fillup\Tols\DSN_FillupMDB.REG
erstellt werden.
Falls Sie ein 64 Bit Betriebssystem haben sind Anpassungen (WOW6432 Pfad) erforderlich.
Legen Sie die DSN in diesem Fall manuell oder mittels C:\Windows\SysWOW64\odbcad32.exe
an.
Testen Sie die Verbindung zu dieser Datenquelle mit Hilfe der Batch-Datei
C:\DOKinform\Fillup\Tools\Fillup-test_MDB.BAT
Bei korrekter Konfiguration sehen sie nun einen Dialog wie folgt, welchen Sie mit CANCEL
schließen.
© ARIVATO GmbH
Zur weiteren Konfiguration lesen Sie bitte Kapitel 8.2 ff.
DOKinform® FILLup for ELO
Seite 19/26
Stand: 28.05.2015
8 Aufbau einer Test- und Entwicklungsumgebung (MS SQL Server)
Für Test, Präsentation, Konfiguration und Entwicklung stellen wir Ihnen eine Demoumgebung
bestehend aus Datenbank, ELO-Maske und ELOscript zur Verfügung.
Um diese nutzen zu können entpacken Sie die Datei C:\DOKinform\Fillup\Tools\test.zip in den
Ordner C:\DOKinform\Fillup und führen die auf den folgenden Seiten beschriebenen Schritte
durch.
8.1 Erstellen einer Testdatenbank in MSSQL-Server 2005
© ARIVATO GmbH
Starten Sie Microsoft SQL Server Management Studio (Express)
Melden Sie sich als sa oder Benutzer mit entsprechenden Rechten an.
Im Kontextmenü von „Datenbanken“ wählen Sie „Anfügen“, dann „Hinzufügen“
und wählen die Datenbank C:\DOKinform\FillUp\Test\SQL\FILLUPDEMO.mdf aus und
bestätigen mit OK.
Im Kontextmenü von „Sicherheit\Anmeldungen“ wählen Sie „Neue Anmeldung“
Geben Sie nun als Anmeldename DOKINFORM ein und wählen SQL Server-Authentifizierung.
Wählen Sie das Passwort DOKINFORM und entfernen Sie das Häkchen bei „Kennwortrichtlinie
erzwingen“
DOKinform® FILLup for ELO
Seite 20/26
Stand: 28.05.2015
Wählen Sie nun „Benutzerzuordnung“ und markieren die Datenbank FILLUPDEMO und setzen
das „Standardschema“ auf „dbo“ und bestätigen mit OK.
© ARIVATO GmbH
Wählen Sie nun die Datenbank FILLUPDEMO und im Kontextmenü Eigenschaften und dann
„Berechtigungen“.
DOKinform® FILLup for ELO
Seite 21/26
Stand: 28.05.2015
Erteilen Sie dem Benutzer DOKINFORM das Recht „Select“ um Daten lesen zu können und
bestätigen mit OK.
Zum Testen der Konfiguration rufen Sie aus dem Verzeichnis C:\DOKinform\Fillup\test
die Batchdatei Fillup-Test.bat auf. Falls sich Ihre Installation nicht auf Laufwerk C: oder in
abweichenden Pfaden befindet, passen Sie diese zuerst bitte in der Batchdatei an.
© ARIVATO GmbH
Bei korrekter Konfiguration sehen sie nun einen Dialog wie folgt, welchen Sie mit CANCEL
schließen.
DOKinform® FILLup for ELO
Seite 22/26
Stand: 28.05.2015
8.2 ELO
8.2.1 Importieren der Ablagemaske
Erstellen Sie ein neues ELO Archiv mit dem Namen DOKINFORM. Bei Verwendung eines anderen
Archivnamens oder eines bereits existierenden Archives muss in dem ELO-Skript DOKINFORM.VBS
(in der Zeile beginnend mit „RunInArc….“) der Archivname entsprechend angepasst werden.
Importieren Sie aus dem Verzeichnis C:\DOKinform\FillUp\test\ELO die Demo-Maske mit dem
Namen „10 - Customer“ samt Stichwortliste in Ihr Archiv.
In dem ELO-Ordner „DOKinform Tools\FillUp“ befindet sich nun ein Dokument, die
entsprechende Maske ist mit importiert worden. Die Berechtigung ist standardmäßig auf
Vollzugriff für den Benutzer „Administrator“ gesetzt. Andere Benutzer sehen dieses Dokument
nicht, neue Dokumente werden ebenso statisch in diesen Ordner abgelegt.
© ARIVATO GmbH
Die ELO-Maske hat folgenden Aufbau:
DOKinform® FILLup for ELO
Seite 23/26
Stand: 28.05.2015
8.2.2
ELO Windows Client: Einbinden des Skriptes DOKINFORM.VBS
Kopieren Sie das das Script DOKINFORM.VBS aus dem Ordner C:\DOKinform\FillUp\Script in Ihr
ELOscripts Verzeichnis (ab ELOprofessional 7.0 bitte entsprechend in ELO importieren).
Passen Sie in dem Script in Zeile 27/28 die Konstante ELOproduct entsprechend Ihrer ELO
Version an. Die Standard Einstellung lautet für ELOoffice.
Bitte starten Sie den ELO Client neu.
Wählen Sie unter „Systemverwaltung\Skript\Skriptaufrufe“ das Skript DOKINFORM.VBS beim
Ereignis „Beim Bearbeiten der Verschlagwortung“ aus und bestätigen mit OK.
8.2.3
ELO JavaClient: Einbinden der Skripte
Kopieren Sie das das Script VERSCHLAGWORTEN.JS und lib_FillUP.JS aus dem Ordner
C:\DOKinform\FillUp\Script in Ihr „Java Client Scripting Base“ Verzeichnis im ELO Archiv.
© ARIVATO GmbH
Alternativ zur Verwendung des Scriptes Script VERSCHLAGWORTEN.JS können Sie lib_FillUP.JS in
ein vorhandenes Verschlagwortungs Script Ihrer Wahl integrieren.
DOKinform® FILLup for ELO
Seite 24/26
Stand: 28.05.2015
Passen Sie nun in lib_FillUP.JS die Funktionen zur Anzeige der Schaltfläche entsprechend Ihrer
ELO-Maske an.
Bei Klick auf die Schaltfläche wird die Funktion „BTN_FillUP_1“ aufgerufen.
Diese passen Sei entsprechend den gewünschten Fillup Profil an.
© ARIVATO GmbH
Laden Sie nun mit „STRG-ALT-R“ die Skripte neu.
Beim Öffnen der Verschlagwortungsmaske sollten Sie nun die Schaltfläche sehen:
DOKinform® FILLup for ELO
Seite 25/26
Stand: 28.05.2015
9 Beispiel fillup.ini
[Database]
[Prog]
Language="deutsch"
MaxPostBoxEntriesAllowed="100"
LogDir="c:\dokinform\fillup\log"
FileName="FillUp"
[CUSTOMER-NAME]
ProfileName = "Datenzugriff über NAME auf SQL-Server"
ConnectionType =DBConn
DBconn=Driver={SQL Server};Server=MyServer;Datatabase=CRM;Trusted_Connection=yes;
MaxHits="100"
Logging="YES"
LogLevel=9
Name="10 - Customer"
AppendToFillupField="NO"
SaveRestoreIndexData="NO"
SQL1="Select Name1, Name2, Custno, Country, ZIP, City, Street from CRM.dbo.CUSTOMER "
SQL2 = " WHERE (NAME1 LIKE '%"
SQL3 = ""
SQL4 = "%')"
Title = "Name1|Name2|Custno|Country|ZIP|City|Street"
Columns= "180|180|50|60|40|120|170"
SQL_0="ELO-01"
SQL_1="ELO-02"
SQL_2="ELO-06"
SQL_3="ELO-03"
SQL_4="ELO-04"
SQL_5="ELO-05"
SQL_6="ELO-xx"
; Deactivate ShortDef by setting by commenting the line
; ShortDef="ELO-00 / ELO-03 / ELO-01"
ShortDef="ELO-05 / ELO-00 / ELO-01"
ShortSeparator = " / "
; DefCountStatic=0 deactivate static values
DefCountStatic=0
STATIC_0="ELO-00|Text 0"
STATIC_1="ELO-01|Text 1"
STATIC_2="ELO-DD|12.12.2012"
[MDB-TEST]
ProfileName = "Testprofil Access DB"
ConnectionType = "DSN"
DSN="FillupMDB"
user="admin"
PW=""
MaxHits="100"
Logging="YES"
LogLevel=9
Name="Freie Eingabe"
AppendToFillupField="NO"
SaveRestoreIndexData="NO"
SQL1="Select Name, Name2, Kdnr, Land, PLZ, Ort, Strasse from CUSTOMER "
SQL2 = " WHERE (NAME LIKE '%"
SQL3 = ""
SQL4 = "%')"
Title = "Name|Name2|Kd.-Nr.|Land|PLZ|Ort|Strasse"
Columns= "180|180|50|60|40|120|170"
DefCount="5"
SQL_0="ELO-xx"
SQL_1="ELO-xx"
SQL_2="ELO=xx"
SQL_3="ELO-xx"
SQL_4="ELO-xx"
SQL_5="ELO-xx"
SQL_6="ELO-xx"
© ARIVATO GmbH
ShortDef="ELO-05 / ELO-00 / ELO-12 / ELO-01"
ShortSeparator = " / "
DOKinform® FILLup for ELO
Seite 26/26
Stand: 28.05.2015