Membangun Konektor Pencetakan Universal
Artikel ini berisi penunjuk ke sumber daya serta informasi untuk membantu ISV membangun Konektor Pencetakan Universal.
Untuk informasi latar belakang tentang konektor, silakan lihat gambaran umum Konektor Pencetakan Universal.
Pendaftaran ID Klien
Pendaftaran ID klien adalah langkah yang diperlukan untuk menyiapkan identitas ID Microsoft Entra Anda untuk berkomunikasi dengan Universal Print. Silakan lihat Pendaftaran ID klien printer. Artikel ini menjelaskan pendaftaran ID klien untuk printer yang memiliki dukungan Universal Print di firmware mereka. Ini berlaku untuk konektor karena konektor bertindak atas nama printer yang tidak memiliki kemampuan tersebut dalam firmware mereka.
Alur keseluruhan
Silakan lihat bagian 4 "Model" dari spesifikasi Ekstensi Infrastruktur Bersama IPP (IPP-Infra). Dokumen ini akan dirujuk nanti dalam artikel ini.
Dalam kasus Universal Print
- Layanan Universal Print IPP bertindak sebagai "Printer Infrastruktur IPP". Untuk mengambil URI untuk titik akhir layanan IPP, lihat jenis sumber daya printService di Microsoft Graph API.
- Konektor bertindak sebagai "Proksi IPP".
tugas Koneksi or
Konektor melakukan sejumlah tugas atas nama printer yang terpasang di atasnya. Bagian ini mencakup informasi yang diperlukan untuk mengimplementasikan tugas konektor tersebut.
Pendaftaran printer
Silakan lihat pendaftaran printer konektor untuk informasi latar belakang.
Alur pendaftaran printer dijelaskan dalam pendaftaran printer Universal Print.
Penting
Di akhir proses pendaftaran printer, sertifikat dihasilkan untuk printer. Sertifikat ini digunakan untuk mengautentikasi semua permintaan berikutnya yang dikirim ke Universal Print atas nama printer (lihat Mendapatkan token printer). Simpan sertifikat dengan aman!
Memperbarui atribut deskripsi printer
Silakan lihat tugas Proksi IPP yang disebut "Startup" dalam diagram urutan pada halaman 20 dalam spesifikasi IPP-Infra untuk konteks.
Daftar atribut deskripsi printer yang didukung
| Atribut IPP | Atribut IPP |
|---|---|
| dikonfigurasi charset | pdf-fit-to-page-default |
| didukung charset | pdf-fit-to-page-default |
| kompresi yang didukung | pdf-k-octets-didukung |
| salin-default | batasan ukuran pdf |
| salinan yang didukung | pdf-versions-didukung |
| document-format-default | presentation-direction-number-up-default |
| didukung format dokumen | presentation-direction-number-up-supported |
| finishings-default | print-color-mode-default |
| penyelesaian yang didukung | print-color-mode-didukung |
| yang didukung bahasa alami yang dihasilkan | printer-is-accepting-jobs |
| ipp-features-supported | lokasi printer |
| didukung ipp-versions | printer-make-and-model |
| media-col-database | printer-more-info |
| media-col-default | printer-name |
| media-default | printer-resolution-default |
| didukung sumber media | didukung resolusi printer |
| didukung media | status printer |
| media-type-didukung | alasan status printer |
| multiple-document-handling-default | printer-up-time |
| multi-dokumen-penanganan-didukung | printer-uri-didukung |
| multi-dokumen-pekerjaan-didukung | cetak-kualitas-default |
| dikonfigurasi bahasa alami | didukung kualitas cetak |
| number-up-default | print-scaling-default |
| angka yang didukung | print-scaling-didukung |
| didukung operasi | jumlah pekerjaan yang diantrekan |
| orientasi-diminta-default | sides-default |
| orientasi-diminta-didukung | sisi yang didukung |
| output-bin-default | didukung autentikasi uri |
| output-bin-didukung | didukung keamanan uri |
Tip
Untuk dokumentasi nilai yang dapat diterima untuk atribut ini, silakan lihat https://www.iana.org/assignments/ipp-registrations/ipp-registrations.xhtml.
Atribut konektor kustom Microsoft
| Nama atribut | Jenis | Komentar |
|---|---|---|
| microsoft-universal-print-connector-app-version | Teks dengan bahasa | metadata Koneksi or yang digunakan untuk mengidentifikasi konektor saat informasi pemecahan masalah dikumpulkan. Ini termasuk dalam operasi Update-Output-Device-Attributes printer. |
| microsoft-universal-print-connector-operating-system | Teks dengan bahasa | metadata Koneksi or yang digunakan untuk mengidentifikasi konektor saat informasi pemecahan masalah dikumpulkan. Ini termasuk dalam operasi Update-Output-Device-Attributes printer. |
| microsoft-universal-printer-driver-name | Teks dengan bahasa | Digunakan oleh konektor/pencetak untuk mengidentifikasi pengandar pencetak yang digunakan oleh pencetak. Ini termasuk dalam operasi Update-Output-Device-Attributes printer. |
| microsoft-universal-printer-driver-version | Teks dengan bahasa | Digunakan oleh Koneksi or/Printer untuk mengidentifikasi versi pengandar pencetak yang digunakan oleh pencetak. Ini termasuk dalam operasi Update-Output-Device-Attributes printer. |
| microsoft-output-device-job-state-message | Teks tanpa bahasa | Digunakan oleh Koneksi or/Printer untuk menentukan pesan kesalahan yang diperluas ketika pekerjaan cetak gagal. Ini disertakan ketika printer memanggil operasi UpdateJobStatus. Ini dapat mencakup kode kesalahan yang mendasar, tumpukan/pesan pengecualian, atau detail non-PII yang membantu memecahkan masalah kegagalan pekerjaan. |
Menyiapkan pemberitahuan untuk printer
Konektor melakukan sebagian besar komunikasinya dengan Universal Print melalui Universal Print Notification Service. Melalui mekanisme pemberitahuan, konektor dapat menerima peristiwa tentang tindakan yang perlu diambil atas nama printer (misalnya mengambil pekerjaan cetak yang tertunda).
Mekanisme pemberitahuan 'ippget' yang dijelaskan dalam RFC 3996 adalah cara untuk menyiapkan saluran pemberitahuan berbasis peristiwa dengan Universal Print. Tanpa saluran seperti itu, konektor harus terus mengirim permintaan ke Universal Print Notification Service (yaitu memiliki saluran pemberitahuan berbasis polling) untuk mengambil data peristiwa.
Untuk mendapatkan URI untuk titik akhir Notification Service, lihat jenis sumber daya printService di Microsoft Graph API.
Pencetakan
Silakan lihat alur yang dimulai dari tugas Proksi IPP yang disebut "Ambil Pekerjaan dari Printer Infrastruktur" dalam diagram urutan pada halaman 20 dalam spesifikasi IPP-Infra.
Lihat Halaman 20 dalam Spesifikasi IPP (ikuti diagram urutan dari Dapatkan Pekerjaan dan seterusnya).
Membatalkan pendaftaran printer
Silakan merujuk ke Hapus printer di Microsoft Graph API.