Création d’un connecteur d’impression universelle
Cet article contient des pointeurs vers des ressources ainsi que des informations pour aider les éditeurs de logiciels indépendants à créer un connecteur d’impression universelle.
Pour plus d’informations sur le connecteur, consultez la vue d’ensemble du connecteur d’impression universelle.
Inscription de l’ID client
L’inscription d’ID client est l’étape requise pour configurer votre identité d’ID Microsoft Entra pour communiquer avec l’impression universelle. Veuillez consulter l’inscription de l’ID client de l’imprimante. L’article décrit l’inscription d’ID client pour les imprimantes qui prennent en charge l’impression universelle dans leur microprogramme. Il s’applique au connecteur, car le connecteur agit pour le compte des imprimantes qui n’ont pas cette fonctionnalité dans leur microprogramme.
Flux général
Consultez la section 4 « Modèle » de la spécification des extensions d’infrastructure partagée IPP (IPP-Infra). Ce document sera référencé plus loin dans cet article.
Dans le cas de l’impression universelle
- Le service IPP d’impression universelle agit comme « Imprimante d’infrastructure IPP ». Pour récupérer l’URI du point de terminaison de service IPP, reportez-vous au type de ressource printService dans l’API Microsoft Graph.
- Le connecteur agit en tant que « proxy IPP ».
tâches Connecter or
Le connecteur effectue un certain nombre de tâches pour le compte des imprimantes installées sur celui-ci. Cette section inclut les informations requises pour implémenter ces tâches de connecteur.
Inscription de l’imprimante
Consultez l’inscription de l’imprimante du connecteur pour obtenir des informations d’arrière-plan.
Le flux d’inscription d’imprimante est décrit dans l’inscription de l’imprimante d’impression universelle.
Important
À la fin du processus d’inscription de l’imprimante, un certificat est généré pour l’imprimante. Ce certificat est utilisé pour authentifier toutes les demandes suivantes envoyées à l’impression universelle pour le compte de l’imprimante (voir Obtention d’un jeton d’imprimante). Stockez le certificat en toute sécurité !
Mise à jour des attributs de description de l’imprimante
Reportez-vous à la tâche proxy IPP appelée « Démarrage » dans le diagramme de séquence de la page 20 dans la spécification IPP-Infra pour le contexte.
Liste des attributs de description d’imprimante pris en charge
| Attribut IPP | Attribut IPP |
|---|---|
| charset configuré | pdf-fit-to-page-default |
| charset pris en charge | pdf-fit-to-page-default |
| compression prise en charge | pdf-k-octets-pris en charge |
| copies par défaut | pdf-size-constraints |
| copies prises en charge | pdf-versions prises en charge |
| document-format-default | presentation-direction-number-up-default |
| prise en charge du format de document | presentation-direction-number-up-supported |
| finitions par défaut | print-color-mode-default |
| finitions prises en charge | print-color-mode pris en charge |
| generated-natural-languages-supported | printer-is-accept-jobs |
| ipp-features-supported | emplacement de l’imprimante |
| ipp-versions prises en charge | printer-make-and-model |
| media-col-database | printer-more-info |
| media-col-default | nom de l’imprimante |
| media-default | printer-resolution-default |
| media-source-supported | printer-resolution-supported |
| support multimédia | état de l’imprimante |
| media-type-supported | printer-state-reasons |
| multiple-document-handling-default | temps d’attente de l’imprimante |
| gestion de documents multiples prises en charge | printer-uri-supported |
| plusieurs documents-travaux pris en charge | print-quality-default |
| natural-language-configure | print-quality-supported |
| nombre par défaut | print-scale-default |
| number-up-supported | mise à l’échelle d’impression prise en charge |
| opérations prises en charge | queued-job-count |
| orientation-requested-default | sides-default |
| orientation demandée-prise en charge | côtés pris en charge |
| output-bin-default | uri-authentication-supported |
| output-bin-supported | uri-security-supported |
Conseil
Pour obtenir de la documentation sur les valeurs acceptables pour ces attributs, reportez-vous à https://www.iana.org/assignments/ipp-registrations/ipp-registrations.xhtml.
Attributs du connecteur personnalisé Microsoft
| Nom de l’attribut | Type | Commentaires |
|---|---|---|
| microsoft-universal-print-connector-app-version | Texte avec langue | métadonnées Connecter or utilisées pour identifier le connecteur lors de la collecte des informations de résolution des problèmes. Il est inclus dans l’opération Update-Output-Device-Attributes de l’imprimante. |
| microsoft-universal-print-connector-operating-system | Texte avec langue | métadonnées Connecter or utilisées pour identifier le connecteur lors de la collecte des informations de résolution des problèmes. Il est inclus dans l’opération Update-Output-Device-Attributes de l’imprimante. |
| microsoft-universal-printer-driver-name | Texte avec langue | Utilisé par le connecteur/l’imprimante pour identifier le pilote d’imprimante utilisé par l’imprimante. Il est inclus dans l’opération Update-Output-Device-Attributes de l’imprimante. |
| microsoft-universal-printer-driver-version | Texte avec langue | Utilisé par le Connecter or/Imprimante pour identifier la version du pilote d’imprimante utilisée par l’imprimante. Il est inclus dans l’opération Update-Output-Device-Attributes de l’imprimante. |
| microsoft-output-device-job-state-message | Texte sans langue | Utilisé par le Connecter or/Imprimante pour spécifier un message d’erreur étendu lorsqu’une tâche d’impression échoue. Elle est incluse lorsque l’imprimante appelle l’opération UpdateJobStatus. Cela peut inclure un code d’erreur sous-jacent, une pile d’exceptions/un message ou des détails non-PII qui aident à résoudre l’échec du travail. |
Configuration de la notification pour les imprimantes
Le connecteur effectue la majeure partie de sa communication avec l’impression universelle via le service de notification d’impression universelle. Par le biais du mécanisme de notification, le connecteur peut recevoir des événements sur les actions dont il a besoin pour le compte des imprimantes (par exemple, extraire un travail d’impression en attente).
Le mécanisme de notification « ippget » décrit dans RFC 3996 est le moyen de configurer un canal de notification basé sur des événements avec impression universelle. Sans ce type de canal, le connecteur doit envoyer en permanence des demandes au service de notification d’impression universelle (c’est-à-dire avoir un canal de notification basé sur un sondage) pour récupérer les données d’événement.
Pour obtenir l’URI du point de terminaison du service de notification, reportez-vous au type de ressource printService dans l’API Microsoft Graph.
Impression
Reportez-vous au flux à partir de la tâche proxy IPP appelée « Récupérer le travail à partir de l’imprimante d’infrastructure » dans le diagramme de séquence de la page 20 dans la spécification IPP-Infra.
Reportez-vous à la page 20 dans la spécification IPP (suivez le diagramme de séquence à partir de Get Jobs et versions ultérieures).
Désinscription des imprimantes
Reportez-vous à Supprimer l’imprimante dans l’API Microsoft Graph.