Criando um conector de impressão universal
Este artigo contém ponteiros para recursos, bem como informações para ajudar os 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.
Registro de ID do Cliente
O registro da ID do Cliente é a etapa necessária para configurar sua identidade da ID do Microsoft Entra para se comunicar com a Universal Print. Consulte Registro de ID do cliente da impressora. O artigo descreve o registro de ID do cliente para impressoras que têm suporte a impressão universal em seu firmware. Isso se aplica ao conector, uma vez que o conector atua em nome de impressoras que não têm essa capacidade em seu firmware.
Fluxo geral
Consulte a seção 4 "Modelo" da especificação IPP Shared Infrastructure Extensions (IPP-Infra). Este documento será mencionado mais adiante neste artigo.
No caso da Impressão Universal
- O Universal Print IPP Service atua como a "IPP Infrastructure Printer". Para recuperar o URI para o 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.
Registro da impressora
Consulte o registro da impressora conectora 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 registro da impressora, um certificado é gerado para a impressora. Esse certificado é usado para autenticar todas as solicitações subsequentes enviadas à Universal Print em nome da impressora (consulte Obtendo um token de impressora). Armazene o certificado com segurança!
Atualizando atributos de descrição da impressora
Consulte a tarefa Proxy IPP chamada "Inicialização" no diagrama de sequência na página 20 na especificação IPP-Infra para contexto.
Lista de atributos de descrição de impressora suportados
Atributo IPP | Atributo IPP |
---|---|
charset configurado | pdf-fit-to-page-default |
Suportado por charset | pdf-fit-to-page-default |
Compatível com compactação | PDF-K-Octetos suportados |
cópias-padrão | restrições de tamanho pdf |
Cópias suportadas | PDF-versões-suportadas |
formato de documento padrão | apresentação-direção-número-up-default |
suporte para formato de documento | apresentação-direção-número-up-suportado |
acabamentos-padrão | modo de impressão-cor-padrão |
acabamentos suportados | Suportado pelo modo de cor de impressão |
gerado-natural-languages-suportado | printer-is-accepting-jobs |
IPP com suporte a recursos | localização da impressora |
IPP versões-suportadas | impressora-marca-e-modelo |
mídia-col-banco de dados | impressora-mais-info |
media-col-default | nome da impressora |
padrão de mídia | impressora-resolução-padrão |
suporte de fonte de mídia | Compatível com resolução de impressora |
suporte de mídia | estado da impressora |
tipo de mídia suportado | razões do estado da impressora |
múltiplo-documento-manipulação-padrão | Tempo de atividade da impressora |
Suporte para manipulação de vários documentos | Impressora-URI-suportado |
com suporte para vários trabalhos de documentos | qualidade de impressão padrão |
Configurado em linguagem natural | com suporte para qualidade de impressão |
number-up-default | print-scaling-padrão |
suporte para aumento de número | Compatível com dimensionamento de impressão |
Operações suportadas | contagem de trabalhos em fila |
orientação-requested-default | lados-padrão |
orientação-solicitada-suportada | laterais suportadas |
output-bin-default | Suportado pela autenticação URI |
output-bin-suportado | Suportado por segurança URI |
Dica
Para obter a documentação de valores aceitáveis para esses atributos, consulte https://www.iana.org/assignments/ipp-registrations/ipp-registrations.xhtml.
Atributos de conector personalizado da Microsoft
Nome do atributo | Tipo | Comentários |
---|---|---|
microsoft-universal-print-connector-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. |
microsoft-universal-print-connector-operating-system | 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-printer-driver-name | 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-printer-driver-version | 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. |
Configurando a notificação para impressoras
O conector faz a maior parte de sua comunicação com a Universal Print por meio do Universal Print Notification Service. Por meio do mecanismo de notificação, o conector pode receber eventos sobre ações que precisa executar 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 ao Serviço Universal de Notificação de Impressão (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.
Imprimindo
Consulte o fluxo a partir da tarefa Proxy IPP chamada "Recuperar Trabalho da Impressora de Infraestrutura" 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 Obter Trabalhos em diante).
Cancelando o registro de impressoras
Consulte Excluir impressora na API do Microsoft Graph.