DocuWare wird sowohl als Cloud- als auch als On-Premise-Installation unterstützt — welcher Weg für Sie gilt, hängt davon ab, wie Ihre Organisation DocuWare betreibt.
Voraussetzungen
DocuWare Cloud | Eine aktive DocuWare-Cloud-Organisation und Administratorrechte, um eine App-Registrierung anzulegen. |
DocuWare On-Premise | Zugriff auf Ihren DocuWare-Server, um dort den Silvernova-Connector zu installieren, sowie ein DocuWare-Benutzerkonto (Benutzername/Passwort), das Silvernova verwenden darf. Der DocuWare-Server muss dafür nicht aus dem Internet erreichbar sein. |
Nur für DocuWare Cloud
Für DocuWare On-Premise überspringen Sie diesen Abschnitt — es wird keine App-Registrierung benötigt, Sie melden sich in Silvernova direkt mit Ihren DocuWare-Zugangsdaten an (siehe Schritt 3).
1. Einrichten auf DocuWare-Seite
App-Registrierung anlegen
Öffnen Sie in DocuWare das Profilmenü oben rechts und wählen Sie Configurations
Klicken Sie unter Integrations auf App Registration.
Falls noch keine Registrierung für Silvernova existiert: Create Application Registration.
Wählen Sie als Anwendungstyp „Web application" — nur dieser Typ stellt das Client Secret bereit, das Silvernova für die Anmeldung benötigt.
Tragen Sie als Redirect-URI exakt ein:
https://api.silvernova.ai/connectivity/auth/callback
Speichern Sie die Registrierung und generieren Sie ein Client Secret. Kopieren Sie es sofort — es wird nur einmal angezeigt.
Öffnen Sie im Bereich General der Registrierung die Application (Client) ID und kopieren Sie auch diese.
Wichtig: Redirect-URI genau übernehmen: Die Redirect-URI muss zeichengenau https://api.silvernova.ai/connectivity/auth/callback lauten — ohne abschließenden Schrägstrich. Weicht sie ab, meldet DocuWare beim Verbinden den Fehler „invalid_request: Invalid redirect_uri".
Sie haben nun zwei Werte notiert, die Sie gleich in Silvernova eintragen:
Client ID (aus dem Bereich „General")
Client Secret (aus dem Generierungs-Dialog)
2. Buchen der DocuWare-Erweiterung in Silvernova
Melden Sie sich unter app.silvernova.ai an oder legen Sie ein Konto an.
Öffnen Sie die Einstellungen (Zahnrad-Symbol) und wechseln Sie zu Add-ons.
Suchen Sie im Bereich Erweiterungen die Kachel DocuWare und klicken Sie auf Buchen. Bestätigen Sie im Dialog.
3. Einrichten der DocuWare-Erweiterung
Öffnen Sie unter Anbindungen den Eintrag DocuWare und wählen Sie zunächst den passenden Modus.
Modus wählen
Wählen Sie Cloud oder On-Premise, je nachdem, wie Ihre Organisation DocuWare betreibt.
Cloud
Admin-Konfiguration (einmalig, pro Organisation)
Server-URL Ihrer DocuWare-Organisation eintragen, z. B.
https://ihre-organisation.docuware.cloud. Tragen Sie nur die Adresse bis zum Servernamen ein, ohne/DocuWareoder weitere Pfadangaben am Ende.OAuth Client ID eintragen (aus Schritt 1).
OAuth Client Secret eintragen (aus Schritt 1).
Speichern.
Nutzer-Konfiguration (pro Person)
Zum Tab Nutzer-Konfiguration wechseln.
Auf Konto verbinden klicken.
Sie werden zu DocuWare weitergeleitet — dort mit Ihren gewohnten DocuWare-Zugangsdaten anmelden.
Nach erfolgreicher Anmeldung führt DocuWare Sie zurück zu Silvernova.
On-Premise
Richten Sie On-Premise in dieser Reihenfolge ein: zuerst die Admin-Konfiguration, dann den Connector, zuletzt die Nutzer-Konfiguration.
Admin-Konfiguration (einmalig, pro Organisation)
Server-URL Ihres DocuWare-Servers eintragen — nur Protokoll und Servername, ohne
/DocuWaream Ende.
Richtig:https://dms.ihre-organisation.de
Falsch:https://dms.ihre-organisation.de/DocuWareSpeichern. Es werden keine Client-ID/Secret benötigt.
Connector installieren
Für On-Premise-Umgebungen benötigt Silvernova ein Programm, das auf demselben Server installiert werden muss, auf dem DocuWare installiert ist. Darüber stellt Silvernova die Verbindung zu Ihrem DocuWare-Server her:
Installationsprogramm über die Konfigurationsseite herunterladen.
Installer starten, Lizenzbedingungen akzeptieren.
Installation abschließen — es sind keine weiteren Angaben nötig.
Nutzer-Konfiguration (pro Person)
Zum Tab Nutzer-Konfiguration wechseln.
DocuWare-Benutzername und -Passwort eintragen.
Speichern.
Wichtig: Silvernova prüft Ihre Zugangsdaten über den installierten Connector. Ist der Connector noch nicht installiert oder nicht gestartet, erscheint beim Speichern die Meldung, dass die Anmeldung fehlgeschlagen ist — auch wenn Benutzername und Passwort stimmen.
Akten statt Archive anzeigen (optional)
In DocuWare gehören Dokumente nicht über Ordner, sondern über ein Indexfeld wie die Aktennummer zu einer Akte. Ohne weitere Einstellung zeigt der Import deshalb Ihre DocuWare-Archive und darin einzelne Dokumente. Damit der Import stattdessen Ihre Akten anzeigt, tragen Sie in der Admin-Konfiguration im Bereich Akten drei Angaben ein:
Akten-Archiv: der Name des Archivs, in dem Ihre Akten liegen, z. B.
Aktenverwaltung.Feld für die Aktennummer: der Name des Indexfelds mit der Aktennummer, z. B.
Akten-Nr.Feld für die Aktenbezeichnung: der Name des Indexfelds mit der Aktenbezeichnung, z. B.
Akten-Name
Speichern Sie die Einstellungen. Der Import zeigt danach die Aktennummern dieses Archivs. Über das Suchfeld finden Sie eine Akte anhand des Anfangs ihrer Aktennummer. Mit Komplette Akte importieren übernehmen Sie alle Dokumente dieser Akte; die Akte erhält in Silvernova die Aktenbezeichnung als Namen.
Wichtig: Füllen Sie entweder alle drei Angaben aus oder keine. Andere Archive zeigt der Import in diesem Modus nicht an. Jeder Nutzer braucht in DocuWare Zugriff auf eine Suchmaske dieses Archivs.
Tipp: Archiv und Felder können Sie so eintragen, wie sie in DocuWare angezeigt werden.
4. Fertig!
Ab sofort erscheint neben „Neue Akte" der Button „Importieren". Wie Sie damit Akten und Dokumente aus DocuWare übernehmen, lesen Sie im Artikel Akten mittels einer Kanzleisoftwareanbindung in Silvernova importieren.
Häufige Fehler
Beim Importieren erscheint „Mit dieser Erweiterung ist etwas schiefgelaufen"
Prüfen Sie die Server-URL in der Admin-Konfiguration: Sie darf nicht auf
/DocuWareenden.On-Premise: Prüfen Sie, ob der Connector auf dem DocuWare-Server läuft.
Prüfen Sie, ob Sie sich mit Ihren DocuWare-Zugangsdaten im DocuWare Web-Client anmelden können. Wurde Ihr Passwort geändert, tragen Sie es in der Nutzer-Konfiguration neu ein.
Wenn Sie die Akten-Einstellungen nutzen: Prüfen Sie, ob Archiv und Feldnamen genau so geschrieben sind wie in DocuWare.



