この記事には、リソースへのポインターと、ISV がユニバーサル印刷コネクタを構築するのに役立つ情報が含まれています。
コネクタの背景情報については、ユニバーサル印刷コネクタの概要を参照してください。
クライアント ID の登録
クライアント ID の登録は、ユニバーサル印刷と通信するために Microsoft Entra ID ID を設定するために必要な手順です。 プリンター クライアント ID の登録を参照してください。 この記事では、ファームウェアでユニバーサル印刷がサポートされているプリンターのクライアント ID 登録について説明します。 ファームウェアにそのような機能が組み込まれていないプリンターの代わりにコネクタが動作するため、これはコネクタに適用されます。
全体的なフロー
IPP 共有インフラストラクチャ拡張機能の仕様 (IPP-Infra) のセクション 4 「モデル」を参照してください。 このドキュメントについては、この記事の後半で説明します。
ユニバーサルプリントの場合
- ユニバーサル印刷 IPP サービスは、"IPP インフラストラクチャ プリンター" として機能します。 IPP サービス エンドポイントの URI を取得するには、Microsoft Graph API で
printService リソースの種類を参照してください。 - コネクタは "IPP プロキシ" として機能します。
コネクタのタスク
コネクタは、そのコネクタにインストールされているプリンターに代わって多数のタスクを実行します。 このセクションには、これらのコネクタ タスクを実装するために必要な情報が含まれています。
プリンターの登録
背景情報については、「コネクタ プリンターの登録」を参照してください。
プリンター登録フローについては、ユニバーサル印刷プリンターの登録で説明されています。
重要
プリンター登録プロセスの最後に、プリンターの証明書が生成されます。 この証明書は、プリンターに代わってユニバーサル印刷に送信されるすべての後続の要求を認証するために使用されます (プリンター トークンの取得
プリンター記述属性の更新
コンテキストについては、IPP-Infra 仕様 の 20 ページのシーケンス図の「スタートアップ」と呼ばれる IPP プロキシ タスクを参照してください。
サポートされているプリンター記述属性の一覧
プリンターは、必要な数のプリンター記述属性を宣言できます。 ユニバーサル印刷では、すべての IPP 定義プリンター記述属性とカスタム属性がサポートされます。 カスタム属性は、IPP テンプレートに従って定義する必要があります (たとえば、カスタム メディア サイズの値はフォーム custom_19_nxminの場合があります)。
各印刷クライアントには、印刷オプションのサポートに関して独自の制限がある場合があります。 例えば:
- Windows では、Mopria 仕様に従って印刷オプションがサポートされています。
- Mac には AirPrint 認定が必要です。
- OneDrive for Business などの Web アプリケーションでは、PDF をサポートするプリンターのみに制限される場合があります
- 等。
ユニバーサル印刷で宣言できる属性のサンプル リストを次に示します。
| IPP 属性 | IPP 属性 |
|---|---|
| charset-configured | pdf-fit-to-page-default |
| charset-supported | pdf-fit-to-page-default |
| 圧縮対応 | pdf-k-octets-supported |
| copies-default | PDFサイズの制約 |
| copies-supported | サポートされているPDFバージョン |
| ドキュメント形式のデフォルト | presentation-direction-number-up-default |
| サポートされているドキュメント形式 | presentation-direction-number-up-supported |
| finishings-default | 印刷-カラー-モード-デフォルト |
| finishings-supported | print-color-mode-supported |
| generated-natural-languages-supported | printer-is-accepting-jobs |
| ipp-features-supported | プリンターの場所 |
| サポートされているIPPバージョン | プリンターのメーカーおよびモデル |
| media-col-database | プリンターの詳細情報 |
| media-col-default | プリンター名 |
| media-default | プリンタ解像度デフォルト |
| media-source-supported | printer-resolution-supported |
| media-supported | プリンターの状態 |
| サポートされているメディアタイプ | printer-state-reasons |
| 複数文書処理デフォルト | printer-up-time |
| 複数文書の処理がサポートされています | printer-uri-supported |
| multiple-document-jobs-supported | 印刷品質デフォルト |
| 自然言語設定済み | 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認証サポート済み |
| output-bin-supported | uri-security-supported |
ヒント
これらの属性に使用できる値のドキュメントについては、https://www.iana.org/assignments/ipp-registrations/ipp-registrations.xhtmlを参照してください。
Microsoft カスタム コネクタ属性
| 属性名 | 型 | コメント |
|---|---|---|
| マイクロソフト ユニバーサル プリント コネクター アプリ バージョン | 言語を含むテキスト | トラブルシューティング情報の収集時にコネクタを識別するために使用されるコネクタ メタデータ。 プリンターの Update-Output-Device-Attributes 操作に含まれています。 |
| マイクロソフト・ユニバーサル・プリント・コネクタ・オペレーティング・システム | 言語を含むテキスト | トラブルシューティング情報の収集時にコネクタを識別するために使用されるコネクタ メタデータ。 プリンターの Update-Output-Device-Attributes 操作に含まれています。 |
| マイクロソフト・ユニバーサル・プリンター・ドライバー・ネーム | 言語を含むテキスト | プリンターで使用されるプリンター ドライバーを識別するためにコネクタ/プリンターによって使用されます。 プリンターの Update-Output-Device-Attributes 操作に含まれています。 |
| マイクロソフト-ユニバーサル-プリンタードライバー-バージョン | 言語を含むテキスト | コネクタ/プリンターで使用され、プリンターで使用されるプリンター ドライバーのバージョンを識別します。 プリンターの Update-Output-Device-Attributes 操作に含まれています。 |
| microsoft-output-device-job-state-message | 言語のないテキスト | 印刷ジョブが失敗したときに拡張エラー メッセージを指定するためにコネクタ/プリンターによって使用されます。 プリンターが UpdateJobStatus 操作を呼び出すときに含まれます。 これには、基になるエラー コード、例外スタック/メッセージ、またはジョブエラーのトラブルシューティングに役立つ PII 以外の詳細が含まれます。 |
プリンターの通知の設定
コネクタは、ユニバーサル印刷通知サービスを介してユニバーサル印刷との通信の大部分を行います。 通知メカニズムを使用して、コネクタはプリンターに代わって実行する必要があるアクション (保留中の印刷ジョブのフェッチなど) に関するイベントを受信できます。
RFC 3996 で説明されている通知メカニズムである 'ippget' は、ユニバーサル印刷を使用してイベントベースの通知チャネルを設定する方法です。 このようなチャネルがない場合、コネクタは、イベント データを取得するために、ユニバーサル印刷通知サービス (つまり、ポーリング ベースの通知チャネル) に継続的に要求を送信する必要があります。
Notification Service エンドポイントの URI を取得するには、Microsoft Graph API で
印刷
IPP-Infra 仕様の 20 ページのシーケンス図の「インフラストラクチャ プリンターからジョブを取得する」という IPP プロキシ タスクから始まるフローを参照してください。
IPP 仕様の 20 ページを参照してください （「ジョブの取得」以降のシーケンス図に従います）。
プリンターの登録解除
Microsoft Graph API の プリンター の削除を参照してください。
プリンター統合のテスト
プリンターが期待どおりに動作することを確認するには、次のツールを使用してプリンターをテストすることをお勧めします。