Jasper-Druckerkomponente
Diese Komponente wird zum automatischen Drucken eines Dokuments auf der Basis eines Ereignisses verwendet. Außerdem können Sie die PDF oder ein RTF-Objekt eines Dokuments generieren. Es handelt sich um eine XML-basierte Standardkomponente: akzeptiert XML als Eingabe und stellt eine identische Ausgabe-XML bereit.
Das Drucken einer Entnahmeliste in einem Geschäft zur Abholung im Geschäft ist beispielsweise ein Beispiel, bei dem das Geschäft den Lagerbestand nicht verwaltet. In diesem Fall erfasst die Website, auf der die Bestellung aufgegeben wird oder ein Call-Center Bestellungen für die Abholung im Geschäft. Diese Bestellungen werden zur Verarbeitung an das Geschäft gesendet. Das Verkaufspersonal zur Steuerung des Lagerbestands prüft in regelmäßigen Abständen, ob Aufträge entnommen werden müssen. Ist dies der Fall, kann der Mitarbeiter eine Papierentnahmeliste drucken, um die erforderlichen Produkte aus dem Einzelhandelsgeschoss zu ziehen. In einigen Fällen kann der Druck automatisch ausgelöst werden, wenn eine Bestellung im Geschäft empfangen wird.
Ein Dokument kann mit einem einzigen Klick von der Konsole aus gedruckt werden. Dies wird durch die Verwendung der Ablaufausführung und der Druckerkomponente unterstützt.
Die Jasper-Druckkomponente kann verwendet werden, um einen PDF-Bericht zu generieren und über die HTTP -Antwort zu streamen. Dazu können Sie einen Service mit einer Jasper-Druckkomponente konfigurieren und die Option "Jasper-Druckobjekt" auswählen. Dieser Dienst wird nun durch HTTP an "InteropJasperServlet" aufgerufen, wobei die XML-Eingabe "locale" an den Dienst und der Name des Dienstes, den Sie für die Generierung von PDF-Objekten erstellt haben, übergeben werden. Diese Services werden im Service Definition Framework (SDF) erstellt. Weitere Informationen zu SDF und zum Erstellen von Services finden Sie unter Servicedefinitionsframework.
Sie können den Erfolg und das Fehlschlagen der Druckereignisse auch mithilfe der Drucktransaktion prüfen, die unter dem allgemeinen Prozesstyp definiert ist. Diese Transaktion ist konfigurierbar und hat zwei Ereignisse: Print.ON_SUCCESS und Print.ON_FAILURE. Das Ereignis ON_FAILURE wird nur für Serviceaussetzungsausnahmebedingungen wie Druckfehler ausgelöst.
Die folgende Tabelle enthält die Jasper-Druckkonfigurationseigenschaften:
| Feld | Beschreibung |
|---|---|
| Registerkarte 'Allgemein' | |
| Jasper-Bericht | Dies ist eine kompilierte Jasper-Datei. Der Dateiname unterstützt Variablen sowohl im Standardformat als auch im erweiterten Variablenformat. |
| Bericht: Ablaufdatum wählen | Geben Sie das Element an, das als Stammelement des Berichts gesendet werden soll. Standardmäßig wird die gesamte XML verwendet. Wenn dieses Feld angegeben ist, aber nicht in ein Element aufgelöst wird, wird ein Fehler ausgelöst. |
| Ländereinstellung | Geben Sie die Ländereinstellung für die Umsetzung der Literale im Bericht an. Die Daten in der XML können mithilfe der Standardkomponente lokalisiert werden, die in Standardkomponenteerläutert wird. |
| Verwenden Sie das Ressourcenpaket für die Systemsoftware „ Sterling™ Order Management “ | Wenn diese Option aktiviert ist, werden alle Literale im Bericht mithilfe des System-Software -Ressourcenpakets „ Sterling Order Management “ in die gewünschte Sprache übersetzt. |
| Registerkarte "Ausgabe" | |
| Drucker | Diese Auswahl treffen, um einen zu verwendenden Drucker anzugeben. |
| Druckername | Geben Sie den XML-Pfad ein, der auf den zu verwendenden Drucker verweist. |
| Anzahl Kopien | Geben Sie die Anzahl der zu druckenden Kopien ein. |
| Registerkarte "Variablen" | |
| Variablenname | Der Name des Parameters, der an die Validatormethode übergeben werden soll |
| Variablenwert | Der Wert des Parameters, der an die Validatormethode übergeben werden soll |
Um benutzerdefinierte Druckformate zuzulassen, unterstützt die Konfiguration der Druckkomponente die Änderung von Berichtsdateinamen auf der Basis einer Eingabe-XML. Beispiel: Die Eingabe-XML enthält den Dateinamen:
${jasperfolder}/compiled/${orgcode}/report.${doctype}.jasper
Zunächst werden alle Variablen anhand der auf der Registerkarte "Variablen" definierten Variablen aufgelöst.
orgcode gn xml:/Order/@OrganizationCode
doctype gn xml:/Order/@DocumentType
Die übrigen Variablen werden anhand der Datei yfs.properties aufgelöst. In diesem Fall wird die Variable ${jasperfolder} aus der yfs.properties -Definition aufgelöst: jasperFolder=/someCustomJasperFolder. Sie können diese Eigenschaft
ändern, indem Sie einen Eintrag für sie in der Datei <INSTALL_DIR>/properties/customer_overrides.properties hinzufügen.
Mit der Eingabe von <Order
OrganizationCode="DEFAULT" DocumentType="0001" .... /> wird der Ausdruck wie folgt aufgelöst: /someCustomJasperFolder/compiled/DEFAULT/report.0001.jasper.
Eine Ausnahmebedingung wird ausgelöst, wenn beim Verarbeiten des Berichts ein Fehler auftritt. Beispielsweise wird eine Ausnahmebedingung ausgelöst, wenn der Dateiname ungültig ist. Beim Drucken des Berichts wird eine Serviceaussetzungsausnahmebedingung ausgelöst, die das Anhalten eines asynchronen Service ermöglicht.