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 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
Adding and removing user name and password
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.
|
|
|