Der combit address manager Webclient

Transkript

1 combit GmbH Untere Laube Konstanz Der combit address manager Webclient Einführung Der address-manager.net Webclient ist eine Beispiel-Anwendung für die address manager Scripting- Technologie. Der Client demonstriert den Zugriff auf eine address manager Datenbank über das Internet. Grundlage ist dabei die mitgelieferte Datenbank test.dbf. Das Beispiel wird im Source-Code (Active Server Pages mit VBScript) ausgeliefert. Es ist ausdrücklich erwünscht, dieses im Rahmen der Lizenzbedingungen (s.u.) für eigene Implementationen zu verwenden. Hierbei sind je nach Anforderungen kleinere Anpassungen und Konfigurationen notwendig. Dieses Dokument beschreibt die bestehende Möglichkeiten des Webclients sowie die ggf. Anpassungen. Die Anpassungen setzen Kenntnisse in ASP und VBScript voraus. Beachten Sie, dass Sie den Source-Code sowie die mitgelieferten Grafiken nur im Rahmen eines address manager Webclients verwenden dürfen. Der Webclient in Aktion Im folgenden haben wir Ihnen einige Screenshots des address-manager.net Webclients zusammengestellt, die einen Teil der vielen Möglichkeiten aufzeigen sollen. Jeder Benutzer muss sich vor der Benutzung mit Benutzernamen und Passwort authentifizieren. Zudem kann die gewünschte Datenbank gewählt werden. Copyright combit GmbH 1

2 Das Hauptfenster verfügt über eine übersichtliche Toolleiste mit den wichtigsten Funktionen sowie ein Menü. Die Beispielmaske wurde der test.dbf nachempfunden. Auch die Menüs wurden dem "echten" address manager nachempfunden und mit den gleichen Symbolen versehen. Eine spezielle Einarbeitung kann daher entfallen. Copyright combit GmbH 2

3 Der allgemeine Extrakt zum Filtern von Datensätzen. Der Index-Extrakt. Gesetzte Codes werden in einem eigenen Dialog angezeigt und lassen sich beliebig ändern/ neu setzen. Copyright combit GmbH 3

4 Alle Kunden-Kontakte im Kontakt-Container werden übersichtlich und mit den bekannten Symbolen dargestellt. Auch neue Kontakte lassen sich einfach hinzufügen. Im Dokumenten-Container abgelegte Dateien lassen sich nicht nur anzeigen sondern auch direkt auf den lokalen Rechner downloaden. Copyright combit GmbH 4

5 Der Listen-Druck ermöglicht die Ausgabe der gesamte Datenbank oder auch nur des erstellten Extraktes in verschiedenen Formaten. Hier die HTML-Version direkt im Browser-Fenster. Der gleiche Ausdruck in der RTF-Version. Ist MS Word auf dem PC installiert, wird die RTF-Datei direkt im Browser-Fenster angezeigt und kann dort z.b. weiterbearbeitet, gedruckt oder gespeichert werden. Copyright combit GmbH 5

6 Und noch einmal der gleiche Ausdruck, diesmal betrachtet im mitgelieferten ActiveX PlugIn. Vorteil dieses PlugIns: Sie können die Listen über das Internet in der selben Qualität ausdrucken, wie Sie dies sonst an Ihrem Arbeitsplatz machen würden. Auch Zoomen, Blättern oder der Versand per sind möglich. Copyright combit GmbH 6

7 Betriebsvoraussetzungen Zum Betrieb des Webclients sind Server-seitig folgende Voraussetzungen zu erfüllen: Microsoft Internet Information Server (IIS) ab Version 4.0 Installierter address manager ab Version 2001 Zugriff auf die zentralen address manager Datenbanken Client-seitig sind die folgenden Voraussetzungen zu erfüllen: Microsoft Internet Explorer ab Version 4.0 (eine Netscape-kombatible Version befindet sich in Vorbereitung) Aktiviertes JavaScript Aktivierte Cookies (session+persistent) Installation Installieren Sie das mitgelieferte Programmm amnet.exe in ein Verzeichnis Ihrer Wahl auf dem Webserver. Richten Sie das Verzeichnis als neue Site oder virtuelles Verzeichnis innerhalb einer bestehenden Site ein. Die Erstellung einer eigene IIS-Application ist nicht notwendig, der Webclient nutzt keine eigene global.asa. Beachten Sie, dass der address manager auf dem Webserver installiert sein muss, damit dieser durch die ASP instanziert werden kann. Sofern der Webserver auch als Programm-Server für den regulären address manager Betrieb dient, wird dies durch die bestehende Lizenz abgedeckt. Sofern es sich um einen zusätzlichen Server handelt, ist eine zusätzliche Netzwerk-Lizenz notwendig, vgl. Kapitel Lizensierung weiter unten. Copyright combit GmbH 7

