Présentation de l’API d’impression cloud Impression universelleUniversal Print cloud printing API overview

La fonction Impression universelle est une solution d’impression moderne qui permet aux organisations de gérer leur infrastructure d’impression via les services cloud de Microsoft.Universal Print is a modern print solution that organizations can use to manage their print infrastructure through cloud services from Microsoft.

Capture d’écran de la page d’accueil du portail Azure Impression universelle

Pourquoi utiliser la fonction Impression universelle ?Why use Universal Print?

La fonction Impression universelle déplace les fonctionnalités d’impression de Windows Server vers le cloud Microsoft 365. Ainsi, les organisations n’ont plus besoin de serveurs d’impression locaux et n’ont pas besoin d’installer de pilotes d’imprimante sur les appareils.Universal Print moves key Windows Server print functionality to the Microsoft 365 cloud, so organizations no longer need on-premises print servers and do not need to install printer drivers on devices. De plus, la fonction Impression universelle ajoute des fonctionnalités clés telles que les groupes de sécurité pour l’accès aux imprimantes, la détection d’imprimantes en fonction de l’emplacement et une expérience d’administrateur enrichie.In addition, Universal Print adds key functionality like security groups for printer access, location-based printer discovery, and a rich administrator experience.

Au fur et à mesure que les organisations adoptent l’impression universelle, les organisations et les éditeurs de logiciels indépendants peuvent utiliser l’API Impression universelle dans Microsoft Graph pour créer et développer des applications afin de prendre en charge de nouveaux scénarios.As organizations adopt Universal Print, organizations and independent software vendors (ISVs) can use the Universal Print API in Microsoft Graph to build and extend applications to support new scenarios.

Le déplacement d’une infrastructure d’impression vers le cloud permet d’imprimer des documents directement à partir d’applications web et mobiles.Moving print infrastructure to the cloud enables printing documents directly from web and mobile applications.

Pour commencer à utiliser l’API Impression universelle :To get started with the Universal Print API:

  1. Créez un travail d’impression et stockez l’ID de document obtenu.Create a print job and store the resulting document ID.
  2. Chargez des données de document dans le document.Upload document data to the document.
  3. Démarrez le travail d’impression.Start the print job.

Gérer des imprimantesManage printers

Le suivi des imprimantes, des configurations d’imprimante et de l’utilisation des imprimantes d’une organisation est une tâche complexe.Keeping track of an organization's printers, printer configurations, and printer usage is a complex task. L’API Impression universelle permet l’intégration dans ces trois domaines.The Universal Print API enables integration in all three areas.

Remplacer ou mettre à jour le matériel d’imprimante en toute transparenceSeamlessly replace or update printer hardware

Les imprimantes ne sont pas visibles pour les utilisateurs tant qu’elles ne sont partagées, ce qui offre aux administrateurs un contrôle précis sur le matériel d’imprimante disponible à un moment donné.Printers are not visible to users until they are shared, providing administrators fine-grained control over which printer hardware is available at a given time.

Le partage d’une imprimante crée une ressource printerShare qui peut être mise à jour à tout moment afin de pointer vers une autre imprimante, ce qui facilite le remplacement du matériel d’imprimante endommagé ou la mise hors connexion des imprimantes pour la maintenance.Sharing a printer creates a printerShare resource that can be updated at any time to point to a different printer, making it easy to replace broken printer hardware or take printers offline for maintenance.

Pour l’utiliser dans votre application, utilisez Update printerShare pour mettre à jour la référence printer de printerShare.To use this in your application, use Update printerShare to update the printerShare's printer reference.

Extension de l'impression universelle pour soutenir l'impression à la demandeExtending Universal Print to support pull printing

L'API d'impression universelle de Microsoft Graph permet à votre application de prendre en charge l'impression à la demande.The Microsoft Graph Universal Print API enables your application to support pull printing. Pour configurer l'impression à la demande, vous devez enregistrer des déclencheurs qui notifient votre demande (via la communication de service à service) lorsque certains événements d'impression se produisent, comme le lancement d'une tâche d'impression.To set up pull printing, you will register triggers that notify your application (via service-to-service communication) when certain print events happen, such as a print job being started.

