sendToPrinter operation

Prints a document, such as a PostScript file, using the specified printer protocol.

The Archive wizard can be used to add this operation to a process. (See Preserving process results using the Archive Wizard.)

For example, your application requires that a record from a data file is merged with a form design, and generates a PostScript file. The PostScript file is then sent to a printer. Use the sendToPrinter operation to send the generated output to a printer.

For information about the General and Route Evaluation property groups, see Common operation properties.

Input properties

Properties to specify the document and destination.

Input Document

A document value that contains a document output to send to the specified printer. If you are printing a PDF document, the PDF document must be flattened before you to can use this operation.

If you provide a literal value, clicking the ellipsis button  opens the Select an Asset dialog box. (See About Select Asset.)

Printer Protocol

(Optional) A PrinterProtocol value that represents the printer protocol to use.

If you provide a literal value, select one of these values:

CUPS:
An indirect method to access the print server. A valid print server must be specified.

DirectIP:
A direct method using internet protocols to access the print server that uses the default port 9100. A valid print server must be specified.

LPD:
An indirect method to access the specified printer by name through the print server. A valid print server and printer must be specified.

SharedPrinter:
A direct method to access the printer directly by name. A valid printer name must be specified.
Note: You cannot use the Shared Printer protocol for the sendToPrinter operation when the LiveCycle Server runs on Windows 2008 and has the PDF Generator service deployed. Use alternate protocols like CIFS or Direct IP.

CIFS:
A direct method using the Common Internet File System printing protocol to access a printer or print server. When you use CIFS as a protocol, specify the Universal Naming Convention (UNC) name for the printer or shared printer queue in the Server URI property.

To authenticate with a network printer when using the CIFS protocol, add a password credential to the Trust Store. Use the URL of the printer as the credential name (alias), for example \\print-server.domain.com\printer. The credential defines a user name and password that can authenticate against the printer. For information about creating the credential, see Managing certificates and credentials. In a domain with many printers that share the same credentials, you can also give the the network path of the domain as an alias in the Trust Store. This enables the alias to be used for multiple printers sharing the same credentials in the domain. The Output service looks for the credentials of a printer with URI \\print-server.domain.name.com\printer by looking up aliases in the Trust Store in the following order:

\\print-server.domain.name.com\printer 
\\print-server.domain.name.com  
\\domain.name.com  
\\name.com 
\\com 
\\

Server URI

(Optional) A string value that represents the URI of the print server to use that is useful for LPD, CUPS, Direct IP, CIFS, printer protocols. The LiveCycle Server must have access to the print server.

When you use CIFS, use UNC names, such as \\sharedqueue\printername or \sharedqueue.

Printer Name

(Optional) A string value that represents the name of a particular printer on the specified print server. This value is useful when you set the Printer Protocol property to SharedPrinter or LPD.

Exceptions

This operation can throw an OutputException exception.

// Ethnio survey code removed