建置 通用列印連線程式
本文包含資源的指標,以及協助ISV建置 通用列印連線程式 的資訊。
如需連接器的背景資訊,請參閱 通用列印連線程式 概觀。
用戶端識別元註冊
用戶端識別元註冊是設定 Microsoft Entra ID 身分識別以與通用列印通訊所需的步驟。 請參閱 印表機用戶端標識元註冊。 本文說明其韌體中具有通用列印支援的印表機用戶端標識元註冊。 它適用於連接器,因為連接器代表在其韌體中沒有這類功能的印表機。
整體流程
請參閱 IPP 共用基礎結構延伸模組規格的第 4 節「模型」(IPP-Infra)。 本文稍後將參考這份檔。
在通用列印的情況下
- 通用列印 IPP 服務會做為「IPP 基礎結構印表機」。 若要擷取 IPP 服務端點的 URI,請參閱 Microsoft Graph API 中的 printService 資源類型 。
- 連接器會做為「IPP Proxy」。
連線 or 工作
連接器會代表其上安裝的印表機執行許多工作。 本節包含實作這些連接器工作所需的資訊。
印表機註冊
如需背景資訊,請參閱 連接器印表機註冊 。
印表機註冊流程會在通用印表表機註冊中說明。
重要
在印表機註冊程序結束時,會產生印表機的憑證。 此憑證可用來驗證代表印表機傳送至通用列印的所有後續要求(請參閱 取得印表機令牌)。 安全地儲存憑證!
更新印表機描述屬性
如需內容,請參閱 IPP-Infra 規格第 20 頁的序列圖中稱為「啟動」的 IPP Proxy 工作。
支援的印表機描述屬性清單
IPP 屬性 | IPP 屬性 |
---|---|
charset-configured | pdf-fit-to-page-default |
charset 支援 | pdf-fit-to-page-default |
支援壓縮 | pdf-k-octets-supported |
copies-default | pdf-size-constraints |
copies-supported | pdf-versions-supported |
document-format-default | presentation-direction-number-up-default |
支援 document-format-supported | presentation-direction-number-up-supported |
finishings-default | print-color-mode-default |
完成支援 | print-color-mode-supported |
generated-natural-languages-supported | printer-is-accepting-jobs |
ipp-features-supported | printer-location |
ipp-versions-supported | printer-make-and-model |
media-col-database | printer-more-info |
media-col-default | printer-name |
media-default | printer-resolution-default |
media-source-supported | 支援印表機解析度 |
媒體支援 | printer-state |
media-type-supported | printer-state-reasons |
multiple-document-handling-default | 印表機上線時間 |
multiple-document-handling-supported | printer-uri-supported |
multiple-document-jobs-supported | print-quality-default |
natural-language-configured | print-quality-supported |
number-up-default | print-scaling-default |
支持 number-up | 支持 print-scaling-supported |
operations-supported | queued-job-count |
orientation-requested-default | 側邊預設值 |
orientation-requested-supported | 側邊支援 |
output-bin-default | uri-authentication-supported |
output-bin 支援 | uri-security-supported |
提示
如需這些屬性可接受的值檔,請參閱 https://www.iana.org/assignments/ipp-registrations/ipp-registrations.xhtml。
Microsoft 自定義連接器屬性
屬性名稱 | 類型 | 註解 |
---|---|---|
microsoft-universal-print-connector-app-version | 具有語言的文字 | 收集疑難解答資訊時,連線 或用來識別連接器的元數據。 它包含在印表機的 Update-Output-Device-Attributes 作業中。 |
microsoft-universal-print-connector-operating-system | 具有語言的文字 | 收集疑難解答資訊時,連線 或用來識別連接器的元數據。 它包含在印表機的 Update-Output-Device-Attributes 作業中。 |
microsoft-universal-printer-driver-name | 具有語言的文字 | 連接器/印表機用來識別印表機所使用的印表機驅動程式。 它包含在印表機的 Update-Output-Device-Attributes 作業中。 |
microsoft-universal-printer-driver-version | 具有語言的文字 | 連線 或印表機用來識別印表機所使用的印表機驅動程式版本。 它包含在印表機的 Update-Output-Device-Attributes 作業中。 |
microsoft-output-device-job-state-message | 沒有語言的文字 | 連線 or/Printer 用來指定列印作業失敗時的擴充錯誤訊息。 印表機呼叫 UpdateJobStatus 作業時會包含它。 這可以包含基礎錯誤碼、例外狀況堆疊/訊息或非 PII 詳細數據,以協助針對作業失敗進行疑難解答。 |
設定印表機的通知
連接器會透過 通用列印通知服務與通用列印進行大部分的通訊。 透過通知機制,連接器可以接收代表印表機採取之動作的相關事件(例如擷取擱置的印表作業)。
RFC 3996 中所述的 『ippget』 通知機制是使用通用列印來設定事件型通知通道的方式。 如果沒有這類通道,連接器必須持續將要求傳送至通用列印通知服務(亦即具有輪詢型通知通道),才能擷取事件數據。
若要取得通知服務端點的 URI,請參閱 Microsoft Graph API 中的 printService 資源類型 。
列印
請參閱 IPP-Infra 規格第 20 頁順序圖中名為「從基礎結構印表機擷取作業」的 IPP Proxy 工作。
請參閱 IPP 規格中的第 20 頁(遵循從取得作業開始的順序圖)。