---
name: "Lire::ReportSpec"
section: "3pm"
platform: "linux"
package: "lire"
version: "2.1.1-8"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/Lire::ReportSpec"
---

# Lire::ReportSpec(3pm)

API to the XML report specifications.

## NAME

Lire::ReportSpec - API to the XML report specifications.

## SYNOPSIS

```
    use Lire::ReportSpec;
```

## DESCRIPTION

## META INFORMATION METHODS

### list\_specs( $superservice )

Returns an array reference containing all the report specification type available for the `$superservice` superservice.

### has\_spec( $superservice, $type )

Returns true if there is a `$type` specification available for the `$superservice`.

## OBJECT METHODS

### subreport\_id( \[ $new\_subreport\_id \] )

Returns (and optionnally change) the id that will be associated to the Subreport that will be generated by this specification.

### chart\_configs()

Returns an array reference containing the Lire::Report::ChartConfig objects that specifies the charts that should be generated when the Lire::Report::Subrpeport object specified by this object will be formatted.

### add\_chart\_config( $chart\_config )

Adds a Lire::Report::ChartConfig object that should be added to the Lire::Report::Subreport object that is specified by this object.

### filter\_spec( \[ $new\_filter\_spec \] )

Returns (and optionally changes) the Lire::FilterExpr that should be applied to create the Lire::Report::Subreport specified by this object. This will be undef if no filtering should be applied.

### calc\_spec( \[ $new\_aggregator \] )

Returns (and optionally changes) the Lire::Aggregator that should be used to create the Lire::Report::Subreport specified by this object.

### mark\_missing( $reason )

Mark that the report that should be generated by this report specification should be marked as missing. The `$reason` parameter gives the reason why the subreport will be missing.

### is\_missing()

Returns true if the subreport generated by this report specification should be marked missing.

### set\_store( $store )

Sets the DLF store upon which this ReportSpec will be generated when **create\_subreport()** will be called.

### create\_subreport()

Creates a Lire::Report::Subreport object based on this report specification. This will be a missing subreport if the **mark\_missing()** method was called.

Called by **Lire::ReportSection::create\_report\_section()**.

### create\_table\_info()

Returns a Lire::Report::TableInfo object that describes the table generated by subreport of this type.

## SEE ALSO

```
  Lire::FilterSpec(3pm), Lire::ReportConfig(3pm),
  Lire::ReportSection(3pm)
```

## AUTHOR

```
  Francis J. Lacoste <flacoste@logreport.org>
```

## VERSION

`$Id:` ReportSpec.pm,v 1.59 2006/07/23 13:16:30 vanbaal Exp $

## COPYRIGHT

Copyright (C) 2001-2004 Stichting LogReport Foundation LogReport@LogReport.org

This file is part of Lire.

Lire is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program (see COPYING); if not, check with http://www.gnu.org/copyleft/gpl.html.