8 Was leistet das mitgelieferte Beispiel? Folgende Feature sind im address-manager.net Webclient bereits enthalten: Auswahl einer Datenbank aus dem Datenbank-Verzeichnis Login mit Benutzernamen und Passwort Anzeige eines nachempfundenen address manager Fensters mit Toolbar/ Navigation mit den wichtigsten Funktionen Menü mit analogen Einträgen und Symbolen Anzeige einer Eingabemaske mit den zwei Registerkarten Stammdaten und Zusätze Navigieren zwischen Datensätzen (Vor, Zurück, Anfang, Ende) Ändern und Speichern von Datensätzen (inkl. pessimistischer Datensatz-Sperrung bei Beginn der Änderung) Neuanlage Schnell-Suche Normale Suche Auswahl der Sortierung/ Index Extrakt/ Filter Allgemein Index-Extrakt/ -Filter Ausgabe/ Druck als LL-Datei, d.h. Ausdruck auf dem lokalen Drucker ohne Qualitätsverlust durch integriertes ActiveX PlugIn Ausgabe/ Druck als HTML-Datei (Export) Ausgabe/ Druck als RTF-Datei (Export) Anzeige und Änderung von Code-Feldern Anzeige von Kontakt-Containern mit den Symbolen aus dem address manager Hinzufügen von neuen Kontakten Anzeige von Dokumenten-Containern und inkl. Download der hinterlegten Dateien auf den lokalen Rechner Copyright combit GmbH 8

9 Welche Konfigurationen müssen vorgenommen werden? Wenn Sie einen eigenen Webclient für Ihre Daten anbieten wollen, müssen je ggf. einige Änderungen/ Konfigurationen vorgenommen werden. Kentnisse in Active Server Pages und VBScript werden vorausgesetzt. Übersicht der Dateien Im folgenden finden Sie eine Übersicht aller mit dem Beispiel ausgelieferten Dateien. Die fett markierten Dateien müssen dabei ggf. angepasst werden (s.u.). \ \dialogs\ \grafix\ card.asp css.asp default.asp dologout.asp frameset.asp login.asp nav.asp splash.asp statusbar.asp about.asp addcodes.asp addcontact.asp codes.asp contacts.asp docus.asp filter.asp help.asp index.asp indexfilter.asp llview.asp locate.asp print.asp seek.asp waitforfile.asp Eingabemaske Zentrales Cascading Stylesheets (CSS) Include Startseite, Frameset Wird aufgerufen, wenn die Session abgelaufen ist Frameset für Eingabemaske, Navigation und Statusleiste Login-Scripts, keine HTML-Ausgabe (Redirect) Navigation/ Toolbar Login-Seite Statusleiste Über/ Info Code-Feld ändern Kontakt hinzufügen Code-Feld anzeigen Kontakt-Container anzeigen Dokumenten-Container anzeigen Extrakt Allgemein Hilfe Sortierung wählen Index-Extrakt Anzeige einer LL-Datei (ActiveX PlugIn) Normale Suche Drucken Schnell-Suche Warte-Dialog (für Druck) \includes\ \mascs\ \temp\ *.* Diverse Grafiken dbfunctions.asp dhtmllib.js management.as p menu.asp navcond.js scripts.asp additional.asp main.asp Datenbank-Funktionen JavaScript für das DHTML Menü Grundlegende Funktionen für das Session-Management, wird von jeder Seite included Die Definition/ Konfiguration des DHTML Menüs JavaScript für das DHTML Menü Diverse Scripts für die Eingabemaske und die Navigation Registerlasche Stammdaten Registerlasche Zusätze *.* Diverse temporäre Dateien (z.b. für den Druck und den Download aus Dokumenten-Container) Copyright combit GmbH 9

