Report Viewer
Das Report Viewer-Modul generiert Berichte basierend auf dem Crystal Reports Viewer.
Mit Crystal Reports (muss separat erworben werden) können Sie unter Verwendung von Visual Report Designer
eigene Berichte entwerfen und erstellen. Der Report Designer umfasst Werkzeuge, die eine benutzerdefinierte Berichterstellung unterstützen. Dieses Thema behandelt ausschließlich das Anpassen von Berichten für Kofax Capture. Es wird davon ausgegangen, dass Sie mit SQL Server und Crystal Reports vertraut sind.
Anpassen von Standardberichten
Am einfachsten ist es, Ihr eigenes Logo anstelle des Kofax Capture-Logos zu verwenden. Am einfachsten lassen sich eigene Berichte durch Ändern der Standardberichte erstellen. Sie können beispielsweise die Gruppen- und/oder Datenspalten ändern, indem Sie die Abfragen ändern, die von diesen Berichten verwendet werden.
Verwenden eines eigenen Logos
Sie können das Kofax Capture-Logo in der rechten oberen Ecke der Standardberichte mühelos durch Ihr eigenes Logo ersetzen.
Ändern Sie die Größe Ihres Logos mit einem Grafikeditor, sodass es maximal 300 Pixel breit und 80 Pixel hoch ist. Speichern Sie Ihr Logo unter logo.bmp im Verzeichnis <Kofax Capture-Installationsordner>\Bin\Reports. Sie können eine beliebige Farbtiefe verwenden.
Erstellen eigener benutzerdefinierter Berichte
Wenn die Standardberichte nicht an Ihre Anforderungen angepasst werden können, haben Sie die Möglichkeit, mit Crystal Reports eigene Berichte zu erstellen.
Wenn Sie eigene Berichte erstellen, ist es möglicherweise hilfreich zu verstehen, wie die Logografik in die Standardberichte integriert wird. Das Standardlogo wird in die Standardberichte als Bild mit einer dynamischen Grafikposition
basierend auf einem Formelfeld namens LogoLocation
eingefügt. Die LogoLocation wird von der Report Viewer zur Laufzeit festgelegt.
Die Position des Bitmap-Bildes wird durch die Position der linken oberen Ecke der Bitmap bestimmt. Um Bitmaps unterschiedlicher Größe einfügen zu können, positioniert deshalb die Kofax Capture Report Viewer-Berichtsanzeige das Steuerelement "CompanyLogo" so, dass dessen rechte Kante auf die rechte Kante des Steuerelements "PrintDateTime" ausgerichtet wird. Die Position des Bildes wird nur dann ordnungsgemäß angepasst, wenn beide Steuerelemente vorhanden sind.
Datenbankverbindung
Das Report Viewer-Modul kann nur mit der Kofax Capture-Datenbank verwendet werden. Sie können damit keine Berichte erstellen oder anzeigen, die auf Daten aus anderen Quellen basieren.
Beim Erstellen benutzerdefinierter Berichte müssen Sie mithilfe von Microsoft OLE DB Provider für SQL Server eine OLE DB (ADO)-Verbindung erstellen.
Wenn Sie die SQL Server-Datenbank verwenden, benutzen Sie die von Ihrem Datenbank-Administrator zur Verfügung gestellten Datenbankverbindungsinformationen.
Wenn Sie die integrierte Kofax Capture-Standarddatenbankkonfiguration verwenden, benutzen Sie die folgenden Verbindungsinformationen, wobei KCServer der Speicherort des Kofax Capture-Servers ist.
-
Server: <KCServer>\AscentCapture
-
UserID: StatsMgr
-
Kennwort: Screen73
-
Kennwort, wenn USGCB-Compliance ausgewählt ist: HDveq3XTgHS6%h$
-
Datenbank: ACSystem
Diese Berichte basieren nicht auf den Tabellen der (veralteten) Datenbank Stats.mdb, die lediglich zu Kompatibilitätszwecken zur Verfügung gestellt wird.
Datenbankansichten
In den folgenden Datenbankansichten können Sie leichter auf Daten für die Berichte zugreifen. Sie können sie bei den benutzerdefinierten Berichten verwenden.
viewBatchList
Diese Ansicht enthält eine Zeile für jeden Stapel, der sich derzeit im System befindet. Diese Werte sind immer verfügbar, auch dann, wenn die Benutzerstatistik nicht aktiviert ist.
| Spalte | Beschreibung |
|---|---|
|
BatchGUID |
Zeichenfolge, die einen Stapel eindeutig kennzeichnet. |
|
ExternalBatchID |
Externe Kennung des Stapels. |
|
BatchName |
Name des Stapels. |
|
BatchClassName |
Name der Stapelklasse. |
|
ModuleName |
Lokalisierter Name des aktuellen Moduls. Wie die Warteschlange in Batch Manager. |
|
ModuleUniqueID |
Nicht lokalisierte eindeutige Kennung für das aktuelle Modul. |
|
ModuleCustom |
Wahr (True), wenn das aktuelle Modul ein benutzerdefiniertes Modul ist. |
|
Beschreibung |
Stapelbeschreibung. |
|
Priorität |
Aktuelle Stapelpriorität. |
|
StationID |
Kennung der Station, die den Stapel verarbeitet. |
|
ContainsErrors |
Wie die Spalte ! im Batch Manager. |
|
ActualPages |
Anzahl der Seiten im Stapel zum Zeitpunkt der letzten Schließung einer Sitzung. |
|
ActualDocs |
Anzahl der Dokumente im Stapel zum Zeitpunkt der letzten Schließung einer Sitzung. |
|
BatchStatus |
Wie StatsBatchModule.BatchStatus. |
|
BatchStatusName |
Zeichenfolge äquivalent mit BatchStatus. |
|
InProgressString |
Beschreibende Informationen zum aktuellen Status des Stapels während der Verarbeitung. Wird derzeit nur vom Kofax Capture-Netzwerkserver verwendet. |
|
NextSiteGUID |
Eindeutige Kennung des Standorts, an dem der Stapel als nächstes verarbeitet wird. Identisch mit der aktuellen Standort-GUID, wenn Kofax Capture-Netzwerkserver nicht verwendet wird. |
|
NextSiteName |
Name des Standorts, an dem der Stapel als nächstes verarbeitet wird |
|
CreationDate |
Datum und Uhrzeit der Erstellung des Stapels. |
|
CreationTimeZone |
Anzahl der Minuten, die die Erstellungszeit von GMT (WEZ) abweicht. |
|
CreationSiteGUID |
Eindeutige Kennung des Standorts, an dem der Stapel verarbeitet wurde. |
|
CreationSiteName |
Der Name des Standorts, an dem der Stapel erstellt wurde. |
|
CreationSiteTZName |
Zeichenfolge für die Zeitzone, in der der Stapel erstellt wurde. |
viewStatsBatchSummary
Diese Ansicht enthält eine Zeile für jede Zeile in StatsBatch, zu der es ebenfalls mindestens eine Zeile in StatsBatchModule gibt. Dies ist praktisch eine Zeile für jeden Stapel. Diese Werte sind nur verfügbar, wenn die Benutzerstatistik aktiviert ist.
| Spalte | Beschreibung |
|---|---|
|
BatchName |
Wie in StatsBatch. |
|
CreationStationID |
Wie in StatsBatch. |
|
CreationStationID |
Wie in StatsBatch. |
|
CreationUserID |
Wie in StatsBatch. |
|
CreationUserName |
Wie in StatsBatch. |
|
BatchClass |
Wie in StatsBatch. |
|
BatchClassDescription |
Wie in StatsBatch. |
|
ExternalBatchID |
Wie in StatsBatchModule. |
|
LastSessionDateTime |
Späteste EndDateTime für den Stapel aus StatsBatchModule. |
|
FirstSessionDateTime |
Früheste EndDateTime für den Stapel aus StatsBatchModule. |
|
ProcessingSeconds |
Die Summe der Unterschiede zwischen StatsBatchModule.EndDateTime und StatsBatchModule.StartDateTime für alle Sitzungen. |
|
EndToEndSeconds |
Der Unterschied zwischen LastSessionDateTime und FirstSessionDateTime. |
|
Dokumente 1 |
Die Summe der Unterschiede zwischen StatsBatchModule.DocumentsCreated und StatsBatchModule.DocumentsDeleted für alle Sitzungen. |
|
Seiten 1 |
Die Summe der Unterschiede zwischen StatsBatchModule.PagesCreated und StatsBatchModule.PagesDeleted für alle Sitzungen. |
|
Priorität |
Die Priorität des Stapels. Wenn sich die Priorität während der Verarbeitung des Stapels ändert, ist dies die mittlere Priorität auf der Basis der Anzahl der Sitzungen. |
|
ExpectedPages |
Wie in StatsBatchModule. |
|
ExpectedDocs |
Wie in StatsBatchModule. |
|
Deleted |
Größer als 0, wenn der Stapel gelöscht wurde. |
|
Exportiert |
Größer als 0, wenn der Stapel exportiert wurde. |
|
PagesPerDocument |
StatsBatchModule.PagesPerDocument. Wenn sich die Anzahl der Seiten während der Verarbeitung des Stapels ändert, ist dies die mittlere Anzahl der Seiten auf der Basis der Anzahl der Sitzungen. |
|
PagesScanned 1 |
Gesamtsumme von StatsBatchModule.PagesScanned. |
|
PagesDeleted 1 |
Gesamtsumme von StatsBatchModule.PagesDeleted. |
|
DocumentsCreated 1 |
Gesamtsumme von StatsBatchModule.DocumentsCreated. |
|
DocumentsDeleted 1 |
Gesamtsumme von StatsBatchModule.DocumentsDeleted. |
|
ChangedFormTypes 1 |
Gesamtsumme von StatsBatchModule.ChangedFormTypes. |
|
PagesReplaced 1 |
Gesamtsumme von StatsBatchModule.PagesReplaced. |
1 Wenn die Statistikattribute des benutzerdefinierten Moduls in der API nicht richtig festgelegt wurden, sind die Daten in diesen Spalten nicht definiert.
viewStatsSession
|
Spalte |
Beschreibung |
|---|---|
|
ModuleStartDateTime |
Wie in StatsModuleLaunch.StartDateTime |
|
ModuleEndDateTime |
Wie in StatsModuleLaunch.EndDateTime. |
|
ModuleUniqueID |
Wie in StatsModuleLaunch. |
|
ModuleName |
Wie in StatsModuleLaunch. |
|
UserID |
Wie in StatsModuleLaunch. |
|
UserName |
Wie in StatsModuleLaunch. |
|
StationID |
Wie in StatsModuleLaunch. |
|
SiteID |
Wie in StatsModuleLaunch. |
|
SiteName |
Wie in StatsModuleLaunch. Wenn dieser Wert leer ist, wird hier die Standortkennung eingefügt. Dies ist der Fall, wenn ein Upgrade von Ascent Capture Version 7.0 oder älter durchgeführt wurde. |
|
OrphanedModule |
Wie in StatsModuleLaunch.Orphaned. |
|
BatchModuleID |
Wie in StatsBatchModule. |
|
ExternalBatchID |
Wie in StatsBatchModule. |
|
BatchDescription |
Wie in StatsBatchModule. |
|
NextModuleUniqueID |
Wie in StatsBatchModule.ModuleCloseUniqueID |
|
NextModuleName |
Wie in StatsBatchModuleModuleName. |
|
SessionStartDateTime |
Wie in StatsBatchModule.StartDateTime. |
|
SessionEndDateTime |
Wie in StatsBatchModule.EndDateTime. |
|
ProcessingSeconds |
Unterschied zwischen StatsBatchModule.EndDateTime und StatsBatchModule.StartDateTime. |
|
BatchStatus |
Wie in StatsBatchModule. |
|
BatchStatusName |
Zeichenfolge äquivalent mit BatchStatus. |
|
Priorität |
Wie in StatsBatchModule. |
|
ExpectedPages |
Wie in StatsBatchModule. |
|
ExpectedDocs |
Wie in StatsBatchModule. |
|
Deleted |
Wie in StatsBatchModule. |
|
PagesPerDocument |
Wie in StatsBatchModule. |
|
PagesScanned 1 |
Wie in StatsBatchModule. |
|
PagesDeleted 1 |
Wie in StatsBatchModule. |
|
DocumentsCreated 1 |
Wie in StatsBatchModule. |
|
DocumentsDeleted 1 |
Wie in StatsBatchModule. |
|
ChangedFormTypes 1 |
Wie in StatsBatchModule. |
|
PagesReplaced 1 |
Wie in StatsBatchModule. |
|
ErrorCode |
Wie in StatsBatchModule. |
|
ErrorText |
Wie in StatsBatchModule. |
|
OrphanedBatch |
Wie in StatsBatchModule.Orphaned. |
1 Wenn die Statistikattribute des benutzerdefinierten Moduls in der API nicht richtig festgelegt wurden, sind die Daten in diesen Spalten nicht definiert.
Speichern benutzerdefinierter Berichte
Die Standardberichtsvorlagen befinden sich unter <Kofax Capture-Installationsordner>\Bin\Reports. Wenn Sie die benutzerdefinierten Berichte im selben Ordner speichern, werden sie automatisch im Report Viewer-Menü und im Fenster Bericht auswählen angezeigt.
Berichtsvorlagendateien müssen die Erweiterung rpt
haben. Berichte werden dem Menü und dem Fenster in alphabetischer Reihenfolge anhand des Dateinamens hinzugefügt. Sie können die Sortierreihenfolge durch Präfixnummern vor den Dateinamen ändern. Beispiel:
01_Besonderer Bericht.rpt
02_Bericht zur Westregion.rpt
03_Landesbericht.rpt
Die vorausgehenden Nummern werden für die Anzeige im Menü oder Fenster entfernt.
Sie können den Berichtsnamen auch Zugriffstasten hinzufügen, indem Sie ein kaufmännisches Und-Zeichen (&) vor dem zu verwendenden Zeichen einfügen. Um beispielsweise den ersten Buchstaben jedes Berichts der Zugriffstaste zuzuweisen, können Sie wie folgt vorgehen:
01_&SpeziellerBericht.rpt
02_&Westregionsbericht.rpt
03_&Landesbericht.rpt
Das Fenster Bericht auswählen enthält außerdem eine kurze Beschreibung jedes Berichts. In Crystal Reports können Sie in der Berichtszusammenfassung einen Kommentar zum Bericht hinzufügen. Dieser Kommentar wird im Fenster "Bericht auswählen" als Berichtsbeschreibung verwendet.
Anzeigen des Fensters Berichtseinstellungen
Wenn Ihr benutzerdefinierter Bericht ein Textobjekt namens DateRangeTitle enthält, zeigt das Report Viewer-Modul das Fenster Berichtseinstellungen mit dem DateRangeTitle zugewiesenen Wert als Fenstertitel. Das Report Viewer-Modul stellt außerdem die Parameter ReportStart und ReportEnd auf die im Fenster ausgewählten Werte ein.
Wenn der Bericht die Parameter ReportStart und ReportEnd nicht enthält, wird das Fenster zwar angezeigt und der Bericht erstellt, aber mit protokollierten Fehlern.
Wenn der Bericht das Textobjekt DateRangeTitle nicht enthält, wird das Fenster "Berichtseinstellungen" nicht angezeigt.
Wenn der Bericht die genannten Objekte, die das Fenster Berichtseinstellungen einblenden, sowie andere Parameter enthält, wird das Fenster Berichtseinstellungen zuerst eingeblendet und dann folgt das Standardfenster für Crystal Reports für die übrigen Parameter.
Wenn der benutzerdefinierte Bericht nicht die Parameter ReportStart und ReportEnd, jedoch andere Parameter enthält, wird das Standardfenster für Crystal Reports angezeigt.
Beachten Sie, Sie dass bei Anzeige des Standardfensters für Crystal Reports-Parameter das Fenster Bitte warten geschlossen wird, bevor der Bericht vollständig angezeigt wurde.
Papierformat
Das Report Viewer-Modul kann automatisch die Berichtsränder anpassen, damit eine einzelne Berichtsvorlage auf Papier im Format DIN A4 und Letter gedruckt werden kann.
Wenn das Report Viewer-Modul die Anpassung an diese Standardpapierformate automatisch vornehmen soll, müssen Sie die Berichtsvorlage für das Format Letter mit folgenden Seitenrand-Angaben speichern. Der Werte sind so ausgewählt, dass für die Formate DIN A4 und Letter der Rand mindestens 1/4 Zoll (ungefähr 0,63 cm) beträgt.
Wenn Sie andere Einstellungen verwenden, nimmt das Report Viewer-Modul keine automatischen Anpassungen vor. Dies kann sinnvoll sein, wenn Sie andere Papierformate verwenden möchten.
Die im Folgenden aufgelisteten Werte gelten für das Papierformat Letter:
|
Ausrichtung |
Ränder oben und unten |
Ränder links und rechts |
|---|---|---|
|
Querformat |
0,617 Zoll |
0,500 Zoll |
|
Hochformat |
0,500 Zoll |
0,617 Zoll |
Beim Drucken auf Papier des Formats DIN A4 werden die Ränder automatisch auf die Werte in der folgenden Tabelle angepasst:
|
Ausrichtung |
Ränder oben und unten |
Ränder links und rechts |
|---|---|---|
|
Querformat |
0,500 Zoll |
0,846 Zoll |
|
Hochformat |
0,846 Zoll |
0,500 Zoll |