ユニバーサル プリント コネクタの構築
この記事には、リソースへのポインターと、ISV がユニバーサル プリント コネクタを構築するのに役立つ情報が含まれています。
コネクタの背景情報については、「ユニバーサル プリント コネクタの概要」を参照してください。
クライアント ID の登録
クライアント ID の登録は、Azure Active Directory ID を設定し、ユニバーサル プリントと通信するために必要な手順です。 「プリンター クライアント ID の登録」を参照してください。 この記事では、ファームウェアでユニバーサル プリントがサポートされているプリンターでのクライアント ID 登録について説明します。 コネクタはファームウェアにそのような機能を持たないプリンターに代わって動作するため、コネクタに適用されます。
全体的な流れ
IPP 共有インフラストラクチャ拡張機能の仕様 (IPP-Infra) のセクション 4 「モデル」を参照してください。 このドキュメントはこの記事の後半で参照します。
ユニバーサル プリントの場合
- ユニバーサル プリント IPP サービスは、「IPP インフラストラクチャ プリンター」として機能します。 IPP サービス エンドポイントの URI を取得するには、Microsoft Graph API の 「printService リソースの種類」 を参照してください。
- コネクタは「IPP プロキシ」として機能します。
コネクタのタスク
コネクタは、そのコネクタにインストールされているプリンターに代わって多数のタスクを実行します。 このセクションには、これらのコネクタ タスクを実装するために必要な情報が含まれています。
プリンターの登録
背景情報については、コネクタ プリンターの登録を参照してください。
プリンター登録フローについては、ユニバーサル プリントのプリンターの登録に関するページを参照してください。
重要
プリンター登録プロセスの最後に、プリンターの証明書が生成されます。 この証明書は、プリンターに代わってユニバーサル プリントに送信されるすべての後続の要求を認証するために使用されます (「プリンター トークンの取得」を参照)。 証明書を安全に保存します！
プリンター記述属性の更新
コンテキストについては、IPP-Infra 仕様の 20 ページ目のシーケンス図で、「スタートアップ」と呼ばれる IPP プロキシ タスクを参照してください。
サポートされているプリンター記述属性のリスト
| IPP 属性 | IPP 属性 |
|---|---|
| charset-configured | pdf-fit-to-page-default |
| charset-supported | pdf-fit-to-page-default |
| compression-supported | 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 |
| finishings-supported | 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-resolution-supported |
| media-supported | printer-state |
| media-type-supported | printer-state-reasons |
| multiple-document-handling-default | printer-up-time |
| 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-supported | print-scaling-supported |
| operations-supported | queued-job-count |
| orientation-requested-default | sides-default |
| orientation-requested-supported | sides-supported |
| output-bin-default | uri-authentication-supported |
| output-bin-supported | uri-security-supported |
ヒント
これらの属性に使用できる値のドキュメントについては、https://www.iana.org/assignments/ipp-registrations/ipp-registrations.xhtml を参照してください。
Microsoft カスタム コネクタ属性
| 属性名 | Type | コメント |
|---|---|---|
| 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 | 言語のないテキスト | 印刷ジョブが失敗したときに拡張エラー メッセージを指定するためにコネクタ/プリンターによって使用されます。 プリンターが UpdateJobStatus 操作を呼び出すときに含まれています。 これには、基になるエラー コード、例外スタック/メッセージ、またはジョブエラーのトラブルシューティングに役立つ PII 以外の詳細が含まれます。 |
プリンターの通知の設定
コネクタは、ユニバーサル プリント通知サービスを介して、ユニバーサル プリントとの通信の大部分を行います。 通知メカニズムを使用して、コネクタはプリンターに代わって実行する必要がある操作 (保留中の印刷ジョブのフェッチなど) に関するイベントを受信できます。
RFC 3996 で説明されている 'ippget' 通知メカニズムは、ユニバーサル プリントでイベント ベースの通知チャネルをセットアップする方法です。 このようなチャンネルがない場合、コネクタは、イベント データを取得するために、ユニバーサル プリント通知サービス (つまり、ポーリング ベースの通知チャネル) に継続的に要求を送信する必要があります。
通知サービス エンドポイントの URI を取得するには、Microsoft Graph API の 「printService リソースの種類」 を参照してください。
印刷
IPP-Infra 仕様の 20 ページ目のシーケンス図で、「インフラストラクチャ プリンターからのジョブの取得」と呼ばれている IPP プロキシ タスクから始まるフローを参照してください。
IPP 仕様の 20 ページ目を参照してください (ジョブの取得以降のシーケンス図に従ってください)。
プリンターの登録解除
Microsoft Graph API の 「プリンターの削除」を参照してください。