counterproc - process a COUNTER report
counterproc [option...] [file...]
counterproc -h|--help
counterproc -V|--version
counterproc performs common operations on electronic resource reports that conform (more or less) to the COUNTER Codes of Practice, Release 2. These include report validation, correction of many common errors, and extraction of raw usage data.
The action to take is specified as an option, and the file to process is the sole non-option argument. Standard input is processed if no file is specified.
Output includes the (corrected) report, which is printed to standard output, and whatever other output is appropriate for the desired action, which is printed to standard error.
The exit status of counterproc will be 0 if the report is valid, or -1 if the report is not valid.
Note: If none of -c, --validate, -A, or --atomize is specified, the report will be processed using Biblio::COUNTER::Processor::Simple, which prints verbose diagnostic information to standard error and the (corrected) report to standard output.
Validate the input.
Biblio::COUNTER::Processor::Validate will be used to check the report, printing a count of errors and warnings to standard error and the (corrected) output to standard output.
Extract data from the report, producing a single tab-delimited line for each datum. The data lines are preceded by a single line containing column headers.
Each line of output has the following elements, which appear in the order listed:
The short code that indicates the type of the report (e.g., JR1 or DB3).
JR1
DB3
The name of the file containing the report. Set to - if processing standard input.
-
The <Biblio::COUNTER::Processor::Atomize|Biblio::COUNTER::Processor::Atomize> instance. (Just ignore this.)
The instance of the appropriate subclass of <Biblio::COUNTER::Report|Biblio::COUNTER::Report>. (Ignore this, too.)
A string of the form YYYY-mm denoting the period in question.
The type of event counted (requests, sessions, searches, or turnaways).
requests
sessions
searches
turnaways
The count itself.
The platform on which the resource was provided.
The resource title.
The resource's publisher. May be the empty string.
The journal's print ISSN.
The journal's online ISSN.
The book's ISBN.
Be verbose. The effect of this depends on the action to be taken.
Print help information and exit.
Print the version number and exit. If the -v or --verbose option is specified, print out additional information.
View the manual page for counterproc.
View the license under which counterproc is distributed.
Paul Hoffman (nkuitse AT nkuitse DOT com)
Copyright 2008-2009 Paul M. Hoffman.
This module is free software; you can redistribute it and/or modify it under the same terms as Perl:
the GNU General Public License as published by the Free Software Foundation; either version 1, or (at your option) any later version;
or
the "Artistic License".
For the full text of these licenses, see the script file itself or enter the command counterproc -L.
Biblio::COUNTER
Biblio::COUNTER::Report
Biblio::COUNTER::Report::Processor::Simple
Biblio::COUNTER::Report::Processor::Validate
Biblio::COUNTER::Report::Processor::Atomize
To install Biblio::COUNTER, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Biblio::COUNTER
CPAN shell
perl -MCPAN -e shell install Biblio::COUNTER
For more information on module installation, please visit the detailed CPAN module installation guide.