Zum Hauptinhalt springen
title: “Reporting Service konfigurieren” description: “Erstellen Sie die Reporting-Datenbank, richten Sie die Datenzugriffskomponente ein, wechseln Sie zwischen Datenbanken und aktivieren Sie den ABBYY FlexiCapture 12 Reporting Service für Mandanten.” keywords: [“Reporting Service konfigurieren”, “Reporting-Datenbank”, “CreateEventLogDb.ps1”, “appsettings.json”, “Datenzugriffskomponente”, “EventLogApiCreateDb.exe”, “Event Logging Mode”, “Mandant”, “ABBYY FlexiCapture 12”] ---“

​
Konfigurieren des ABBYY FlexiCapture 12 Reporting Service

Der Service speichert alle Informationen in einer separaten Datenbank. Daher müssen Sie nach Abschluss der Installation eine Datenbank erstellen, in der Daten zur Dokumentverarbeitung gespeichert werden. Gehen Sie dazu wie folgt vor:
  1. Starten Sie auf dem Computer, auf dem der ABBYY FlexiCapture 12 Reporting Service installiert ist, PowerShell mit Administratorrechten.
  2. Wechseln Sie in den Ordner CreateDb im Verzeichnis, in dem der Service installiert wurde. Sie können auch den folgenden Befehl verwenden, wenn der Service im Standardpfad installiert wurde: cd C:\inetpub\wwwroot\FlexiCapture12Reporting\CreateDb
  3. Starten Sie das Skript CreateEventLogDb.ps1 mit den erforderlichen Parametern. Beispiel: CreateEventLogDb.ps1 HostName\SQLInstanceName DATABASENAME user password
Ersetzen Sie die Parameter in diesem Skript durch den Namen der Datenbank, die Sie erstellen, und Ihre eigenen Anmeldedaten. Wichtig! User und Password sind optionale Parameter und werden nur bei der Microsoft-SQL-Authentifizierung verwendet. Wenn beim Starten des Skripts kein User oder Password angegeben wird, verwendet das Programm das Windows-Konto, unter dem der Reporting Service ausgeführt wird. Stellen Sie sicher, dass dieses Windows-Konto über Zugriffsberechtigungen für die Reporting-Service-Datenbank verfügt. 4. Fügen Sie dem Abschnitt AppSettings der Datei web.config der Administration and Monitoring Console den folgenden Schlüssel hinzu: <add key=“ExternalLogServiceSettingEnabled” value=“true” /> Speichern Sie Ihre Änderungen. 5. Öffnen Sie die Administration and Monitoring Console und wechseln Sie zu Settings → Event Logging Mode. Geben Sie im Feld ABBYY FlexiCapture 12 Reporting Service die Adresse des Reporting Service im folgenden Format an: http://<ServiceAddress>:8001. Bitte stellen Sie sicher, dass Port 8001 nicht von einer anderen Anwendung verwendet wird. 6. Recyceln Sie in Internet Information Services (IIS) den „FlexiCapture 12 Reporting“-Application-Server-Pool. Nachdem Sie die oben genannten Schritte abgeschlossen haben, zeichnet das Programm Dokumentverarbeitungsdaten für den Standard-Mandanten in den Tabellen DocumentEditingStatistic und EventLog der Datenbank auf.

​
Konfigurieren des Datenzugriffs für den Reporting Service

Sobald der Reporting Service bereit ist, konfigurieren Sie die Datenzugriffskomponente, sofern Sie sich für die Installation und Verwendung dieser Komponente entschieden haben:
  1. Wechseln Sie in das Verzeichnis, in dem die Datenzugriffskomponente installiert wurde. Das Standardverzeichnis ist C:\inetpub\wwwroot\FlexiCapture12ReportingDataAccess.
  2. Öffnen Sie die Datei appsettings.json und geben Sie die folgenden Einstellungen an:
  • DecryptionKey aus der web.config des Application Server. Standardmäßig finden Sie diese Einstellungen unter C:\inetpub\wwwroot\FlexiCapture12\Server.
  • ValidationKey aus der web.config des Application Server.
  • ConnectionString für die Verbindung mit der Reporting-Datenbank. Sie finden ihn in der appsettings.json des Reporting Service (der Standardpfad ist C:\inetpub\wwwroot\FlexiCapture12Reporting).
  • ReportingDataPath — der Pfad zu dem Ordner, in den die Daten exportiert werden sollen. Wenn es mehrere Mandanten gibt, werden die Daten jedes Mandanten in einem separaten Unterordner gespeichert.
  • RunTenantsDataGenerationPeriodSec — die Zeit in Sekunden, die zwischen automatischen Exporten neuer Reporting-Daten vergehen soll. Der Standardwert ist 14400, also 4 Stunden.
