Prints
a document, such as a PostScript file, using the specified printer
protocol.
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 propertiesProperties to specify the document and destination.
Input DocumentA 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.
|
|
|