Frage:
Ist es möglich, den DocuWare Web Client mit meinen anderen Anwendungen zu integrieren?
Antwort:
Der Web Client bietet eine einzigartige Möglichkeit zur Integration in jede Anwendung, indem er eine spezielle URL verwendet, über die Dokumente heruntergeladen, gesucht oder angezeigt werden können.
Die Anwendung, in die Sie integrieren möchten, muss in der Lage sein, diese spezielle URL in dem von DocuWare benötigten Format zu generieren.
Die URL-Integration ist Teil des SDK-Pakets. Wenn Sie also Zugang zu diesen Handbüchern und Dokumentenrichtlinien haben und gleichzeitig Unterstützung erhalten möchten, müssen Sie das SDK-Paket erwerben. Für weitere Informationen zum Produkt wenden Sie sich bitte an Ihren DocuWare-Partner.
Die Absicht dieses Artikels ist es, Ihnen zu zeigen, wie Sie die URL-Integration im Web Client aktivieren und wie Sie sie mit einem Programm namens URL Creator testen können. Der URL-Creator wird mit dem SDK-Paket geliefert.
- Sie benötigen eine Webinstanz, die in der DocuWare-Administration angelegt wurde. Die Webinstanz kann mit der Read Only-Lizenz des Web Clients konfiguriert werden, wenn Sie nur Dokumente abrufen und anzeigen möchten.
Bitte achten Sie besonders auf das Zielverzeichnis und die http-Adresse. Diese werden später bei der Konfiguration Ihrer URL im URL-Creator benötigt.
- Klicken Sie mit der rechten Maustaste auf die Webinstanz und wählen Sie "Neue Integration erstellen".
- Ordnen Sie ein beliebiges Paar von Archiv und Ergebnisliste zu, das in der ausgewählten Webinstanz verfügbar ist.
Bitte beachten Sie die von Ihnen angegebene Kennung, da sie später benötigt wird.
- Neustart des IIS (Internet Information Services)
- Öffnen Sie nun das Tool URL Creator (UrlCreator.exe), um zu testen, ob die Einstellungen der Web Client Integration zugänglich sind. Dieser URL Creator ist Teil des SDK-Pakets.
Der FAQ-Artikel behandelt nur eine sehr einfache Konfiguration, deshalb lesen Sie bitte das Handbuch, das mit dem SDK-Paket geliefert wird, für eine detaillierte Liste aller Parameter und Optionen. - DocuWare URL Creator - Registerkarte URL-Typ
- DocuWare URL Creator - Registerkarte Allgemeine Parameter
1 = Dies ist typischerweise der Name des Servers, auf dem der Web Client läuft, aber es kann auch eine eigene URL sein (z.B.: www.domainname.com). Dies kann in der DocuWare-Administration unter "System -> Webverbindungen" -> "Interne Adresse" überprüft (und definiert) werden.
2 = Dies ist der Name des Zielverzeichnisses (siehe Schritt 1).
3 = Je nachdem, wie der Web Client konfiguriert ist, können Sie die URL entweder über die Windows-Authentifizierung verwenden lassen oder einen DocuWare-Benutzer angeben, dessen Anmeldeinformationen verwendet werden.
4 = Zur Verbesserung der Sicherheit können Sie eine Passphrase verwenden, die zunächst in der DocuWare-Administration eingestellt werden muss (siehe Schritt 1).
- DocuWare URL Creator - Registerkarte Integrationsparameter
1 = Dies ist der Identifikator, den Sie in Schritt 3 definiert haben.
2 = Wählen Sie den Integrationstyp der URL aus.
3 = Dies ist die GUID der Ergebnisliste, die verwendet wird. Rufen Sie in der DocuWare-Administration die gewünschte Ergebnisliste auf, um deren GUID zu sehen. Bitte stellen Sie sicher, dass Benutzer, die auf diese Integration zugreifen, Zugriff auf diesen Dialog haben.
5 = Dies ist die Abfrage, die von der Integration ausgeführt wird. Die notwendige Syntax wird im Handbuch erläutert.
- DocuWare URL Creator - Registerkarte Andere Parameter
- Generieren Sie die URL mit der entsprechenden Schaltfläche und öffnen Sie sie anschließend, um sie zu testen.
Dies ist die allgemeine Syntax, die Ihre Anwendung bei der Generierung Ihrer URL befolgen muss.
Der URL Creator an sich ist nur ein Werkzeug, um die Möglichkeiten der URL-Integration zu demonstrieren und die serverseitigen Einstellungen zu testen, was Sie immer tun sollten, bevor Sie mit dem Erstellen Ihrer eigenen URL beginnen.
Sie können dieses Tool auch verwenden, um die URL, die Sie in Ihrer Anwendung erstellt haben, zu analysieren, um deren Konfiguration zu überprüfen.
Wenn mehr als ein Dokument zurückgegeben wird, wird Ihnen die Ergebnisliste angezeigt, die Sie in Ihrer URL-Integration definiert haben. Andernfalls wird das Dokument direkt geöffnet (allerdings mit den Einstellungen der Ergebnisliste).
Sobald Sie sich in der Ergebnisliste befinden, können Sie ein Dokument öffnen und die meisten Funktionen des Viewers sind verfügbar. Dies kann je nachdem, welche Art von Webinstanz Sie als Grundlage für die Integration verwendet haben (regelmäßig oder schreibgeschützt), unterschiedlich sein.
