Introducción a la API de impresión en la nube de Impresión universal

  • Artículo

Impresión universal es una solución de impresión moderna que las organizaciones pueden usar para administrar su infraestructura de impresión a través de los servicios en la nube de Microsoft.

Captura de pantalla de la página principal de Impresión universal de Azure Portal

¿Por qué usar Impresión universal?

Impresión universal traslada la funcionalidad clave de impresión de Windows Server a la nube de Microsoft 365, por lo que las organizaciones ya no necesitan servidores de impresión locales y no tienen que instalar controladores de impresoras en los dispositivos. Asimismo, la impresión universal ofrece funciones clave como grupos de seguridad para el acceso a las impresoras, detección de impresoras basada en la ubicación y una experiencia de administración enriquecida.

A medida que las organizaciones adopten la impresión universal, las organizaciones y los proveedores de software independientes (ISV) pueden usar la API de Impresión universal de Microsoft Graph para crear aplicaciones y ampliarlas a fin de admitir nuevos escenarios.

Trasladar la infraestructura de impresión a la nube permite imprimir documentos directamente desde aplicaciones web y móviles.

  • Los usuarios pueden enviar trabajos de impresión a printerShare.
  • Los administradores de impresoras también pueden enviar trabajos de impresión a una impresora para realizar pruebas preliminares antes de compartir la impresora con la organización.

Siga estos pasos para enviar trabajos de impresión a printerShare:

  1. Cree un trabajo de impresión y guarde el id. del documento resultante.
  2. Cree una uploadSession para el documento.
  3. Cargar bytes en la sesión de carga.
  4. Inicie el trabajo de impresión.

Administrar impresoras

Realizar el seguimiento de las impresoras de la organización, de las configuraciones y del uso de las impresoras es una tarea compleja. La API de Impresión universal permite la integración en las tres áreas.

Reemplazar o actualizar el hardware de las impresoras sin problemas

Las impresoras no son visibles para los usuarios hasta que se comparten, lo que proporciona a los administradores un control específico sobre qué hardware de impresora está disponible en un momento dado.

El uso compartido de una impresora crea un recurso printerShare que puede actualizarse en cualquier momento para apuntar a otra impresora, lo que hace que sea más fácil reemplazar el hardware de impresoras averiadas o dejar impresoras sin conexión para tareas de mantenimiento.

Para usar esto en la aplicación, use Update printerShare para actualizar la referencia printer del recurso printerShare.

Habilitar impresión de extracción

La API de Impresión universal de Microsoft Graph permite que su aplicación sea compatible con la impresión pull. Para configurar la impresión de extracción, registre desencadenadores que notifiquen a la aplicación (a través de la comunicación de servicio a servicio) cuando se produzcan determinados eventos de impresión, como un trabajo de impresión que se está iniciando.

Estos desencadenadores permiten a su aplicación interrumpir el flujo de trabajo de impresión para hacer tareas como redirigir los trabajos a diferentes impresoras y modificar la carga del documento.

Siga estos pasos para habilitar la impresión pull:

  1. Crear una printTaskDefinition usando la aplicación de permisos. Esta definición de tarea abstracta se usa para crear una tarea que contenga el trabajo de la aplicación. Es necesario establecer al menos una definición de tarea por inquilino, que se puede asociar a cualquier número de impresoras del inquilino utilizando desencadenadores de tareas (vea el paso 4).

  2. Registre una o varias impresoras virtuales mediante un token de autenticación de administrador y un nullphysicalDeviceId. Una "impresora virtual" es sólo un objeto de impresión en Impresión universal sin un dispositivo físico adjunto. Normalmente, los usuarios imprimen en impresoras virtuales y, posteriormente, recogen sus trabajos de impresión en un dispositivo de impresión físico. Vea el paso 6.

  3. Actualice los atributos de su impresora virtualutilizando permisos de aplicación y un application/ipp tipo de medio (ver ejemplos).

  4. Cree un desencadenador de tareas para la impresora virtual con un token de autenticación de administrador que asociará la definición de la tarea con la impresora virtual. El appId usado para generar el token de acceso debe ser el mismo appId que se usó para crear la definición de tarea.

  5. Cuando se envía un trabajo de impresión a la impresora virtual, se pausa debido a printTaskTrigger. Una printTask con processing estado será creada en función de la printTaskDefinition asociada.

  6. Cuando el usuario desliza un distintivo en un dispositivo de impresora física, la impresora notifica a la aplicación. En ese momento, la aplicación puede recuperar los trabajos de la impresora virtual asociada filtrar la lista de trabajos creados por el usuario actual.

  7. Cuando el usuario seleccione uno o más trabajos para imprimir, la aplicación puede redirigir los trabajos de impresión a la impresora física y, ¡se iniciará la impresión! La llamada de redirección solo se ejecutará si hay una printTask en processing estado en la impresora asociada iniciada por un desencadenador que esta aplicación creó en el paso 4. La tarea se establecerá automáticamente en completed estado cuando se redirija.

Referencia de la API

¿Busca la referencia de la API para este servicio?

Enviar comentarios

Nos gustaría escuchar sus comentarios sobre las API de Impresión universal. Proporcione sus sugerencias en el Foro de ideas para Plataformas de desarrolladores de Microsoft 365.

Contenido relacionado