DOKinform DirectSearch für ELOprofessional, ELOenterprise JAVA Client. Dokumentation

Transkript

1 DOKinform DirectSearch für ELOprofessional, ELOenterprise JAVA Client Dokumentation

2 Impressum Version: 1.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 DirectSearchJAVA Seite 1/10

3 Inhaltsverzeichnis 1 Einleitung Installation Individuelle Konfiguration Erweiterte Konfiguration Verwendung regulärer Ausdrücke Betrieb und Fehlersuche...9 DOKinform DirectSearchJAVA Seite 2/10

4 1 Einleitung Diese Dokumentation beschreibt die Installation und die erforderlichen Einstellungen für den Betrieb mit Ihrem ELO-Archiv. DOKinform DirectSearch arbeitet als sog. Tray-Programm und reagiert auf bestimmte Tastenkombinationen (Hotkeys). Je nach Hotkey wird aus einer anderen Anwendung ein Suchbegriff extrahiert und mit diesem Begriff in ELO eine Suche durchgeführt. Das Ergebnis der Suche wird in ELO angezeigt. Über individuell konfigurierbare Hotkeys, bietet DOKInform DirectSearch die Möglichkeit, aus praktisch jeder Windows Applikation eine Suche in ELO durchzuführen. DOKinform DirectSearchJAVA Seite 3/10

5 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 können Sie DirectSearch starten. 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 DirectSearch) 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 (DirectSearch.lic) in den DirectSearchJAVA 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). DOKinform DirectSearchJAVA Seite 4/10

6 3 Individuelle Konfiguration Um die Funktionsweise von DOKinform DirectSearch an Ihre individuellen Wünsche anzupassen, können Sie die Konfigurationsdatei directsearch.ini mit einem Editor (z.b. Notepad) bearbeiten. Die einzelnen Werte haben folgende Bedeutung: Parameter für das Programm [Prog] HotKeyExit Legen Sie hier eine Tastenkombination zum Beenden von DirectSearchJAVA fest. Der Eintrag NOHOTKEY bewirkt, dass man das Programm nur über das Menü beenden kann (Standardvorgabe). HotKeyExit_text Anzeigetext für Beenden Logging="YES" Werte: YES / NO LogPath="c:\DOKinform\DirectSearchJAVA\log" Verzeichnis für logging URL http-url zur Navigation zur Produktseite auf Als Hotkey ist praktisch jede beliebige Tastenkombination (keine Maus-Clicks) möglich. Bitte bedenken Sie bei der Wahl eines Hotkey, dass dieser systemweit gilt und somit evtl. Funktionen in Ihrem Programm überlagert. Diese sind dann nicht mehr über die gewohnte Tastenkombination zugänglich. Eine Syntax Beschreibung der möglichen Hotkeys finden Sie direkt in der Datei DirectSearch.ini. DOKinform DirectSearchJAVA Seite 5/10

7 Die Einstellungen für Hotkey1 und Hotkey2 erfolgen analog. HotKey1 Taste / Tastenkombination zum Auslösen der ersten Suchfunktion HotKey1_text Anzeige eines Beschreibungstextes für dieses Hotkey. ACHTUNG: dieser Wert muss in der entsprechenden language.xxx Datei eingetragen werden. HotKey1_send Zu sendende Tastenkombination. Mehrere nacheinander folgende Tastenanschläge werden durch ein (pipe, Alt+0124) Zeichen getrennt. HotKey1_delay Falls Ihre Anwendung sehr träge auf Tastatureingaben reagiert, können Sie hier eine Wartezeit in Millisekunden einstellen. Diese wird von DirectSearch als Pausenzeit zwischen zwei Tastencodes verwendet. HotKey1_Mask Name der ELO-Maske mit welcher die Suche erfolgen soll. HotKey1_fieldName Anzeigename des ELO Maskenfeldes in welchem gesucht werden soll. HotKey1_field Wenn Sie hier SHORT eintragen wird die Suche Masken übergreifend in der Kurzbezeichnung durchgeführt. Für eine Suche in einer bestimmten Maske und einem bestimmten Feld lassen Sie dieses Feld leer. HotKey1_regexp Regulärer Ausdruck zum Filtern des erkannten Suchbegriffes. DOKinform DirectSearchJAVA Seite 6/10