10 Durchführung der Anpassung management.asp Damit die Liste der verfügbaren Datenbank, der Benutzer, etc. aufgebaut werden kann, müssen in dieser Datei die drei folgenden Pfade angegeben werden. Alle Pfade müssen dabei mit einem Backslash abgeschlossen werden: amwpath amwdbpath amwprintpath main.asp Pfad des address manager Installationsverzeichnisses Pfad des Datenbankverzeichnisses Pfad des Druckverzeichnisses Die Datei main.asp enthält die Registerlasche Stammdaten. Die in der Maske vorhandenen Eingabefelder werden dabei als INPUT Tags nachgebildet. Wichtig ist dabei a) das NAME Attribut sowie b) das VALUE Attribut. NAME muss amw_ + address manager Feldname lauten. VALUE muss die ASP Anweisung <%=fld(feldname)%> lauten, wobei FELDNAME durch den address manager Feldnamen zu ersetzten ist. Anpassungen sollten auf Basis der bestehenden Felder per Copy&Paste vorgenommen werden. additional.asp Die Registerlaschen Zusätze sowie Datensatz-Infos der test.dbf wurden in dieser Seite zusammengefasst. Die Änderungen sind analog zu main.asp vorzunehmen. card.asp Diese Seite included die Masken main.asp und additional.asp und fasst diese in einer einzigen (D)HTML-Seite zusammen. Sofern weitere Masken hinzugefügt werden, sind diese in dieser Datei entsprechend dem vorhandenen Schema einzufügen. statusbar.asp Auch diese Seite included die beiden Masken-Dateien. statusbar.asp ist für den ständigen Daten- Austausch zwischen Server und Client verantwortlich und wird statt card.asp bei jeder Änderung des Datensatzzeigers aktualisiert. Auch hier sind ggf. hinzugefügte Masken entsprechend dem vorhandenen Schema einzufügen. Copyright combit GmbH 10

11 Einstellungen für den Internet Information Server Nachfolgende Screenshots zeigen die Einstellungen des Internet Information Server 5.0 (betrieben auf einem Windows 2000 Advanced Server), wie er unter "live" zu sehen ist: Copyright combit GmbH 11

12 Copyright combit GmbH 12

21 Lizensierung Für die Verwendung eines eigenen address-manager.net Clients gelten die folgenden lizenzrechtlichen Voraussetzungen: Das gezeigte Beispiel wird im Source Code (Active Server Pages/ VBScript) zusammen mit dem address manager ausgeliefert. Das Beispiel basiert auf der address manager Scripting Technologie sowie der mitgelieferten Datenbank test.dbf. Sollte eine andere Datenbankstruktur verwendet werden, sind geringfügige Änderungen/ Konfigurationen notwendig. Diese Änderungen sind nicht Bestandteil des mitgelieferten Beispieles. Der Webclient ist nur in den Netzwerkversionen verfügbar und ist nur in Verbindung mit dieser zu verwenden. Erlaubt ist innerhalb der regulären Lizenzbestimmungen der nicht öffentliche Zugriff durch personifizierte Benutzer. Dabei darf jeder Benutzer nur einmal über den Webclient angemeldet sein. Andere Lizensierungsarten auf Anfrage. Der address manager muss auf dem Webserver installiert sein. Sofern der Webserver auch als Programm-Server für den regulären address manager Betrieb dient, wird dies durch die bestehende Lizenz abgedeckt. Sofern es sich um einen zusätzlichen Server handelt, ist eine zusätzliche Netzwerk-Lizenz notwendig. Pro Netzwerk-Lizenz ist also nur eine Installation erlaubt. Weitere Informationen entnehmen Sie bitte auch dem combit Lizenzvertrag, der Ihrem Produkt beiliegt oder auch im Internet unter eingesehen werden kann. Hinweis: combit macht keine Angaben zu einer bestimmten Eignung obiger Informationen. Irrtümer und Fehler bleiben ausdrücklich vorbehalten, die Angaben erfolgen ohne Gewähr und enthalten keine Zusicherung. Die Informationen können z.t. auch ein Versuch sein, Ihnen bei einer Aufgabenstellung zu helfen, selbst wenn das Produkt eigentlich nicht für diesen speziellen Zweck vorgesehen wurde. Copyright combit GmbH 21