Ausgaben Admin Modus

Aus BormOnlineHilfe
Version vom 14. Februar 2017, 15:08 Uhr von Luca.Foehn (Diskussion | Beiträge) (→‎Script Editor)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Zur Navigation springen Zur Suche springen

Admin Modus

OPM Admin Funktionen

Um in den Adminmodus zu kommen müssen Sie zuerst im Desktop den Adminmodus aktivieren. Öffnen Sie anschliessend den Druckdialog, erscheint ein zusätzliches Register Administrator. Es werden hierbei keine Favoriten mehr angezeigt, jedoch leere Ordner und ausgeblendete Berichte.


Berichte verschieben

Die Position eines Outputs kann bequem mit Drag and Drop verschoben werden. Dies funktioniert auch mit ganzen Ordnern. Ordner können allerdings nicht in Ordner verschoben werden.

Bilder aus Zwischenablage zuweisen

Wenn Sie einen Printscreen z.B. von einem Bericht machen und diesen Befehl aufrufen, so wird der Printscreen als PNG Datei im Verzeichnis des Output mit dem Namen des Outputs _Typ_Preview angelegt. Evt. bestehende Dateien werden ohne Rückfrage überschrieben. Die Bilder werden rechts unten als Vorschau angezeigt und dienen dazu, dass sie grundsätzlich erkennen um was für einen Bericht es sich handelt.

Zeile editieren

Klicken Sie auf Zeile editieren erscheint der Dialog zum Einstellen der Eigenschaften des Outputs. Hier stehen folgende Eigenschaften zur Verfügung:

Spalte Beschreibung
Gruppe Gruppe welcher der Bericht angehört.
Name Der Name steht in der linken Spalte des Dialoges.
Bezeichnung Die Bezeichnung steht in der 2. Spalte des Dialoges und beschreibt z.B. ob man eine Selektion verwenden muss.
Beschreibung Die Beschreibung dient dazu den Inhalt des Outputs näher zu erläutern damit der Benutzer weiss was angezeigt wird.
Ausgabetyp Der Ausgabetyp legt fest, um was für einen Output es sich handelt. Die Typen werden weiter unten behandelt. Wer den Ausgabetyp ändert muss genau wissen was er tut.
Scriptaufruf Kennung Die Kennung wird verwendet für den Aufruf des Outputs aus Scripten heraus. Dies betrifft folgende Funktionen:


BGShowReport
BGPrintReport
BGExportReport
BGExportReportPDF
BGExportReportRTF
BGExportReportWORD
Die Kennung muss im Script an den entsprechenden Parameter übergeben werden.
Hiermit werden folgende alten Funktionen abgelöst:
CTOShowReport
CTOPrintReport
CTOExportReport
CTOExportReportPDF
CTOExportReportRTF
CTOExportReportWORD
Die Verwendung der Kennung hat den Vorteil, dass der Output im Druckdialog bestimmt werden kann ohne das Script zu verändern. Dies trifft z.B. zu, wenn man eine neue Version eines Outputs erstellt.
Die Kennung ist pro Gruppe eindeutig.
Die Kennungen können auch über den Befehl Kennungen verwalten angepasst werden. Hier steht eine bessere Übersicht zur Verfügung.

Sichtbar Legt fest ob ein Output für die Benutzer sichtbar ist. Im Admin Modus sind alle Outputs sichtbar.
Parameter zu Beleg speichern Diese Option legt fest, ob die gespeicherten Parameter zum Beleg gespeichert werden.
Dauer für Timeout (ms) Timeoutdauer vor dem starten des Berichts in Millisekunden.
Dateiname Der Dateiname legt fest wo der Output abgelegt ist. Je nach Ausgabetyp werden unterschiedliche Dateien angezeigt. Es wird immer der relative Pfad zum Basisverzeichnis verwendet.
Script Soll ein Script vor dem Output ausgeführt werden kann dies hier angegeben werden. Es wird immer der relative Pfad zum Basisverzeichnis verwendet.


Parameter Designer

Sollen zur Ausgabe Parameter verwendet werden, so können diese im Parameterdialog erfasst werden. Nach Aufruf der Funktion erscheint der Parameterdialog. Ein Parameter kann auch erfasst werden ohne das er im Bericht vorhanden ist. Er kann z.B. in einem vorgeschalteten Script zur Anwendung kommen. Verwaltung Berichtsparameter

