Présentation de l’API d’impression cloud Impression universelle

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.

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

Pourquoi utiliser la fonction Impression universelle ?

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. 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.

Au fur et à mesure que les organisations adoptent la fonctionnalité 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.

Le déplacement d’une infrastructure d’impression vers le cloud permet d’imprimer des documents directement à partir d’applications web et mobiles.

  • Les utilisateurs peuvent envoyer des travaux d’impression à printerShare.
  • Les administrateurs d’imprimantes peuvent également envoyer des travaux d’impression à une imprimante à des fins de tests préliminaires avant de partager celle-ci avec l’organisation.

Pour envoyer des travaux d’impression à printerShare, procédez comme suit :

  1. Créez un travail d’impression, puis stockez l’ID de document obtenu.
  2. Créez une session de chargement uploadSession pour le document.
  3. Chargez des octets dans la session de chargement créée.
  4. Démarrez le travail d’impression.

Gérer des imprimantes

Le suivi des imprimantes, des configurations d’imprimante et de l’utilisation des imprimantes d’une organisation est une tâche complexe. L’API Impression universelle permet l’intégration dans ces trois domaines.

Remplacer ou mettre à jour le matériel d’imprimante en toute transparence

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é.

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.

Pour l’utiliser dans votre application, utilisez Update printerShare pour mettre à jour la référence printer de printerShare.

Activer l’impression par extraction

L'API Impression universelle de Microsoft Graph permet à votre application de prendre en charge le pull printing. Pour configurer le pull printing, 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.

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.

Procédez comme suit pour activer l’impression à la demande :

  1. Créez un printTaskDefinition à l’aide des autorisations d’application. 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. 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).

  2. Enregistrez une ou plusieurs imprimantes virtuelles à l’aide d’un jeton d’authentification administrateur et d’un null physicalDeviceId. Une « imprimante virtuelle » n’est qu’un objet Imprimante (printer) auquel aucun appareil physique n’a été associé dans la fonctionnalité Impression universelle. 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. Voir l’étape 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).

  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. L’appId utilisé pour générer le jeton d’accès doit être le même appId que celui qui a été utilisé pour créer la définition de tâche.

  5. Lorsqu’un travail d’impression est envoyé à l’imprimante virtuelle, celui-ci est suspendu en raison de la printTaskTrigger. Un printTask avec l’état processing est créé sur la base duprintTaskDefinition associé.

  6. Lorsque l’utilisateur balaye un badge sur un périphérique d’imprimante physique, l’imprimante notifie votre 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.

  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. 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. La tâche est automatiquement définie sur l’état completed après l’avoir redirigée.

Référence d’API

Vous recherchez la référence d’API pour ce service ?

Envoyer des commentaires

N’hésitez pas à nous faire part de vos commentaires sur les API Impression universelle. Proposez vos suggestions sur le Forum des idées de la plateforme de développement Microsoft 365.

Voir aussi