Construindo um conector de impressão universal
Este artigo contém ponteiros para recursos, bem como informações para ajudar ISVs a criar um conector de impressão universal.
Para obter informações básicas sobre o conector, consulte a visão geral do conector de impressão universal.
Registo de ID de Cliente
O registro da ID do Cliente é a etapa necessária para configurar sua identidade do Microsoft Entra ID para se comunicar com o Universal Print. Consulte Registro de ID do cliente da impressora. O artigo descreve o registro de ID de cliente para impressoras que têm suporte Universal Print em seu firmware. Aplica-se ao conector, uma vez que o conector atua em nome de impressoras que não têm essa capacidade em seu firmware.
Fluxo global
Consulte a secção 4 "Modelo" da especificação IPP Shared Infrastructure Extensions (IPP-Infra). Este documento será referido mais adiante neste artigo.
No caso da Universal Print
- O Serviço IPP de Impressão Universal atua como a "Impressora de Infraestrutura IPP". Para recuperar o URI do ponto de extremidade do serviço IPP, consulte o tipo de recurso printService na API do Microsoft Graph.
- O conector atua como o "Proxy IPP".
Tarefas do conector
O conector executa uma série de tarefas em nome das impressoras instaladas nele. Esta seção inclui as informações necessárias para implementar essas tarefas de conector.
Registo da impressora
Consulte o registro da impressora do conector para obter informações básicas.
O fluxo de registro da impressora é descrito no registro da impressora Universal Print.
Importante
No final do processo de registo da impressora, é gerado um certificado para a impressora. Este certificado é utilizado para autenticar todos os pedidos subsequentes enviados para a Universal Print em nome da impressora (consulte Obter um token de impressora). Guarde o certificado em segurança!
Atualizando atributos de descrição da impressora
Consulte a tarefa de proxy IPP chamada "Inicialização" no diagrama de sequência na página 20 na especificação IPP-Infra para obter o contexto.
Lista de atributos de descrição da impressora suportados
| Atributo IPP | Atributo IPP |
|---|---|
| configurado para charset | pdf-fit-to-page-padrão |
| suportado por charset | pdf-fit-to-page-padrão |
| suportado por compressão | pdf-k-octets-suportado |
| cópias-padrão | restrições de tamanho pdf |
| cópias suportadas | pdf-versões-suportadas |
| documento-formato-padrão | apresentação-direção-número-up-default |
| com suporte para formato de documento | apresentação-direção-número-up-suportado |
| acabamentos-padrão | print-color-mode-default |
| acabamentos suportados | suportado pelo modo de impressão e cor |
| gerado-natural-idiomas-suportados | printer-is-accepting-jobs |
| IPP-Recursos-suportados | localização da impressora |
| IPP-versões-suportadas | impressora-marca-e-modelo |
| media-col-database | impressora-mais-info |
| media-col-padrão | nome da impressora |
| mídia-padrão | impressora-resolução-padrão |
| suporte a fonte de mídia | com suporte para resolução de impressora |
| suportado por mídia | estado-impressora |
| suportado por tipo de mídia | impressora-estado-razões |
| múltiplo-manipulação-documento-padrão | tempo de atividade da impressora |
| com suporte para manipulação de vários documentos | Printer-URI-suportado |
| com suporte a vários trabalhos de documentos | qualidade de impressão-padrão |
| configurada em linguagem natural | suportado com qualidade de impressão |
| número-up-default | print-scaling-default |
| número suportado | suportado por dimensionamento de impressão |
| suportado por operações | contagem de trabalhos em fila |
| orientação-solicitado-padrão | laterais-padrão |
| orientação-solicitado-suportado | Laterais-suportadas |
| saída-bin-padrão | URI-Autenticação-suportada |
| suportado pelo output-bin- | URI-Security-suportado |
Gorjeta
Para obter a documentação de valores aceitáveis para esses atributos, consulte https://www.iana.org/assignments/ipp-registrations/ipp-registrations.xhtml.
Atributos do conector personalizado da Microsoft
| Nome do atributo | Tipo | Comentários |
|---|---|---|
| microsoft-universal-print-conector-app-version | Texto com idioma | Metadados do conector usados para identificar o conector quando as informações de solução de problemas são coletadas. Ele está incluído na operação Update-Output-Device-Attributes da impressora. |
| sistema operacional microsoft-universal-print-connector | Texto com idioma | Metadados do conector usados para identificar o conector quando as informações de solução de problemas são coletadas. Ele está incluído na operação Update-Output-Device-Attributes da impressora. |
| microsoft-universal-impressora-driver-nome | Texto com idioma | Usado pelo conector/impressora para identificar o driver de impressora usado pela impressora. Ele está incluído na operação Update-Output-Device-Attributes da impressora. |
| microsoft-universal-impressora-driver-versão | Texto com idioma | Usado pelo conector/impressora para identificar a versão do driver de impressora usada pela impressora. Ele está incluído na operação Update-Output-Device-Attributes da impressora. |
| microsoft-output-device-job-state-message | Texto sem idioma | Usado pelo conector/impressora para especificar uma mensagem de erro estendida quando um trabalho de impressão falha. Ele é incluído quando a impressora chama a operação UpdateJobStatus. Isso pode incluir um código de erro subjacente, pilha/mensagem de exceção ou detalhes não PII que ajudam a solucionar a falha do trabalho. |
Configurar a notificação para impressoras
O conector faz a maior parte de sua comunicação com o Universal Print através do Universal Print Notification Service. Através do mecanismo de notificação, o conector pode receber eventos sobre ações que precisa tomar em nome das impressoras (por exemplo, buscar um trabalho de impressão pendente).
O mecanismo de notificação 'ippget' descrito no RFC 3996 é a maneira de configurar um canal de notificação baseado em eventos com o Universal Print. Sem esse canal, o conector deve enviar continuamente solicitações para o Universal Print Notification Service (ou seja, ter um canal de notificação baseado em sondagem) para recuperar dados de eventos.
Para obter o URI para o ponto de extremidade do Serviço de Notificação, consulte o tipo de recurso printService na API do Microsoft Graph.
Impressão
Consulte o fluxo a partir da tarefa IPP Proxy chamada "Retrieve Job from Infrastructure Printer" no diagrama de sequência na página 20 na especificação IPP-Infra.
Consulte a Página 20 na Especificação IPP (siga o diagrama de sequência de Get Jobs em diante).
Cancelar o registro de impressoras
Consulte Excluir impressora na API do Microsoft Graph.