Componente stampante Jasper
Questo componente viene utilizzato per stampare automaticamente un documento basato su un evento. Inoltre, è anche possibile generare il PDF o un oggetto RTF di un documento. È un componente standard basato su XML: accetta XML come input e fornisce un XML di output identico.
Ad esempio, la stampa di un elenco di ritiro in un negozio per il ritiro dal negozio è un esempio in cui il negozio non conserva l'inventario. In questo caso, il sito Web in cui viene effettuato l'ordine o un call center acquisisce gli ordini per il ritiro dal negozio. Questi ordini vengono inviati al negozio per l'elaborazione. Un associato del controllo inventario del negozio verifica periodicamente se sono presenti ordini da ritirare. In caso affermativo, l'associato può stampare un elenco di ritiro carta per estrarre i prodotti richiesti dal piano di vendita al dettaglio. In alcuni casi, la stampa può essere attivata automaticamente quando un ordine viene ricevuto nel negozio.
Un documento può essere stampato comodamente con un singolo clic dalla console. Ciò è supportato utilizzando l'esecuzione del flusso e il componente della stampante.
Il componente di stampa Jasper può essere utilizzato per generare un report PDF e inviarlo tramite la risposta HTTP . Questa operazione può essere eseguita configurando un servizio con un componente di stampa Jasper e selezionando l'opzione "Oggetto di stampa Jasper". Questo servizio viene ora invocato effettuando una chiamata HTTP alla servlet "InteropJasperServlet" e passando il "locale" XML di input al servizio e il nome del servizio creato per la generazione di oggetti PDF. Questi servizi vengono creati in SDF (Service Definition Framework). Per ulteriori informazioni su SDF e su come creare un servizio, consultare Service definition framework.
È anche possibile controllare l'esito positivo e negativo degli eventi di stampa utilizzando la transazione di stampa definita nel tipo di elaborazione generale. Questa transazione è configurabile e ha due eventi: Print.ON_SUCCESS e Print.ON_FAILURE. L'evento ON_FAILURE viene generato solo per le eccezioni di sospensione del servizio come gli errori di stampa.
La seguente tabella fornisce le proprietà di configurazione della stampa Jasper:
| Campo | Descrizione |
|---|---|
| Scheda Generale | |
| Report Jasper | Questo è un file Jasper compilato. Il nome file supporta le variabili sia in formato standard che avanzato. |
| Scadenza di selezione report | Specificare l'elemento da inviare come root del report. Per impostazione predefinita, viene utilizzato l'intero XML. Viene generato un errore, se questo campo viene fornito ma non si risolve in un elemento. |
| Impostazioni internazionali | Specificare la locale per la conversione dei valori letterali nel report. I dati nell'XML possono essere localizzati utilizzando il componente predefinito descritto in Componente predefinito. |
| Utilizza il pacchetto di risorse software del sistem Sterling™ Order Management | Se selezionato, tutti i caratteri letterali nel report vengono tradotti nella lingua richiesta utilizzando il pacchetto di risorse software di sistema Sterling Order Management. |
| Scheda Output | |
| Stampante | Selezionare questa opzione per specificare una stampante da utilizzare. |
| Nome stampante | Immettere il percorso XML che punta alla stampante da utilizzare. |
| Numero di copie | Immettere il numero di copie che si desidera stampare. |
| Scheda Variabili | |
| Nome variabile | Il nome del parametro da trasmettere al metodo del programma di convalida. |
| Valore variabile | Il valore del parametro da passare al metodo del programma di convalida. |
Per consentire formati di stampa personalizzati, la configurazione del componente di stampa supporta la modifica dei nomi file di report basati su un XML di input. Ad esempio, se l'XML di input contiene il nome file:
${jasperfolder}/compiled/${orgcode}/report.${doctype}.jasper
Innanzitutto, tutte le variabili vengono risolte rispetto alle variabili definite nella scheda Variabili:
orgcode v xml:/Order/@OrganizationCode
doctype v xml:/Order/@DocumentType
Le variabili rimanenti vengono risolte rispetto al file yfs.properties . In questo caso, la variabile ${jasperfolder} viene risolta dalla definizione yfs.properties jasperFolder=/someCustomJasperFolder. Per modificare questa proprietà, aggiungere una voce per essa nel file <INSTALL_DIR>/properties/customer_overrides.properties .
Quindi, con l'input di <Order
OrganizationCode="DEFAULT" DocumentType="0001" .... /> , l'espressione si risolve in /someCustomJasperFolder/compiled/DEFAULT/report.0001.jasper.
Viene generata un'eccezione se si verifica un errore durante l'elaborazione del prospetto. Ad esempio, viene generata un'eccezione se il nome file non è valido. Durante la stampa del report viene generata un'eccezione di sospensione del servizio che consente di sospendere un servizio asincrono.