DFprintdb — Print case report forms merged with data records from the study database
DFprintdb
[-d]
[-A]
[-usealias]
[-p string]
[-i string]
[-o string]
[-t string]
[-e platelist|all]
{-s #}
DFprintdb prints case report forms merged with data records from a study database. One page is printed for each data record in the input file, and is bookmarked by the record keys: subject ID, visit and then plate. Printed output is either sent directly to the printer or the named output file.
DFprintdb uses the high resolution backgrounds previously generated by DFsetup during a operation. A background, named DFbkgd###.png is created for each CRF plate, where ### is the plate number. If tagged backgrounds also exist, e.g. DFbkgd###_all_SPA.png for a Spanish background used at all visits for plate ###, they can be requested using the -t option.
If the high resolution PNG background does not exist for a plate, DFprintdb will print the field widgets and the data they contain on a blank background.
-d | the input file is in DFdiscover Retrieval File (DRF) format where each input record contains only the record keys. Without this option, each record is assumed to be in data export format. |
-A | size the output pages for A4 paper rather than the default US-letter size. |
-usealias | output the subject alias, if defined, in place of the subject ID. If there is no subject alias, output the subject ID. |
-p string | the name of the printer that the output should be sent to. The default is the printer defined by the study configuration. |
-i string | the input file of data records that are
to be merged for printing. Records are assumed to be in the format output by a
previous DFexport.rpc, unless |
-o string | the name of the output file. Instead
of printing directly to the printer the output can be re-directed to a file
with this argument. If both |
-t string | the CRF background type. If the study setup includes backgrounds tagged with different type names, this option can be used to select the type to be used for printing. For example, -t SPA to use Spanish backgrounds, if a Spanish version of the CRFs was imported and tagged with 'SPA'. If this option is omitted, or used but the specified type does not exist for a particular plate, the default CRF background (i.e. untagged version) will be used if one exists. |
-e platelist|all | plates for which text fields may expand beyond their display size. Without this option printed text is truncated if it exceeds the field display size. For example, allows text field expansion, if necessary, on plates 10 to 15 and 22; while allows text expansion on all plates. NOTE: expanded text may cover other data fields on the plate and thus should be used only on plates with empty space into which text fields can expand. |
-s | the DFdiscover study number (required). |
DFprintdb exits with one of the following statuses:
0 | The command was successful. |
36 | The required command-line arguments were not present or were incorrectly specified. |
> 0 | The database server could not be contacted, communication with the database server failed, the study number is not defined, the database setup cannot be read, the input file cannot be read, or the output file cannot be written. |