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.
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.
Imprimer des documents à partir d’applications web et mobiles
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 :
- Créez un travail d’impression, puis stockez l’ID de document obtenu.
- Créez une session de chargement uploadSession pour le document.
- Chargez des octets dans la session de chargement créée.
- 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.
Gardez un œil sur l’état, les configurations et la disponibilité de l’imprimante à l’aide des fonctions Lister les imprimantes et printerStatus.
Déterminez qui utilise vos imprimantes et la quantité d’impressions effectuées à l’aide des API de création de rapports :
Configurez les autorisations des utilisateurs en modifiant l’appartenance des utilisateurs et des groupes sur les imprimantes :
Remplacer ou mettre à jour le matériel d’imprimante en toute transparence
Les imprimantes ne sont pas visibles par les utilisateurs tant qu’elles ne sont pas partagées, ce qui permet aux administrateurs de contrôler finement 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 l’impression par extraction, vous inscrivez des déclencheurs qui notifient votre application (via la communication de service à service) lorsque certains événements d’impression se produisent, tels qu’un travail d’impression en cours de démarrage.
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 :
Créez un printTaskDefinition à l’aide des autorisations d’application. Cette définition de tâche abstraite est utilisée pour créer une tâche qui contiendra le travail 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).
Inscrivez 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 ultérieurement leurs travaux d’impression sur un périphérique d’impression physique. Voir l’étape 6Mettre à jour les attributs de votre imprimante virtuelle à l’aide d’autorisations d’application et d’un type de média
application/ipp
(voir exemples).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.
Lorsqu’un travail d’impression est envoyé à l’imprimante virtuelle, il est suspendu en raison de printTaskTrigger. Un printTask avec l’état
processing
est créé sur la base duprintTaskDefinition associé.Lorsque l’utilisateur balaye un badge sur un périphérique d’imprimante physique, l’imprimante avertit 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.
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’étatcompleted
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.