Fields

Description

Profile Name

Enter the name of the Printer Profile.

Output Type

Select the printer spooler type from the Output Type drop-down list. The selection displays different fields depending on the selected type. See the table below for more information.

Description

Enter a full description for the Printer Profile.

Buttons

Exit

Click Exit to close the screen

Save

Click Save to save the Printer Profile

Cancel

Click Cancel to cancel any changes to the Printer Profile.

New

Click New to create a new Printer Profile.

Delete

Click Delete to delete the selected Printer Profile.

Fields

Description

Output Type

The table details the Output Types. Selection of a type determines the fields that are displayed. This table defines the extra fields for each type, if you want to know more about a field for a particular Output Type, refer elsewhere in this table for the field.

Default

The output for the report follows the settings for the Operator, which is determined by their Operator Group.

Suppress Page Header

Click the check box suppress the output of the page header defined against the report.

Suppress 1st Form Feed

Click the check box to suppress the output of the PROIV standard report 1st line (not defined in the report).

Suppress 1st Line

Click the check box to suppress the first form feed.

Suppress Fields

Click the check box to only output headers, not the data fields.

Logical Printer

This sets the report output to go to one of the ten logical printers that can be set up in a PROIV Environment. These can map to physical printers through the server or the client.

Printer Name

Choose LP0 – LP9 from the list. These are the PROIV logical printers which can be mapped to server printers, client printers, physical files, etc.

Form Id

Enter the system specific spooler command string. This is system dependent.

No. of Copies

Set the number of copies that are printed (if the spooler system supports this).

Raw Mode

Click the check box to output with no interpretation of control characters.

Group Output

Click the check box to leave a spool file open at the end of output, so that subsequent reports and documents are appended to that spool file for printing.

Spool Output

Click the check box to spool the output. This only applies to multi-tasking systems that support spooling

Create Hold File

This is used when creating spooled output. Click check box to create a physical file with the function name same as the file name, and a file extension of PRT.

Printer Queue

This option sends the report output to an operating system printer queue. This could be logical or physical.

Queue Name

Enter the spooler system queue name. Depending on the operating system, and how the spooler is configured, this could be a physical printer name, or a logical queue name.

Printer Port

This option sends the report output to your local PC printer port (e.g. LPT1).

Port Number

Choose LPT1 – LPT9 from the list.

Network Printer via Client

This option sends the report output to a printer available to your local PC via the network.

Printer Name

Choose LP0 – LP9 from the list. These are the PROIV logical printers which can be mapped to server printers, client printers, physical files, etc.

Attached Printer

This option sends the report output to the printer physically attached to your local PC.

Screen

This option sends the report output to your screen.

Client File

Enter the default file extension (and optionally file name) on the client.

Physical File

This option sends the report output to a physical file on the server.

Physical Device

This option sends the report output to a named physical device on the server.

Device

The name of the physical device to be output to.

Screen with Delimited Output

This option sends the report output to your screen, in a character-delimited form, ignoring the formatting as defined in the Report function. The delimiter is user-defined.

Delimiter

Choose the delimiter to use from the list of standard delimiters, or enter a string of no more than 4 characters. Special characters can also be used, escaped with a backslash.

File with Delimited Output

This option sends the report output to a physical file on the server, in a character-delimited form, ignoring the formatting as defined in the Report function. The delimiter is user-defined.

API – for Bus & Tasks

This option sends the report output through the PROIV Bus to a 3rd party application. This is only applicable if the report is being called by a Task. The output is in character-delimited form, ignoring the formatting as defined in the Report function. The delimiter is user-defined.

XML – to Screen

Allows the transformation of an XML report to a document (usually in PDF format but other formats can be used). The report is then rendered on a workstation running the PROIV Client. If a file name is specified in the Client File field, a physical file is created on the client. The formatting of the output, as defined in the Report function, is ignored.

Client File

Enter a file type extension which the client will use to open the report. For example, entering .pdf opens the report the program associated with the .pdf file extension. You can also enter the name of the physical file which is output to the PROIV Client.  For example, entering myreport.pdf in the field will send the report to a physical file called myreport.pdf and open it with the application associated with .pdf extension.

Alternate Tag Names

Click the check box to use alternate tag names. If no XML tag names are specified in the report definition, the PROIV generates generic tag names. Checking this box tells PROIV to use a different standard for the generic tag names.

Explicit Tag Names Only

Click the check box to use explicit tag names, which limits the XML output to those data elements that have explicitly defined XML tag names. This enables an existing PROIV Report to be easily made to run in both XML mode and normal mode, with only the required elements output as XML.

Output Source Attribute

Click the check box to outputs the source of the element as an attribute in the XML tag.

Don’t Indent Output

Click the check box to turn indenting off. Generally, the XML output will be indented to show nesting. Checking this turns the indenting off. It is important to note that this will have no impact on PDF printing.

Suppress Sequence Nos

Click the check box to suppress the Sequence attribute for XML output. The attribute is automatically generated on all record elements and suppressing it for XML output ensures that the output can be used for other purposes such as versioning and differencing.

XML Transform

Enter the name of the XSL file which transforms the XML into 'human-readable' documents. The XSL files must be stored on the server in the directory specified by the environment variable PROIV_XSL (or in the default /xsl directory) if they are to be found at runtime. The PROIV_XSL environment variable is set in the prov4v[n].ini file. If the Client File and XML Transform fields are left empty, the raw XML is created and displayed in the associated XML viewer.

XML – to Physical File

This option enables you to send a report output to a physical file on a server in XML or PDF format (if a XML transform is used). The formatting of the output, as defined in the Report function, is ignored.

File Name

Enter the name of the physical file which is output to the server. The field is limited to 80 characters, accepts free text, and has no validation. For example, entering myreport.pdf in the field will send the report to a physical file called myreport.pdf to the server. You can also enter a physical path of where you want the output to be placed on the server. If the file already exists on the server it will be overwritten by the new output and no warning appears.

XML – to the Bus & Tasks API

This option sends the report output through the PROIV Bus to a 3rd party application. This is only applicable if the report is being called by a Task. The formatting of the output, as defined in the report function, is ignored.