Uso da API sendToPrinter

Visão geral

No AEM Forms, você pode usar o serviço SendToPrinter para enviar um documento para a impressora. O serviço SendToPrinter suporta os seguintes mecanismos de acesso de impressão:

  • Impressora acessível diretamente : 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.

  • Impressora acessível indiretamente : 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.

    Ao enviar um documento para uma impressora, especifique um destes protocolos de impressão:

    • 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: O serviço de Saída suporta o protocolo de impressão CIFS (Common Internet File System).

Usando o Serviço SendToPrinter

A tabela abaixo listas:

  • informações sobre o printerName ou printServer a ser usado para vários protocolos.
  • valor ou exceção que uma impressora retorna para várias combinações de URI e Nome do Servidor de Impressora
Protocolo (mecanismo de acesso) URI do servidor de impressão (PrinterSpec.printServer) Nome da impressora (PrinterSpec.printerName) Resultado
SharedPrinter Qualquer Vazio Exceção: O argumento necessário sPrinterName não pode estar vazio.
SharedPrinter Qualquer Inválido Uma exceção indica que a impressora não foi encontrada.
SharedPrinter Qualquer Válido Trabalho de impressão bem-sucedido.
LPD Vazio Qualquer uma exceção informando que o argumento necessário sPrintServerUri não pode estar vazio.
LPD Inválido Vazio uma exceção informando que o argumento necessário sPrinterName não pode estar vazio.
LPD Inválido Não vazio uma exceção informando que sPrintServerUri não foi encontrada.
LPD Válido Inválido uma exceção informando que a impressora não pode ser encontrada.
LPD Válido Válido Um trabalho de impressão bem-sucedido.
CUPS Vazio Qualquer uma exceção informando que o argumento necessário sPrintServerUri não pode estar vazio.
CUPS Inválido Qualquer uma exceção informando que a impressora não pode ser encontrada.
CUPS Válido Qualquer Trabalho de impressão bem-sucedido.
DirectIP Vazio Qualquer uma exceção informando que o argumento necessário sPrintServerUri não pode estar vazio.
DirectIP Inválido Qualquer uma exceção informando que a impressora não pode ser encontrada.
DirectIP Válido Qualquer Trabalho de impressão bem-sucedido.
CIFS Válido Vazio Trabalho de impressão bem-sucedido.
CIFS Inválido Qualquer erro desconhecido ao imprimir usando CIFS.
CIFS Vazio Qualquer uma exceção informando que o argumento necessário sPrintServerUri não pode estar vazio.

Suporte de autenticação

A autenticação é suportada apenas para impressão CIFS. Para autenticar, forneça o nome de usuário/senha/domínio em PrinterSpec. Você pode criptografar uma senha usando AEM Serviço CyprtoSupport Granite executando as seguintes etapas:

  1. Vá para https://<servidor>:<porta>/sistema/console.

  2. Vá para Principal > Suporte de criptografia.

  3. Digite um texto simples e clique em Protect.

Nesta página