PrintCapabilities ドキュメント構築チェックリスト

このトピックは最新ではありません。 最新の情報については、「 印刷スキーマの仕様」を参照してください。

要素の種類の概要では、PrintCapabilities ドキュメントを構成するさまざまな要素について説明します。 このセクションでは、PrintCapabilities ドキュメントの作成者が、デバイスを記述する PrintCapabilities ドキュメントを作成するために使用できるチェックリストを提供します。

  1. デバイス構成に寄与するすべてのデバイス属性を特定します。 このようなデバイス属性ごとに、Feature/Option コンストラクトとして表すか、パラメーター コンストラクトとして表すかを決定します。

  2. 各デバイス機能について、印刷スキーマ キーワードで定義されているフィーチャーで表すことができるかどうかを決定します。 そうでない場合は、新しいプライベート定義フィーチャー (および対応する名前属性) を導入する必要があります。

    • [印刷スキーマ キーワード定義のフィーチャー インスタンス] で、このフィーチャーを設定できる使用可能な各状態を特定します。 各状態は、Feature インスタンスの Option に対応します。 これらの状態のうち、この機能に関連付けられている印刷スキーマ定義の Option インスタンスに対応する状態と、カスタマイズされた Option インスタンスを必要とする状態を決定します。 Option Definitions トピックでは、新しい Option インスタンスを構築する方法と、既存の Option インスタンスから新しい Option インスタンスを派生させる方法について説明します。

    • 標準外のフィーチャー インスタンスの場合は、ある Option を別のオプションと区別するために使用できる特性を特定します。 ScoredProperty 要素でこのような各特性を表し、各 Option インスタンスで、各 ScoredProperty にその Option に固有の値を割り当てます。 特定のフィーチャーの各 Option が一意になるように、ScoredProperty 要素が十分にあることを確認します。 非標準の Feature インスタンスと Option インスタンスは、その性質上、重要ではありません。 つまり、別のドライバーは、ドライバーが作成する PrintTicket で指定された標準外の機能またはオプションと一致する同等の機能またはオプションを見つけることができません。

  3. Option に ParameterRef 要素を含める必要があるかどうかを判断します。 詳細については、「 パラメーターコンストラクト 」および「 パラメーター参照要素」を参照してください

  4. パラメーターの場合は、印刷スキーマ キーワードで定義されている ParameterDef インスタンスのいずれかが適切に一致しているかどうかを判断します。 その場合は、印刷スキーマ キーワードから ParameterDef インスタンスをコピーし、変更可能な各 Property インスタンスの値を最適に調整します。 印刷スキーマ キーワードに含まれる ParameterDef インスタンスがいずれも適切に一致しない場合は、独自の ParameterDef インスタンスを作成します。 詳細については、「 PrintCapabilities ドキュメントのパラメーター」を参照してください。

  5. Print Schema Keywords ドキュメントに必要なすべての Property および ScoredProperty インスタンスが PrintCapabilities ドキュメントに存在し、正しく初期化されていることを確認します。

  6. 必要に応じて、Property インスタンスとサブプロパティ インスタンスを追加します。 印刷スキーマ キーワードで定義されている Property インスタンスの対象にならない特徴付けが必要なデバイスの側面がある場合は、プライベートに定義された Property インスタンスを導入できます。

  7. 名前属性の名前空間規則に従います。 これは、プライベート定義の名前属性と、印刷スキーマ キーワードで定義されている属性に適用されます。

  8. 同じ要素型の子は、10 個を超える要素の深さに入れ子にすることはできません。 この規則は、定義できる要素の種類ごとに個別に適用されます。

印刷機能ドキュメントの XML コンテンツは、UTF-8 または UTF-16 を使用してエンコードする必要があることに注意してください。

報告される Feature、Option、ParameterDef インスタンスのセットは、スナップショットに関係なく変更されないことに注意してください。 各 Option インスタンスを構成する ScoredProperty インスタンスと、各 ScoredProperty 要素に割り当てられた値も変更しないでください。 各 ParameterDef インスタンスを構成する Property インスタンスについても、同じことが当てはまります。

Feature/Option コンストラクトとパラメーターを完全に定義するために指定する必要がある追加の Property インスタンスの一覧については、「 ParameterDef 」と 「ParameterInit」を参照してください。 たとえば、各フィーチャーでは、ユーザー インターフェイス (UI) の動作を指定する必要があります。具体的には、各フィーチャーに対して 1 つまたは複数の Option インスタンスを一度に選択できます。 印刷スキーマ キーワード ドキュメントでは、これらの Property インスタンスを定義します。ここでは、PrintCapabilities ドキュメント内に表示する必要があり、印刷スキーマ キーワードで定義されている Value インスタンスを使用できます。

PrintCapabilities プロバイダーは、すべての構成に依存する Property インスタンスに適切な値を出力します。 たとえば、印刷速度がカラー モードと使用される解像度の両方に依存する場合、PrintCapabilities プロバイダーは、クライアント提供の PrintTicket で指定されたカラー モードと解像度の設定をメモし、印刷速度の適切な値を報告する必要があります。 ScoredProperty インスタンスはすべて単一値である必要があることに注意してください。その Value インスタンスは、デバイスの構成が変更されたときに変更できません。

また、印刷スキーマ キーワードで定義されている Property インスタンスは、そこで指定された場所に表示される必要があることにも注意してください。 PrintCapabilities ドキュメント内の任意の場所に表示することはできません。 プライベート定義の Property インスタンスは、スキーマ定義の Property インスタンス内のサブプロパティとしても、任意の場所に表示できます。

設定間の機能的な競合は、類似した機能を持つが異なる 2 つの競合しない印刷スキーマ要素として定義されることに注意してください。 たとえば、JobDuplexAllDocumentsContiguously と DocumentDuplex です。どちらもデバイスの双方向関数を表しますが、関数の適用、ジョブ全体に連続して適用される関数、ドキュメントに適用される関数が異なります。 このような要素が 2 つ指定されている場合、優先順位は PrintCapabilities プロデューサーと PrintTicket コンシューマーによって決定されます。 "制約付き" 属性を使用して競合する要素間の制約を適切に示すのは、PrintCapabilities プロデューサーの責任です。 このセマンティック競合を示すパブリック印刷スキーマ内の要素は、その定義で識別されます。

印刷スキーマの仕様