Script Editor

Der Scripteditor erlaubt es, das Script zu einer Ausgabe zu editieren. Ist noch kein Script vorhanden wird automatisch nach Rückfrage eines erstellt. Innerhalb der Scripte stehen folgende Funktionen zur Verfügung:

Spalte Beschreibung
GetCrystalParameter Wird zuerst aufgerufen. Es stehen alle Parameter eines Berichtes sowie @LIST_ID als Variablen zur Verfügung. Wenn true zurück gegeben wird, dann wird kein Parameterdialog angezeigt. In diesem Fall geht das Programm davon aus, das innerhalb der Funktion die Parameter bereits gesetzt wurden, durch einen Dialog abgefragt etc.
BeforeExecutingReport Wird vor der Berichtsausgabe aber nach der Abfrage der Parameter aufgerufen. Es stehen alle Parameter eines Berichtes mit den Werten die der Benutzer eingegeben hat sowie @LIST_ID als Variablen zur Verfügung. Ausserdem stehen noch folgende Variablen zur Verfügung:
Variable Beschreibung
KOPIENANZAHL Manipulationsmöglichkeit der Kopienanzahl, wenn die Kopienanzahl des Unterberichts auf "BS" gesetzt wurde. Die Variable wird nur bei Stapeldrucken ausgewertet.
DRUCKERAUSWAHL Manipulationsmöglichkeit des Ausgabedruckers. Die Zuweisung muss in folgender Form passieren:

Druckernummer/Kopien,Druckernummer/Kopien,... z.B. 2/1,4/2 das entspricht folgender Ausdrucksvarianten: Drucker 2 - 1 Kopie, Drucker 4 - 2 Kopien Die Variable wird nur bei Stapeldrucken ausgewertet.

AUSGABEMEDIUM Das Ausgabemedium bestimmt, ob der Ausdruck auf dem Bildschirm (AUSGABEMEDIUM=0) oder auf dem Drucker (AUSGABEMEDIUM=1) gestartet wurde. Wird die Ausgabe auf dem Bildschirm gestartet und anschließend der "Druckknopf" betätigt und ein Ausdruck gestartet, so wird das Ausgabemedium ebenfalls auf 1 gesetzt. Der richtige Auswertungszeitpunkt ist also die Funktion AfterExecutingReport(). Was jedoch nie bekannt ist, ist ob der Ausdruck vom Benutzer abgebrochen wurde, oder nur eine Seite gedruckt wurde oder der Drucker das Papier "gefressen" hat. Die Auswertung dieser Variable sollte also immer mit Rückfrage stattfinden.
current_scriptname Diese Variable enthält den Namen des Scriptes das ausgeführt wird. Dadurch kann man erkennen wo man ist. Es wird der vollständige Pfad mit Dateinamen übergeben. Die Variable muss mit GetVariableAsString("current_scriptname") abgerufen werden.

Für die Ermittlung des Tabellenamen kann auch die Funktion CTORPTGetTableName() verwendet werden. Diese gibt direkt den Tabellennamen zurück welcher auf dem der Bericht aufgerufen wird.

AfterExecutingReport Befehl wird nach dem Berichtsaufruf ausgeführt

Objekt mit externem Editor bearbeiten

Mit dem Befehl Objekt mit externem Editor bearbeiten wird die zur Ausgabe zugehörige Datei zum Bearbeiten geöffnet. Es muss ein geeignetes Bearbeitungsprogramm auf dem Rechner installiert sein.

Vorgabe Optionen Werte editieren

Mit Hilfe von Vorgabe Optionen Werte editieren können für Parameter Vorgaben erfasst werden die beim erstmaligen Öffnen der Ausgabe in die Parameter eingetragen werden. Dies hilft den Benutzern wenn sie zu Beginn die Ausgabe öffnen. Folgend werden die letzten vom Benutzer eingegebenen Parameterwerte vorgegeben.

Ordner einfügen

Fügt einen neuen Ordner ein. Ordner können nur auf der obersten Ebene erstellt werden. Ein Ordner kann mit dem Befehl Output löschen entfernt werden