Ces déclencheurs permettent à votre application d’interrompre le flux de travail d’impression pour effectuer des tâches telles que la redirection de tâches vers différentes imprimantes et la modification de la charge utile du document.These triggers enable your application to interrupt the print workflow to do things such as redirecting jobs to different printers and modifying the document payload.

Procédez comme suit pour activer l’impression à la demande :Follow these steps to enable pull printing:

  1. Créez un printTaskDefinition à l’aide des autorisations d’application.Create a printTaskDefinition using application permissions. Cette définition abstraite de la tâche sera utilisée pour créer une tâche qui contiendra la tâche pour votre application.This abstract task definition will be used to create task that will hold the job for your application. Vous devez définir au moins une définition de tâche par locataire, qui peut être associée à un nombre quelconque d'imprimantes dans le locataire à l'aide de déclencheurs de tâches (voir étape 4).You need to define at least one task definition per tenant, which can be associated with any number of printers in the tenant using task triggers (see step 4).

  2. Enregistrez une ou plusieurs imprimantes virtuelles à l’aide d’un jeton d’authentification administrateur et d’un null physicalDeviceId.Register one or more virtual printers using an administrator authentication token and a null physicalDeviceId. Une « imprimante virtuelle » n’est qu’un objet d’imprimante dans une impression universelle sans appareil physique associé.A "virtual printer" is just a printer object in Universal Print without a physical device attached. En règle générale, les utilisateurs impriment sur des imprimantes virtuelles et récupèrent ensuite leurs tâches d’impression sur un appareil d’impression physique.Usually, users will print to virtual printers and later pick up their print jobs at a physical print device. Voir l’étape 6See step 6.

  3. Mettre à jour les attributs de votre imprimante virtuelle à l’aide d’autorisations d’application et d’un type de média application/ipp (voir exemples).Update the attributes of your virtual printer by using application permissions and an application/ipp media type (see examples).

  4. Créer un déclencheur de tâche pour votre imprimante virtuelle à l’aide d’un jeton d’authentification administrateur qui associe votre définition de tâche à une imprimante virtuelle.Create a task trigger for your virtual printer using an administrator authentication token that will associate your task definition with virtual printer.

  5. Lorsqu’un travail d’impression est envoyé à l’imprimante virtuelle, celui-ci est suspendu en raison de la printTaskTrigger.When a print job is submitted to the virtual printer, it will be paused due to the printTaskTrigger. Un printTask avec l’état processing est créé sur la base duprintTaskDefinition associé.A printTask with processing state will be created based on the associated printTaskDefinition.

  6. Lorsque l’utilisateur balaye un badge sur un périphérique d’imprimante physique, l’imprimante notifie votre application.When the user swipes a badge at a physical printer device, the printer will notify your application. Votre application peut alors extraire les tâches de l’imprimante virtuelle associée et filtrer la liste sur les tâches créées par l’utilisateur actuel.At that time, your application can fetch the jobs of the associated virtual printer and filter the list to jobs created by the current user.

  7. Lorsque l’utilisateur sélectionne une ou plusieurs tâches à imprimer, votre application peut rediriger les tâches d’impression vers l’imprimante physique et la tâche commence à s’imprimer.When the user selects one or more jobs to print, your application can redirect the print job(s) to the physical printer and the job will start printing! L’appel de redirection ne réussira que si un printTask dans l’état processing de l’imprimante associée a commencé par un déclencheur créé à l’étape 4.The redirect call will only succeed if there is a printTask in processing state on the associated printer started by a trigger that this app created in step 4. La tâche est automatiquement définie sur l’état completed après l’avoir redirigée.The task will automatically be set to completed state after redirecting it.

    Remarque : les tâches d’impression suspendues qui ne sont pas redirigées dans un délai de 2 jours sont supprimées.NOTE: Paused print jobs that are not redirected within 2 days will be deleted.

Référence d’APIAPI reference

Vous recherchez la référence d’API pour ce service ?Looking for the API reference for this service?

Envoyer des commentairesProvide feedback

N’hésitez pas à nous faire part de vos commentaires sur les API Impression universelle.We'd love to hear your feedback about the Universal Print APIs. Fournissez vos suggestions sur UserVoice.Provide your suggestions on UserVoice.

Voir aussiSee also