Lire::OutputJob(3pm)

Lire::OutputJob3pm

Object used to represent a configured formatting of a report

Usage

  use Lire::OutputJob;
  use Lire::OutputFormat;
  my $email = new Lire::OutputJob( 'email', $output, $output_cfg,
                                   'emails' => [ '[email protected]' ] );
  $email->run( 'report.xml' );
  my $file = new Lire::OutputJob( 'file', $output, $output_cfg,
                                  'filename' => '/var/www/reports/daily-%Y%m%d'  );
  $file->run( 'report.xml' );

Overview

The Lire::OutputJob objects are used to represent how a report should formatted. These objects are most often created from the Lire configuration. (The 'output_jobs' specification.)

new( $destination_type, $format, $format_cfg, ... );

Create a new Lire::OutputJob object. Two parameters are required:

$destination_type

Can be either 'email' or 'file'.

$format

A Lire::OutputFormat object.

$format

The configuration data that will be passed to the OutputFormat object.

The method will returns an instance of Lire::EmailOutputJob or Lire::FileOutputJob.

format

Returns the Lire::OutputFormat associated with this OutputJob.

format_cfg

Returns the configuration data that will be used when formatting the report.

run( $report_file )

Formats and sends or save the XML report $report_file according the OutputJob parameters.

Lire::EmailOutputJob

Extra parameters for 'email' type

emails

An array reference to the emails that will receive the formatted report.

subjet

The subject of the email.

extra_file

An additional text file that will be appended to text report or attach to other report types.

emails()

Returns as an array the emails to which the report will be sent.

subject()

Returns the subject of the email.

extra_file()

Returns the filename that will be appended to the text report or attach to the message for other report's type.

Lire::FileOutputJob

Extra parameters for 'file' type.

file

A file path with possible strftime(3pm) interpolation. This will be were the formatted report will be saved.

file()

Returns this OutputJob destination file.

output_file( [$time] )

Returns the destination file with strftime(3) specifier interpolated.

Version

$Id: OutputJob.pm,v 1.8 2006/07/23 13:16:29 vanbaal Exp $

Releases

6 releases since Debian 3.1 (Sarge); the text changed 5 times.

  1. 3.1
  2. 4.0
  3. 5.0
  4. 6.0
  5. 7
  6. Arch

Author

  Francis J. Lacoste <[email protected]>

From lire 2.1.1-8 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.