Usar la API sendToPrinter

Última actualización: 2023-03-15
  • Creado para:
  • User

Información general

En AEM Forms, puede utilizar el servicio SendToPrinter para enviar un documento a la impresora. El servicio SendToPrinter es compatible con los siguientes mecanismos de acceso de impresión:

  • Impresora accesible directamente : A printer that is installed on the same computer is called a direct accessible printer, and the computer is named printer host. This type of printer can be a local printer that is connected to the computer directly.

  • Impresora accesible indirectamente : The printer that is installed on a print server is accessed from other computers. Technologies such as the common UNIX® printing system (CUPS) and the Line Printer Daemon (LPD) protocol are available to connect to a network printer. To access an indirect accessible printer, specify the print server’s IP or host name. Using this mechanism, you can send a document to an LPD URI when the network has an LPD running. The mechanism lets you route the document to any printer that is connected to the network that has an LPD running.

    Cuando envíe un documento a una impresora, especifique uno de estos protocolos de impresión:

    • CUPS : A printing protocol named common UNIX printing system. This protocol is used for UNIX operating systems and enables a computer to function as a print server. The print server accepts print requests from client applications, processes them, and sends them to configured printers. On the IBM AIX® operating system, usage of CUPS is not recommended.
    • ``DirectIP : A standard protocol for remote printing and managing print jobs. This protocol can be used locally or remotely. Print queues are not required.
    • ``LPD : A printing protocol named Line Printer Daemon protocol or Line Printer Remote (LPR) protocol. This protocol provides network print server functionality for UNIX-based systems.
    • SharedPrinter : A printing protocol that enables a computer to use a printer that is configured for that computer.
    • CIFS: El Servicio de salida es compatible con el protocolo de impresión del Sistema común de archivos de Internet (CIFS).

Uso del servicio SendToPrinter

La tabla siguiente enumera:

  • información sobre el printerName o printServer que se utilizará para varios protocolos.
  • valor o excepción que devuelve una impresora para varias combinaciones de URI de servidor de impresora y nombre de la impresora
Protocolo (mecanismo de acceso) URI del servidor de impresora (PrinterSpec.printServer) Nombre de la impresora (PrinterSpec.PrinterName) Resultado
SharedPrinter Cualquiera Vacío Excepción: El argumento requerido sPrinterName no puede estar vacío.
SharedPrinter Cualquiera No válido Una excepción indica que no se puede encontrar la impresora.
SharedPrinter Cualquiera Válido Trabajo de impresión correcto.
LPD Vacío Cualquiera una excepción que indica que el argumento requerido sPrintServerUri no puede estar vacío.
LPD No válido Vacío una excepción que indica que el argumento requerido sPrinterName no puede estar vacío.
LPD No válido No vacío excepción que indica que no se encuentra sPrintServerUri.
LPD Válido No válido una excepción que indica que no se puede encontrar la impresora.
LPD Válido Válido Un trabajo de impresión correcto.
CUPS Vacío Cualquiera una excepción que indica que el argumento requerido sPrintServerUri no puede estar vacío.
CUPS No válido Cualquiera una excepción que indica que no se puede encontrar la impresora.
CUPS Válido Cualquiera Trabajo de impresión correcto.
DirectIP Vacío Cualquiera una excepción que indica que el argumento requerido sPrintServerUri no puede estar vacío.
DirectIP No válido Cualquiera una excepción que indica que no se puede encontrar la impresora.
DirectIP Válido Cualquiera Trabajo de impresión correcto.
CIFS Válido Vacío Trabajo de impresión correcto.
CIFS No válido Cualquiera error desconocido al imprimir con CIFS.
CIFS Vacío Cualquiera una excepción que indica que el argumento requerido sPrintServerUri no puede estar vacío.

Compatibilidad con autenticación

La autenticación solo es compatible para la impresión CIFS. Para autenticarse, proporcione el nombre de usuario/contraseña/dominio en PrinterSpec. Puede cifrar una contraseña utilizando el servicio Granite Crypto Support de AEM al seguir estos pasos:

  1. Vaya a https://<server>:<port>/system/console.

  2. Vaya a Principal > Crypto Support.

  3. Introduzca texto sin formato y haga clic en Proteger.

En esta página