Elenco di controllo per la costruzione di documenti PrintCapabilities

Questo argomento non è aggiornato. Per ottenere le informazioni più aggiornate, consultare la Specifica dello schema di stampa .

Il Riepilogo dei tipi di elemento illustra i vari elementi che costituiscono un documento PrintCapabilities. Questa sezione fornisce un elenco di controllo che gli autori dei documenti PrintCapabilities possono usare per creare un documento PrintCapabilities che descrive un dispositivo.

  1. Identificare tutti gli attributi del dispositivo che contribuiscono alla configurazione del dispositivo. Per ogni attributo del dispositivo di questo tipo, determinare se deve essere rappresentato come costrutto Feature/Option o come costrutto di parametri.

  2. Per ogni funzionalità del dispositivo, determinare se può essere rappresentata da una funzionalità definita nelle parole chiave dello schema di stampa. In caso contrario, sarà necessario introdurre una nuova funzionalità definita privatamente (e un attributo del nome corrispondente).

    • Per le istanze della funzionalità definite dalle parole chiave dello schema di stampa, identificare ognuno degli stati disponibili su cui è possibile impostare questa funzionalità. Ogni stato corrisponde a un'opzione dell'istanza di Feature. Determinare quali di questi stati corrispondono alle istanze di Opzione con schema di stampa associate a questa funzionalità e quali stati richiedono un'istanza di Option personalizzata. L'argomento definizioni di opzioni presenta informazioni su come costruire nuove istanze di Option e su come derivare nuove istanze di Option dalle istanze di Option esistenti.

    • Per le istanze di Feature non standard, identificare le caratteristiche che possono essere usate per distinguere un'opzione da un'altra. Rappresentare ogni caratteristica di questo tipo da un elemento ScoredProperty e, in ogni istanza di Option, assegnare a ogni scoredProperty un valore specifico di tale opzione. Assicurarsi che siano presenti elementi ScoredProperty sufficienti in modo che ogni opzione per una determinata funzionalità sia univoca. Le istanze di Feature e Option non standard sono di natura nonportabile. Ciò significa che un altro driver non sarà in grado di trovare funzionalità o opzione equivalenti in modo che corrisponda a una funzionalità o un'opzione non standard specificata in PrintTicket creato dal driver.

  3. Determinare se un'opzione deve contenere elementi ParameterRef. Per altre informazioni, vedere Costrutti di parametri e elementi di riferimento dei parametri .

  4. Per i parametri, determinare se una delle istanze ParameterDef definite nelle parole chiave dello schema di stampa è una corrispondenza adeguata. Se è così, copia l'istanza ParameterDef dalle Parole chiave dello Schema di Stampa e modifica il valore di ciascuna istanza della proprietà modificabile per il miglior adattamento. Se nessuna delle istanze di *ParameterDef* corrisponde adeguatamente alle parole chiave dello schema di stampa, crea una tua istanza personalizzata di *ParameterDef*. Per altre informazioni, vedere parametri nel documento PrintCapabilities.

  5. Assicurarsi che tutte le istanze di Property e ScoredProperty richieste dal documento Print Schema Keywords siano presenti nel documento PrintCapabilities e che siano inizializzate correttamente.

  6. Aggiungere altre istanze di Proprietà e sottoproprietà secondo necessità. È possibile introdurre istanze di Proprietà definite privatamente se sono presenti aspetti del dispositivo che è necessario caratterizzare che non sono coperti dalle istanze property definite nelle parole chiave dello schema di stampa.

  7. Osservare la convenzione dello spazio dei nomi per gli attributi del nome. Questo vale per gli attributi dei nomi definiti privatamente e per quelli definiti nelle parole chiave dello schema di stampa.

  8. Gli elementi figlio dello stesso tipo di elemento non devono annidarsi a una profondità di più di 10 elementi. Questa regola si applica in modo indipendente a ogni tipo di elemento che può essere definito.

Si noti che le funzionalità di stampa del contenuto XML del documento DEVONO essere codificate usando UTF-8 o UTF-16.

Si noti che il set di istanze Feature, Option e ParameterDef segnalate non deve cambiare, indipendentemente dallo snapshot. Le istanze ScoredProperty che costituiscono ogni istanza Option e il valore assegnato a ciascun elemento ScoredProperty non devono cambiare. Lo stesso vale per le istanze di Property che costituiscono ogni istanza ParameterDef.

Per un elenco di istanze di proprietà aggiuntive che devono essere fornite per definire completamente costrutti e parametri di Feature/Option, vedere ParameterDef e ParameterInit. Ad esempio, ogni funzionalità deve specificare il comportamento dell'interfaccia utente, specificamente se è possibile selezionare esattamente una o più istanze di Option per ogni funzionalità contemporaneamente. Il documento Print Schema Keywords definisce queste istanze di Property, dove devono essere visualizzate all'interno del documento PrintCapabilities e quali istanze value definite nelle parole chiave dello schema di stampa sono disponibili.

Il provider PrintCapabilities è responsabile dell'emissione del valore appropriato per tutte le istanze delle proprietà dipendenti dalla configurazione. Ad esempio, se la frequenza di stampa dipende sia dalla modalità colore che dalla risoluzione utilizzata, il provider PrintCapabilities deve prendere nota delle impostazioni di modalità colore e risoluzione specificate nel printTicket fornito dal client e deve segnalare il valore appropriato per la frequenza di stampa. Si noti che ogni istanza scoredProperty deve essere a valore singolo; L'istanza di Value non può cambiare quando cambia la configurazione del dispositivo.

Si noti anche che le istanze di proprietà definite nelle Parole Chiave dello Schema di Stampa devono apparire nel percorso specificato lì. Non possono essere visualizzati in posizioni arbitrarie all'interno di un documento PrintCapabilities. Le istanze delle proprietà definite privatamente possono essere visualizzate ovunque, anche come sottoproprietà all'interno di istanze di Proprietà definite da schema.

Si noti che un conflitto funzionale tra le impostazioni è definito come due elementi dello schema di stampa non in conflitto che hanno una funzione simile, ma sono funzionalità diverse. Un esempio sarebbe JobDuplexAllDocumentsContiguously e DocumentDuplex; entrambi rappresentano la funzione duplex del dispositivo, ma differiscono nell'applicazione della funzione, una che si applica all'intero processo in modo contiguo e una ai documenti. Nel caso in cui vengano specificati due elementi di questo tipo, la precedenza è determinata dal produttore di PrintCapabilities e dal consumatore di PrintTicket. È responsabilità del produttore di PrintCapabilities indicare correttamente i vincoli tra gli elementi in conflitto tramite l'attributo "vincolato". Gli elementi dello schema di stampa pubblico che presentano questo conflitto semantico vengono identificati nella relativa definizione.

Specifica dello Schema di Stampa