Die Parameter ValidationKey, ConnectionString, RunTenantsDataGenerationPeriodSec und ReportingDataPath sind nicht in der Datei appsettings.json enthalten, die zusammen mit der Datenzugriffskomponente installiert wird. Sie müssen diese Parameter manuell nach dem Parameter DecryptionKey hinzufügen und durch Kommas voneinander trennen.
  1. Starten Sie den ABBYY FlexiCapture ReportingResults-Web-Service in IIS neu.
  2. Starten Sie den ABBYY FlexiCapture ReportingResults Service unter Dienste neu.
Nachdem Sie die obigen Schritte abgeschlossen haben, exportiert das Programm Reporting-Daten automatisch in den in appsettings.json angegebenen Ordner. Bitte beachten Sie, dass der Reporting Service beim automatischen Datenexport die am Vortag gesammelten Reporting-Daten exportiert. Das bedeutet, dass der erste Export von Reporting-Daten erst einen Tag nach der Installation und Konfiguration des Reporting Service erfolgt. Sie können Reporting-Daten auch jederzeit manuell über die API exportieren (ausführliche Anweisungen finden Sie unter REST API-Datenzugriff).

​
Ändern der vom ABBYY FlexiCapture 12 Reporting Service verwendeten Datenbank

Um die vom Reporting Service verwendete Datenbank zu ändern, müssen Sie die Datei appsettings.json bearbeiten. Dies kann manuell erfolgen oder – ab ABBYY FlexiCapture 12 Release 4 Update 2 – mithilfe des Dienstprogramms EventLogApiCreateDb.exe in Kombination mit dem Skript ConnectEventlogDb.ps1. Sie können entweder zu einer vorhandenen Datenbank wechseln, die bereits Daten enthält, oder zu einer neuen leeren Datenbank. Wenn Sie zu einer neuen leeren Datenbank wechseln, initialisiert das Dienstprogramm EventLogApiCreateDb.exe die Datenbank zunächst. Im Folgenden finden Sie eine Schritt-für-Schritt-Anleitung.
  • So ändern Sie die Datenbank manuell:
  1. Starten Sie auf dem Computer, auf dem der ABBYY FlexiCapture 12 Reporting Service installiert ist, PowerShell mit Administratorrechten.
  2. Öffnen Sie die Datei appsettings.json, die sich unter C:\inetpub\wwwroot\FlexiCapture12Reporting befindet, und nehmen Sie die erforderlichen Änderungen vor.
  • So ändern Sie die Datenbank mithilfe des Dienstprogramms EventLogApiCreateDb.exe:
  1. Führen Sie den entsprechenden Dienstprogrammbefehl aus:
  • So initialisieren Sie eine neue leere Datenbank: EventLogApiCreateDb.exe [ServerName] [NewDatabaseName] [User Password] init
  • So stellen Sie eine Verbindung mit einer vorhandenen Datenbank her, die bereits Daten enthält: EventLogApiCreateDb.exe [ServerName] [NewDatabaseName] [User Password] connect
Das Dienstprogramm öffnet die Verbindungszeichenfolge aus der Datei appsettings.json.
  1. Führen Sie das Skript ConnectEventlogDb.ps1 aus, um die Verbindungszeichenfolge in der Datei appsettings.json zu ändern. Das allgemeine Muster für das Skript lautet wie folgt:
ConnectEventlogDb.ps1 ServerName OtherDatabaseName [User Password]
Aus Sicherheitsgründen wird das Kennwort in appsettings.json verschlüsselt. Anschließend startet das Skript ConnectEventlogDb.ps1 den Reporting Service neu.

​
Aktivieren des Reporting Service für einen nicht standardmäßigen Mandanten

Standardmäßig wird der Reporting Service nur für den Standard-Mandanten ausgeführt. Um den Reporting Service für einen nicht standardmäßigen Mandanten zu aktivieren, setzen Sie im Feld Flags der Tabelle dbo.Tenant das erste Bit für den entsprechenden Mandanten. Anschließend zeichnet das Programm Daten zur Dokumentverarbeitung für den angegebenen nicht standardmäßigen Mandanten in den Datenbanktabellen DocumentEditingStatistic und EventLog auf.