Attributi XML

  • Articolo

Questo argomento non è aggiornato. Per le informazioni più aggiornate, vedere La specifica dello schema di stampa.

Esistono diversi attributi XML che vengono visualizzati in diversi tipi di elemento definiti in Print Schema Framework. Gli attributi XML con lo stesso nome hanno in genere lo stesso significato e rispettano le stesse regole indipendentemente dal tipo di elemento in cui risiedono. Di conseguenza, gli attributi XML sono elencati qui in base al nome e non al tipo di elemento host. Gli attributi XML definiti privatamente non sono consentiti. Solo gli attributi XML definiti qui possono essere utilizzati in un documento PrintCapabilities o printTicket e quindi solo nel contesto definito.

Anche se le parti private non sono autorizzate a introdurre nuove definizioni nello spazio dei nomi di un'altra parte, è consentito utilizzare nomi esistenti di un altro spazio dei nomi privato, purché l'uso sia coerente con l'utilizzo stabilito dall'altra parte. Pertanto, un'opzione può contenere elementi ScoredProperty definiti da diverse parti, ognuna che risiede in spazi dei nomi diversi.

Nome attributo Tipi di dati e valori Scopo Note
Nome
XML QName
 Questo attributo XML identifica l'istanza dell'elemento. Distingue un elemento da un altro dello stesso tipo di elemento. Questo attributo XML viene così ampiamente usato come attributo name.
 Le restrizioni seguenti riguardano l'attributo name.
  • L'attributo name deve essere sotto forma di QName xml definito. Ovvero, deve essere qualificato da uno spazio dei nomi XML valido. I QName visualizzati come valori degli attributi del nome devono essere qualificati in modo esplicito per lo spazio dei nomi anche se è definito uno spazio dei nomi predefinito.
  • Il contenuto del carattere deve essere quello di un QName xml definito valido.
  • I nomi definiti privatamente devono essere qualificati con uno spazio dei nomi associato in modo univoco alla parte che ha introdotto l'attributo name.
  • Requisito di univocità di pari livello: due elementi di pari livello appartenenti allo stesso tipo di elemento possono avere lo stesso attributo del nome. L'unica eccezione è gli elementi Option, in cui l'attributo name può essere usato per definire un'opzione. Gli elementi Option di pari livello possono quindi avere lo stesso attributo name.
  • I tipi di elemento seguenti possono contenere attributi di nome: Property, ScoredProperty, ParameterDef, Option e Feature.
  • Gli attributi name devono essere visualizzati in ognuno dei tipi di elemento che li contengono, tranne nel caso di alcuni elementi dell'opzione pubblica di schema di stampa pubblica definiti in precedenza, ad esempio DocumentNUp.
Nell'esempio seguente viene illustrato come identificare un'istanza di Option usando un attributo 'name'. Questo è il modo corretto per definire gli elementi Option. Un provider non deve avere opzioni senza nome, a meno che non siano definite pubblicamente nello schema di stampa, ad esempio DocumentNUp.
  <psf:Option name="psk:StapleBottomRight">
    \<psf:ScoredProperty name="psk:Angle">
      <psf:Value xsi:type="xs:integer">_Undefined_<psf:Value>
    </psf:ScoredProperty>
    <psf:ScoredProperty name="psk:SheetCapacity" >
      <psf:Value xsi:type="xs:integer">_Undefined_<psf:Value>
    <psf:ScoredProperty>
  </psf:Option>
Propagare
Enumerazione
Nessun valore è attualmente definito.
 L'attributo propagate non viene utilizzato nella versione iniziale di Print Schema Framework. È documentato qui in modo che PrintCapabilities o il codice di convalida PrintTicket implementato per la versione iniziale di Print Schema Framework possa elaborare eventuali versioni dello schema successive senza errori.
Vincolata
Enumerazione
Valori consentiti:
  • Nessuno
  • PrintTicket Impostazioni
  • AmministrazioneImpostazioni
  • Dispositivo Impostazioni
Indica se l'opzione è disponibile per la selezione o per l'uso.
I valori consentiti dell'attributo vincolato hanno i significati seguenti. Si noti che questi valori sono elencati in ordine, dal meno restrittivo (Nessuno) al più restrittivo (Dispositivo Impostazioni).
Nessuno
  • L'opzione non è vincolata.
PrintTicket Impostazioni
  • L'opzione è vincolata dalle impostazioni printticket. Ciò implica che la modifica della configurazione può rimuovere il vincolo.
AmministrazioneImpostazioni
  • L'opzione è vincolata dalle impostazioni dell'amministratore; L'opzione non può essere abilitata dall'utente.
Dispositivo Impostazioni
  • L'opzione è vincolata dalle impostazioni del dispositivo o dalle opzioni del dispositivo installate fisicamente; L'opzione non può essere abilitata dall'utente o dall'amministratore.
Quando il provider PrintCapabilities segnala i valori dell'attributo vincolato, deve essere segnalato il vincolo più restrittivo trovato. Ad esempio, se un'opzione è vincolata da un'impostazione di amministratore e da un'impostazione del dispositivo, il provider PrintCapabilities deve segnalare Device Impostazioni.
Xmlns
URI
 Questo attributo XML stabilisce un collegamento tra un URI (Uniform Resource Identifier) dello spazio dei nomi e il prefisso dello spazio dei nomi visualizzato in XML QName. È necessario stabilire un collegamento di questo tipo all'URI dello spazio dei nomi definito per Print Schema Framework prima di poter usare qualsiasi tag di elemento definito dal framework, attributi, attributi del nome e così via. È possibile dichiarare questo spazio dei nomi come predefinito per evitare di qualificare effettivamente i tag di elemento con un prefisso dello spazio dei nomi, anche se tutti gli altri QName devono essere qualificati in modo esplicito. Lo spazio dei nomi standard deve essere definito nell'elemento radice appropriato. Osservare tutte le regole e le convenzioni XML relative all'uso dell'attributo xmlns.
L'URI per Print Schema Framework è http://schemas.microsoft.com/windows/2003/08/printing/printschemaframework.
L'URI per le parole chiave dello schema di stampa è 'https://schemas.microsoft.com/windows/2003/08/printing/printschemakeywords'.

Specifica dello schema di stampa