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 ficam visíveis para os usuários até que sejam compartilhadas, fornecendo aos administradores controle refinado sobre qual hardware de impressora está disponível em um 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 pull, você registra gatilhos que notificam seu aplicativo (via comunicação de serviço em serviço) quando determinados eventos de impressão acontecem, como um trabalho de impressão sendo iniciado.

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. Essa definição de tarefa abstrata é usada para criar uma tarefa que manterá o trabalho para seu aplicativo. É 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. Registre uma ou mais impressoras virtuais usando 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 usuários imprimem em impressoras virtuais e, posteriormente, pegam seus trabalhos de impressão em um 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 um trabalho de impressão é enviado à impressora virtual, ele é pausado 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 usuário desliza um selo em um dispositivo de impressora física, a impressora notifica seu aplicativo. 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