Ausgabe kopieren

Mit dem Befehl Ausgabe kopieren erstellen Sie eine neue Ausgabe durch kopieren der aktuellen. Es öffnet sich der Erfassungsdialog. Geben sie einen neuen Namen ein. Die weiteren Felder wie Ausgabetyp, Datei und Script bleiben leer. Sie werden nach dem Erstellen der neuen Ausgabe vom bestehenden kopiert und eingetragen.

ListId kopieren

Um Vorgänge nach voll ziehen zu können kann die ListId in die Zwischenablage kopiert werden.

Verzeichnis öffnen

Öffnet den Explorer mit dem Verzeichnis der Ausgabedatei.

Script in Editor öffnen

Öffnet die zugehörige Script Datei im zugewiesenen Editor.

Bereich zuweisen

Der Bereich legt fest, in welchem Programm ein Bericht angezeigt wird. Mit Bereich zuweisen können Sie einen Bericht in einem Bereich aktivieren oder deaktivieren.

Gruppe auswählen

Um eine andere Verarbeitung zu administrieren kann man eine andere Gruppe wählen. Es erscheint der Auswahldialog für die Gruppen. In der ersten Zeile kann man einen Suchfilter eingeben. Mit einem doppelklick auf die Gruppe kann man diese auswählen. Der Druckdialog wird neu mit den Berichten der ausgewählten Gruppe geladen. Zu beachten ist, das jetzt nicht mehr gedruckt werden kann, da die SYS_LIST Einträge nicht mehr zu der gewählten Gruppe passen.

Kennungen verwalten

Über diesen Befehl kann man die Kennungen der aktuellen Gruppe verwalten. Es werden die Outputs angezeigt mit ihren Kennungen. In der Spalte Kennungen kann man die Kennungen bearbeiten.

Parameter kopieren und einfügen

Mit diesen Befehlen können Sie die Parameter eines Berichts kopieren und in einem anderen Bericht einfügen.

Ex- und Import

Um Berichte in eine andere Umgebung zu transferieren müssen Sie diese Exportieren. Seine Definition inkl. Der zugehörigen Dateien wird in eine XML Datei exportiert. Um diesen in der Zielumgebung wieder zu importieren muss Ausgabe importieren gewählt werden und die XML Datei ausgewählt werden. Es können keine Excel Berichtsgenerator Ausgaben und Stapeldrucke exportiert werden.

Ausgabe erstellen

Um eine neue Ausgabe zu Erstellen muss der Befehl Neue Datei erstellen gewählt werden. Es erscheint ein Dialog der Vorlagen für die verschiedenen Möglichkeiten bietet. Es wird das Verzeichnis \Client\BGReportEngine aufgelistet. Hier können beliebige Templates hinterlegt werden.

Dateiformat bestimmt welche Dateivorlage erscheint. Der Typ legt den Bereich fest in dem die neue Ausgabe erscheinen soll. In Neuer Dateiname kann man den Dateinamen angeben der auch als Vorschlag für die Namensgebung übernommen wird. Nach Vorlage suchen erlaubt es eine bestehende Ausgabe aus dem Dateisystem auszuwählen.

Nach dem Klick auf Ok erscheint der Erfassungsdialog für die Ausgabe. Dort kann man noch die erweiterten Angaben einstellen und nach dem Speichern wird die Ausgabe erstellt, die Vorlage kopiert und die Ausgabe an der aktuellen Stelle im Ausgabebaum unten angefügt. Danach können Sie die Ausgabe bearbeiten.

Optionen verwalten

Optionen erlauben es, Berichtseigenschaften einzustellen. Sie werden z.B. dafür verwendet um Logos ein- oder aus zu blenden. Optionen können in Crystal Berichten mit Hilfe der Funktionen BGGetOPOptionString BGGetOPOptionNumber Diesen muss die output_id und der Optiosnname übergeben werden. Die output_id erreicht man, in dem man einen Parameter mit dem Namen output_id anlegt vom Typ Zahl. In diesen wird vom Programm automatisch die output_id der aktuellen Ausgabe übergeben. Beispiel:

BGGetOPOptionString({?output_id},"TEST");

