Visão geral da API de impressão em nuvem da Impressão Universal

  • Artigo

A Impressão Universal é uma solução moderna que as organizações podem usar para gerir a infraestrutura de impressão através de serviços de nuvem da Microsoft.

Captura de tela da página inicial do portal da Impressão Universal do Azure

Por que usar a Impressão Universal?

A Impressão Universal move a funcionalidade de impressão do Windows Server para a nuvem do Microsoft 365, para que as organizações não precisem mais de servidores de impressão locais e não precisem instalar drivers de impressora em dispositivos. Além disso, a Impressão Universal adiciona funcionalidades fundamentais, como grupos de segurança para acesso à impressora, descoberta de impressora baseada no local e uma experiência de administrador avançada.

Como as organizações adotam a Impressão Universal, as organizações e os fornecedores independentes de software (ISVs) podem usar a API de Impressão Universal no Microsoft Graph para criar e ampliar aplicativos para suportar novos cenários.

Mover a infraestrutura de impressão para a nuvem permite imprimir documentos diretamente de aplicativos da Web e móveis.

  • Os usuários podem enviar trabalhos de impressão para o printerShare.
  • Os administradores da impressora também podem enviar trabalhos de impressão, para fazer testes preliminares antes de compartilhar a impressora com a organização.

Siga estas etapas para enviar trabalhos de impressão para o printerShare:

  1. Crie um trabalho de impressão e armazene a ID do documento resultante.
  2. Crie uma uploadSession para o documento.
  3. Bytes de upload para a sessão de upload criada.
  4. Iniciar o trabalho de impressão.

Gerenciar impressoras

É uma tarefa complexa acompanhar as impressoras de uma organização, suas configurações e uso. A API de Impressão Universal permite a integração em todas as três áreas.

Substituir ou atualizar o hardware da impressora sem problemas

As impressoras não são visíveis para os utilizadores até serem partilhadas, fornecendo aos administradores um controlo detalhado sobre o hardware da impressora que está disponível num determinado momento.

O compartilhamento de uma impressora cria um recurso printerShare que pode ser atualizado a qualquer momento para indicar uma impressora diferente, facilitando a substituição de hardware de uma impressora quebrada ou a desativação de impressoras para manutenção.

Para usá-lo em seu aplicativo, use Update printerShare para atualizar a referência printer de printerShare.

Habilitar impressão segura

A API de Impressão Universal do Microsoft Graph permite que o seu aplicativo suporte a impressão segura. Para configurar a impressão por solicitação, regista acionadores que notificam a sua aplicação (através da comunicação serviço a serviço) quando ocorrem determinados eventos de impressão, como uma tarefa de impressão a ser iniciada.

Esses acionadores permitem que o seu aplicativo interrompa o fluxo de trabalho de impressão para fazer coisas como redirecionar os trabalhos para diferentes impressoras e modificar o conteúdo do documento.

Siga estes passos para habilitar a impressão segura:

  1. Crie uma Definição de Tarefa de impressão usando as permissões do aplicativo. Esta definição de tarefa abstrata é utilizada para criar uma tarefa que irá manter a tarefa para a sua aplicação. É necessário estabelecer pelo menos uma definição de tarefa por inquilino, que pode ser associada a qualquer número de impressoras, usando acionadores de tarefa (ver etapa 4).

  2. Registe uma ou mais impressoras virtuais com um token de autenticação de administrador e um nullphysicalDeviceId. Sem um dispositivo físico acoplado, uma "impressora virtual" é apenas um objeto de impressora na Impressão Universal. Normalmente, os utilizadores imprime em impressoras virtuais e, mais tarde, recolhem as tarefas de impressão num dispositivo de impressão física. Veja o passo 6.

  3. Atualize os atributos de sua impressora virtual usando as permissões do aplicativo e um application/ipp tipo de mídia (veja exemplos).

  4. Crie um acionador de tarefas para sua impressora virtual usando um token de autenticação de administrador que irá associar a definição da sua tarefa com a impressora virtual. O appId usado para gerar o token de acesso deve ser o mesmo appId que foi usado para criar a definição de tarefa.

  5. Quando uma tarefa de impressão é submetida para a impressora virtual, esta é colocada em pausa devido ao printTaskTrigger. Uma Tarefa de impressão com processingestado será criada com base na Definição da Tarefa de impressão associada.

  6. Quando o utilizador percorra um distintivo num dispositivo de impressora física, a impressora notifica a sua aplicação. Nessa altura, o seu aplicativo pode buscar os trabalhos da impressora virtual associada e filtrar a lista de trabalhos criados pelo usuário atual.

  7. Quando o usuário seleciona um ou mais trabalhos para imprimir, seu aplicativo pode redirecionar o(s) trabalho(s) de impressão para a impressora física e o trabalho começará a imprimir! A chamada de redirecionamento só terá sucesso se houver uma Tarefa de impressão em processing estado na impressora associada iniciada por um acionador que este aplicativo criou no passo 4. A tarefa será automaticamente definida para o completed estado após o redirecionamento.

Referência da API

Está procurando a referência de API para esse serviço?

Faça comentários

Gostaríamos de ouvir seus comentários sobre as APIs de Impressão Universal. Forneça suas sugestões no fórum de ideias daPlataforma de Desenvolvedor do Microsoft 365.

Conteúdo relacionado