Show Menu
TÓPICOS×

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 lista:
  • 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 o serviço CyprtoSupport AEM Granite executando as seguintes etapas:
  1. Vá para https://<servidor>:<porta>/sistema/console.
  2. Vá para Principal > Suporte a criptografia .
  3. Insira um texto simples e clique em Proteger .