Damit diese Funktionen zur Verfügung stehen muss auf dem Client die Datei u2lCTOFunctions.dll in der Crystal Report Installation aktualisiert werden.

Ausgabe löschen

Löscht die aktuell markierte Ausgabe. Es wird noch gefragt, ob die Dateien auch gelöscht werden sollen.

Drucker definieren

Hier kann die Zuweisung der Drucker zu den Druckernummern vorgenommen werden. Diese Zuweisung pro Benutzer auf jedem PC erfolgen da das Druckertreibermodell von Windows keine zentrale Verwaltung zulässt.

Benutzerberechtigungen

Berichte können Berechtigungen unterliegen. Diese werden in den Benutzerberechtigungen aktiviert.

Stapeldruck

Der Stapeldruck ermöglicht es, mehrere Berichte zusammen zu drucken (Dies funktioniert nur mit Crystal Report Berichten). Um einen Stapeldruck zu definieren wählt man Batch erstellen oder bearbeiten. Es erscheint der Dialog zum Erfassen eines Stapeldruckes

Geben sie einen Namen ein und speichern sie den Stapeldruck. Es erscheint der Dialog zum Verwalten der Berichte im Stapeldruck.

Funktion Beschreibung
Berichte zu Stapeldruck hinzufügen Hier können sie aus den Berichten der aktuellen Verarbeitung auswählen und einen oder mehrere Berichte dem Stapeldruck zu weisen. Wählen sie diese mit Hilfe der Checkbox aus. Nach dem Klick auf Übernehmen werden die Berichte hinzugefügt.
Reihenfolge der Berichte ändern Mit Drag and Drop können sie die Reihenfolge der Berichte in einem Stapeldruck ändern. Alternativ kann aber auch die Nummer der Reihenfolge verändert werden.
Bericht entfernen Durch markieren und Klick auf den Befehl Bericht entfernen wird der aktuell selektierte Bericht aus dem Stapeldruck entfernt.
Parameterwerte setzen Jedem Bericht in einem Stapeldruck können fixe Werte seinen Parametern zugewiesen werden. Klicken sie auf das + vor dem jeweiligen Bericht. Es werden die Parameter des Berichtes angezeigt. In der letzten Spalte können sie jedem Parameter einen fixen Wert zuweisen. Dies ermöglicht einen variablen Bericht mit verschiedenen Parametern unterschiedlich auf zu rufen. Soll kein Parameterdialog beim Aufruf erscheinen muss allen Parametern ein Wert zugewiesen werden. Hat ein Parameter keinen Wert erscheint der Dialog beim Aufruf des Berichtes.
Drucker zuweisen BormBusiness ermöglicht es, über eine Druckerzuweisung jedem Bericht einen fixen Drucker zu zuweisen. Die Drucker werden über eine Nummer identifiziert und können dann auf jeder Arbeitsstation mit einem definierten Drucker verbunden werden.


Dies erfolgt nach folgendem Prinzip:

Nr Beschreibung PC1 PC2 PC3 PC4
Hans Peter Marlies Claudia
1 Normalpapier \\Druckerserver\\HP Druckcenter \\Druckerserver\\HP Druckcenter \\Druckerserver\\HP Druckcenter \\PC4\\HP Laserjet
2 Etiketten \\Druckerserver\\Etikettendrucker \\Druckerserver\\Etikettendrucker \\Druckerserver\\Marlies Etikettendrucker
3 Einzahlungsschein \\Druckerserver\\Einzahlungsschein \\Druckerserver\\Einzahlungsschein \\Druckerserver\\Einzahlungsschein
4 Firmenpapier \\Druckerserver\\HP Druckcenter Schacht 4 \\Druckerserver\\HP Druckcenter Schacht 4 \\Druckerserver\\HP Laserjet Schacht 2 \\Druckerserver\\HP Laserjet Schacht 2

Der Druck sucht sich beim Aufruf automatisch den richtigen Drucker der der verwendeten Nummer auf dem aufrufenden Arbeitsplatz zugewiesen ist.

Kopienanzahl Für jeden Bericht in einem Stapeldruck kann die Kopienanzahl festgelegt werden. Dabei ist zu beachten, das die angegebene Kopienanzahl mit der Kopienanzahl die der Benutzer angegeben hat multipliziert wird.