8 Hotkey3 ist für die ELO isearch reserviert und erfordert nur folgende Konfiguration: HotKey3 Taste / Tastenkombination zum Auslösen der ersten Suchfunktion HotKey3_text Anzeige eines Beschreibungstextes für dieses Hotkey. ACHTUNG: dieser Wert muss in der entsprechenden language.xxx Datei eingetragen werden. HotKey3_send Zu sendende Tastenkombination. Mehrere nacheinander folgende Tastenanschläge werden durch ein (pipe, Alt+0124) Zeichen getrennt. HotKey3_delay Falls Ihre Anwendung sehr träge auf Tastatureingaben reagiert, können Sie hier eine Wartezeit in Millisekunden einstellen. Diese wird von DirectSearch als Pausenzeit zwischen zwei Tastencodes verwendet. DOKinform DirectSearchJAVA Seite 7/10

9 4 Erweiterte Konfiguration Dieses Kapitel beschreibt Möglichkeiten der speziellen Anpassung. Diese setzen umfangreiche Systemkenntnisse voraus und sind somit i.d.r. nicht für Endanwender geeignet. Bitte kontaktieren Sie Ihren DOKinform Partner für Unterstützung. 4.1 Verwendung regulärer Ausdrücke Falls der extrahierte Suchbegriff unerwünschte Zeichen enthält welche bei der Suche stören, so können diese mit Hilfe von regulären Ausdrücken entfernt werden. Beispiel: In einem Maskenfeld Ihres ERP-Systems steht der Wert R4711. Das R steht für Rechnung, 4711 ist die Nummer der Rechnung. In ELO haben Sie in der Verschlagwortung ein Feld mit der Belegart, hier steht Rechnung drin und ein Feld mit der Belegnummer, hier steht 4711 drin. Wenn Sie nun nach 4711 suchen wollen, muss vorher das R entfernt werden. Dafür können Sie den Regulären Ausdruck \d{4} verwenden. Dieser übernimmt aus dem Suchfeld nur den numerischen Anteil und davon nur 4 Zeichen, also Details zu regulären Ausdrücken finden Sie im Internet z.b. unter Konfiguration DirectSearch: Öffnen Sie die Konfigurationsdatei DirectSearch.ini. Sofern noch nicht vorhanden, fügen Sie in der Sektion [PROG] an beliebiger Stelle folgende Zeile(n) ein: HotKey1_regexp= HotKey2_regexp= HotKey3_regexp= Nach dem Gleichheitszeichen fügen Sie den gewünschten regulären Ausdruck ein. DOKinform DirectSearchJAVA Seite 8/10

10 5 Betrieb und Fehlersuche Beim Start des Programmes wird ein Splash angezeigt und ein Symbol im Windows Systemtray eingeblendet. Über eine Sprechblase zeigt das Programm die aktuell eingestellten Parameter für die Suche an. 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. Das Symbol lässt sich mit der Maus (linke oder rechte Taste) anklicken. In dem nun angezeigten Menü können Sie weitere Informationen abrufen oder das Programm beenden. DOKinform DirectSearch: Navigation zu der Produkt-Homepage (über Microsoft InternetExplorer, wird bei Bedarf direkt gestartet) Lizenzdaten: Anzeige der Lizenzdaten DOKinform DirectSearchJAVA Seite 9/10

11 Information: Anzeige der aktuell eingestellten HotKeys Beenden: beendet das Programm DOKinform DirectSearchJAVA Seite 10/10